Tools

Claude Managed Agents stellt eine Reihe integrierter Tools bereit, die Claude autonom innerhalb einer Session verwenden kann. Du steuerst, welche Tools verfügbar sind, indem du sie in der Agenten-Konfiguration 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, das sie verwendet, um die Aufgabe fortzusetzen. Um dem Agenten Tools von einem MCP-Server zur Verfügung zu stellen, 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 Agenten-Konfiguration aufnimmst. Verwende die Werte in der Spalte „Name", um Tools im configs-Array zu referenzieren.

Wenn die Ausgabe eines Tools 100.000 Zeichen (etwa 25.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, wenn du einen Agenten erstellst. 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-5
tools:
  - type: agent_toolset_20260401
    configs:
      - name: web_fetch
        enabled: false
YAML



Bestimmte Tools deaktivieren

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 }
  ]
}



Nur bestimmte Tools aktivieren

Das default_config-Objekt legt die Grundeinstellung für jedes Tool im Set fest, und die configs-Einträge pro Tool überschreiben sie. 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 sind analog zu benutzerdefinierten Client-Tools in der Messages API.

Jedes benutzerdefinierte Tool definiert einen Vertrag: Du gibst an, 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 Aufrufe benutzerdefinierter Tools empfängst und Ergebnisse während einer Session zurückgibst.

Wenn deine Sessions in einer selbst gehosteten Sandbox laufen, kann der Environment-Worker benutzerdefinierte Tools aus deiner Sandbox bereitstellen, einschließlich Tools, die einen MCP-Server innerhalb deines Netzwerks kapseln.

ant beta:agents create <<'YAML'
name: Weather Agent
model: claude-opus-5
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 Definitionen benutzerdefinierter Tools

• Liefere extrem detaillierte Beschreibungen. Dies ist mit Abstand der wichtigste Faktor für die Tool-Performance. Deine Beschreibungen sollten erklären, was das Tool tut und wann es verwendet werden soll (und wann nicht). Erkläre, was jeder Parameter bedeutet und wie er das Verhalten des Tools beeinflusst. Weise auf wichtige Einschränkungen oder Limitierungen hin. Je mehr Kontext du Claude über deine Tools geben kannst, desto besser kann es bestimmen, wann und wie sie verwendet werden. Strebe drei bis vier Sätze pro 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 deine Tool-Oberfläche für Claude leichter navigierbar.
• Verwende aussagekräftige Namespaces in Tool-Namen. Wenn deine Tools mehrere Dienste oder Ressourcen umfassen, stelle den Namen die Ressource voran (zum Beispiel db_query oder storage_read). Das macht die Tool-Auswahl eindeutig, wenn deine Bibliothek wächst.
• Gestalte Tool-Antworten so, dass sie nur Informationen mit hohem Signalwert zurückgeben. Gib semantische, stabile Bezeichner zurück (zum Beispiel Slugs oder UUIDs) statt undurchsichtiger interner Referenzen, und nimm nur die Felder auf, 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