Tool-Referenz

Diese Seite ist eine Referenz für die Tools, die Anthropic bereitstellt, und die optionalen Eigenschaften, die Sie für jede Tool-Definition festlegen können. Eine konzeptionelle Einführung in die Tool-Nutzung finden Sie unter Tool use with Claude. Anleitungen zur Implementierung der Tool-Nutzung in Ihrer Anwendung finden Sie unter Define tools.

Von Anthropic bereitgestellte Tools

Anthropic stellt zwei Arten von Tools bereit: Server-Tools, die auf der Infrastruktur von Anthropic ausgeführt werden, und Client-Tools, bei denen Anthropic das Schema definiert, aber Ihre Anwendung die Ausführung übernimmt. Beide Arten erscheinen im tools-Array Ihrer Anfrage neben benutzerdefinierten Tools.

Für die Modellkompatibilität siehe die Seite des jeweiligen Tools. Unterstützte Modelle variieren je nach Tool und Tool-Version.

Tool-Versionierung

Die meisten von Anthropic bereitgestellten Tools tragen ein _YYYYMMDD-Suffix im type-String. Eine neue Version wird veröffentlicht, wenn sich das Verhalten, das Schema oder die Modellunterstützung des Tools ändert. Ältere Versionen bleiben verfügbar, damit bestehende Integrationen weiterhin funktionieren.

Wenn ein Tool mehrere aktive Versionen hat, variiert die Beziehung zwischen ihnen:

• Capability-keyed: web_search_20260209 und web_fetch_20260209 fügen dynamische Inhaltsfilterung über ihre Vorgänger hinzu. code_execution_20260120 fügt programmatic tool calling aus der Sandbox hinzu. In jedem Fall sind sowohl die neue als auch die alte Version aktuell; welche Sie verwenden, hängt davon ab, ob Sie die neue Funktionalität benötigen.
• Model-keyed: text_editor_20250728 ist für Claude 4-Modelle und text_editor_20250124 ist für frühere Modelle. Die Version, die Sie verwenden, hängt vom Modell ab, das Sie anvisieren.
• Variante, keine Version: tool_search_tool_regex_20251119 und tool_search_tool_bm25_20251119 sind zwei Suchalgorithmen, die zusammen veröffentlicht wurden. Keiner ersetzt den anderen.
• Legacy: code_execution_20250522 unterstützt nur Python. code_execution_20250825 fügt Bash und Dateivorgänge hinzu.

Der mcp_toolset-Typ ist nicht datumsversioniert; die Versionierung wird stattdessen im anthropic-beta-Header durchgeführt.

Tool-Definitionseigenschaften

Jedes Tool im tools-Array, einschließlich benutzerdefinierter Tools, akzeptiert optionale Eigenschaften, die steuern, wie das Tool geladen wird, wer es aufrufen kann und wie seine Eingaben validiert werden. Diese Eigenschaften setzen sich zusammen: Sie können defer_loading und cache_control und strict auf demselben Tool festlegen.

allowed_callers-Werte

allowed_callers ist ein Array, das jede Kombination der folgenden Werte akzeptiert:

Das Weglassen von "direct" aus dem Array (z. B. "allowed_callers": ["code_execution_20260120"]) bedeutet, dass das Tool nur von innerhalb der Code-Ausführung aufgerufen werden kann. Der tool_use-Block der Antwort enthält ein caller-Feld, das angibt, welcher Aufrufer das Tool aufgerufen hat. Siehe Programmatic tool calling für die vollständige Behandlung, einschließlich der caller-Antwortform und des Fehlerverhaltens.

defer_loading und Prompt-Caching

Tools mit defer_loading: true werden aus dem gerenderten Tools-Bereich entfernt, bevor der Cache-Schlüssel berechnet wird. Sie erscheinen überhaupt nicht im System-Prompt-Präfix. Wenn die Tool-Suche ein aufgeschobenes Tool entdeckt und eine tool_reference dafür zurückgibt, wird die vollständige Definition des Tools an dieser Stelle im Gesprächstext inline erweitert, nicht im Präfix.

Dies bedeutet, dass defer_loading: true Ihren Prompt-Cache bewahrt. Sie können aufgeschobene Tools zu einer Anfrage hinzufügen, ohne einen vorhandenen Cache-Eintrag zu invalidieren, und der Cache bleibt gültig über den Zug hinweg, in dem das Tool entdeckt wird, und den Zug, in dem es aufgerufen wird.

Wie Sie defer_loading mit cache_control-Breakpoints kombinieren, finden Sie in der Tool search tool prompt caching guidance.