find_mood_reference_scenes
Find reference scenes that achieve a target mood by entering any mood description, using semantic search when exact tag isn't available.
Instructions
Find reference scenes that strongly achieve a target mood.
Returns:
A dict with:
- method: "tag_matched" if target_mood closely matched a
precoded mood tag, "semantic_fallback" if it didn't and results
came from raw nearest-neighbor search instead, or "unavailable"
if the reference index isn't available.
- matched_tag / tag_similarity: the closest precoded tag and
its cosine similarity to target_mood, regardless of which
method was used -- lets the caller judge match confidence even on
the fallback path.
- results: the ranked scene matches themselves. Empty if no
scenes are available or the index is unavailable.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| top_k | No | Maximum number of matches to return. | |
| target_mood | Yes | The mood to rewrite toward, in free text (e.g. "paranoid", "wistful", "a creeping sense of being watched"). Doesn't need to match a precoded label -- close matches use a precise tag-filtered search, anything else falls back to raw semantic search so results are still returned. |