Tools

Claude Managed Agents stellt eine Reihe integrierter Tools bereit, die Claude innerhalb einer Session autonom nutzen kann. Du steuerst, welche Tools verfügbar sind, indem du sie in der Agentenkonfiguration angibst.

Claude Managed Agents unterstützt auch benutzerdefinierte Tools. Deine Anwendung führt diese Tools separat aus und gibt die Ergebnisse an Claude zurück, der sie verwendet, um die Aufgabe fortzusetzen. Um dem Agenten Tools von einem MCP-Server bereitzustellen, verwende stattdessen den MCP-Connector.



Verfügbare Tools

Das Agenten-Toolset umfasst die folgenden Tools. Alle sind standardmäßig aktiviert, wenn du das Toolset in deine Agentenkonfiguration aufnimmst. Verwende die Werte in der Spalte „Name", um Tools im configs-Array zu referenzieren.

Wenn eine Tool-Ausgabe 100.000 Token überschreitet, wird sie automatisch in eine Datei in der Sandbox geschrieben. Das Modell erhält eine gekürzte Vorschau mit dem Dateipfad und kann den vollständigen Inhalt von dort lesen.



Konfigurieren des Toolsets

Aktiviere das vollständige Toolset mit agent_toolset_20260401 beim Erstellen eines Agenten. Verwende das configs-Array, um bestimmte Tools zu deaktivieren oder ihre Einstellungen zu überschreiben. Jeder Config-Eintrag kann auch eine permission_policy festlegen, die steuert, ob die Aufrufe des Tools automatisch genehmigt werden oder eine Bestätigung erfordern. Siehe Berechtigungsrichtlinien für die verfügbaren Richtlinientypen.

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



Deaktivieren bestimmter Tools

Um ein Tool zu deaktivieren, setze enabled: false in seinem Config-Eintrag im Toolset-Objekt des tools-Arrays deines Agenten:

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



Aktivieren nur bestimmter Tools

Das default_config-Objekt legt die Basiskonfiguration für jedes Tool im Set fest, und tool-spezifische configs-Einträge überschreiben diese. Um mit allem deaktiviert zu starten und nur das zu aktivieren, was du brauchst, setze 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 den integrierten Tools kannst du benutzerdefinierte Tools definieren. Benutzerdefinierte Tools entsprechen den benutzerdefinierten Client-Tools in der Messages API.

Jedes benutzerdefinierte Tool definiert einen Vertrag: Du legst fest, welche Operationen verfügbar sind und was sie zurückgeben, und Claude bestimmt, wann und wie sie aufgerufen werden. Das Modell führt niemals selbst etwas aus. Es gibt eine strukturierte Anfrage aus, dein Code führt die Operation aus, und das Ergebnis fließt zurück in die Konversation. Siehe Session-Event-Stream, um zu erfahren, wie du benutzerdefinierte Tool-Aufrufe empfängst und Ergebnisse während einer Session zurückgibst.

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

Sobald du benutzerdefinierte Tools für den Agenten definiert hast, ruft der Agent sie während einer Session auf.



Best Practices für benutzerdefinierte Tool-Definitionen

• Stelle extrem detaillierte Beschreibungen bereit. Dies ist mit Abstand der wichtigste Faktor für die Tool-Performance. Deine Beschreibungen sollten erklären, was das Tool macht und wann es verwendet werden sollte (und wann nicht). Erkläre, was jeder Parameter bedeutet und wie er das Verhalten des Tools beeinflusst. Weise auf wichtige Vorbehalte oder Einschränkungen hin. Je mehr Kontext du Claude über deine Tools geben kannst, desto besser kann es bestimmen, wann und wie sie zu verwenden sind. Strebe drei bis vier Sätze für jede Tool-Beschreibung an, mehr, wenn das Tool komplex ist.
• Fasse verwandte Operationen in weniger Tools zusammen. Anstatt für jede Aktion ein separates Tool zu erstellen (create_pr, review_pr, merge_pr), gruppiere sie in einem einzigen Tool mit einem action-Parameter. Weniger, aber leistungsfähigere Tools reduzieren Mehrdeutigkeiten bei der Auswahl und machen es Claude leichter, sich in deiner Tool-Landschaft zurechtzufinden.
• Verwende aussagekräftiges Namespacing in Tool-Namen. Wenn deine Tools mehrere Dienste oder Ressourcen umfassen, stelle den Namen die Ressource als Präfix voran (zum Beispiel db_query oder storage_read). Dies macht die Tool-Auswahl eindeutig, wenn deine Bibliothek wächst.
• Gestalte Tool-Antworten so, dass sie nur relevante Informationen zurückgeben. Gib semantische, stabile Bezeichner zurück (zum Beispiel Slugs oder UUIDs) anstelle von undurchsichtigen internen Referenzen, und schließe nur die Felder ein, die Claude benötigt, um seinen nächsten Schritt zu bestimmen. Aufgeblähte Antworten verschwenden Kontext und erschweren es Claude, das Wesentliche zu extrahieren.



Nächste Schritte