> ## 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 > Documentazione di AgentEye CLI Agent Skill. 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](/it/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: | Interfaccia | Che cosa è | Dove gira | Usala quando | | ------------------------------------------------------- | ------------------------------------------ | ------------------------------------------------ | --------------------------------------------------------------------- | | **[CLI](/it/agenteye/cli)** | Il riferimento comando/flag per `agenteye` | Il tuo terminale | Vuoi eseguire o scrivere uno script di un comando specifico | | **[CLI recipes](/it/agenteye/cli-recipes)** | Pattern copia-incolla di `jq`/pipeline | Il tuo terminale / script | Stai integrando la CLI nell'automazione | | **CLI skill** (questo doc) | Una porta in linguaggio naturale sulla CLI | Il tuo agente di codifica, sulla tua workstation | Vuoi semplicemente chiedere e lasciare che l'agente scelga il comando | | **[AI Assistant in-dashboard](/it/agenteye/assistant)** | Una chat integrata nel dashboard | Un container interno `agent` nel tuo cluster | Vuoi 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](/it/agenteye/assistant)) è 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](/it/agenteye/cli) — `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 `/.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](/it/agenteye/api-keys)). 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 `, `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 ` / `incidents assign you@…`. Per i comandi esatti, i flag e le forme JSON dietro questi, vedi [cli.md](/it/agenteye/cli) e [cli-recipes.md](/it/agenteye/cli-recipes). *** ## Vedi anche * **[CLI](/it/agenteye/cli)** — riferimento completo di comando e flag per `agenteye`. * **[CLI recipes per agenti](/it/agenteye/cli-recipes)** — pattern copia-incolla di `jq` e gestione exit-code. * **[AI Assistant](/it/agenteye/assistant)** — l'assistente in-dashboard (da non confondere con questa skill di terminale). * **[API Keys](/it/agenteye/api-keys)** — il modello di permesso per-org che limita ciò che la skill può fare.