search_entities
Search the warehouse for entities that match a single term. Returns ranked candidates with similarity scores; the agent decides which (if any) the user meant. Entity types: duid (5-letter+ codes like ARWF1), station (station-level results that group all DUIDs at that station), region (canonical IDs NSW1/VIC1/QLD1/SA1/TAS1/SNOWY1), interconnector (Basslink, Heywood, QNI, VNI, Murraylink, Directlink, Project EnergyConnect), and fuel_type (Coal/Gas/Hydro/Wind/Solar/Battery/Biomass/Diesel). DUID matches also carry region, fuel_type, registered_capacity_mw and schedule_type (SCHEDULED/SEMI-SCHEDULED/NON-SCHEDULED), plus a note when the schedule type limits which tables hold rows for the unit: read it before querying bids, dispatch targets or constraints. Pick search terms from the user's question yourself. Call once per term — do not pass the whole question. Similarity is 0..1; treat scores below 0.7 with scepticism (the query term is probably a generic English word, not an entity reference).
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": "search_entities"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of candidates to return, ranked by similarity. Defaults to 10 and is clamped to 1..=50. Increase when the term is ambiguous and you want to see more options. | |
| query | Yes | A single term to search for. Pick this from the user's question yourself: a station name ("Hornsdale"), a DUID code or prefix ("ARWF1", "HBESS"), a region alias ("victoria"), an interconnector alias ("basslink"), or a fuel type ("wind"). Do not pass the whole question — call this tool once per term you want to look up. | |
| types | No | Optional filter to specific entity types. Valid values: "duid", "station", "region", "interconnector", "fuel_type". Omit to search across all types. | |
| question_id | No | Optional UUID returned by an earlier `start_question` call. When provided, this tool call is attributed to that question. |