Outils

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

Claude Managed Agents prend également en charge les outils personnalisés définis par l'utilisateur. Votre application exécute ces outils séparément et renvoie les résultats à Claude, qui les utilise pour poursuivre la tâche. Pour donner à l'agent des outils provenant d'un serveur MCP, utilisez plutôt le connecteur MCP.



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. Utilisez les valeurs de la colonne Nom pour référencer les outils dans le tableau configs.

Lorsque la sortie d'un outil dépasse 100 000 tokens, elle est automatiquement écrite dans un fichier du bac à sable. Le modèle reçoit un aperçu tronqué avec le chemin du fichier et peut lire le contenu complet à partir de là.



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. Chaque entrée de configuration peut également définir une permission_policy qui contrôle si les appels de l'outil sont approuvés automatiquement ou nécessitent une confirmation. Consultez Politiques de permissions pour connaître les types de politiques disponibles.

ant beta:agents create <<'YAML'
name: Coding Assistant
model: claude-opus-4-8
tools:
  - type: agent_toolset_20260401
    configs:
      - name: web_fetch
        enabled: false
YAML



Désactivation d'outils spécifiques

Pour désactiver un outil, définissez enabled: false dans son entrée de configuration au sein de l'objet d'ensemble d'outils du tableau tools de votre agent :

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



Activation d'outils spécifiques uniquement

L'objet default_config définit la base de référence pour chaque outil de l'ensemble, et les entrées configs par outil la remplacent. 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.

Chaque outil personnalisé définit un contrat : vous spécifiez quelles opérations sont disponibles et ce qu'elles renvoient, et Claude détermine 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 est réinjecté dans la conversation. Consultez Flux d'événements de session pour savoir comment recevoir les appels d'outils personnalisés et renvoyer les résultats pendant une session.

ant beta:agents create <<'YAML'
name: Weather Agent
model: claude-opus-4-8
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
YAML

Une fois que vous avez défini des outils personnalisés sur l'agent, celui-ci les invoque pendant une session.



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 pour les performances des outils. Vos descriptions doivent expliquer ce que fait l'outil et quand l'utiliser (et quand ne pas l'utiliser). Expliquez ce que signifie chaque paramètre et comment il affecte le comportement de l'outil. Signalez toutes les mises en garde ou limitations importantes. Plus vous donnez de contexte à Claude sur vos outils, mieux il détermine quand et comment les utiliser. Visez trois à quatre phrases pour chaque 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 distinct pour chaque action (create_pr, review_pr, merge_pr), regroupez-les en un seul outil avec un paramètre action. Des outils moins nombreux mais plus polyvalents réduisent l'ambiguïté de sélection et facilitent la navigation de Claude dans votre surface d'outils.
• Utilisez un espace de noms 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 ou storage_read). Cela rend la sélection d'outils sans ambiguïté à mesure que votre bibliothèque s'agrandit.
• Concevez les réponses d'outils pour ne renvoyer que des informations à forte valeur. Renvoyez 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 déterminer sa prochaine étape. Des réponses surchargées gaspillent du contexte et rendent plus difficile pour Claude d'extraire ce qui compte.



Prochaines étapes