Claude Platform Docs
Managed AgentsPremiers pas

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-onboard

Concepts fondamentaux

ConceptDescription
AgentLe modèle, l’invite système, les outils, les serveurs MCP et les compétences
EnvironnementConfiguration 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
SessionUne 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énementsMessages échangés entre votre application et l’agent (tours de l’utilisateur, résultats d’outils, mises à jour de statut)

Avant de commencer

  1. Créer un compte Claude Console

    Inscrivez-vous pour obtenir un compte Claude Console, ou connectez-vous à celui que vous possédez déjà.

  2. Choisir votre méthode d’authentification

    La connexion via la CLI est recommandée pour le développement local.

    CLIClé API
  1. Installer la CLI

    brew install anthropics/tap/ant
  2. Se connecter

    ant auth login

    Une fois la connexion terminée, les SDK et la CLI récupéreront automatiquement vos identifiants.

Installer le SDK

pip install anthropic

Créer votre première session

  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.

    ant apply coding-assistant.md
    coding-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 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 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.

  2. 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 limited avec 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éseau limited, la liste allowed_hosts s’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.

    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 avec une seule commande, transmettez les deux fichiers : ant apply coding-assistant.md environment.yaml.

  3. Démarrer une session

    Créez une session qui fait 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}")
  4. 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 :

    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 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 :

  1. Provisionne une sandbox : la configuration de votre environnement détermine la manière dont elle est construite.
  2. Exécute la boucle de l’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 de la 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 inactivité : 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 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 ?