Tools

Claude Managed Agents bietet eine Reihe von integrierten Tools, die Claude autonom innerhalb einer Sitzung nutzen kann. Sie kontrollieren, welche Tools verfügbar sind, indem Sie sie in der Agent-Konfiguration angeben.

Benutzerdefinierte Tools werden ebenfalls unterstützt. Ihre Anwendung führt diese Tools separat aus und sendet die Tool-Ergebnisse zurück an Claude; Claude kann die Ergebnisse nutzen, um die aktuelle Aufgabe fortzusetzen.

Verfügbare Tools

Der Agent-Toolsatz umfasst die folgenden Tools. Alle sind standardmäßig aktiviert, wenn Sie den Toolsatz in Ihre Agent-Konfiguration aufnehmen.

Konfigurieren des Toolsatzes

Aktivieren Sie den vollständigen Toolsatz mit agent_toolset_20260401 beim Erstellen eines Agenten. Verwenden Sie das configs-Array, um bestimmte Tools zu deaktivieren oder ihre Einstellungen zu überschreiben.

Deaktivieren bestimmter Tools

Um ein Tool zu deaktivieren, setzen Sie enabled: false in seinem Config-Eintrag:

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

Aktivieren nur bestimmter Tools

Um mit allem zu beginnen, das ausgeschaltet ist, und nur das zu aktivieren, was Sie benötigen, setzen Sie default_config.enabled auf false:

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

Benutzerdefinierte Tools

Zusätzlich zu integrierten Tools können Sie benutzerdefinierte Tools definieren. Benutzerdefinierte Tools sind analog zu benutzerdefinierten Client-Tools in der Messages API.

Benutzerdefinierte Tools ermöglichen es Ihnen, Claudes Fähigkeiten zu erweitern, um eine größere Vielfalt von Aufgaben auszuführen. Jedes Tool definiert einen Vertrag: Sie geben an, welche Operationen verfügbar sind und was sie zurückgeben; Claude entscheidet, wann und wie sie aufgerufen werden. Das Modell führt niemals etwas von selbst aus. Es gibt eine strukturierte Anfrage aus, Ihr Code führt die Operation aus, und das Ergebnis fließt zurück in das Gespräch.

Nachdem Sie das Tool auf der Agent-Ebene definiert haben, wird der Agent die Tools im Laufe einer Sitzung aufrufen. Siehe Session-Ereignisstrom für den vollständigen Ablauf.

Best Practices für benutzerdefinierte Tool-Definitionen

• Geben Sie äußerst detaillierte Beschreibungen. Dies ist bei weitem der wichtigste Faktor für die Tool-Leistung. Ihre Beschreibungen sollten erklären, was das Tool tut, wann es verwendet werden sollte (und wann nicht), was jeder Parameter bedeutet und wie er das Verhalten des Tools beeinflusst, sowie alle wichtigen Vorbehalte oder Einschränkungen. Je mehr Kontext Sie Claude über Ihre Tools geben können, desto besser wird es bei der Entscheidung, wann und wie sie verwendet werden. Streben Sie nach mindestens 3-4 Sätzen pro Tool-Beschreibung, mehr wenn das Tool komplex ist.
• Konsolidieren Sie verwandte Operationen in weniger Tools. Anstatt ein separates Tool für jede Aktion zu erstellen (create_pr, review_pr, merge_pr), gruppieren Sie sie in einem einzelnen Tool mit einem action-Parameter. Weniger, aber leistungsfähigere Tools reduzieren Auswahlmehrdeutigkeit und machen Ihre Tool-Oberfläche für Claude leichter zu navigieren.
• Verwenden Sie aussagekräftige Namensräume in Tool-Namen. Wenn Ihre Tools mehrere Services oder Ressourcen umfassen, präfixieren Sie Namen mit der Ressource (z. B. db_query, storage_read). Dies macht die Tool-Auswahl eindeutig, wenn Ihre Bibliothek wächst.
• Gestalten Sie Tool-Antworten so, dass sie nur hochwertige Informationen zurückgeben. Geben Sie semantische, stabile Identifikatoren (z. B. Slugs oder UUIDs) anstelle von undurchsichtigen internen Referenzen zurück, und beziehen Sie nur die Felder ein, die Claude benötigt, um seinen nächsten Schritt zu überdenken. Aufgeblähte Antworten verschwenden Kontext und machen es für Claude schwieriger, das Wichtige zu extrahieren.