Перейти к основному содержанию
AgentEye CLI skill (agenteye-cli) — это устанавливаемый Agent Skill, который обучает кодирующего агента — Claude Code, Codex и совместимые инструменты — управлять вашим развёртыванием AgentEye через CLI agenteye на основе запросов на естественном языке: «что-нибудь сломалось сегодня?», «дай CI ключ, который может только отправлять события», «подтверди срабатывающий инцидент и назначь его мне». Это не сервис и не отдельный бинарный файл. Это небольшой пакет инструкций, который работает поверх уже установленного CLI: агент запускает agenteye --json …, парсит чистый JSON и отвечает вам прозой. Всё, что он может сделать, вы можете сделать сами, введя те же команды.

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

AgentEye предоставляет четыре способа достичь одних и тех же данных и управления. Они дополняют друг друга:
ИнтерфейсЧто этоГде работаетИспользуйте, когда
CLIСправочник команд и флагов для agenteyeВаш терминалВы хотите запустить или создать скрипт для конкретной команды
CLI recipesГотовые к копированию паттерны jq/pipelineВаш терминал / скриптыВы интегрируете CLI в автоматизацию
CLI skill (этот документ)Интерфейс на естественном языке к CLIВаш кодирующий агент на вашей рабочей станцииВы хотите просто спросить и позволить агенту выбрать команду
Встроенный AI ассистентЧат, встроенный в панель управленияВнутренний контейнер agent в вашем кластереВы хотите вопросы и ответы в панели управления над вашими данными

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

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

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

  1. agenteye CLI установлен и находится в PATH (см. cli.md — 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). Команда, для которой у вас нет разрешения, возвращает код выхода 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 и cli-recipes.md.

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

  • CLI — полный справочник команд и флагов для agenteye.
  • CLI recipes для агентов — готовые к копированию паттерны jq и обработка кодов выхода.
  • AI ассистент — встроенный в панель ассистент (не путайте с этим terminal skill).
  • API ключи — модель разрешений по организации, которая ограничивает то, что может делать skill.