Tool-Aufrufe verarbeiten

Diese Seite behandelt den Lebenszyklus eines Tool-Aufrufs: das Auslesen von tool_use-Blöcken aus Claudes Antwort, das Formatieren von tool_result-Blöcken in deiner Antwort und das Signalisieren von Fehlern. Für die SDK-Abstraktion, die dies automatisch übernimmt, siehe Tool Runner.

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



Ergebnisse von Client-Tools verarbeiten

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

• id: Ein eindeutiger Bezeichner für diesen speziellen Tool-Use-Block. Dieser wird später verwendet, um die Tool-Ergebnisse zuzuordnen.
• 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 du eine Tool-Use-Antwort für ein Client-Tool erhältst, solltest du:

1. name, id und input aus dem tool_use-Block extrahieren.
2. Das tatsächliche Tool in deiner Codebasis ausführen, das diesem Tool-Namen entspricht, und dabei das Tool-input übergeben.
3. Die Konversation fortsetzen, indem du eine neue Nachricht mit der role user sendest, die einen content-Block mit dem Typ tool_result und den folgenden Informationen enthält:
   • tool_use_id: Die id der Tool-Use-Anfrage, für die dies ein Ergebnis ist.
   • content (optional): Das Ergebnis des Tools, als String (zum Beispiel "content": "15 degrees"), als Liste verschachtelter Content-Blöcke (zum Beispiel "content": [{"type": "text", "text": "15 degrees"}]) oder als Liste von Document-Blöcken (zum Beispiel "content": [{"type": "document", "source": {"type": "text", "media_type": "text/plain", "data": "15 degrees"}}]). Diese Content-Blöcke können die Typen text, image, document oder search_result verwenden.
   • is_error (optional): Auf true setzen, wenn die Tool-Ausführung zu einem Fehler geführt hat.

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

{
  "role": "user",
  "content": [
    { "type": "tool_result", "tool_use_id": "toolu_01" /* ... */ },
    { "type": "text", "text": "What should I do next?" } // ✅ Text after tool_result
  ]
}

Nach Erhalt des Tool-Ergebnisses verwendet Claude diese Informationen, um weiterhin eine Antwort auf den ursprünglichen User-Prompt zu generieren.



Ergebnisse von Server-Tools verarbeiten

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



Fehler mit is_error behandeln

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



Nächste Schritte