Wenn Claude mit einer Tool-Nutzungsanfrage antwortet, muss dein Server das angeforderte Tool tatsächlich ausführen und die Ergebnisse zurücksenden. Dieser Schritt umfasst das Extrahieren der Tool-Nutzungs-Teile aus Claudes Antwort, das Ausführen der entsprechenden Funktionen und die korrekte Formatierung der Ergebnisse.
Umgang mit mehreren Tool-Anfragen
Claude kann mehrere Tool-Nutzungs-Teile in einer einzigen Antwort senden. Dein Code muss diese Möglichkeit defensiv behandeln. Eine Assistentennachricht kann einen Text-Teil enthalten, gefolgt von einem, zwei oder sogar noch mehr Tool-Nutzungs-Teilen.

Der Ablauf funktioniert folgendermaßen: Claude sendet eine Anfrage mit JSON-Schema, erhält einen Tool-Nutzungs-Teil, dann führt dein Server das Tool aus und sendet einen Tool-Ergebnis-Teil zurück, damit Claude eine endgültige Antwort liefern kann.

Extrahieren der Tool-Nutzungs-Teile
Erstelle zunächst eine Funktion, um alle aus einer Chat-Anfrage zurückgegebenen Teile zu verarbeiten:
def run_tools(parts):
tool_requests = [part for part in parts if "toolUse" in part]
tool_result_parts = []
for tool_request in tool_requests:
tool_use_id = tool_request["toolUse"]["toolUseId"]
tool_name = tool_request["toolUse"]["name"]
tool_input = tool_request["toolUse"]["input"]Diese Comprehension filtert die Liste der Teile so, dass nur Dictionaries enthalten sind, die einen „toolUse“-Schlüssel enthalten, und ignoriert dabei Text-Teile.
Ausführen der eigentlichen Tools
Erstelle eine Hilfsfunktion, um das angeforderte Tool auszuführen:
def run_tool(tool_name, tool_input):
if tool_name == "get_current_datetime":
return get_current_datetime(**tool_input)
else:
raise Exception(f"Unknown tool name: {tool_name}")Das entscheidende Detail hier ist die Verwendung von **tool_input, um das Dictionary der Argumente in deine Tool-Funktion zu splatten. Claude gibt Argumente immer als Dictionary-Objekt zurück, daher musst du es korrekt entpacken.
Erstellen von Tool-Ergebnis-Teilen
Nachdem du ein Tool ausgeführt hast, musst du die Antwort als Tool-Ergebnis-Teil formatieren:

Tool-Ergebnis-Teile erfordern drei Schlüsseleigenschaften:
- toolUseId - Muss mit der ID des ursprünglichen Tool-Nutzungs-Teils übereinstimmen
- content - Die Ausgabe deines Tools, als String serialisiert
- status - Entweder „success“ oder „error“
Tool-Nutzungs-IDs verstehen
Das System der Tool-Nutzungs-IDs wird wichtig, wenn Claude mehrere Tools parallel anfordert. Wenn Claude beispielsweise ein Taschenrechner-Tool zweimal ausführen möchte:

Jede Tool-Nutzung erhält eine eindeutige ID (wie „ab3“ und „po9“), und deine Tool-Ergebnisse müssen die passenden IDs enthalten, damit Claude weiß, welches Ergebnis zu welcher Anfrage gehört.
Fehlerbehandlung
Umschließe deine Tool-Ausführung mit try-catch-Blöcken. Claude geht intelligent mit Tool-Fehlern um und passt seinen Ansatz möglicherweise an, wenn du korrekte Fehlerinformationen zurückgibst:
try:
tool_output = run_tool(tool_name, tool_input)
tool_result_part = {
"toolResult": {
"toolUseId": tool_use_id,
"content": [{"text": json.dumps(tool_output)}],
"status": "success"
}
}
except Exception as e:
tool_result_part = {
"toolResult": {
"toolUseId": tool_use_id,
"content": [{"text": f"Error: {e}"}],
"status": "error"
}
}Vollständige Implementierung
Hier ist die vollständige Funktion, die Tool-Anfragen verarbeitet und formatierte Ergebnisse zurückgibt:
def run_tools(parts):
tool_requests = [part for part in parts if "toolUse" in part]
tool_result_parts = []
for tool_request in tool_requests:
tool_use_id = tool_request["toolUse"]["toolUseId"]
tool_name = tool_request["toolUse"]["name"]
tool_input = tool_request["toolUse"]["input"]
try:
tool_output = run_tool(tool_name, tool_input)
tool_result_part = {
"toolResult": {
"toolUseId": tool_use_id,
"content": [{"text": json.dumps(tool_output)}],
"status": "success"
}
}
except Exception as e:
tool_result_part = {
"toolResult": {
"toolUseId": tool_use_id,
"content": [{"text": f"Error: {e}"}],
"status": "error"
}
}
tool_result_parts.append(tool_result_part)
return tool_result_partsSobald du die Tool-Ergebnis-Teile hast, kannst du sie in deiner nächsten Chat-Anfrage an Claude zurücksenden und so den Tool-Nutzungs-Zyklus abschließen.