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

# Запросы

> Документация по запросам FailproofAI Observability.

Задавайте любые вопросы о данных вашего агента и получайте ответы за секунды. FailproofAI Observability предоставляет библиотеку сохранённых готовых к запуску запросов по вашим событиям и оценкам, так что вы начинаете с рабочего примера вместо пустого редактора SQL.

<img src="https://mintcdn.com/exosphere/kH8rXaL6tCSRWEFy/agenteye/images/queries.png?fit=max&auto=format&n=kH8rXaL6tCSRWEFy&q=85&s=0035db75f0157d16acfe8dd0a4a95cd7" alt="Библиотека сохранённых запросов: сетка переиспользуемых запросов, как встроенные предустановки, так и пользовательские" width="3200" height="2000" data-path="agenteye/images/queries.png" />

*Ваша библиотека сохранённых запросов на `/<org-slug>/queries`: встроенные предустановки рядом с запросами, сохранёнными вашей командой.*

## Начните с предустановки, а не с пустой страницы

Вам не нужно запоминать имена таблиц или писать SQL с нуля. Библиотека открывается со встроенными предустановками для вопросов, которые команды задают чаще всего, рядом с запросами, которые сохранила и назвала ваша команда. Выберите тот, который близок к тому, что вам нужно, и вы уже наполовину на пути к ответу.

Каждый сохранённый запрос привязан к организации и доступен для общего использования, поэтому полезные запросы, которые пишут ваши коллеги, становятся и вашими. Назовите запрос, добавьте описание один раз, и любой в вашей организации сможет его найти, запустить или позже закрепить его результаты на панели управления.

Найдите это на `/<org-slug>/queries`.

## Отредактируйте и запустите в компоновщике SQL

Откройте любой запрос, и он попадёт в компоновщик SQL, где вы можете его изменить и увидеть ответ немедленно: без экспорта, без круговых поездок, без ожидания кого-то ещё.

<img src="https://mintcdn.com/exosphere/kH8rXaL6tCSRWEFy/agenteye/images/query-lab.png?fit=max&auto=format&n=kH8rXaL6tCSRWEFy&q=85&s=0db5b6d69d597935380c3a027c745dd5" alt="Компоновщик SQL запросов, запускающий сохранённый запрос, с боковой панелью схемы и живой сеткой результатов" width="3200" height="2000" data-path="agenteye/images/query-lab.png" />

*Компоновщик SQL: ваш запрос слева, боковая панель схемы, чтобы вы никогда не угадывали имя столбца, и живая сетка результатов внизу.*

* **Боковая панель схемы** показывает таблицы аналитики и их столбцы, так что вы можете составить запрос без поиска имён полей.
* **Живая сетка результатов** возвращает строки в момент запуска, так что вы итерируете за секунды вместо угадывания и переугадывания.
* **Предназначена только для чтения.** Запросы выполняются для вашего хранилища событий и проверяются на сервере: разрешены только операторы `SELECT` и `WITH`, с ограничением по времени выполнения и лимитом строк. Исследовательский запрос никогда не может изменить ваши данные, а неуправляемый запрос останавливается автоматически.

Довольны результатом? Сохраните его обратно в библиотеку, чтобы вся команда им воспользовалась, или закрепите его результаты на панели управления как линейный, столбчатый, площадной или круговой элемент.

## Запускайте их из терминала или позвольте помощнику написать их

Те же сохранённые запросы следят за вами везде, где вы работаете:

* **Из терминала.** CLI `agenteye` выводит список, запускает и сохраняет те же самые запросы, поэтому вы можете вставить результат в скрипт, интегрировать его в CI или передать агенту кодирования.

```bash theme={null}
agenteye query list                 # the same saved queries, from your terminal
agenteye query run errs --arg prod  # run one and print the rows (add --json to pipe it)
```

Смотрите [CLI и агенты](/ru/agenteye/cli-and-agents) для полного набора команд.

* **От AI помощника.** Не знаете, как сформулировать SQL? Задайте вопрос встроенному в панель управления [AI помощнику](/ru/agenteye/assistant) на простом английском языке, и он составит запрос и сохранит его в вашу библиотеку.

Запуск сохранённого запроса контролируется разрешением `queries:run`, отделённым от разрешений на создание или удаление запросов, так что вы можете предоставить доступ на чтение, не позволяя всем переписывать библиотеку.

## Связанные материалы

* [Панели управления](/ru/agenteye/dashboards): закрепляйте результаты запросов в общие диаграммы на уровне организации.
* [AI помощник](/ru/agenteye/assistant): задавайте вопросы на простом английском языке и получайте запрос.
* [CLI и агенты](/ru/agenteye/cli-and-agents): запускайте и сохраняйте те же запросы из терминала.