Handling tool use responses

📝 Lernnotizen: Tool-Nutzung und Konversation mit Claude

🛠️ Tools in der API-Anfrage

• Implementierung: Die JSON Schema Spezifikation für die Tools wird als Keyword-Argument tools in die Chat-Funktion übergeben.
• Zweck: Dies beschreibt dem Modell, welche Funktionen es zur Beantwortung von Anfragen nutzen kann.

⚙️ Tool-Auswahl (tool_choice)

Die Option tool_choice (ein verschachteltes Dictionary) steuert, wie das Modell die Tools verwendet:

• auto (Standard): Claude entscheidet selbst, ob und welches Tool verwendet werden soll.
• any (String): Claude wird gezwungen, ein Tool zu verwenden (welches es wählt).
• tool_name (String): Claude wird gezwungen, ein spezifisches Tool mit dem angegebenen Namen zu verwenden.

🤖 Antwortstruktur bei Tool-Nutzung

Wenn Claude ein Tool verwenden möchte, ändert sich die Struktur der Antwort:

• stop_reason: Zeigt den Grund an, warum das Modell die Ausgabe beendet hat. Bei Tool-Nutzung lautet dieser Wert: tool_use.
• assistant Nachricht: Enthält nun eine Liste von Inhalten (content), die mehrere Teile (parts) haben kann:
• text Part: Text, den das Modell dem Benutzer zur Hilfe liefert (z. B. "Ich kann die aktuelle Zeit für Sie abrufen. ").
• tool_use Part: Ein Objekt, das die Anweisung an den Entwickler ist, ein Tool auszuführen.

Takeaways

• Tools werden über das Keyword-Argument tools (JSON Schema) in die Chat-Funktion implementiert.
• Die Option tool_choice steuert die Tool-Nutzung: auto (Standard), any (muss ein Tool nutzen) oder ein spezifischer tool_name.
• Wenn ein Tool verwendet wird, ändert sich die Antwortstruktur; der stop_reason ist dann tool_use.
• Die assistant Nachricht enthält bei Tool-Nutzung Teile (parts), die entweder Text oder die Anweisung zur Tool-Ausführung (tool_use) sind.