Wird geladen
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 bereitgestellt 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
response.content[1].input

Dies gibt dir ein Dictionary der Argumente, die Claude an deine Funktion übergeben möchte. Da deine Funktion Keyword-Argumente und kein Dictionary erwartet, verwendest du die Unpacking-Syntax von Python:

python
get_current_datetime(**response.content[1].input)

Notebook-Zelle, die den oben gezeigten Unpacking-Aufruf ausführt und die Zeitangabe „14:41:05“ zurückgibt.

Tool-Ergebnis-Block

Nachdem du die Tool-Funktion ausgeführt hast, musst du die Ergebnisse mithilfe eines Tool-Result-Blocks an Claude zurücksenden. Dieser Block befindet sich innerhalb einer Benutzernachricht und teilt Claude mit, was beim Ausführen des Tools passiert ist.

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

Der Tool-Result-Block hat mehrere wichtige Eigenschaften:

  • tool_use_id - Muss mit der ID des ToolUse-Blocks übereinstimmen, zu dem dieses ToolResult gehört
  • content - Ausgabe der Ausführung deines Tools, serialisiert als String
  • is_error - True, wenn ein Fehler aufgetreten ist

Umgang mit mehreren Tool-Aufrufen

Claude kann in einer einzigen Antwort mehrere Tool-Aufrufe anfordern. Wenn ein Benutzer beispielsweise fragt „Was ist 10 + 10 und was ist 30 + 30?“, könnte Claude mit zwei separaten ToolUse-Blöcken antworten.

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

Jeder Tool-Aufruf erhält eine eindeutige ID, und du musst diese IDs beim Zurücksenden der Ergebnisse abgleichen. Dies stellt sicher, dass Claude weiß, welches Ergebnis zu welcher Anfrage gehört, selbst wenn die Ergebnisse in einer anderen Reihenfolge eintreffen.

Claude gibt die 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.

Die Folgeanfrage erstellen

Deine Folgeanfrage an Claude muss den vollständigen Gesprächsverlauf sowie das neue Tool-Ergebnis enthalten. Hier ist die Struktur:

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

Der vollständige Nachrichtenverlauf enthält nun:

  • Ursprüngliche Benutzernachricht
  • Assistant-Nachricht mit Tool-Use-Block
  • Benutzernachricht mit Tool-Result-Block

Die abschließende Anfrage stellen

Beim Senden der Folgeanfrage musst du weiterhin das Tool-Schema einbeziehen, auch wenn du nicht erwartest, dass Claude einen weiteren Tool-Aufruf tätigt. Claude benötigt das Schema, um die Tool-Referenzen in deinem Gesprächsverlauf zu verstehen.

python
client.messages.create(
    model=model,
    max_tokens=1000,
    messages=messages,
    tools=[get_current_datetime_schema]
)

Unser Server sendet Claude das Tool-Schema, die Frage „Wie spät ist es gerade?“, den Tool-Use- und den Tool-Result-Block.

Claude antwortet dann mit einer endgültigen Nachricht, die die Tool-Ergebnisse in eine natürliche Antwort für den Benutzer integriert. Der Tool-Nutzungs-Workflow ist nun abgeschlossen - du hast Claude erfolgreich ermöglicht, über deine eigene Funktion auf Echtzeitinformationen zuzugreifen.