discover_random
Discover a random artwork matching your constraints to break repetitive search patterns. Auto-seeds from constraints if cache is cold, or returns a hint to search first.
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). |