Premiers pas avec Claude Managed Agents

Ce guide vous accompagne dans la création d'un agent, la configuration d'un environnement, le démarrage d'une session et le streaming des réponses de l'agent.

Concepts fondamentaux

Prérequis

• Un compte Claude Console
• Une clé API

Installer la CLI

brew install anthropics/tap/ant

VERSION=1.38.0
OS=$(uname -s | tr '[:upper:]' '[:lower:]')
case $(uname -m) in
  x86_64) ARCH=amd64 ;;
  aarch64) ARCH=arm64 ;;
esac
curl -fsSL "https://github.com/anthropics/anthropic-cli/releases/download/v${VERSION}/ant_${VERSION}_${OS}_${ARCH}.tar.gz" \
  | sudo tar -xz -C /usr/local/bin ant

go install github.com/anthropics/anthropic-cli/cmd/ant@latest

export PATH="$PATH:$(go env GOPATH)/bin"

Vérifiez l'installation :

ant --version

Installer le SDK

pip install anthropic

Définissez votre clé API comme variable d'environnement :

export ANTHROPIC_API_KEY="your-api-key-here"

Créer votre première session

1. 1

   Créer un agent

   Créez un agent qui définit le modèle, le « system prompt » (invite système) et les outils disponibles.

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   

   ant apply coding-assistant.md

   coding-assistant.md

   

   ---
   name: Coding Assistant
   model: claude-opus-5-5
   tools:
     - type: agent_toolset_20260401
   ---
   
   You are a helpful coding assistant. Write clean, well-documented code.

   ant apply affiche l'ID de l'agent et l'enregistre dans claude-lock.json. Vous y ferez référence dans chaque session que vous créerez.

   Le type d'outil agent_toolset_20260401 active l'ensemble complet des outils d'agent préconstruits (bash, opérations sur les fichiers, recherche web, et plus encore). Consultez Outils pour obtenir la liste complète et les options de configuration propres à chaque outil.

2. 2

   Créer un environnement

   Un environnement définit le « sandbox » (bac à sable) dans lequel votre agent s'exécute.

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   

   ant apply environment.yaml

   environment.yaml

   

   # yaml-language-server: $schema=https://platform.claude.com/schemas/ant/beta/environment.json
   name: quickstart-env
   config:
     type: cloud
     networking:
       type: limited
       allow_package_managers: true

   ant apply enregistre également l'ID de l'environnement dans claude-lock.json. Pour créer l'agent et l'environnement en une seule commande, passez les deux fichiers : ant apply coding-assistant.md environment.yaml.

3. 3

   Démarrer une session

   Créez une session qui référence votre agent et votre environnement.

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   

   session = client.beta.sessions.create(
       agent=agent.id,
       environment_id=environment.id,
       title="Quickstart session",
   )
   
   print(f"Session ID: {session.id}")

4. 4

   Envoyer un message et recevoir la réponse en streaming

   Ouvrez un flux, envoyez un événement utilisateur, puis traitez les événements à mesure qu'ils arrivent :

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   

   with client.beta.sessions.events.stream(session.id) as stream:
       # Send the user message after the stream opens
       client.beta.sessions.events.send(
           session.id,
           events=[
               {
                   "type": "user.message",
                   "content": [
                       {
                           "type": "text",
                           "text": "Create a Python script that generates the first 20 Fibonacci numbers and saves them to fibonacci.txt",
                       },
                   ],
               },
           ],
       )
   
       # Process streaming events
       for event in stream:
           match event.type:
               case "agent.message":
                   for block in event.content:
                       if block.type == "text":
                           print(block.text, end="")
               case "agent.tool_use":
                   print(f"\n[Using tool: {event.name}]")
               case "session.status_idle":
                   print("\n\nAgent finished.")
                   break

   L'agent écrit un script Python, l'exécute dans le sandbox et vérifie que le fichier de sortie a bien été créé. Votre sortie ressemble à ceci :

   I'll create a Python script that generates the first 20 Fibonacci numbers and saves them to a file.
   [Using tool: write]
   [Using tool: bash]
   The script ran successfully. Let me verify the output file.
   [Using tool: bash]
   fibonacci.txt contains the first 20 Fibonacci numbers (0 through 4181).
   
   Agent finished.

   

Ce qui se passe

Lorsque vous envoyez un événement utilisateur, Claude Managed Agents :

1. Provisionne un sandbox : la configuration de votre environnement détermine la manière dont il est construit.
2. Exécute la boucle d'agent : Claude détermine quels outils utiliser en fonction de votre message.
3. Exécute les outils : les écritures de fichiers, les commandes bash et les autres appels d'outils s'exécutent à l'intérieur du sandbox.
4. Diffuse les événements en streaming : vous recevez des mises à jour en temps réel pendant que l'agent travaille.
5. Passe en veille : l'agent émet un événement session.status_idle lorsqu'il n'a plus rien à faire.

Créer une application complète

Chacun de ces guides de démarrage rapide associe Claude Managed Agents à un framework de chat populaire pour constituer une application complète et exécutable. Dans chacun d'eux, le framework affiche l'interface de chat tandis qu'une session gérée exécute la boucle d'agent côté serveur : la session conserve la transcription, exécute les outils dans un sandbox et diffuse en streaming les événements que le front-end affiche.

Étapes suivantes