CLI, SDK et bibliothèquesCLI ant

Scripts et automatisation avec la CLI

Gérez les ressources de l'API sous forme de fichiers YAML avec contrôle de version, enchaînez les commandes de la CLI ant dans des scripts et manipulez les ressources depuis Claude Code.

Cette page présente des flux de travail orientés tâches basés sur la CLI ant. Pour les options et indicateurs sous-jacents, consultez Utilisation de la CLI.

Contrôle de version des ressources de l'API

Vous pouvez utiliser la CLI pour gérer le contrôle de version des ressources de l'API telles que les compétences, les agents, les environnements ou les déploiements sous forme de fichiers YAML dans votre dépôt, et les maintenir synchronisées avec l'API Claude.

Pour plus d'informations sur ces ressources, consultez Agents gérés.

Définissez votre agent

Écrivez la définition de l'agent dans summarizer.agent.yaml :

summarizer.agent.yaml

name: Summarizer
model: claude-sonnet-4-6
system: |
  You are a helpful assistant that writes concise summaries.
tools:
  - type: agent_toolset_20260401

Créez l'agent
ant beta:agents create < summarizer.agent.yaml
Output
{ "id": "agent_011CYm1BLqPXpQRk5khsSXrs", "version": 1, "name": "Summarizer", "model": "claude-sonnet-4-6" /* ... */ }
Notez l'id dans la réponse. Vous le passerez à la commande de création de session dans une étape ultérieure.
Ajoutez summarizer.agent.yaml à votre dépôt et maintenez-le synchronisé avec l'API dans votre pipeline CI. La commande de mise à jour nécessite l'ID de l'agent et la version actuelle en tant qu'indicateurs :
CLI
ant beta:agents update --agent-id agent_011CYm1BLqPXpQRk5khsSXrs --version 1 < summarizer.agent.yaml
Définissez l'environnement
Une session s'exécute dans un environnement, qui définit le bac à sable dans lequel elle s'exécute. Écrivez la définition de l'environnement dans summarizer.environment.yaml :
summarizer.environment.yaml
name: summarizer-env config: type: cloud networking: type: unrestricted
Créez l'environnement
ant beta:environments create < summarizer.environment.yaml
Output
{ "id": "env_01595EKxaaTTGwwY3kyXdtbs", "name": "summarizer-env" /* ... */ }
Notez l'id dans la réponse. Vous le passerez à la commande de création de session dans une étape ultérieure.
Ajoutez summarizer.environment.yaml à votre dépôt et maintenez-le synchronisé avec l'API dans votre pipeline CI. La commande de mise à jour nécessite l'ID de l'environnement en tant qu'indicateur :
CLI
ant beta:environments update --environment-id env_01595EKxaaTTGwwY3kyXdtbs < summarizer.environment.yaml

Démarrez une session

Collez l'id de l'agent et l'id de l'environnement issus des sorties précédentes dans la commande de création de session :

ant beta:sessions create \
  --agent agent_011CYm1BLqPXpQRk5khsSXrs \
  --environment-id env_01595EKxaaTTGwwY3kyXdtbs \
  --title "Summarization task"

Output

{
  "id": "session_01JZCh78XvmxJjiXVy3oSi7K",
  "status": "running"
  /* ... */
}

Envoyez un message utilisateur

Copiez l'id de la session depuis la sortie précédente dans --session-id :

ant beta:sessions:events send \
  --session-id session_01JZCh78XvmxJjiXVy3oSi7K \
  --event '{type: user.message, content: [{type: text, text: "Summarize the benefits of type safety in one sentence."}]}'

Lisez la conversation
--transform s'exécute sur chaque événement listé, ce qui affiche le texte de chaque message dans l'ordre. --format auto remplace l'explorateur interactif que les commandes de liste ouvrent par défaut dans un terminal :
ant beta:sessions:events list \ --session-id session_01JZCh78XvmxJjiXVy3oSi7K \ --transform 'content.0.text' --format auto --raw-output
Output
```
Summarize the benefits of type safety in one sentence.
Type safety catches errors at compile time rather than runtime, reducing bugs, improving code clarity, enabling better tooling support, and making codebases easier to maintain and refactor with confidence.
```
Pour observer une session pendant son exécution, utilisez ant beta:sessions:events stream --session-id session_01JZCh78XvmxJjiXVy3oSi7K. Les événements sont écrits sur stdout au fur et à mesure de leur arrivée.

Modèles de scripts

La CLI est conçue pour se combiner avec les outils shell standard.

Enchaîner la sortie d'une liste dans une seconde commande

--transform id --raw-output sur un point de terminaison de liste émet un ID brut par ligne, de sorte que les outils standard tels que head et xargs s'appliquent directement. Capturez le premier résultat, puis passez-le à une commande suivante :

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

Inspecter les erreurs

Les indicateurs --transform-error et --format-error appliquent le même filtrage aux réponses d'erreur. --raw-output ne s'applique pas aux erreurs, utilisez donc --format-error yaml pour obtenir un scalaire sans guillemets. Extrayez uniquement le message d'erreur :

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

Output

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

Utiliser la CLI depuis Claude Code

Claude Code peut utiliser la CLI ant directement. Une fois la CLI installée et authentifiée, vous pouvez demander à Claude Code d'opérer directement sur vos ressources de l'API. Par exemple :

« Liste mes sessions d'agent récentes et résume celles qui ont généré des erreurs. »
« Téléverse chaque PDF du dossier ./reports vers l'API Files et affiche les ID résultants. »
« Récupère les événements de la session session_01... et dis-moi où l'agent s'est bloqué. »

Claude Code exécute ant via le shell, analyse la sortie structurée et raisonne sur les résultats (aucun code d'intégration personnalisé n'est requis).

Was this page helpful?

CLI, SDK et bibliothèquesCLI ant

Scripts et automatisation avec la CLI

Gérez les ressources de l'API sous forme de fichiers YAML avec contrôle de version, enchaînez les commandes de la CLI ant dans des scripts et manipulez les ressources depuis Claude Code.

Cette page présente des flux de travail orientés tâches basés sur la CLI ant. Pour les options et indicateurs sous-jacents, consultez Utilisation de la CLI.

Contrôle de version des ressources de l'API

Pour plus d'informations sur ces ressources, consultez Agents gérés.

Définissez votre agent

Écrivez la définition de l'agent dans summarizer.agent.yaml :

summarizer.agent.yaml

name: Summarizer
model: claude-sonnet-4-6
system: |
  You are a helpful assistant that writes concise summaries.
tools:
  - type: agent_toolset_20260401

Créez l'agent
ant beta:agents create < summarizer.agent.yaml
Output
{ "id": "agent_011CYm1BLqPXpQRk5khsSXrs", "version": 1, "name": "Summarizer", "model": "claude-sonnet-4-6" /* ... */ }
Notez l'id dans la réponse. Vous le passerez à la commande de création de session dans une étape ultérieure.
Ajoutez summarizer.agent.yaml à votre dépôt et maintenez-le synchronisé avec l'API dans votre pipeline CI. La commande de mise à jour nécessite l'ID de l'agent et la version actuelle en tant qu'indicateurs :
CLI
ant beta:agents update --agent-id agent_011CYm1BLqPXpQRk5khsSXrs --version 1 < summarizer.agent.yaml
Définissez l'environnement
Une session s'exécute dans un environnement, qui définit le bac à sable dans lequel elle s'exécute. Écrivez la définition de l'environnement dans summarizer.environment.yaml :
summarizer.environment.yaml
name: summarizer-env config: type: cloud networking: type: unrestricted
Créez l'environnement
ant beta:environments create < summarizer.environment.yaml
Output
{ "id": "env_01595EKxaaTTGwwY3kyXdtbs", "name": "summarizer-env" /* ... */ }
Notez l'id dans la réponse. Vous le passerez à la commande de création de session dans une étape ultérieure.
Ajoutez summarizer.environment.yaml à votre dépôt et maintenez-le synchronisé avec l'API dans votre pipeline CI. La commande de mise à jour nécessite l'ID de l'environnement en tant qu'indicateur :
CLI
ant beta:environments update --environment-id env_01595EKxaaTTGwwY3kyXdtbs < summarizer.environment.yaml

Démarrez une session

Collez l'id de l'agent et l'id de l'environnement issus des sorties précédentes dans la commande de création de session :

ant beta:sessions create \
  --agent agent_011CYm1BLqPXpQRk5khsSXrs \
  --environment-id env_01595EKxaaTTGwwY3kyXdtbs \
  --title "Summarization task"

Output

{
  "id": "session_01JZCh78XvmxJjiXVy3oSi7K",
  "status": "running"
  /* ... */
}

Envoyez un message utilisateur

Copiez l'id de la session depuis la sortie précédente dans --session-id :

ant beta:sessions:events send \
  --session-id session_01JZCh78XvmxJjiXVy3oSi7K \
  --event '{type: user.message, content: [{type: text, text: "Summarize the benefits of type safety in one sentence."}]}'

Lisez la conversation
--transform s'exécute sur chaque événement listé, ce qui affiche le texte de chaque message dans l'ordre. --format auto remplace l'explorateur interactif que les commandes de liste ouvrent par défaut dans un terminal :
ant beta:sessions:events list \ --session-id session_01JZCh78XvmxJjiXVy3oSi7K \ --transform 'content.0.text' --format auto --raw-output
Output
```
Summarize the benefits of type safety in one sentence.
Type safety catches errors at compile time rather than runtime, reducing bugs, improving code clarity, enabling better tooling support, and making codebases easier to maintain and refactor with confidence.
```
Pour observer une session pendant son exécution, utilisez ant beta:sessions:events stream --session-id session_01JZCh78XvmxJjiXVy3oSi7K. Les événements sont écrits sur stdout au fur et à mesure de leur arrivée.

Modèles de scripts

La CLI est conçue pour se combiner avec les outils shell standard.

Enchaîner la sortie d'une liste dans une seconde commande

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

Inspecter les erreurs

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

Output

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

Utiliser la CLI depuis Claude Code

Claude Code peut utiliser la CLI ant directement. Une fois la CLI installée et authentifiée, vous pouvez demander à Claude Code d'opérer directement sur vos ressources de l'API. Par exemple :

« Liste mes sessions d'agent récentes et résume celles qui ont généré des erreurs. »
« Téléverse chaque PDF du dossier ./reports vers l'API Files et affiche les ID résultants. »
« Récupère les événements de la session session_01... et dis-moi où l'agent s'est bloqué. »

Claude Code exécute ant via le shell, analyse la sortie structurée et raisonne sur les résultats (aucun code d'intégration personnalisé n'est requis).

Was this page helpful?