Vai al contenuto principale
La skill CLI di AgentEye (agenteye-cli) è un Agent Skill installabile che insegna a un agente di codifica — Claude Code, Codex e strumenti compatibili — a operare sul tuo deployment di AgentEye attraverso la agenteye CLI a partire da richieste in inglese naturale: “c’è qualcosa di rotto oggi?”, “dai a CI una chiave che può solo inviare eventi”, “riconosci l’incidente in corso e assegnalo a me”. Non è un servizio o un binario separato. È un piccolo bundle di istruzioni che gira sopra la CLI che hai già installato: l’agente esegue agenteye --json …, analizza il JSON pulito e ti risponde in prosa. Tutto ciò che può fare, potresti farlo tu stesso digitando gli stessi comandi.

​
Come si relaziona alle altre interfacce di AgentEye

AgentEye ti offre quattro modi per raggiungere gli stessi dati e controlli. Si completano a vicenda:
InterfacciaChe cosa èDove giraUsala quando
CLIIl riferimento comando/flag per agenteyeIl tuo terminaleVuoi eseguire o scrivere uno script di un comando specifico
CLI recipesPattern copia-incolla di jq/pipelineIl tuo terminale / scriptStai integrando la CLI nell’automazione
CLI skill (questo doc)Una porta in linguaggio naturale sulla CLIIl tuo agente di codifica, sulla tua workstationVuoi semplicemente chiedere e lasciare che l’agente scelga il comando
AI Assistant in-dashboardUna chat integrata nel dashboardUn container interno agent nel tuo clusterVuoi Q&A in-dashboard sui tuoi dati

​
vs. l’AI Assistant in-dashboard — una distinzione importante

Questi sono due strumenti diversi con raggi di azione molto diversi:
  • L’AI Assistant in-dashboard (assistant.md) è una chat integrata nel dashboard, supportata da un container interno agent. È sola lettura più authoring approvato: può bozze di query salvate e dashboard, ma ogni modifica si ferma per il tuo click-approvazione esplicito, e non cancella mai. È gestito dal permesso agent:use e vede solo i dati dell’org che stai visualizzando.
  • La CLI skill gira sulla tua workstation dentro il tuo agente di codifica e guida la CLI agenteye come te. Può eseguire la superficie completa, incluse le mutazioni — creare/ruotare/disabilitare chiavi API, cambiare le impostazioni dell’org, risolvere incidenti, eliminare query salvate — limitato solo dai permessi del tuo login della CLI. Trattalo esattamente come faresti con l’esecuzione di questi comandi manualmente.

​
Prerequisiti

  1. La CLI agenteye installata e su PATH (vedi cli.md — pipx install agenteye).
  2. L’URL del tuo dashboard impostato (AGENTEYE_DASHBOARD_URL, oppure l’agente passa --base-url).
  3. Una sessione autenticata: esegui prima agenteye login tu stesso. La skill non può completare per te il login con codice monouso inviato per email — ti dirà di eseguire agenteye login se la sessione manca o è scaduta (exit code CLI 4).

​
Installare la skill

Agent Skills sono cartelle che contengono un SKILL.md (più riferimenti opzionali). Installi la skill agenteye-cli posizionando la sua cartella dove il tuo agente cerca le skill:
  • Claude Code — copia la cartella agenteye-cli/ in ~/.claude/skills/ (disponibile in ogni progetto) o in <your-repo>/.claude/skills/ (limitato a quel repo). Claude Code la scopre automaticamente; verifica con l’elenco /skills, o semplicemente fai una domanda che corrisponda alla sua descrizione.
  • Codex (OpenAI) — Codex legge lo stesso SKILL.md. Il agents/openai.yaml fornito imposta allow_implicit_invocation: true, quindi Codex auto-seleziona la skill quando un’attività corrisponde; altrimenti invocala esplicitamente come $agenteye-cli.
La skill è mantenuta insieme alla CLI agenteye ed è distribuita come parte del tuo pacchetto AgentEye — se non hai la cartella agenteye-cli, contatta il tuo referente AgentEye. Nulla al riguardo è limitato: non ha bisogno di nessuna immagine Docker e nessuna credenziale, perché guida solo la CLI agenteye pubblica contro il tuo dashboard.

​
Sicurezza — le mutazioni NON richiedono conferma quando un agente esegue la CLI

Leggi questo prima di lasciare che un agente faccia modifiche. La CLI agenteye normalmente chiede “sei sicuro?” prima di un’azione distruttiva. Salta automaticamente quella conferma ogni volta che non è collegata a un terminale — che è esattamente il modo in cui un agente di codifica la esegue — e --json la salta anche. Quindi il prompt di sicurezza non si attiverà per l’agente. La skill è scritta per compensare: le è stato indicato di dichiarare il comando esatto che eseguirà e ottenere il tuo OK esplicito prima di qualsiasi cambio di stato. Mantieni quella disciplina — quando guidi AgentEye attraverso un agente, tu sei il passo di conferma. I comandi che modificano lo stato su cui stare attenti:
  • keys create / update / disable / regenerate
  • users create / update / disable / enable
  • settings set
  • alerts create / update / delete / test
  • i subcommand incidents di scrittura: ack / assign / resolve / open / comment-add / comment-delete / subscribe / unsubscribe
  • query create / update / delete
  • agent rename / delete
  • orgs switch
Tutto sotto Observe (events, sessions, evals, errors, list, whoami, orgs list/current/perms) è di sola lettura e non cambia nulla. Poiché l’agente agisce come te, può solo fare ciò che il tuo login è autorizzato a fare — i permessi sono risolti per org (vedi api-keys.md). Un comando per il quale non hai permesso restituisce exit code 5 con il permesso esatto denominato, quindi l’agente può dirti precisamente cosa chiedere a un admin invece di fallire opacamente.

​
Ciò che puoi chiedere

La skill mappa l’intento in linguaggio naturale al comando agenteye giusto, scoprendo prima i valori validi (list <kind>, whoami) in modo che non indovini:
  • “C’è qualcosa di rotto / fallito nelle ultime 24 ore?” → errors --since 24h --aggregate, poi una ripartizione.
  • “Perché la sessione run-001 ha fallito?” → events --session-id run-001 --all + evals --session-id run-001.
  • “Come sta andando la qualità questa settimana?” → evals --aggregate --since 7d, poi approfondisci le esecuzioni con punteggi bassi.
  • “Dai a CI una chiave che può solo inviare eventi.” → keys create ci --add events:add (dichiara il comando, poi lo crea e cattura il segreto monouso).
  • “Chi ha accesso? Rendi Dana di sola lettura.” → users list → users update dana@… --permission-set read-only (dopo confermare con te).
  • “Riconosci l’incidente in corso e assegnalo a me.” → incidents list --state firing → incidents ack <id> / incidents assign <id> you@….
Per i comandi esatti, i flag e le forme JSON dietro questi, vedi cli.md e cli-recipes.md.

​
Vedi anche

  • CLI — riferimento completo di comando e flag per agenteye.
  • CLI recipes per agenti — pattern copia-incolla di jq e gestione exit-code.
  • AI Assistant — l’assistente in-dashboard (da non confondere con questa skill di terminale).
  • API Keys — il modello di permesso per-org che limita ciò che la skill può fare.