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.

Concepts 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 dans 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)

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

Créer un agent
Créez un agent qui définit le modèle, l'invite système et les outils disponibles.
AGENT_ID=$(ant beta:agents create --transform id --raw-output < coding-assistant.agent.yaml) echo "Agent ID: $AGENT_ID"
coding-assistant.agent.yaml
name: Coding Assistant model: id: claude-opus-5 system: You are a helpful coding assistant. Write clean, well-documented code. tools: - type: agent_toolset_20260401
Le type d'outil agent_toolset_20260401 active l'ensemble complet des outils d'agent préconfigurés (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 retourné. Vous le référencerez dans chaque session que vous créerez.
Créer un environnement
Un environnement définit le bac à sable (sandbox) dans lequel votre agent s'exécute.
ENVIRONMENT_ID=$(ant beta:environments create --transform id --raw-output < quickstart.environment.yaml) echo "Environment ID: $ENVIRONMENT_ID"
quickstart.environment.yaml
name: quickstart-env config: type: cloud networking: type: unrestricted
Enregistrez l'environment.id retourné. Vous le référencerez dans chaque session que vous créerez.
Pour exécuter le bac à sable sur votre propre infrastructure plutôt que dans un bac à sable cloud, consultez Bacs à sable auto-hébergés.

Démarrer une session

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

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

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:
                    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 bac à sable et vérifie que le fichier de sortie a é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 un bac à sable : votre configuration d'environnement détermine comment il est construit.
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 du bac à sable.
Diffuse les événements en streaming : vous recevez des mises à jour en temps réel pendant que l'agent travaille.
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 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 un bac à sable et diffuse en streaming les événements que le front-end affiche.

Chat SDK

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. Changer l'adaptateur du Chat SDK déplace le même gestionnaire vers Slack, Teams, Discord ou WhatsApp.

assistant-ui

Un analyste de feuilles de calcul dans un chat construit à partir des primitives assistant-ui. Les sessions constituent la liste des fils de discussion, un seul réducteur transforme le journal d'événements de session en messages et cartes d'outils, et chaque commande bash affiche une porte Autoriser/Refuser en ligne avant son exécution.

CopilotKit (AG-UI)

Un assistant de finances personnelles dans un chat CopilotKit. L'adaptateur AG-UI pour Claude Managed Agents associe chaque fil de chat à une session gérée et diffuse les réponses token par token en streaming, et des outils personnalisés affichent des graphiques interactifs directement dans la conversation.

Étapes suivantes

Définir votre agent

Créez des configurations d'agent réutilisables et versionnées

Configurer les environnements

Personnalisez les paramètres réseau et de bac à sable

Outils d'agent

Activez des outils spécifiques pour votre agent

Flux d'événements de session

Gérez les événements et orientez l'agent en cours d'exécution

Déploiements planifiés

Exécutez votre agent selon un calendrier cron récurrent

Démarrage rapide wiki de connaissances

Distillez une fois un corpus de documents en un wiki de connaissances, puis répondez aux questions répétées à partir de celui-ci pour une fraction du coût

Was this page helpful?

Concepts 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 dans 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)

Créer votre première session

Créer un agent
Créez un agent qui définit le modèle, l'invite système et les outils disponibles.
AGENT_ID=$(ant beta:agents create --transform id --raw-output < coding-assistant.agent.yaml) echo "Agent ID: $AGENT_ID"
coding-assistant.agent.yaml
name: Coding Assistant model: id: claude-opus-5 system: You are a helpful coding assistant. Write clean, well-documented code. tools: - type: agent_toolset_20260401
Le type d'outil agent_toolset_20260401 active l'ensemble complet des outils d'agent préconfigurés (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 retourné. Vous le référencerez dans chaque session que vous créerez.
Créer un environnement
Un environnement définit le bac à sable (sandbox) dans lequel votre agent s'exécute.
ENVIRONMENT_ID=$(ant beta:environments create --transform id --raw-output < quickstart.environment.yaml) echo "Environment ID: $ENVIRONMENT_ID"
quickstart.environment.yaml
name: quickstart-env config: type: cloud networking: type: unrestricted
Enregistrez l'environment.id retourné. Vous le référencerez dans chaque session que vous créerez.
Pour exécuter le bac à sable sur votre propre infrastructure plutôt que dans un bac à sable cloud, consultez Bacs à sable auto-hébergés.

Démarrer une session

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

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

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:
                    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 bac à sable et vérifie que le fichier de sortie a é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 un bac à sable : votre configuration d'environnement détermine comment il est construit.

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 du bac à sable.

Diffuse les événements en streaming : vous recevez des mises à jour en temps réel pendant que l'agent travaille.

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

Étapes suivantes

Créez des configurations d'agent réutilisables et versionnées

Configurer les environnements

Personnalisez les paramètres réseau et de bac à sable

Outils d'agent

Activez des outils spécifiques pour votre agent

Flux d'événements de session

Gérez les événements et orientez l'agent en cours d'exécution

Déploiements planifiés

Exécutez votre agent selon un calendrier cron récurrent

Démarrage rapide wiki de connaissances

Distillez une fois un corpus de documents en un wiki de connaissances, puis répondez aux questions répétées à partir de celui-ci pour une fraction du coût

Was this page helpful?

Concepts fondamentaux

Prérequis

Installer la CLI

Installer le SDK

Créer votre première session

Ce qui se passe

Créer une application complète

Étapes suivantes

Concepts fondamentaux

Prérequis

Installer la CLI

Installer le SDK

Créer votre première session

Ce qui se passe

Créer une application complète

Étapes suivantes

Concepts fondamentaux

Prérequis

Installer la CLI

Installer le SDK

Créer votre première session

Ce qui se passe

Créer une application complète

Étapes suivantes

Concepts fondamentaux

Prérequis

Installer la CLI

Installer le SDK

Créer votre première session

Ce qui se passe

Créer une application complète

Étapes suivantes