Premiers pas avec Claude Managed Agents
Créez votre premier agent autonome.
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.
Claude Code
Laissez Claude Code configurer votre agent pour vous
/claude-api managed-agents-onboardConcepts fondamentaux
| Concept | Description |
|---|---|
| Agent | Le modèle, l’invite système, les outils, les serveurs MCP et les compétences |
| Environnement | Configuration de l’endroit où les sessions s’exécutent : un bac à sable cloud géré par Anthropic, ou un bac à sable auto-hébergé sur votre propre infrastructure |
| Session | Une instance d’agent en cours d’exécution au sein d’un environnement, effectuant une tâche spécifique et générant des sorties |
| Événements | Messages échangés entre votre application et l’agent (tours de l’utilisateur, résultats d’outils, mises à jour de statut) |
Avant de commencer
Créer un compte Claude Console
Inscrivez-vous pour obtenir un compte Claude Console, ou connectez-vous à celui que vous possédez déjà.
Choisir votre méthode d’authentification
La connexion via la CLI est recommandée pour le développement local.
CLIClé API
Installer la CLI
brew install anthropics/tap/antPour les environnements Linux, téléchargez directement le binaire de la version.
VERSION=2.12.1 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 antVous pouvez trouver toutes les versions sur la page des versions GitHub.
Vous pouvez également installer la CLI à partir des sources avec
go install, ce qui nécessite Go 1.26.10 ou une version ultérieure.go install github.com/anthropics/anthropic-cli/v2/cmd/ant@latestgo installplace le binaire dans$(go env GOPATH)/bin. Ajoutez ce répertoire à votrePATHs’il n’y figure pas déjà :export PATH="$PATH:$(go env GOPATH)/bin"Se connecter
ant auth loginUne fois la connexion terminée, les SDK et la CLI récupéreront automatiquement vos identifiants.
Créer une clé API
Créez une clé API dans la Claude Console.
Définir la variable d’environnement
Les SDK et la CLI lisent votre clé depuis
ANTHROPIC_API_KEY:export ANTHROPIC_API_KEY="your-api-key-here"
Pour exécuter les exemples de la CLI, installez la CLI :
brew install anthropics/tap/antPour les environnements Linux, téléchargez directement le binaire de la version.
VERSION=2.12.1
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 antVous pouvez trouver toutes les versions sur la page des versions GitHub.
Vous pouvez également installer la CLI à partir des sources avec go install, ce qui nécessite Go 1.26.10 ou une version ultérieure.
go install github.com/anthropics/anthropic-cli/v2/cmd/ant@latestgo install place le binaire dans $(go env GOPATH)/bin. Ajoutez ce répertoire à votre PATH s’il n’y figure pas déjà :
export PATH="$PATH:$(go env GOPATH)/bin"Installer le SDK
pip install anthropicCréer votre première session
Créer un agent
Créez un agent qui définit le modèle, le « system prompt » (invite système) et les outils disponibles.
CLIant apply coding-assistant.mdcoding-assistant.md--- name: Coding Assistant model: claude-opus-5-5 tools: - type: agent_toolset_20260401 configs: - name: web_search enabled: false - name: web_fetch enabled: false --- You are a helpful coding assistant. Write clean, well-documented code.ant applyaffiche l’ID de l’agent et l’enregistre dansclaude-lock.json. Vous y ferez référence dans chaque session que vous créerez.Le type d’outil
agent_toolset_20260401active les outils d’agent préconfigurés (bash, opérations sur les fichiers, recherche web, et plus encore). Cet exemple désactive la recherche web et la récupération web, car la tâche de ce guide, l’écriture d’un court script Python, n’utilise pas le web. Donnez à un agent uniquement les outils dont il a besoin. Consultez Outils pour la liste complète et les options de configuration de chaque outil.Créer un environnement
Un environnement définit la « sandbox » (bac à sable) dans laquelle votre agent s’exécute. Celui-ci utilise une mise en réseau
limitedavec les gestionnaires de paquets autorisés, de sorte que le code exécuté dans la sandbox peut atteindre les registres de paquets et hébergeurs de code publics. Avec une mise en réseaulimited, la listeallowed_hostss’applique également à la recherche web et à la récupération web, bien qu’elles s’exécutent en dehors de la sandbox. Lorsqu’aucun hôte n’est répertorié, comme dans cet environnement, elles ne renvoient aucune page ni aucun résultat de recherche. Si votre propre agent utilise ces outils, ajoutez à cette liste les hôtes dont il a besoin.CLIant apply environment.yamlenvironment.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: trueant applyenregistre également l’ID de l’environnement dansclaude-lock.json. Pour créer l’agent et l’environnement avec une seule commande, transmettez les deux fichiers :ant apply coding-assistant.md environment.yaml.Démarrer une session
Créez une session qui fait référence à votre agent et à votre environnement.
Pythonsession = client.beta.sessions.create( agent=agent.id, environment_id=environment.id, title="Quickstart session", ) print(f"Session ID: {session.id}")Envoyer un message et diffuser la réponse en streaming
Ouvrez un flux, envoyez un événement utilisateur, puis traitez les événements à mesure qu’ils arrivent :
Pythonwith 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.") breakL’agent écrit un script Python, l’exécute dans la 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 :
- Provisionne une sandbox : la configuration de votre environnement détermine la manière dont elle est construite.
- Exécute la boucle de l’agent : Claude détermine quels outils utiliser en fonction de votre message.
- Exécute les outils : les écritures de fichiers, les commandes bash et les autres appels d’outils s’exécutent à l’intérieur de la sandbox.
- Diffuse les événements en streaming : vous recevez des mises à jour en temps réel pendant que l’agent travaille.
- Passe en inactivité : l’agent émet un événement
session.status_idlelorsqu’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 créer 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 de l’agent côté serveur : la session conserve la transcription, exécute les outils dans une sandbox et diffuse en streaming les événements que le front-end affiche.
Un analyste de recherche dans un chat de navigateur construit avec le Chat SDK de Vercel. Chaque conversation est une session persistante qui diffuse sa réponse en streaming pendant qu’un flux en direct affiche les appels d’outils. Remplacer l’adaptateur du Chat SDK permet de déplacer le même gestionnaire vers Slack, Teams, Discord ou WhatsApp.
Un analyste de feuilles de calcul dans un chat construit à partir des primitives d’assistant-ui. Les sessions constituent la liste des fils de discussion, un seul reducer transforme le journal des événements de la session en messages et en cartes d’outils, et chaque commande bash affiche une barrière Autoriser/Refuser en ligne avant de s’exécuter.
Un assistant de finances personnelles dans un chat CopilotKit. L’adaptateur AG-UI pour Claude Managed Agents associe chaque fil de discussion à une session gérée et diffuse les réponses en streaming token par token, et des outils personnalisés affichent des graphiques interactifs directement dans la conversation.
Étapes suivantes
Créez des configurations d’agent réutilisables et versionnées
Personnalisez les paramètres de mise en réseau et de sandbox
Activez des outils spécifiques pour votre agent
Gérez les événements et orientez l’agent pendant son exécution
Exécutez votre agent selon une planification cron récurrente
Condensez une seule fois un corpus de documents en un wiki de connaissances, puis répondez aux questions récurrentes à partir de celui-ci pour une fraction du coût
Cette page vous a-t-elle été utile ?