Loading...
    • Construire
    • Admin
    • Modèles et tarification
    • SDKs clients
    • Référence API
    Search...
    ⌘K
    Premiers pas
    Introduction à ClaudeDémarrage rapide
    Construire avec Claude
    Aperçu des fonctionnalitésUtiliser l'API MessagesGérer les raisons d'arrêt
    Capacités du modèle
    Réflexion étendueRéflexion adaptativeEffortMode rapide (bêta : aperçu de recherche)Sorties structuréesCitationsMessages en streamingTraitement par lotsRésultats de rechercheRefus en streamingSupport multilingueEmbeddings
    Outils
    AperçuFonctionnement de l'utilisation des outilsOutil de recherche webOutil de récupération webOutil d'exécution de codeOutil de mémoireOutil BashOutil d'utilisation de l'ordinateurOutil d'édition de texte
    Infrastructure des outils
    Recherche d'outilsAppel d'outils programmatiqueStreaming d'outils précis
    Gestion du contexte
    Fenêtres de contexteCompactionÉdition du contexteMise en cache des promptsComptage de tokens
    Travailler avec des fichiers
    Files APISupport PDFImages et vision
    Compétences
    AperçuDémarrage rapideMeilleures pratiquesCompétences pour l'entrepriseCompétences dans l'API
    MCP
    Serveurs MCP distantsConnecteur MCP
    Ingénierie des prompts
    AperçuMeilleures pratiques de promptingOutils de prompting dans la Console
    Tester et évaluer
    Définir le succès et créer des évaluationsUtiliser l'outil d'évaluation dans la ConsoleRéduire la latence
    Renforcer les garde-fous
    Réduire les hallucinationsAugmenter la cohérence des sortiesAtténuer les jailbreaksRéduire les fuites de prompt
    Ressources
    Glossaire
    Notes de version
    Claude Platform
    Console
    Log in
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...

    Solutions

    • AI agents
    • Code modernization
    • Coding
    • Customer support
    • Education
    • Financial services
    • Government
    • Life sciences

    Partners

    • Amazon Bedrock
    • Google Cloud's Vertex AI

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Company

    • Anthropic
    • Careers
    • Economic Futures
    • Research
    • News
    • Responsible Scaling Policy
    • Security and compliance
    • Transparency

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Help and security

    • Availability
    • Status
    • Support
    • Discord

    Terms and policies

    • Privacy policy
    • Responsible disclosure policy
    • Terms of service: Commercial
    • Terms of service: Consumer
    • Usage policy
    Définir votre agent

    Outils

    Configurez les outils disponibles pour votre agent.

    Claude Managed Agents fournit un ensemble d'outils intégrés que Claude peut utiliser de manière autonome au cours d'une session. Vous contrôlez les outils disponibles en les spécifiant dans la configuration de l'agent.

    Les outils personnalisés définis par l'utilisateur sont également pris en charge. Votre application exécute ces outils séparément et renvoie les résultats à Claude ; Claude peut utiliser les résultats pour continuer la tâche en cours.

    Toutes les requêtes API Managed Agents nécessitent l'en-tête bêta managed-agents-2026-04-01. Le SDK définit automatiquement l'en-tête bêta.

    Outils disponibles

    L'ensemble d'outils de l'agent comprend les outils suivants. Tous sont activés par défaut lorsque vous incluez l'ensemble d'outils dans la configuration de votre agent.

    OutilNomDescription
    BashbashExécuter des commandes bash dans une session shell
    ReadreadLire un fichier depuis le système de fichiers local
    WritewriteÉcrire un fichier dans le système de fichiers local

    Was this page helpful?

    • Outils disponibles
    • Configuration de l'ensemble d'outils
    • Désactivation d'outils spécifiques
    • Activation uniquement d'outils spécifiques
    • Outils personnalisés
    • Bonnes pratiques pour les définitions d'outils personnalisés
    EditeditEffectuer un remplacement de chaîne dans un fichier
    GlobglobCorrespondance rapide de motifs de fichiers à l'aide de motifs glob
    GrepgrepRecherche de texte à l'aide de motifs regex
    Web fetchweb_fetchRécupérer du contenu depuis une URL
    Web searchweb_searchRechercher des informations sur le web

    Configuration de l'ensemble d'outils

    Activez l'ensemble d'outils complet avec agent_toolset_20260401 lors de la création d'un agent. Utilisez le tableau configs pour désactiver des outils spécifiques ou remplacer leurs paramètres.

    agent=$(curl -fsSL https://api.anthropic.com/v1/agents \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d @- <<'EOF'
{
  "name": "Coding Assistant",
  "model": "claude-sonnet-4-6",
  "tools": [
    {
      "type": "agent_toolset_20260401",
      "configs": [
        {"name": "web_fetch", "enabled": false}
      ]
    }
  ]
}
EOF
)

    Désactivation d'outils spécifiques

    Pour désactiver un outil, définissez enabled: false dans son entrée de configuration :

    {
  "type": "agent_toolset_20260401",
  "configs": [
    { "name": "web_fetch", "enabled": false },
    { "name": "web_search", "enabled": false }
  ]
}

    Activation uniquement d'outils spécifiques

    Pour commencer avec tout désactivé et n'activer que ce dont vous avez besoin, définissez default_config.enabled sur false :

    {
  "type": "agent_toolset_20260401",
  "default_config": { "enabled": false },
  "configs": [
    { "name": "bash", "enabled": true },
    { "name": "read", "enabled": true },
    { "name": "write", "enabled": true }
  ]
}

    Outils personnalisés

    En plus des outils intégrés, vous pouvez définir des outils personnalisés. Les outils personnalisés sont analogues aux outils client définis par l'utilisateur dans l'API Messages.

    Les outils personnalisés vous permettent d'étendre les capacités de Claude pour effectuer une plus grande variété de tâches. Chaque outil définit un contrat : vous spécifiez quelles opérations sont disponibles et ce qu'elles retournent ; Claude décide quand et comment les appeler. Le modèle n'exécute jamais rien par lui-même. Il émet une requête structurée, votre code exécute l'opération, et le résultat revient dans la conversation.

    agent=$(curl -fsSL https://api.anthropic.com/v1/agents \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d @- <<'EOF'
{
  "name": "Weather Agent",
  "model": "claude-sonnet-4-6",
  "tools": [
    {
      "type": "agent_toolset_20260401"
    },
    {
      "type": "custom",
      "name": "get_weather",
      "description": "Get current weather for a location",
      "input_schema": {
        "type": "object",
        "properties": {
          "location": {"type": "string", "description": "City name"}
        },
        "required": ["location"]
      }
    }
  ]
}
EOF
)

    Une fois que vous avez défini l'outil au niveau de l'agent, l'agent invoquera les outils au cours d'une session. Consultez Flux d'événements de session pour le flux complet.

    Bonnes pratiques pour les définitions d'outils personnalisés

    • Fournissez des descriptions extrêmement détaillées. C'est de loin le facteur le plus important dans les performances des outils. Vos descriptions doivent expliquer ce que fait l'outil, quand il doit être utilisé (et quand il ne doit pas l'être), ce que signifie chaque paramètre et comment il affecte le comportement de l'outil, ainsi que toutes les mises en garde ou limitations importantes. Plus vous pouvez donner de contexte à Claude sur vos outils, mieux il sera en mesure de décider quand et comment les utiliser. Visez au moins 3 à 4 phrases par description d'outil, davantage si l'outil est complexe.
    • Consolidez les opérations connexes en moins d'outils. Plutôt que de créer un outil séparé pour chaque action (create_pr, review_pr, merge_pr), regroupez-les dans un seul outil avec un paramètre action. Moins d'outils, mais plus capables, réduisent l'ambiguïté de sélection et facilitent la navigation de Claude dans votre surface d'outils.
    • Utilisez un nommage significatif dans les noms d'outils. Lorsque vos outils couvrent plusieurs services ou ressources, préfixez les noms avec la ressource (par exemple, db_query, storage_read). Cela rend la sélection des outils non ambiguë à mesure que votre bibliothèque s'agrandit.
    • Concevez les réponses des outils pour ne retourner que des informations à haute valeur ajoutée. Retournez des identifiants sémantiques et stables (par exemple, des slugs ou des UUID) plutôt que des références internes opaques, et n'incluez que les champs dont Claude a besoin pour raisonner sur sa prochaine étape. Les réponses volumineuses gaspillent le contexte et rendent plus difficile pour Claude d'extraire ce qui compte.