Wenn Claude entscheidet, ein Tool zu verwenden, gibt es eine spezielle Antwortstruktur zurück, die sorgfältig behandelt werden muss. Das Verständnis dieses Antwortformats und die Implementierung eines ordnungsgemäßen Konversationsmanagements sind entscheidend für den Aufbau robuster tool-fähiger Anwendungen.
Konfiguration der Tool-Auswahl
Bevor wir uns mit Antworten befassen, lohnt es sich zu verstehen, wie man steuern kann, wann Claude Tools verwendet. Der Parameter toolChoice bietet dir drei Optionen:

- auto - Claude entscheidet, ob ein Tool verwendet wird (Standardverhalten)
- any - Claude muss ein Tool verwenden, kann aber wählen, welches
- specific tool - Zwingt Claude, ein bestimmtes Tool namentlich zu verwenden
Die dritte Option ist besonders nützlich zum Testen, wenn du sicherstellen möchtest, dass Claude eine bestimmte Funktion aufruft.
Mehrteilige Nachrichtenstruktur
Wenn Claude ein Tool verwenden möchte, gibt es eine Assistant-Nachricht mit mehreren Inhaltsteilen zurück, anstatt nur Text:

Die Antwort enthält zwei Teile:
- Text-Teil - Menschenlesbare Erklärung wie „Ich kann dir helfen, die aktuelle Uhrzeit herauszufinden. Lass mich diese Information für dich finden"
- ToolUse-Teil - Strukturierte Daten, die dir mitteilen, welches Tool mit welchen Argumenten ausgeführt werden soll
Den ToolUse-Teil verstehen
Der ToolUse-Teil enthält drei wichtige Informationen:

- toolUseId - Eine eindeutige Kennung, die du benötigst, wenn du das Tool-Ergebnis zurücksendest
- name - Der genaue Tool-Name aus deinem JSON-Schema, den Claude aufrufen möchte
- input - Ein Dictionary von Argumenten, die Claude an deine Tool-Funktion übergeben möchte
Konversationsablauf mit Tools
Die Tool-Nutzung folgt einem bestimmten Konversationsmuster, das erfordert, den vollständigen Nachrichtenverlauf beizubehalten:

Wenn du eine Tool-Nutzungsanfrage erhältst, musst du:
- Die Tool-Informationen aus dem ToolUse-Teil extrahieren
- Deine tatsächliche Tool-Funktion ausführen
- Eine ToolResult-Nachricht zusammen mit dem vollständigen Konversationsverlauf zurücksenden
- Die ursprüngliche User-Nachricht und die Tool-Nutzungsnachricht des Assistant in deine nächste Anfrage einbeziehen
Aktualisieren von Hilfsfunktionen
Um mehrteilige Nachrichten richtig zu behandeln, musst du deine Funktionen zur Nachrichtenverarbeitung aktualisieren. Hier erfährst du, wie du deine Funktionen flexibel genug gestaltest, um sowohl einfachen Text als auch komplexe mehrteilige Inhalte zu verarbeiten:
def add_user_message(messages, content):
if isinstance(content, str):
user_message = {"role": "user", "content": [{"text": content}]}
else:
user_message = {"role": "user", "content": content}
messages.append(user_message)
def add_assistant_message(messages, content):
if isinstance(content, str):
assistant_message = {"role": "assistant", "content": [{"text": content}]}
else:
assistant_message = {"role": "assistant", "content": content}
messages.append(assistant_message)Du möchtest außerdem deine Chat-Funktion aktualisieren, damit sie sowohl den Text als auch die vollständige Liste der Teile zurückgibt:
def chat(messages, system=None, temperature=1.0, stop_sequences=[], tools=None):
# ... vorhandener Setup-Code ...
response = client.converse(**params)
text = response["output"]["message"]["content"][0]["text"]
parts = response["output"]["message"]["content"]
return text, partsÜberprüfen des Stop-Grunds
Claudes Antwort enthält auch ein übergeordnetes Feld stopReason. Wenn es gleich "tool_use" ist, möchte Claude ein Tool aufrufen, anstatt nur eine Textantwort zu liefern — das ist dein Signal, die Tool-Informationen zu extrahieren und die angeforderte Funktion auszuführen. Der oben beschriebene chat()-Helfer gibt dieses Feld noch nicht aus, daher kannst du vorerst die Tool-Nutzung erkennen, indem du die zurückgegebene Liste der Teile auf einen Eintrag mit einem toolUse-Schlüssel überprüfst. Du wirst chat() in einer späteren Lektion so erweitern, dass es stopReason direkt zurückgibt.
Mit diesen Mustern bist du bereit, Claudes Tool-Nutzungsanfragen zu bearbeiten und während mehrfacher Interaktionen mit Tools einen ordnungsgemäßen Konversationsablauf aufrechtzuerhalten.