Wird geladen

Tool-Ergebnisse senden

Lektion 267 Min.
Wird geladen

Nachdem Claude einen Tool-Aufruf angefordert hat, musst du die Funktion ausführen und die Ergebnisse zurücksenden. Dies vervollständigt den Tool-Nutzungs-Workflow, indem Claude die angeforderten Informationen zur Verfügung gestellt werden.

Die Tool-Funktion ausführen

Wenn Claude mit einem Tool-Use-Block antwortet, extrahierst du die Eingabeparameter und rufst deine Funktion auf. So greifst du auf die Tool-Parameter zu:

python
# Auf den Tool-Nutzung-Block zugreifen
tool_use_block = response.content[1]

# Die Eingabeparameter abrufen
input_params = tool_use_block.input

# Rufe deine Funktion mit den Parametern auf
result = get_current_datetime(**input_params)

Das doppelte Sternchen (**) entpackt das Dictionary in Keyword-Argumente, die deine Funktion erwartet.

Tool-Result-Block

Nachdem du das Tool ausgeführt hast, sendest du die Ergebnisse mithilfe eines Tool-Result-Blocks an Claude zurück. Dieser Block hat mehrere wichtige Eigenschaften:

Beispiel eines Tool-Result-JSON mit type „tool_result", content „12:47:13", is_error False und einer übereinstimmenden tool_use_id.

  • tool_use_id - Muss mit der ID aus dem ursprünglichen Tool-Use-Block übereinstimmen
  • content - Die Ausgabe deiner Tool-Funktion, in einen String umgewandelt
  • is_error - Wird auf true gesetzt, wenn während der Ausführung ein Fehler aufgetreten ist

Umgang mit mehreren Tool-Aufrufen

Claude kann mehrere Tool-Aufrufe in einer einzigen Antwort anfordern. Wenn ein Nutzer beispielsweise fragt „Was ist 10 + 10 und was ist 30 + 30?", könnte Claude zwei separate Tool-Use-Blöcke senden:

Claude sendet Taschenrechner-Tool-Use-Blöcke ab3 für 10 + 10 und po9 für 30 + 30; Ergebnisse kommen zurück als po9-Ausgabe 60, dann ab3-Ausgabe 20.

Jeder Tool-Use-Block erhält eine eindeutige ID, und du musst diese IDs beim Zurücksenden der Ergebnisse zuordnen:

Claude gibt Tool-Uses ab3 für 10 + 10 und po9 für 30 + 30 zurück; unser Server antwortet mit po9-Ausgabe 60, dann ab3-Ausgabe 20.

Dieses ID-System stellt sicher, dass Claude jedes Ergebnis korrekt der entsprechenden Anfrage zuordnen kann, selbst wenn die Ergebnisse in einer anderen Reihenfolge eintreffen.

Die Folgeanfrage senden

Deine Folgeanfrage an Claude muss den vollständigen Gesprächsverlauf sowie das neue Tool-Ergebnis enthalten:

python
messages.append({
    "role": "user",
    "content": [{
        "type": "tool_result",
        "tool_use_id": response.content[1].id,
        "content": result,
        "is_error": False
    }]
})

Der Gesprächsablauf sieht folgendermaßen aus:

Unser Server sendet Claude das Tool-Schema, die Frage „Wie spät ist es gerade?" sowie die Tool-Use- und Tool-Result-Blöcke.

Denk daran, das Tool-Schema in deine Folgeanfrage einzubeziehen, auch wenn Claude wahrscheinlich keine Tools erneut aufrufen muss. Claude benötigt das Schema, um die Tool-Referenzen im Gesprächsverlauf zu verstehen.

Vollständiger Workflow

Hier ist der vollständige Prozess:

  1. Der Nutzer stellt eine Frage, die Tool-Nutzung erfordert
  2. Claude antwortet mit einem Tool-Use-Block
  3. Du führst die angeforderte Tool-Funktion aus
  4. Du sendest eine Folgeanfrage mit dem Tool-Ergebnis
  5. Claude liefert eine endgültige Antwort unter Verwendung der Tool-Ausgabe

Die endgültige Anfrage enthält deinen vollständigen Nachrichtenverlauf, den Tool-Result-Block und das Tool-Schema. Claude antwortet dann mit einer regulären Textnachricht, die die Informationen aus deiner Tool-Ausführung einbezieht.