> ## 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.

# AgentEye CLI Agent Skill

> Документация AgentEye CLI Agent Skill.

**AgentEye CLI skill** (`agenteye-cli`) — это устанавливаемый *Agent Skill*, который обучает кодирующего агента — Claude Code, Codex и совместимые инструменты — управлять вашим развёртыванием AgentEye через CLI [`agenteye`](/ru/agenteye/cli) на основе запросов на естественном языке: *«что-нибудь сломалось сегодня?»*, *«дай CI ключ, который может только отправлять события»*, *«подтверди срабатывающий инцидент и назначь его мне»*.

Это **не** сервис и **не** отдельный бинарный файл. Это небольшой пакет инструкций, который работает поверх уже установленного CLI: агент запускает `agenteye --json …`, парсит чистый JSON и отвечает вам прозой. Всё, что он может сделать, вы можете сделать сами, введя те же команды.

***

## Как это связано с другими интерфейсами AgentEye

AgentEye предоставляет четыре способа достичь одних и тех же данных и управления. Они дополняют друг друга:

| Интерфейс                                             | Что это                                      | Где работает                                  | Используйте, когда                                                |
| ----------------------------------------------------- | -------------------------------------------- | --------------------------------------------- | ----------------------------------------------------------------- |
| **[CLI](/ru/agenteye/cli)**                           | Справочник команд и флагов для `agenteye`    | Ваш терминал                                  | Вы хотите запустить или создать скрипт для конкретной команды     |
| **[CLI recipes](/ru/agenteye/cli-recipes)**           | Готовые к копированию паттерны `jq`/pipeline | Ваш терминал / скрипты                        | Вы интегрируете CLI в автоматизацию                               |
| **CLI skill** (этот документ)                         | Интерфейс на естественном языке к CLI        | Ваш кодирующий агент на вашей рабочей станции | Вы хотите просто спросить и позволить агенту выбрать команду      |
| **[Встроенный AI ассистент](/ru/agenteye/assistant)** | Чат, встроенный в панель управления          | Внутренний контейнер `agent` в вашем кластере | Вы хотите вопросы и ответы в панели управления над вашими данными |

### против встроенного AI ассистента — важное различие

Это два разных инструмента с очень разными областями воздействия:

* **Встроенный AI ассистент** ([assistant.md](/ru/agenteye/assistant)) — это чат в панели управления, поддерживаемый внутренним контейнером `agent`. Это **только для чтения плюс авторизация с подтверждением**: он может создавать черновики сохранённых запросов и панелей, но любое изменение требует вашего явного подтверждения, и он никогда не удаляет. Защищён разрешением `agent:use` и видит только данные той организации, которую вы просматриваете.
* **CLI skill** работает на *вашей* рабочей станции внутри *вашего* кодирующего агента и управляет CLI `agenteye` **как вы**. Он может выполнять **полную поверхность CLI, включая изменения** — создавать/ротировать/отключать API ключи, менять настройки организации, разрешать инциденты, удалять сохранённые запросы — ограниченный только разрешениями вашего логина CLI. Относитесь к нему так же внимательно, как если бы вы вводили эти команды вручную.

***

## Необходимые условия

1. **`agenteye` CLI установлен** и находится в `PATH` (см. [cli.md](/ru/agenteye/cli) — `pipx install agenteye`).
2. Ваш **URL панели управления установлен** (`AGENTEYE_DASHBOARD_URL`, или агент передаёт `--base-url`).
3. **Активная сессия входа**: сначала запустите `agenteye login` самостоятельно. Skill **не может** завершить отправленный по почте одноразовый код входа за вас — он скажет вам запустить `agenteye login`, если сессия отсутствует или истекла (код выхода CLI `4`).

***

## Установка skill

Agent Skills — это папки, содержащие `SKILL.md` (плюс опциональные справочники). Вы устанавливаете skill `agenteye-cli`, поместив его папку туда, где ваш агент ищет skills:

* **Claude Code** — скопируйте папку `agenteye-cli/` в `~/.claude/skills/` (доступно во всех проектах) или в `<ваш-репо>/.claude/skills/` (ограничено этим репо). Claude Code автоматически обнаруживает его; проверьте со списком `/skills` или просто задайте вопрос, который соответствует его описанию.
* **Codex (OpenAI)** — Codex читает тот же `SKILL.md`. Включённый `agents/openai.yaml` устанавливает `allow_implicit_invocation: true`, поэтому Codex автоматически выбирает skill при совпадении задачи; иначе вызовите его явно как `$agenteye-cli`.

Skill поддерживается вместе с CLI `agenteye` и распространяется как часть вашего пакета AgentEye — если у вас нет папки `agenteye-cli`, обратитесь к вашему контакту AgentEye. Ничего в этом не ограничивается: ему не нужен образ Docker и не нужны учётные данные, потому что он только управляет **публичным** CLI `agenteye` против вашей собственной панели управления.

***

## Безопасность — изменения НЕ требуют подтверждения, когда агент запускает CLI

**Прочитайте это перед тем, как позволить агенту вносить изменения.**

CLI `agenteye` обычно спрашивает *«вы уверены?»* перед деструктивным действием. Это **автоматически пропускает подтверждение, когда он не подключен к терминалу — это именно то, как работает кодирующий агент — и `--json` тоже пропускает это.** Поэтому запрос безопасности **не** срабатывает для агента.

Skill написан для компенсации: ему поручено указать точную команду, которую он запустит, и получить ваше явное **OK перед любым изменением состояния**. Сохраняйте эту дисциплину — когда вы управляете AgentEye через агента, *вы* являетесь шагом подтверждения. Команды, изменяющие состояние, на которые следует обратить внимание:

* `keys create` / `update` / `disable` / `regenerate`
* `users create` / `update` / `disable` / `enable`
* `settings set`
* `alerts create` / `update` / `delete` / `test`
* записывающие подкоманды `incidents`: `ack` / `assign` / `resolve` / `open` / `comment-add` / `comment-delete` / `subscribe` / `unsubscribe`
* `query create` / `update` / `delete`
* `agent rename` / `delete`
* `orgs switch`

Всё под **Observe** (`events`, `sessions`, `evals`, `errors`, `list`, `whoami`, `orgs list/current/perms`) только для чтения и ничего не изменяет.

Поскольку агент действует **как вы**, он может делать только то, что разрешено вашему логину — разрешения разрешаются **по организации** (см. [api-keys.md](/ru/agenteye/api-keys)). Команда, для которой у вас нет разрешения, возвращает код выхода `5` с указанным точным разрешением, поэтому агент может точно сказать вам, что попросить у администратора, вместо того чтобы дать неудачу без объяснений.

***

## Что вы можете у него спросить

Skill отображает намерения на естественном языке на правую команду `agenteye`, сначала обнаруживая допустимые значения (`list <kind>`, `whoami`), поэтому он не угадывает:

* *«Что-нибудь сломалось / срабатывает в последние 24 часа?»* → `errors --since 24h --aggregate`, затем разбор.
* *«Почему сессия `run-001` не удалась?»* → `events --session-id run-001 --all` + `evals --session-id run-001`.
* *«Как качество развивается на этой неделе?»* → `evals --aggregate --since 7d`, затем углубитесь в низкооценённые запуски.
* *«Дай CI ключ, который может только отправлять события.»* → `keys create ci --add events:add` (он указывает команду, затем создаёт её и захватывает одноразовый секрет).
* *«Кто имеет доступ? Сделай Dana только для чтения.»* → `users list` → `users update dana@… --permission-set read-only` (после подтверждения с вами).
* *«Подтверди срабатывающий инцидент и назначь его мне.»* → `incidents list --state firing` → `incidents ack <id>` / `incidents assign <id> you@…`.

Для точных команд, флагов и JSON форм за этим см. [cli.md](/ru/agenteye/cli) и [cli-recipes.md](/ru/agenteye/cli-recipes).

***

## Смотрите также

* **[CLI](/ru/agenteye/cli)** — полный справочник команд и флагов для `agenteye`.
* **[CLI recipes для агентов](/ru/agenteye/cli-recipes)** — готовые к копированию паттерны `jq` и обработка кодов выхода.
* **[AI ассистент](/ru/agenteye/assistant)** — встроенный в панель ассистент (не путайте с этим terminal skill).
* **[API ключи](/ru/agenteye/api-keys)** — модель разрешений по организации, которая ограничивает то, что может делать skill.