Scripting e automazione con la CLI

Questa pagina copre i flussi di lavoro orientati alle attività costruiti sulla CLI ant. Per i flag sottostanti e le opzioni di output, consulta Usare la CLI.



Controllo di versione delle risorse API

Puoi usare la CLI per gestire con il controllo di versione le risorse API come skill, agenti, ambienti o deployment come file YAML nel tuo repository e mantenerli sincronizzati con la Claude API.



Pattern di scripting

La CLI è progettata per comporsi con gli strumenti shell standard.



Concatena l'output di un elenco in un secondo comando

--transform id --raw-output su un endpoint di elenco emette un ID semplice per riga, quindi gli strumenti standard come head e xargs si applicano direttamente. Cattura il primo risultato, poi passalo a un comando successivo:

FIRST_AGENT=$(ant beta:agents list \
  --transform id --raw-output | head -1)

ant beta:agents:versions list \
  --agent-id "$FIRST_AGENT" \
  --transform "{version,created_at}" --format jsonl



Ispeziona gli errori

I flag --transform-error e --format-error applicano lo stesso filtraggio alle risposte di errore. --raw-output non si applica agli errori, quindi usa --format-error yaml per uno scalare senza virgolette. Estrai solo il messaggio di errore:

ant beta:agents retrieve --agent-id bogus \
  --transform-error error.message --format-error yaml 2>&1

GET "https://api.anthropic.com/v1/agents/bogus?beta=true": 404 Not Found
Agent not found.



Usa la CLI da Claude Code

Claude Code può usare la CLI ant senza configurazione aggiuntiva. Con la CLI installata e autenticata, puoi chiedere a Claude Code di operare direttamente sulle tue risorse API. Per esempio:

• "Elenca le mie sessioni agente recenti e riassumi quali hanno generato errori."
• "Carica ogni PDF in ./reports nella Files API e stampa gli ID risultanti."
• "Recupera gli eventi per la sessione session_01... e dimmi dove l'agente si è bloccato."

Claude Code esegue ant tramite shell, analizza l'output strutturato e ragiona sui risultati (nessun codice di integrazione personalizzato richiesto).



Autentica le richieste curl con le credenziali della CLI

Gli script che chiamano l'API con curl o un altro client HTTP possono usare le credenziali memorizzate da ant auth login invece di una chiave API statica. Il token di accesso OAuth va nell'header Authorization come bearer token; l'header x-api-key è solo per le chiavi API statiche.

ant auth print-credentials --access-token stampa il token di accesso del profilo attivo, aggiornandolo prima se è scaduto o prossimo alla scadenza:

curl https://api.anthropic.com/v1/messages \
  -H "Authorization: Bearer $(ant auth print-credentials --access-token)" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "hi"}]
  }'

Esegui ant auth status per confermare a quale organizzazione e workspace hai effettuato l'accesso; avvisa quando una variabile d'ambiente sta sovrascrivendo il tuo login.