discover_random
Pick a random artwork from cache that matches specified constraints (region, period, artist exclusion, museum). Auto-seeds cache for first use. Use to break repetitive search patterns and discover unexpected works.
Instructions
Pick one random artwork from the local cache that matches the given constraints. Useful for breaking out of repetitive search territory (e.g. surface a random Edo-period work to satisfy a no-back-to-back-European-pre-1900 pairing rule). On a cold cache with region or period constraints provided, auto-seeds via a small search_artworks call derived from those constraints before sampling — so first-time use works without manually warming the cache. Without constraints, returns a hint to run search_artworks first.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| region | No | Normalized region tag (e.g. "china", "japan", "netherlands"). Exact match. | |
| period | No | Normalized period tag (e.g. "tang dynasty", "edo", "safavid"). Exact match. | |
| not_artist | No | Artist names to exclude (exact match against the canonical artist name field). | |
| museum | No | Optional museum code to restrict to (met, cleveland, aic). |