Protocol method · query
query
Find entities (or documents) with the compact query syntax or its JSON form; paginated, returns handles.
- Scope:
read - Service:
core - MCP:
ara_query
Params
| Param | Required | Description |
|---|---|---|
session | yes | Session handle from session.begin. |
q | Compact query: space-separated terms that must all hold. Light (has the component), !Light (lacks it), name:Crate*, a bare word (radio: names containing it), parent:e_1c0d, under:e_1c0d, prefab:crate, depth<=1, e_8b21 (an ID), field comparisons such as Light.intensity>500, Light.kind=spot, Transform.position.y<=0. | |
filter | The same conditions as JSON; combined with q. | |
doc | Document (asset ID, path or @path#id); default: every scene and prefab. | |
kind | Search entities (default) or documents. | |
fields | Field paths to return per entity (Light.intensity), effective values. | |
detail | Per-item detail: summary (default), handles or full. | |
limit | Page size (default 50, max 500). | |
cursor | next from the previous page. |