failproofai 1.0.1-beta.1 → 1.0.1

package/.next/standalone/docs-old/ru/agenteye/api-keys.mdx

@@ -0,0 +1,280 @@
+---
+title: "API ключи"
+description: "API ключи контролируют, кто и что может получить доступ к вашему серверу Failproof AI Observability, позволяя коллектору отправлять события без предоставления прав на чтение или администрирование."
+---
+
+
+API ключи контролируют, кто и что может получить доступ к вашему серверу Failproof AI Observability, позволяя коллектору отправлять события без предоставления прав на чтение или администрирование. Каждый ключ имеет одно или несколько разрешений, и каждое разрешение ограничивает доступ к определённым маршрутам сервера; вы даёте только те разрешения, которые необходимы для работы. В большинстве развёртываний требуется всего три типа ключей.
+
+## Три ключа, необходимые большинству развёртываний
+
+| Ключ | Разрешения | Кто его использует |
+|---|---|---|
+| Ключ коллектора | `events:add` | `agenteye-collector` на каждой машине агента для отправки событий. |
+| Ключ для чтения панели управления | `events:read`, `keys:read` | Оператор только для чтения или интеграция, которая запрашивает данные без их изменения. |
+| Ключ начальной загрузки администратора | все разрешения | Оператор, который впервые запускает экземпляр (и панель управления). Инициализируется из переменной окружения `ADMIN_KEY`. Смотрите [Ключ начальной загрузки администратора](#bootstrap-admin-key). |
+
+Начните отсюда. Обращайтесь к полному каталогу разрешений ниже только если вам нужен узкоспециализированный ключ с пользовательской областью действия. Смотрите также [Рекомендуемая структура ключей](#recommended-key-layout) и [Создание ключей](#creating-keys).
+
+---
+
+## Разрешения
+
+Сервер обеспечивает фиксированный каталог разрешений; каждое из них ограничивает доступ к определённым HTTP маршрутам. **Ключ администратора** содержит все разрешения; ограниченный ключ содержит подмножество, которое вы предоставляете при создании. Неизвестные строки разрешений отклоняются при создании ключа.
+
+> **Примечание:** Два действительных разрешения предназначены только для человека/панели управления и не могут быть предоставлены API ключу: `orgs:admin` (администрирование экземпляра, только для операторов) и `keys:update`. Запрос `POST /keys` или `PATCH /keys/:id`, пытающийся предоставить любое из них, отклоняется с кодом HTTP 422. Смотрите строку `keys:update` ниже, чтобы понять, почему ключ-носитель может создавать ключи, но никогда их не редактирует.
+
+### Приём и запрос событий
+
+| Разрешение | HTTP маршруты | Что это позволяет |
+|---|---|---|
+| `events:add` | `POST /events` | Приём пакетов событий от коллектора. Единственное разрешение, которое нужно коллектору. |
+| `events:read` | `GET /events`, `GET /events/latency_aggregate`, `GET /events/environments`, `GET /events/models`, `GET /sessions/:session_id/export` | Запрос событий, список известных окружений, список идентификаторов моделей в данных (используется представлением Models и фильтрами моделей), расчёт агрегированной задержки, которая питает тепловую карту / полосы процентилей, и экспорт сеанса в JSONL. Общие конечные точки фильтров `GET /events/environments` и `GET /events/agent_ids` доступны с **либо** `events:read` **либо** `evaluations:read`, так что страница сеансов (ограниченная `evaluations:read`) переиспользует те же грани для каждой организации. `GET /events/models` не является одной из них: требует `events:read`, поэтому участник, имеющий только `evaluations:read`, получает 403 от неё. |
+
+### Сеансы и оценки
+
+| Разрешение | HTTP маршруты | Что это позволяет |
+|---|---|---|
+| `evaluations:read` | `GET /sessions`, `GET /evaluations`, `GET /evaluations/aggregate`, `GET /evaluations/environments`, `GET /evaluation-jobs` | Список сеансов, чтение результатов оценки, свёрнутое здоровье оценки, используемое панелями управления, и состояние очереди рабочих заданий оценки. |
+| `evaluations:trigger` | `POST /sessions/:session_id/re-evaluate` | Ручной расчёт переоценки для завершённого сеанса. |
+
+### Панели управления
+
+| Разрешение | HTTP маршруты | Что это позволяет |
+|---|---|---|
+| `dashboards:read` | `GET /dashboards`, `GET /dashboards/:id`, `GET /dashboards/:id/tiles` | Список панелей управления, загрузка одной и чтение её плиток. |
+| `dashboards:write` | `POST /dashboards`, `PUT /dashboards/:id`, `POST /dashboards/:id/tiles`, `PUT /dashboards/:id/tiles/:tile_id`, `DELETE /dashboards/:id/tiles/:tile_id`, `PUT /dashboards/:id/tiles/layout` | Создание и редактирование панелей управления, добавление / редактирование / удаление плиток и переупорядочение сетки плиток. |
+| `dashboards:delete` | `DELETE /dashboards/:id` | Удаление всей панели управления (удаление на уровне плиток находится под `dashboards:write`). |
+
+### Сохранённые запросы (SQL редактор)
+
+| Разрешение | HTTP маршруты | Что это позволяет |
+|---|---|---|
+| `queries:read` | `GET /queries`, `GET /queries/:id`, `GET /queries/schema` | Список сохранённых запросов, загрузка одного и проверка схемы только для чтения, которая используется редактором. |
+| `queries:write` | `POST /queries`, `PUT /queries/:id` | Создание и редактирование сохранённых запросов. SQL по-прежнему маршрутизируется через ту же роль только для чтения и охранявшие проверки SQL, что и вызов `queries:run`. |
+| `queries:delete` | `DELETE /queries/:id` | Удаление сохранённого запроса. |
+| `queries:run` | `POST /queries/run` | Выполнение сохранённых или произвольных SQL запросов против роли только для чтения, используемой редактором. |
+
+### AI ассистент
+
+| Разрешение | HTTP маршруты | Что это позволяет |
+|---|---|---|
+| `agent:use` | `GET /agent/conversations`, `POST /agent/conversations`, `GET /agent/conversations/:id`, `PATCH /agent/conversations/:id`, `DELETE /agent/conversations/:id`, `PUT /agent/conversations/:id/messages` | Общение с AI ассистентом и управление вашими собственными (приватными) разговорами. Требуется для **пользователя** увидеть панель ассистента; собственный ключ ассистента `dashboard-assistant` и инициализируется отдельно (смотрите ниже). |
+
+### API ключи
+
+| Разрешение | HTTP маршруты | Что это позволяет |
+|---|---|---|
+| `keys:create` | `POST /keys` | Создание нового ограниченного API ключа. **Не** предоставляет редактирование разрешений существующего ключа (это `keys:update`). |
+| `keys:read` | `GET /keys` | Список существующих ключей. Секреты никогда не возвращаются этой конечной точкой. |
+| `keys:update` | `PATCH /keys/:id` | Редактирование разрешений существующего ключа. **Разрешение только для человека/панели управления**; не может быть назначено API ключу (ключ-носитель может создавать ключи, но никогда их не редактирует). |
+| `keys:disable` | `POST /keys/:id/disable` | Отозвание ключа. Защищённые ключи (`admin`, `dashboard-assistant`) не могут быть отключены; ротируйте их через переменную окружения + перезагрузка. |
+| `keys:regenerate` | `POST /keys/:id/regenerate` | Ротация секрета ключа. Защищённые ключи не могут быть восстановлены через этот маршрут. |
+
+### Пользователи панели управления
+
+| Разрешение | HTTP маршруты | Что это позволяет |
+|---|---|---|
+| `users:create` | `POST /users`, `GET /users/defaults` | Приглашение нового пользователя панели управления (отправляет электронное письмо + одноразовый код доступа (OTP)) и чтение набора разрешений по умолчанию, настроенного панелью управления, используемого при заполнении формы приглашения. |
+| `users:read` | `GET /users`, `GET /users/:id` | Список пользователей и загрузка одной записи пользователя. |
+| `users:update` | `PUT /users/:id` | Редактирование разрешений пользователя. Обновления отправляют электронное письмо об изменении разрешений затронутому пользователю и вступают в силу при его следующем запросе; повторный вход не требуется. |
+| `users:delete` | `DELETE /users/:id`, `POST /users/:id/enable` | Отключение пользователя (немедленно отзывает его сеансы) и повторное включение ранее отключённого пользователя. |
+
+Эти разрешения поддерживают страницу панели управления **Пользователи**, где предоставленные области действия каждого участника отображаются в виде чипов:
+
+![Страница Пользователи: карточка на каждого пользователя панели управления с его электронной почтой, предоставленными разрешениями и элементами управления редактированием/отключением](/agenteye/images/users.png)
+
+### Операционные параметры
+
+| Разрешение | HTTP маршруты | Что это позволяет |
+|---|---|---|
+| `settings:read` | `GET /settings`, `GET /settings/schema`, `GET /settings/model-context-windows`, `GET /settings/model-context-windows/resolve` | Просмотр операционных параметров, управляемых панелью управления, и их метаданных; список переопределений окна контекста для каждой модели; и разрешение эффективного окна для модели. |
+| `settings:write` | `PUT /settings/:key`, `PUT /settings/model-context-windows`, `DELETE /settings/model-context-windows` | Редактирование операционных параметров и добавление, изменение или удаление переопределений окна контекста для каждой модели. Изменения влияют на новые события без перезагрузки сервера. |
+
+![Страница параметров: операционные параметры, управляемые панелью управления, такие как разрешённые входы и время жизни сеанса/OTP, редактируемые без перезагрузки](/agenteye/images/settings.png)
+
+### Оповещения и инциденты
+
+| Разрешение | HTTP маршруты | Что это позволяет |
+|---|---|---|
+| `alerts:read` | `GET /alerts`, `GET /alerts/:id` | Просмотр настроенных определений оповещений. |
+| `alerts:write` | `POST /alerts`, `PUT /alerts/:id`, `DELETE /alerts/:id`, `POST /alerts/:id/test` | Создание, редактирование, удаление и тестовое срабатывание определений оповещений. |
+| `incidents:read` | `GET /alerts/incidents`, `GET /alerts/incidents/:iid`, `GET /alerts/incidents/:iid/comments`, `GET /alerts/incidents/:iid/subscribers` | Просмотр инцидентов и их тактики сортировки. |
+| `incidents:write` | `POST /alerts/:id/incidents` | Ручное открытие инцидента против существующего оповещения. |
+| `incidents:ack` | `POST /alerts/incidents/:iid/ack`, `POST /alerts/incidents/:iid/assign`, `POST /alerts/incidents/:iid/resolve`, `POST /alerts/incidents/:iid/comments`, `POST /alerts/incidents/:iid/subscribe`, `POST /alerts/incidents/:iid/unsubscribe` | Подтверждение, назначение, разрешение и комментирование инцидентов. |
+
+### Аудиты
+
+| Разрешение | HTTP маршруты | Что это позволяет |
+|---|---|---|
+| `audits:read` | `GET /audits`, `GET /audits/:id`, `GET /audits/:id/runs`, `GET /audits/findings`, `GET /audits/findings/:fid` | Просмотр определений аудитов, истории запусков и результатов. |
+| `audits:write` | `POST /audits`, `PUT /audits/:id`, `DELETE /audits/:id`, `POST /audits/:id/run`, `POST /audits/findings/:fid/status` | Создание, редактирование, удаление и запуск аудитов; сортировка результатов (подтверждение / отключение звука / отклонение / разрешение / повторное открытие / назначение). |
+
+> **Примечание:** Чтобы дать ключу поверхность аудита, явно предоставьте `audits:*`. Смотрите [Примечания об обновлении и обратной совместимости](#upgrade-and-backward-compatibility-notes), чтобы узнать, как существующие получатели были мигрированы при появлении Audits.
+
+> Конечная точка средства выбора получателей `GET /alerts/recipients` (в которой указаны адреса электронной почты участников, которых редактор оповещений может уведомить), доступна держателем **либо** `alerts:read` **либо** `alerts:write`, так что редакторы оповещений могут заполнить средство выбора без предоставления `users:read`.
+
+> Просмотрелю панели управления требуется **как** `dashboards:read` (для загрузки сохранённых представлений), так и `evaluations:read` (показатели здоровья вычисляются из данных оценки). Предоставьте `dashboards:write` для позволить пользователю создавать или редактировать панели управления, и `dashboards:delete` для их удаления.
+
+> `/health` и `/auth/*` (запрос OTP, проверка OTP, проверка сеанса, выход) по замыслу не требуют аутентификации; это процесс входа и проверка работоспособности. `GET /access-granters` требует действительный ключ, но без конкретного разрешения, поэтому любой зарегистрировавшийся пользователь может увидеть, какие администраторы могут контактировать об изменениях доступа.
+
+---
+
+## Наборы разрешений
+
+Наборы разрешений позволяют применить именованную роль вместо выбора отдельных токенов каждый раз. Вместо выбора десятка разрешений один за другим для каждого нового пользователя панели управления или API ключа вы выбираете набор, и все назначенные ему получают последовательное, проверяемое право. Редактирование пользовательского набора повторно применяет новое право каждому пользователю, уже назначенному ему, так что изменение роли — это один edit вместо обхода каждого участника.
+
+Каждая организация инициализируется с тремя встроенными наборами:
+
+| Набор | Разрешения | Предназначен для |
+|---|---|---|
+| `read-only` | `events:read`, `keys:read`, `users:read`, `evaluations:read`, `dashboards:read`, `queries:read`, `settings:read`, `alerts:read`, `audits:read`, `incidents:read` | Доступ только для просмотра ко всей операционной поверхности. |
+| `standard` | всё из `read-only`, плюс `evaluations:trigger`, `queries:run`, `incidents:ack`, `agent:use` | Только для чтения плюс повседневные действия дежурного: запуск запросов, переоценка сеансов, подтверждение инцидентов и использование AI ассистента. |
+| `admin` | каждое назначаемое разрешение | Полный контроль над организацией. |
+
+Три встроенных набора **неизменяемы**; их имена всегда означают одно и то же, поэтому `read-only`, `standard` и `admin` безопасны для ссылки в политике и адаптации. Оператор может создавать дополнительные **пользовательские наборы** для моделирования ролей, специфичных для вашей организации (например, роль документ создателя или роль только-коллектора).
+
+Наборы находятся на панели управления и управляются через API по адресу `GET /permission-sets` (список, ограничен `users:read`) и `POST /permission-sets` / `PUT /permission-sets/:name` / `DELETE /permission-sets/:name` (создание, редактирование, удаление пользовательского набора, ограничено `settings:write`). Удаление или редактирование встроенного набора отклоняется.
+
+Членство в наборе поддерживает две другие функции:
+
+- **`DEFAULT_USER_PERMISSIONS`** (право, предварительно выбранное, когда администратор открывает **+ новый пользователь**) по умолчанию использует набор `standard`.
+- **Флаг `--set`** на `agenteye-orgctl` (управление участниками организации) запускает участника из именованного набора, который вы затем можете точно настроить с помощью `--add` / `--remove`.
+
+> **Примечание:** Если набор включает разрешение, которое не может быть назначено ключу (например, пользовательский набор, несущий `keys:update`), инициализация ключа из этого набора отбрасывает неназначаемые токены; сервер иначе отклонил бы ключ с HTTP 422. Пользователи панели управления не подвергаются этому ограничению.
+
+---
+
+## Ключ начальной загрузки администратора
+
+Ключ администратора — это единственная корневая учётная данные, которая позволяет оператору запустить доступ с нуля: с его помощью вы можете создавать каждый другой ограниченный ключ, приглашать первых пользователей панели управления и настраивать экземпляр до того, как будет существовать другой ключ. Это единственный ключ, который вы не создаёте через API ключей; он подготавливается из окружения, чтобы сервер был доступен при первой загрузке.
+
+Установите переменную окружения `ADMIN_KEY` на сервере. При каждом запуске сервер обновляет это значение как ключ администратора со всеми разрешениями.
+
+Для ротации: измените `ADMIN_KEY` на новый секрет и перезагрузите сервер.
+
+---
+
+## Область действия организации
+
+**Организации сами создаются и управляются вне записей этого API ключей оператором.** Жизненный цикл организации и участника (создание / переименование / удаление / очистка организации; добавление / обновление / удаление участника) выполняется с помощью **CLI `agenteye-orgctl`**; нет HTTP API или кнопки панели управления для этого. Что **остаётся** неизменным: **ключи API для каждой организации по-прежнему создаются на панели управления (или через этот API ключей)** членами организации.
+
+В развёртывании с несколькими организациями каждый ключ, который создаёт член организации (через этот API ключей или страницу панели управления **Ключи**), принадлежит **одной организации** и может только читать или писать данные этой организации; организация отмечена на ключе при создании и обеспечивается при каждом запросе. Два ключа начальной загрузки — единственное исключение: ключ `admin` (инициализирован из `ADMIN_KEY`) и ключ `dashboard-assistant` (инициализирован из `AGENT_API_KEY`) — это **ключи области действия экземпляра** (они не имеют организации). Панель управления аутентифицируется с помощью ключа `admin`, чтобы она могла прокси-запросы для каждой организации от имени вошедших участников. Развёртывания на одного арендатора не должны об этом думать; все ключи принадлежат встроенной организации `default`.
+
+---
+
+## Создание ключей
+
+Используйте ключ администратора (или любой ключ с разрешением `keys:create`) для создания дополнительных ограниченных ключей.
+
+### Ключ коллектора (только приём)
+
+```bash
+curl -s -X POST http://your-server/keys \
+  -H "Authorization: Bearer $ADMIN_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "name": "prod-collector",
+    "key": "your-collector-secret",
+    "permissions": ["events:add"]
+  }'
+```
+
+### Ключ панели управления (только чтение)
+
+```bash
+curl -s -X POST http://your-server/keys \
+  -H "Authorization: Bearer $ADMIN_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "name": "dashboard",
+    "key": "your-dashboard-secret",
+    "permissions": ["events:read", "keys:read"]
+  }'
+```
+
+При создании ключа через HTTP API вы предоставляете значение `key` сами; выберите сильный секрет и храните его безопасно. (Панель управления работает иначе: она генерирует сильный секрет для вас и показывает его один раз при создании; смотрите [Управление ключами в панели управления](#key-management-in-the-dashboard).) Ответ подтверждает, что ключ был создан:
+
+```json
+{
+  "id": "550e8400-e29b-41d4-a716-446655440000",
+  "name": "prod-collector",
+  "permissions": ["events:add"],
+  "created_at": "2026-04-01T12:00:00Z"
+}
+```
+
+---
+
+## Перечисление ключей
+
+```bash
+curl -s http://your-server/keys \
+  -H "Authorization: Bearer $ADMIN_KEY"
+```
+
+Секреты ключей не возвращаются в ответах списков, только ID, имена и разрешения.
+
+---
+
+## Отключение ключа
+
+Отключение отзывает доступ немедленно без удаления записи ключа.
+
+```bash
+curl -s -X POST http://your-server/keys/<id>/disable \
+  -H "Authorization: Bearer $ADMIN_KEY"
+```
+
+---
+
+## Восстановление ключа
+
+Генерирует новый секрет для существующего ключа. Старый секрет немедленно становится недействительным.
+
+```bash
+curl -s -X POST http://your-server/keys/<id>/regenerate \
+  -H "Authorization: Bearer $ADMIN_KEY"
+```
+
+Ответ включает новый открытый секрет, **показанный только один раз**.
+
+---
+
+## Управление ключами в панели управления
+
+Страница **Ключи** в панели управления предоставляет UI для всех вышеупомянутых операций. Вам нужен ключ с разрешением `keys:read` для просмотра списка, и `keys:create` / `keys:update` / `keys:disable` / `keys:regenerate` для действий создания / редактирования / отключения / восстановления соответственно. Редактирование разрешений ключа (`keys:update`) отделено от создания одного (`keys:create`), так что вы можете предоставить оператору возможность создавать ключи без возможности переопределения существующих, или наоборот. Ключ администратора охватывает все это.
+
+При создании ключа с панели управления вы не предоставляете секрет; панель управления генерирует сильный секрет для вас и отображает его **один раз** при создании. Скопируйте его немедленно и храните безопасно; он никогда не будет показан снова, точно как при восстановлении. Вы всё ещё можете выбрать разрешения ключа непосредственно или инициализировать их из набора разрешений (смотрите ниже).
+
+![Страница API ключей: карточка на каждый ключ с его именем, предоставленными разрешениями и временем создания, с действиями восстановления и отключения; защищённые ключи, такие как `admin`, отмечены](/agenteye/images/api-keys.png)
+
+---
+
+## Рекомендуемая структура ключей
+
+| Ключ | Разрешения | Используется |
+|---|---|---|
+| `admin` (начальная загрузка через переменную окружения `ADMIN_KEY`) | все | Ops/установка и панель управления (аутентифицируется с `ADMIN_KEY`, прокси-запросы пользователей с проверками разрешений) |
+| Ключ коллектора для каждого хоста | `events:add` | Коллектор на каждой машине агента |
+| `dashboard-assistant` (начальная загрузка через переменную окружения `AGENT_API_KEY`) | `events:read`, `evaluations:read`, `dashboards:read`, `dashboards:write`, `queries:read`, `queries:write`, `queries:run` | AI ассистент, инициализирован автоматически, **защищён**; не может быть отредактирован через API |
+| Ключ телеметрии ассистента (опционально) | `events:add` | Самоинструментирование AI ассистента, если включено |
+
+> **Примечание:** Ключ ассистента **инициализирован автоматически** сервером из переменной окружения `AGENT_API_KEY` (тот же секрет, который агент представляет как `AGENTEYE_API_KEY`); нет ручного этапа создания ключей и нет задействованного ключа администратора. Его разрешения зафиксированы в исходном коде, поэтому область действия не может быть расширена неправильной конфигурацией: читать через события / оценки / панели управления, плюс dashboards-write и queries-read / write / run для потока автора с возможностью попросить AI написать запрос. Все SQL по-прежнему проходит через ту же роль только для чтения и охранявший путь SQL, что и написанный пользователем запрос, поэтому это расширяет *поверхность создания*, а не поверхность данных; деструктивные операции (`queries:delete`, `dashboards:delete`) намеренно остаются вне ключа ассистента. Как ключ `admin`, он **защищён**: не может быть отключен или восстановлен через API ключей, только ротирован путём изменения `AGENT_API_KEY` и перезагрузки. Пользователи панели управления дополнительно нуждаются в разрешении `agent:use` для просмотра и использования ассистента. Если вы включите самоинструментирование, дайте ассистенту отдельный ключ только для `events:add`.
+
+---
+
+## Примечания об обновлении и обратной совместимости
+
+Они нужны только, если вы обновляете существующий экземпляр; новые развёртывания могут их пропустить.
+
+> Когда Audits был выпущен, существующие получатели были расширены вдоль тех же форм ролей, как оповещения: каждый пользователь и набор разрешений, держащий `alerts:read`, получили `audits:read`, и каждый держатель `alerts:write` получил `audits:write`. Существующие API ключи **не** были расширены. Явно предоставьте `audits:*` ключу, если ему нужна поверхность аудита.
+
+> Сохранённые права устаревшего токена `alerts:ack` анализируются как `incidents:ack`, так что дежурные сохраняют доступ без повторного создания ключей. Токен больше не может быть назначен из редактора пользователей панели управления; матрица предлагает `incidents:ack` вместо этого.
+
+---
+
+## Следующие шаги
+
+- [Python SDK](/ru/agenteye/python-sdk): как ваш код агента аутентифицируется при отправке событий.
+- [Безопасность](/ru/agenteye/security): как работают вход, контроль доступа и изоляция данных для каждой организации.

package/.next/standalone/docs-old/ru/agenteye/assistant.mdx

@@ -0,0 +1,63 @@
+---
+title: "AI Assistant"
+description: "Задайте вопрос о данных вашего агента на простом русском языке и получите ответ со ссылками прямо на источники данных."
+---
+
+
+Задайте вопрос о данных вашего агента на простом русском языке и получите ответ со ссылками прямо на источники данных. Не нужно писать SQL, не нужно копаться в дашбордах — помощник **Failproof AI Observability** — это самый быстрый способ для кого угодно в вашей команде получить ответы об агентах.
+
+![Помощник Failproof AI Observability отвечает на вопрос на простом английском языке внутри дашборда, показывая активность агентов в реальном времени, разбор использования модели по агентам и выводы, с отображением выполненных запросов](/agenteye/images/assistant.png)
+*Спросите на простом языке и получите ответ на основе ваших собственных данных. Здесь показано, какие агенты загружены больше всего и какие модели они используют, с отображением выполненных запросов, чтобы вы могли проверить каждую цифру.*
+
+Нечего учить. Откройте чат, введите вопрос и переходите по ссылкам, которые он вернёт:
+
+```
+Вы:  какие сессии ошибались сегодня?
+AI:  5 сессий ошибались сегодня, от новых к старым. Каждая имеет ссылку:
+     • checkout-agent   14:02   тайм-аут инструмента
+     • billing-agent    11:47   необработанная ошибка
+     • ...и ещё 3
+
+Вы:  суммируй эту сессию          (спрос при просмотре сеанса)
+AI:  Этот сеанс выполнил 12 шагов с использованием 3 инструментов и упал
+     в конце, когда инструмент оплаты вернул ошибку. Оценка по критерию
+     "resolved" низкая. Ссылки: сессия, событие с ошибкой и оценка.
+```
+
+## Просто спросите и перейдите прямо к доказательству
+
+Вы перестаёте гадать и писать запросы. Спросите «как тренды качества на боевом сервере на этой неделе?», «какие сессии ошибались сегодня?» или «суммируй эту сессию», и получите чёткий ответ за секунды, вместо того чтобы строить запрос и читать его сами.
+
+Каждый ответ содержит подтверждение. Помощник ссылается на точные сессии, сохранённые запросы и дашборды, которые он использовал для ответа, поэтому вы можете перейти и всё проверить, вместо того чтобы верить на слово. Он также **контекстный**: спросите о «этой сессии» во время просмотра сеанса, и он уже знает, какой запуск вы имеете в виду. Переоткройте любой предыдущий диалог позже из переключателя истории и продолжите с того же места.
+
+## Превратите хороший ответ в сохранённый запрос или дашборд
+
+Когда ответ стоит сохранить, попросите помощника его сохранить. Он подготавливает SQL для сохранённого запроса или собирает дашборд из этих запросов и показывает вам карточку **Одобрить / Отклонить**. Ничто не записывается, пока вы не нажмёте «Одобрить», поэтому вы получаете скорость «просто спросите» с полным контролем в ваших руках.
+
+На странице **Queries** он делает ещё больше и превращается в автора SQL: опишите нужный вам запрос («показать процент ошибок по агентам за последние 7 дней»), и он выведет SQL прямо в редактор, откроет представление различий, чтобы вы смогли **принять** или **отклонить** изменение перед внедрением.
+
+![Страница Observability Queries и её редактор SQL](/agenteye/images/query-lab.png)
+*Страница Queries: в этом редакторе помощник выводит проект запроса только для чтения, который вы можете принять или отклонить.*
+
+Написание SQL через вопросы здесь использует разрешение `queries:run`, то же самое, что за кнопкой **Run** в редакторе. Чат везде остаёт требует `agent:use`.
+
+## Безопасно для всей команды
+
+Вы можете открыть помощника для всех, не беспокоясь о том, к чему он может получить доступ:
+
+- **Он читает только то, что видите вы.** Ответы ограничены вашими разрешениями на чтение, поэтому он никогда не расширяет доступ к вашим данным.
+- **Каждое изменение ждёт вашего подтверждения.** Сохранённые запросы и дашборды создаются только после вашего явного клика на «Одобрить», и нет никакой настройки, которая отключит эту защиту.
+- **Он не может удалять ничего.** Нет инструмента удаления, и помощник не имеет разрешения на удаление. Удаления остаются в ваших руках, в дашборде.
+- **Он остаётся внутри вашей организации.** Помощник видит только организацию, которую вы сейчас просматриваете.
+- **Ваши вопросы остаются вашими.** Запросы и ответы хранятся в вашей собственной базе данных Observability; аналитика продукта записывает только метаданные использования, никогда ваш текст запроса.
+
+## Где его найти
+
+Помощник находится на правом краю каждой страницы под вашей организацией (`/<org-slug>/...`). Нажмите на панель или нажмите `⌘J` / `Ctrl+J`, чтобы развернуть полную панель чата, и перетащите её край для изменения размера; ваша ширина сохраняется при перезагрузке. Вам нужно разрешение **`agent:use`**, чтобы использовать его, иначе панель будет неактивна. Если он ещё не включён для вашего развёртывания (требуется подключение к LLM), вы увидите неактивную панель вместо работающего чата.
+
+## Связанное
+
+- [CLI and agents](/ru/agenteye/cli-and-agents)
+- [Queries](/ru/agenteye/queries)
+- [Dashboards](/ru/agenteye/dashboards)
+- [Evaluation suite](/ru/agenteye/evaluation-suite)

package/.next/standalone/docs-old/ru/agenteye/audits.mdx

@@ -0,0 +1,54 @@
+---
+title: "Audits: ваш автоматический аналитик надёжности"
+description: "Failproof AI Observability ищет те сбои, для которых вы никогда не писали правил, и выдаёт вам ранжированный, подкреплённый доказательствами список того, что именно нужно исправить."
+---
+
+
+Failproof AI Observability ищет те сбои, для которых вы никогда не писали правил, и выдаёт вам ранжированный, подкреплённый доказательствами список того, что именно нужно исправить. Это как если бы аналитик каждую ночь прочёсывал ваши логи, а утром оставлял краткий список на вашем столе.
+
+<div style={{ position: "relative", width: "100%", paddingBottom: "56.25%", height: 0, overflow: "hidden", borderRadius: "12px", margin: "1.5rem 0" }}>
+  <iframe src="https://www.youtube.com/embed/C5nHKGQIqZQ?autoplay=1&mute=1&loop=1&playlist=C5nHKGQIqZQ&rel=0&playsinline=1" title="Смотрите: автоматически найдите, где ваш агент даёт сбой (2 мин)" allow="autoplay; encrypted-media; picture-in-picture; fullscreen" allowFullScreen style={{ position: "absolute", top: 0, left: 0, width: "100%", height: "100%", border: 0 }}></iframe>
+</div>
+
+*Двухминутное введение: от запланированного запуска к исправлению, на которое вы можете действовать.*
+
+![Страница Audits: повторяющиеся задачи, которые сканируют ваши сессии в поисках паттернов сбоев, каждая с расписанием и чувствительностью](/agenteye/images/audits.png)
+*Каждый аудит — это повторяющаяся задача, которая анализирует ваши сессии и составляет ранжированные, подкреплённые доказательствами рекомендации.*
+
+## Перестаньте гадать, что исправить в следующий раз
+
+Оповещения ловят проблемы, которые вы уже знаете. Аудиты ловят те, о которых вы не знали. По установленному вами расписанию аудит просматривает все ваши сессии агентов и ищет паттерны, стоящие внимания, чтобы вы тратили время на действия, а не на прокрутку логов в поисках проблем.
+
+Один запуск нацелен на режимы отказа, которые действительно ломают агентов в production:
+
+- **Кластеры ошибок**: одна и та же ошибка, повторяющаяся из-за общей корневой причины.
+- **Дрейф от базовой линии**: поведение, которое тихо отходит от известного хорошего окна.
+- **Отказ в достижении цели в стенограммах**: запуски, которые технически завершились, но не выполнили работу.
+- **Неправильное использование инструментов**: неправильный инструмент, плохие аргументы или циклы, которые сжигают вызовы.
+- **Компромиссы между качеством и стоимостью**: места, где вы переплачиваете за результат, который можно получить дешевле.
+- **Пробелы в покрытии**: поведение, которое никакая проверка или оповещение не отслеживает.
+
+Вы решаете, насколько тщательно искать, с помощью одного параметра **sensitivity** (low, medium или high), чтобы шумный агент в staging и закрытый агент в production могли быть настроены каждый на свой сигнал.
+
+## Каждая рекомендация подкреплена доказательствами
+
+Вам никогда не нужно верить находке на слово. Каждая рекомендация указывает на точные сессии, из которых она получена, и SQL, который её выявил, поэтому вы можете открыть доказательство и подтвердить проблему в один клик вместо того, чтобы обратный-инженерить утверждение.
+
+Когда находка касается утёкшего учётного данного, она идёт дальше и связывает отдельные события, которые она совпала. Щелкните на одно, и вы окажетесь в точном моменте сессии, уже выбранном — а не в начале длинной стенограммы, которую нужно прокручивать. Ссылка называет событие; она никогда не копирует обнаруженный секрет в находку, поэтому чтение находки — не второе место, где написано ваше учётное данное. Если события больше нет, потому что сессия прошла вашу схему хранения, страница скажет об этом ясно, а не оставит вас в раздумьях, правильно ли вы щелкнули.
+
+Это также то, что держит аудиты честными. Сервер проверяет, что каждая упомянутая сессия действительно существует, и **отбрасывает любую рекомендацию, чьи доказательства не выдерживают проверку**, поэтому аудит исследует, но никогда не выдумывает. То, что попадёт в ваш список, реально, воспроизводимо и ранжировано по значимости, с наибольшими выигрышами в начале.
+
+## Превратите исправление в охранное правило
+
+Исправление проблемы — только половина выигрыша. Другая половина — убедиться, что она не может тихо вернуться. Каждая находка содержит **ярлык в один клик, который составляет повторяющееся оповещение**, предварительно заполненный разумным начальным триггером, который вы можете настроить. Закройте находку, активируйте оповещение, и в следующий раз, когда этот паттерн снова появится, вы получите уведомление вместо того, чтобы заново открыть его в будущем аудите.
+
+## Где его найти
+
+Audits находятся в панели управления по адресу **`/<org-slug>/audits`** (боковая панель на *analyze* к *audits*). Просмотр запусков и находок требует **`audits:read`**; создание, редактирование и триаж аудитов требует **`audits:write`**. Установите область действия и кадency аудита, затем нажмите **Run now**, если хотите получить результаты немедленно, вместо того чтобы ждать следующего запланированного запуска.
+
+## Связанное
+
+- [Alerts](/ru/agenteye/alerts): получайте уведомление в момент пересечения известного вам порога.
+- [Evaluations](/ru/agenteye/evaluations): оценивайте каждый запуск, чтобы регрессии качества всплывали сами.
+- [Error tracking](/ru/agenteye/error-tracking): группируйте и отслеживайте ошибки, которые выбрасывают ваши агенты.
+- [Incidents](/ru/agenteye/incidents): отслеживайте проблему, которую аудит выявил, вплоть до её исправления.

package/.next/standalone/docs-old/ru/agenteye/cli-and-agents.mdx

@@ -0,0 +1,80 @@
+---
+title: "CLI"
+description: "Весь ваш Failproof AI Observability, развёрнутый одной командой."
+---
+
+
+Весь ваш Failproof AI Observability, развёрнутый одной командой. Проверьте production, создайте API-ключ или подтвердите инцидент, не покидая терминала, а затем автоматизируйте всё это в CI или позвольте coding-агенту сделать это на простом английском языке.
+
+```bash
+pipx install agenteye
+agenteye login --email you@example.com      # a 6-digit code lands in your inbox
+agenteye --json sessions --since 24h         # every agent run from the last day, newest first
+```
+
+*CLI `agenteye` взаимодействует с вашим dashboard. Это отдельный инструмент от collector, который отправляет события на сервер.*
+
+## Весь deployment в одной команде
+
+Перестаньте прыгать по табам, чтобы ответить на быстрый вопрос. CLI `agenteye` читает ваши данные и управляет организацией из единого бинарного файла, поэтому проверка, которая раньше требовала кликов в dashboard, становится одной строкой, которую можно переиспользовать, создать alias или вставить в runbook. Вы получаете четыре интерфейса:
+
+- **Читайте ваши данные:** `sessions`, `events`, `evals` и `errors`, отфильтрованные по времени, агенту и окружению.
+- **Управляйте организацией:** `keys`, `users`, `settings`, `alerts` и `incidents`.
+- **Запускайте аналитику:** сохранённые SQL-запросы плюс ad-hoc `query` для анализа данных о событиях.
+- **Спросите ассистента:** `agent ask` подключает того же read-only аналитика, с которым вы общаетесь в dashboard.
+
+Установите один раз с помощью `pipx`, войдите, используя 6-значный код из письма, и готово. Сессия длится около дня; переустановите `agenteye login` когда она истечёт. Используйте его для проверки production, подготовки ключа или триажа срабатывающего инцидента, всё без открытия браузера:
+
+```bash
+agenteye errors --since 24h --aggregate      # what is breaking, grouped by error type
+agenteye incidents list --state firing       # what is on fire right now
+agenteye keys create ci --add events:add     # a key that can only push events, secret shown once
+```
+
+Один привычный нюанс: глобальные опции вроде `--json` идут перед командой. `agenteye --json sessions` правильно; `agenteye sessions --json` неправильно.
+
+## Автоматизируйте, подключите к CI
+
+Каждая команда поддерживает `--json`, и это меняет всё. Чистый JSON идёт в stdout, а статус и предупреждения для человека — в stderr, поэтому захват с `--json` направляется прямо в `jq` без лишних строк для очистки. Именно это делает CLI одинаково полезным как для вас в командной строке, так и для coding-агента, парсящего выходные данные:
+
+```bash
+agenteye --json sessions --since 24h --status error | jq -r '.sessions[].session_id'
+```
+
+Построен для работы без присмотра. Запросы подтверждения пропускаются автоматически, когда терминал не подключён, поэтому ничего не зависает в pipeline, и каждая команда возвращает значимый exit code: `0` успех, `4` не залогинены, `5` недостаточны разрешения (сообщение указывает их, например `alerts:write`), `3` dashboard недоступен. Скрипт может ветвиться на `4` для переаутентификации или на `5` чтобы рассказать вам, что именно нужно попросить у администратора, вместо того чтобы упасть без информации.
+
+## Позвольте coding-агенту управлять им на простом английском
+
+Лучше ещё — вам не должно требоваться помнить все эти флаги вообще. **CLI skill** — это небольшая папка Agent Skill под названием `agenteye-cli`, которая учит coding-агента такого как Claude Code или Codex управлять CLI из простых запросов на английском языке. Спросите "что-нибудь сломалось сегодня?" и агент выберет команду, запустит её от вашего имени и ответит прозой.
+
+Для Claude Code поместите папку `agenteye-cli` в `~/.claude/skills/` и она будет автоматически обнаружена. Failproof AI Observability предоставляет папку; нет ничего дополнительного для установки, потому что она только управляет CLI, который вы уже установили. Залогиньтесь сами первыми: skill не может завершить для вас login с кодом из письма.
+
+Поскольку агент запускает CLI от вашего имени, он может делать всё, что позволяет ваш логин, чтение и запись: создавать ключи, менять настройки, разрешать инциденты. Prompt "вы уверены?" CLI не срабатывает для агента, поэтому skill написан так, чтобы указать точную команду и ждать вашего ОК перед любым изменением. Вы — шаг подтверждения.
+
+```text
+вы    Почему упала сессия run-001?
+
+агент  Running: agenteye --json events --session-id run-001 --all
+       The checkout-agent hit a TimeoutError on its third tool call.
+```
+
+Чтения остаются мгновенными, и каждая запись приостанавливается для вас:
+
+```text
+вы    Дайте CI ключ, который может только отправлять события.
+
+агент  This creates an API key. I'll run:
+         agenteye keys create ci --add events:add
+       OK to proceed?
+
+вы    yes
+
+агент  Done. Key "ci" created with events:add only. The secret is shown once, so store it now.
+```
+
+## Связанное
+
+- [CLI reference](/ru/agenteye/cli): все команды, флаги и JSON-структуры.
+- [CLI recipes for agents](/ru/agenteye/cli-recipes): паттерны `jq` и обработка exit-кодов для копирования-вставки.
+- [CLI agent skill](/ru/agenteye/cli-skill): установка и запуск skill `agenteye-cli`.
+- [AI assistant](/ru/agenteye/assistant): аналитик в dashboard, с которым общается `agent ask`.