> ## Documentation Index
> Fetch the complete documentation index at: https://docs.riggery.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# State query

> Читать структурированные записи Instance.

Точные фильтры по структурированным записям (не семантический поиск Memory). Нужно имя коллекции — смотрите [State collections](/ru/graph/tools/state-collections). Агент также может передать условие `where` по JSON-путям (AND).

<h2 id="input">
  Вход
</h2>

Вкладка инспектора **Настройки**. Правила пустого поля на графе: [Предыдущие узлы](/ru/graph/previous-nodes). **Вставить значение** здесь нет.

У инструмента на агенте эти поля могут быть **Решает агент** или **Фиксировано**.

| Поле          | Обязательно | Пустое             | Заметки                                   |
| ------------- | ----------- | ------------------ | ----------------------------------------- |
| **Коллекция** | Да          | Ошибка             |                                           |
| **Ключ**      | Нет         | —                  | Точный ключ. Пустое — страница коллекции. |
| **Лимит**     | Нет         | По умолчанию: `20` | Максимум 100.                             |

<h2 id="output">
  Выход
</h2>

На следующем узле **Предыдущие узлы** показывает **`State query`: Result** (`{{State query.text}}`, пока имя уникально).

| Выход  | В меню | Тип        | Следующий узел получит                                                                                                                              |
| ------ | ------ | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| Result | Да     | JSON-текст | `{ "items": [ { collection, key, data, createdAt, updatedAt } ], "nextCursor": null }`. Нет совпадений: `No matching records in collection "name".` |