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

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
   tools:
     - type: agent_toolset_20260401
   ---
   
   You are a helpful coding assistant. Write clean, well-documented code.

   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 la liste complète et les options de configuration par outil.

   Enregistrez l'agent.id renvoyé (la commande ant apply de la CLI l'affiche et l'enregistre dans claude-lock.json). Vous y ferez référence dans chaque session que vous créerez.

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

   

   name: quickstart-env
   config:
     type: cloud
     networking:
       type: unrestricted

   Enregistrez l'environment.id renvoyé (également présent dans claude-lock.json si vous avez utilisé ant apply). Vous y ferez référence dans chaque session que vous créerez.

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 au fur et à mesure de leur arrivée :

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   

   with client.beta.sessions.events.stream(session.id) as stream:
       # Envoyer le message utilisateur après l'ouverture du flux
       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",
                       },
                   ],
               },
           ],
       )
   
       # Traiter les événements de streaming
       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