find_similar_text
Find archived scenes matching a plain-language query over their imagery.
Text-to-scene search: embeds ``query`` ("ships at a berth", "a flooded field")
and ranks the stored *image* vectors by cosine similarity. It only works when
the index was built and this query is embedded with the **same** joint
CLIP-family model whose text and image encoders share a vector space (a
dimension mismatch is reported as an error; ``model`` selects it).
Requires the same prebuilt ``catalog.embed.db`` (``umbra embed build``) and
embedding key as ``find_similar``; the only model call is turning the text
query into a vector. Returns the ranked matches as compact records (each with
the acquisition's ``href`` for ``get_item`` / ``quicklook``) plus attribution.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "find_similar_text"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | Joint text-and-image model id. Must match the scene index. A dimension mismatch is an error. | |
| query | Yes | Plain-language description of the imagery to find, embedded in the same space as the scene index. | |
| top_k | No | Maximum matches to return. Default 10. | |
| min_score | No | Minimum cosine similarity. Default 0. Matches below it are dropped. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||