Tool-Aufrufe verarbeiten

Diese Seite behandelt den Tool-Call-Lebenszyklus: Lesen von tool_use-Blöcken aus Claudes Antwort, Formatieren von tool_result-Blöcken in Ihrer Antwort und Signalisieren von Fehlern. Für die SDK-Abstraktion, die dies automatisch verarbeitet, siehe Tool Runner.

Claudes Antwort unterscheidet sich je nachdem, ob ein Client- oder Server-Tool verwendet wird.

Verarbeitung von Ergebnissen von Client-Tools

Die Antwort hat einen stop_reason von tool_use und einen oder mehrere tool_use-Inhaltsblöcke, die Folgendes enthalten:

• id: Ein eindeutiger Bezeichner für diesen bestimmten Tool-Use-Block. Dies wird später verwendet, um die Tool-Ergebnisse abzugleichen.
• name: Der Name des verwendeten Tools.
• input: Ein Objekt, das die an das Tool übergebene Eingabe enthält und dem input_schema des Tools entspricht.

Wenn Sie eine Tool-Use-Antwort für ein Client-Tool erhalten, sollten Sie:

1. Extrahieren Sie name, id und input aus dem tool_use-Block.
2. Führen Sie das tatsächliche Tool in Ihrer Codebasis aus, das diesem Tool-Namen entspricht, und übergeben Sie die Tool-input.
3. Setzen Sie das Gespräch fort, indem Sie eine neue Nachricht mit der role von user und einem content-Block mit dem tool_result-Typ und den folgenden Informationen senden:
   • tool_use_id: Die id der Tool-Use-Anfrage, für die dies ein Ergebnis ist.
   • content: Das Ergebnis des Tools als Zeichenkette (z. B. ), eine Liste verschachtelter Inhaltsblöcke (z. B. ) oder eine Liste von Dokumentblöcken (z. B. ). Diese Inhaltsblöcke können die Typen , oder verwenden.

{
  "role": "user",
  "content": [
    { "type": "text", "text": "Here are the results:" }, // ❌ Text vor tool_result
    { "type": "tool_result", "tool_use_id": "toolu_01" /* ... */ }
  ]
}

Nach Erhalt des Tool-Ergebnisses wird Claude diese Informationen verwenden, um eine Antwort auf die ursprüngliche Benutzereingabe zu generieren.

Verarbeitung von Ergebnissen von Server-Tools

Claude führt das Tool intern aus und integriert die Ergebnisse direkt in seine Antwort, ohne dass zusätzliche Benutzerinteraktion erforderlich ist.

Fehlerbehandlung mit is_error

Es gibt verschiedene Arten von Fehlern, die bei der Verwendung von Tools mit Claude auftreten können:

Nächste Schritte

• Für die Ausführung mehrerer Tools in einer Runde siehe Parallel tool use.
• Für die SDK-Abstraktion, die diese Schleife automatisiert, siehe Tool Runner.
• Für den vollständigen Tool-Use-Workflow siehe Define tools.