search_entities
Search COBie entities by type and optional text query in an Excel file, returning matching items with metadata and configurable limit.
Instructions
Search COBie entities (contact, space, floor, type, component, document) by type and optional query.
For filtered lists by floor/space use list_floors, list_spaces, list_components.
Args:
entity_type: contact|space|floor|type|component|document (plural accepted).
excel_path: Path to COBie Excel file.
query: Optional text to match in any cell (case-insensitive substring).
limit: Max items to return (default 50).
Returns:
items (list of {id, label, key, sheet, rowIndex, fields}), executed_at, provenance.
Example:
search_entities("component", "project.xlsx", query="AHU", limit=10)
# items[].id = "component:AHU-1", items[].fields = {Name, TypeName, ...}
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| query | No | ||
| excel_path | Yes | ||
| entity_type | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||