Find the assets inside a room
find_in_roomFind tracked assets whose 3D bounding-box centers fall inside a room's floor-to-ceiling volume, filter by category, and return external IDs to highlight or isolate.
Instructions
Find the tracked assets that sit inside a room's 3D volume.
Use this to answer room-contents questions (e.g. "what equipment is in room 54?", "the receptacles in the electrical room"), then pass the returned external_ids to highlight_elements or isolate. This tool does NOT change the view by itself.
Membership is by true 3D containment: an asset's bounding-box center must fall inside the room footprint AND within its floor-to-ceiling band, so assets on other floors are correctly excluded.
Examples: - Everything in room 54: room_number='54' - Just the receptacles: room_number='54', category='receptacles'
Returns: {"room": {external_id, room_name, room_number, level_name}, "count": int, "elements": [{external_id, asset_type, description, level_name}]}.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "find_in_room"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max assets to return (1-500). | |
| category | No | Optional category to restrict the result to (e.g. only the receptacles in the room). Omit for all tracked assets. | |
| room_number | No | The room's number as shown on the plans (e.g. '54' for 'EDP I'). Provide this or room_external_id. | |
| room_external_id | No | The room's durable externalId. An alternative to room_number. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||