Pular para o conteúdo principal
A habilidade CLI do AgentEye (agenteye-cli) é uma Habilidade de Agente instalável que ensina um agente de codificação — Claude Code, Codex e ferramentas compatíveis — a operar sua implantação do AgentEye por meio da agenteye CLI a partir de solicitações em linguagem natural: “tem algo quebrado hoje?”, “gera uma chave para o CI que só pode enviar eventos”, “reconhece o incidente ativo e me atribui”. Ela não é um serviço nem um binário separado. É um pequeno pacote de instruções que funciona sobre a CLI que você já instalou: o agente chama agenteye --json …, analisa o JSON limpo e responde em texto corrido. Tudo o que ela pode fazer, você poderia fazer digitando os mesmos comandos.

​
Como ela se relaciona com as outras interfaces do AgentEye

O AgentEye oferece quatro formas de acessar os mesmos dados e controles. Elas se complementam:
InterfaceO que éOnde rodaUse quando
CLIReferência de comandos e flags do agenteyeSeu terminalVocê quer executar ou automatizar um comando específico
Receitas CLIPadrões jq/pipeline prontos para copiarSeu terminal / scriptsVocê está integrando a CLI em automações
Habilidade CLI (este doc)Uma porta de entrada em linguagem natural para a CLISeu agente de codificação, na sua estação de trabalhoVocê quer só perguntar e deixar o agente escolher o comando
Assistente de IA no painelUm chat embutido no painelUm container agent interno no seu clusterVocê quer Q&A no painel sobre seus dados

​
vs. o Assistente de IA no painel — uma distinção importante

Estas são duas ferramentas diferentes com impactos potenciais muito distintos:
  • O Assistente de IA no painel (assistant.md) é um chat embutido no painel, sustentado por um container agent interno. É somente leitura mais criação com aprovação: ele pode rascunhar queries e dashboards salvos, mas toda escrita pausa aguardando seu clique de aprovação explícita, e nunca exclui nada. É protegido pela permissão agent:use e só vê dados da org que você está visualizando.
  • A habilidade CLI roda na sua estação de trabalho dentro do seu agente de codificação e aciona a CLI agenteye como você. Ela pode executar a superfície completa da CLI, incluindo mutações — criar/rotacionar/desabilitar chaves de API, alterar configurações da org, resolver incidentes, excluir queries salvas — limitada apenas pelas permissões do seu login na CLI. Trate-a com exatamente o mesmo cuidado com que trataria a execução desses comandos manualmente.

​
Pré-requisitos

  1. A CLI agenteye instalada e no PATH (veja cli.md — pipx install agenteye).
  2. Sua URL do painel configurada (AGENTEYE_DASHBOARD_URL, ou o agente passa --base-url).
  3. Uma sessão autenticada: execute agenteye login você mesmo primeiro. A habilidade não consegue concluir o login por código único enviado por e-mail por você — ela pedirá para você executar agenteye login se a sessão estiver ausente ou expirada (código de saída da CLI 4).

​
Instalando a habilidade

Habilidades de Agente são pastas que contêm um SKILL.md (mais referências opcionais). Você instala a habilidade agenteye-cli colocando sua pasta onde seu agente procura por habilidades:
  • Claude Code — copie a pasta agenteye-cli/ em ~/.claude/skills/ (disponível em todos os projetos) ou em <seu-repo>/.claude/skills/ (com escopo para aquele repositório). Claude Code a descobre automaticamente; verifique com a lista /skills, ou simplesmente faça uma pergunta que corresponda à sua descrição.
  • Codex (OpenAI) — O Codex lê o mesmo SKILL.md. O arquivo agents/openai.yaml incluído define allow_implicit_invocation: true, então o Codex seleciona a habilidade automaticamente quando uma tarefa corresponde; caso contrário, invoque-a explicitamente como $agenteye-cli.
A habilidade é mantida junto com a CLI agenteye e distribuída como parte do seu pacote AgentEye — se você não tiver a pasta agenteye-cli, entre em contato com seu contato AgentEye. Nada nela é restrito: não precisa de imagem Docker nem de credencial, pois aciona apenas a CLI pública agenteye contra seu próprio painel.

​
Segurança — mutações NÃO pedem confirmação quando um agente executa a CLI

Leia isto antes de deixar um agente fazer alterações. A CLI agenteye normalmente pergunta “tem certeza?” antes de uma ação destrutiva. Ela pula automaticamente essa confirmação sempre que não está conectada a um terminal — que é exatamente como um agente de codificação a executa — e --json também a pula. Portanto, o prompt de segurança não disparará para o agente. A habilidade foi escrita para compensar isso: ela é instruída a declarar o comando exato que executará e obter seu OK explícito antes de qualquer alteração de estado. Mantenha essa disciplina — quando você aciona o AgentEye por meio de um agente, você é a etapa de confirmação. Os comandos que alteram estado a observar:
  • keys create / update / disable / regenerate
  • users create / update / disable / enable
  • settings set
  • alerts create / update / delete / test
  • os subcomandos de escrita de incidents: ack / assign / resolve / open / comment-add / comment-delete / subscribe / unsubscribe
  • query create / update / delete
  • agent rename / delete
  • orgs switch
Tudo em Observe (events, sessions, evals, errors, list, whoami, orgs list/current/perms) é somente leitura e não altera nada. Como o agente age como você, ele só pode fazer o que seu login tem permissão — as permissões são resolvidas por org (veja api-keys.md). Um comando para o qual você não tem permissão retorna código de saída 5 com o nome exato da permissão, para que o agente possa dizer exatamente o que pedir a um administrador em vez de falhar de forma obscura.

​
O que você pode perguntar

A habilidade mapeia intenções em linguagem natural para o comando agenteye correto, descobrindo valores válidos primeiro (list <kind>, whoami) para não adivinhar:
  • “Tem algo quebrado / falhando nas últimas 24 horas?” → errors --since 24h --aggregate, seguido de um detalhamento.
  • “Por que a sessão run-001 falhou?” → events --session-id run-001 --all + evals --session-id run-001.
  • “Como a qualidade está evoluindo esta semana?” → evals --aggregate --since 7d, então detalha as execuções com baixa pontuação.
  • “Gera uma chave para o CI que só pode enviar eventos.” → keys create ci --add events:add (ele declara o comando, cria e captura o segredo de uso único).
  • “Quem tem acesso? Deixa a Dana somente leitura.” → users list → users update dana@… --permission-set read-only (após confirmar com você).
  • “Reconhece o incidente ativo e me atribui.” → incidents list --state firing → incidents ack <id> / incidents assign <id> você@….
Para os comandos exatos, flags e formatos JSON por trás dessas ações, veja cli.md e cli-recipes.md.

​
Veja também

  • CLI — referência completa de comandos e flags do agenteye.
  • Receitas CLI para agentes — padrões jq prontos para copiar e tratamento de códigos de saída.
  • Assistente de IA — o assistente no painel (não confundir com esta habilidade de terminal).
  • Chaves de API — o modelo de permissões por org que limita o que a habilidade pode fazer.