Claude Platform Docs
Managed AgentsIhren Agenten definieren

Tools

Konfiguriere die Tools, die deinem Agenten zur Verfügung stehen.

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

Claude Managed Agents unterstützt außerdem 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 bereitzustellen, verwende stattdessen den MCP-Connector.

Verfügbare Tools

Das Agent-Toolset umfasst die folgenden Tools. Alle sind standardmäßig aktiviert, wenn du das Toolset in die Agentenkonfiguration aufnimmst.

ToolNameBeschreibung
BashbashBash-Befehle in einer Shell-Session ausführen
ReadreadEine Datei aus dem Sandbox-Dateisystem lesen
WritewriteEine Datei in das Sandbox-Dateisystem schreiben
EditeditZeichenkettenersetzung in einer Datei durchführen
GlobglobSchnellen Dateimusterabgleich mit Glob-Mustern durchführen
GrepgrepText mit Regex-Mustern durchsuchen
Web-Fetchweb_fetchInhalte von einer URL abrufen
Websucheweb_searchDas Web nach Informationen durchsuchen

Wenn eine Tool-Ausgabe 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.

Das Toolset konfigurieren

Aktiviere das vollständige Toolset mit agent_toolset_20260401, wenn du einen Agenten erstellst. Verwende das Array configs, um bestimmte Tools zu deaktivieren oder ihre Einstellungen zu überschreiben. Jeder Eintrag wird durch seinen name identifiziert, der einen Wert aus der Spalte „Name“ in Verfügbare Tools annimmt. Ein Eintrag akzeptiert außerdem ein optionales Feld type mit demselben Wert.

Jeder Konfigurationseintrag kann außerdem eine permission_policy festlegen. Die Richtlinie steuert, ob die Aufrufe des Tools ohne Bestätigung ausgeführt werden, eine Bestätigung erfordern oder an den Server gehen, der jeden Aufruf auswertet. Unter Berechtigungsrichtlinien findest du die verfügbaren Richtlinientypen.

Das folgende Beispiel aktiviert das Toolset und deaktiviert web_fetch:

ant apply agent.md
agent.md
---
name: Coding Assistant
model: claude-opus-5-5
tools:
  - type: agent_toolset_20260401
    configs:
      - name: web_fetch
        enabled: false
---

Bestimmte Tools deaktivieren

Um ein Tool zu deaktivieren, setze enabled: false in seinem configs-Eintrag:

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

Nur bestimmte Tools aktivieren

Das Objekt default_config legt die Grundeinstellung für jedes Tool im Set fest, und Einträge in configs pro Tool überschreiben sie. Um mit allem deaktiviert zu beginnen 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 }
  ]
}

Websuche und Web-Fetch einschränken

Die Einträge web_search und web_fetch akzeptieren außerdem Domainlisten, eine Obergrenze für abgerufene Inhalte und einen Suchstandort. Siehe Domains für Websuche und Web-Fetch einschränken.

Typen von Konfigurationseinträgen in den SDKs

Die SDKs typisieren jeden configs-Eintrag nach Tool. Der Typ ist eine Union mit einem Member für jedes integrierte Tool, unterschieden durch type.

In Go, Java, C# und PHP erstellst du Einträge aus typisierten Werten statt aus einfachen Dictionaries oder Hashes. In diesen SDKs ist der Elementtyp von configs die Union selbst, erstelle also jeden Eintrag aus seinem toolspezifischen Member-Typ.

Du kannst type beim Erstellen eines Eintrags weglassen, da der Server ihn aus name ableitet. Antworten enthalten ihn immer. Diese Typisierung ändert nicht das JSON, zu dem ein Eintrag serialisiert wird. Eine Anfrage, deren Einträge nur name, enabled und permission_policy festlegen, ist mit oder ohne type gültig.

Benutzerdefinierte Tools

Benutzerdefinierte Tools entsprechen den benutzerdefinierten Client-Tools in der Messages API. Du legst fest, welche Operationen verfügbar sind und was sie zurückgeben, und Claude entscheidet, wann und wie sie aufgerufen werden.

Claude führt ein benutzerdefiniertes Tool nicht selbst aus. Es gibt eine strukturierte Anfrage aus, dein Code führt die Operation aus, und du gibst das Ergebnis an die Session zurück.

Das folgende Beispiel erstellt einen Agenten mit einem benutzerdefinierten Tool, get_weather, und ohne integrierte Tools:

ant apply agent.md
agent.md
---
name: Weather Agent
model: claude-opus-5-5
tools:
  - 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
---

Neue Namen benutzerdefinierter Tools dürfen nicht mit mcp__ oder ant__ beginnen oder mit dem Namen eines integrierten Agenten-Tools übereinstimmen. Eine Anfrage, die gegen diese Regel verstößt, gibt einen 400-Fehler zurück. Ein bestehendes benutzerdefiniertes Tool kann jedoch mit ant__ beginnen. Ein Agent mit einem solchen Tool akzeptiert ein Update nur, wenn das Update tools ohne diesen Namen sendet. Benenne das Tool also in deinem nächsten Update um oder entferne es. Eine neue Session wird mit einem 400-Fehler abgelehnt, wenn sich ein solches Tool auf ihrem Agenten befindet (nach allen Überschreibungen), auf einem Agenten in der Liste predefined_agents von subagents oder auf einem Agenten in der Liste predefined_agents von workflows. Bereits bestehende Sessions sind nicht betroffen.

Der Agent ruft seine benutzerdefinierten Tools während einer Session auf. Wie du die Aufrufe empfängst und Ergebnisse zurückgibst, erfährst du unter Tool-Aufrufe beantworten, die die Session pausieren.

Für Sessions, die in einer selbst gehosteten Sandbox laufen, kann der Environment-Worker benutzerdefinierte Tools aus der Sandbox bereitstellen. Dazu können Tools gehören, die einen MCP-Server innerhalb deines Netzwerks kapseln.

Best Practices für Definitionen benutzerdefinierter Tools

  • Liefere äußerst detaillierte Beschreibungen. Dies ist mit Abstand der wichtigste Faktor für die Tool-Leistung. Je mehr Kontext du Claude zu deinen Tools gibst, desto besser kann es bestimmen, wann und wie es sie verwenden soll. Strebe drei bis vier Sätze pro Tool-Beschreibung an, mehr, wenn das Tool komplex ist. Deine Beschreibungen sollten Folgendes abdecken:
    • Was das Tool tut
    • Wann es verwendet werden soll und wann nicht
    • Was jeder Parameter bedeutet und wie er das Verhalten des Tools beeinflusst
    • Alle wichtigen Vorbehalte oder Einschränkungen
  • Fasse zusammengehörige Operationen in weniger Tools zusammen. Gruppiere Aktionen wie create_pr, review_pr und merge_pr in einem einzigen Tool mit einem action-Parameter. Weniger, dafür leistungsfähigere Tools verringern Mehrdeutigkeiten bei der Auswahl und machen deine Tool-Oberfläche für Claude leichter navigierbar.
  • Verwende aussagekräftige Namespaces in Tool-Namen. Wenn sich deine Tools über mehrere Dienste oder Ressourcen erstrecken, stelle den Namen die Ressource voran (zum Beispiel db_query oder storage_read). So bleibt die Tool-Auswahl eindeutig, wenn deine Bibliothek wächst.
  • Gestalte Tool-Antworten so, dass sie nur aussagekräftige Informationen zurückgeben. Gib semantische, stabile Bezeichner zurück (zum Beispiel Slugs oder UUIDs) statt undurchsichtiger interner Referenzen. Füge nur die Felder hinzu, 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

Steuere, welche Websites die Web-Tools erreichen können, begrenze abgerufene Inhalte und lokalisiere Suchergebnisse.

Verbinde MCP-Server mit deinen Agenten, um auf externe Tools und Datenquellen zuzugreifen.

Steuere, wann Agenten- und MCP-Tools ausgeführt werden.

Sende Events, streame Antworten und unterbrich oder lenke deine Session um, während sie läuft.

Verfügbarkeit

Agent-Toolset
Die Verfügbarkeitsanforderungen für Agent-Toolset sind auf allen unterstützten Plattformen gleich.
Status
Beta
API
  • Managed Agents
Beta-Header
Erfordert
Modelle
  • Alle Modelle

Zutreffende Endpunkte

  • /v1/agents
  • /v1/sessions
  • /v1/environments
Zero Data RetentionNicht berechtigt

Nicht für ZDR berechtigt, außer bei selbst gehosteten Managed Agents. Sitzungen sind zustandsbehaftete Ressourcen; Transkripte bleiben erhalten, bis du sie löschst. Mehr erfahren

HIPAANicht berechtigt

Nicht für HIPAA berechtigt. Gilt für alle Unterfunktionen von Managed Agents.

War diese Seite hilfreich?