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 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 des outils à Claude ; Claude peut utiliser les résultats pour continuer la tâche en cours.

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.

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.

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

Désactiver des 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 }
  ]
}

Activer uniquement des outils spécifiques

Pour commencer avec tout désactivé et activer uniquement 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 les opérations disponibles et ce qu'elles retournent ; Claude décide quand et comment les appeler. Le modèle n'exécute jamais rien de son propre chef. Il émet une demande structurée, votre code exécute l'opération, et le résultat revient dans la conversation.

ant beta:agents create <<'YAML'
name: Weather Agent
model: claude-opus-4-7
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 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 pour 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, et toutes les mises en garde ou limitations importantes. Plus vous pouvez donner de contexte à Claude sur vos outils, mieux il sera capable de décider quand et comment les utiliser. Visez au moins 3-4 phrases par description d'outil, plus 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 puissants, réduisent l'ambiguïté de sélection et rendent votre surface d'outils plus facile à naviguer pour Claude.
• Utilisez un espacement de noms significatif dans les noms d'outils. Lorsque vos outils s'étendent sur plusieurs services ou ressources, préfixez les noms avec la ressource (par exemple, db_query, storage_read). Cela rend la sélection des outils sans ambiguïté à mesure que votre bibliothèque se développe.
• Concevez les réponses des outils pour retourner uniquement des informations à haut signal. Retournez des identifiants sémantiques et stables (par exemple, des slugs ou des UUID) plutôt que des références internes opaques, et incluez uniquement les champs dont Claude a besoin pour raisonner sur son prochain pas. Les réponses gonflées gaspillent le contexte et rendent plus difficile pour Claude d'extraire ce qui compte.