Wird geladen

Umgang mit Antworten zur Tool-Nutzung

Lektion 247 Min.
Wird geladen

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:

Drei toolChoice-Einstellungen als JSON geschrieben, "auto", "any" und "tool" mit einem Namen, zusammen mit den unten aufgeführten Verhaltensweisen.

  • 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:

Liste der Assistant-Nachrichteninhalte: ein "Text"-Teil und ein "toolUse"-Teil, der get_current_datetime mit date_format %H:%M:%S aufruft.

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:

Beispiel eines ToolUse-Teils, der das Tool "get_current_datetime" mit Input date_format "%H:%M:%S" sowie eine toolUseId benennt.

  • 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:

Unser Server sendet Claude den gesamten Verlauf: User "What time is it?", Assistant-Text und ToolUse-Teil, User ToolResult-Teil.

Wenn du eine Tool-Nutzungsanfrage erhältst, musst du:

  1. Die Tool-Informationen aus dem ToolUse-Teil extrahieren
  2. Deine tatsächliche Tool-Funktion ausführen
  3. Eine ToolResult-Nachricht zusammen mit dem vollständigen Konversationsverlauf zurücksenden
  4. 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:

python
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:

python
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.