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 anstehende Aufgabe fortzusetzen.

Verfügbare Tools

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

Konfigurieren des Toolsatzes

Aktivieren Sie den vollständigen Toolsatz mit agent_toolset_20260401 beim Erstellen eines Agenten. Verwenden Sie das Array configs, 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 nie 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.

Sobald Sie das Tool auf 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

• Bieten Sie extrem 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 Einschränkungen oder Limitierungen. 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 für jede Aktion ein separates Tool 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 sich Ihre Tools über mehrere Services oder Ressourcen erstrecken, 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 durchdenken. Aufgeblähte Antworten verschwenden Kontext und machen es Claude schwerer, das Wichtige zu extrahieren.