Sending tool results

📚 Lernnotizen: Tool-Nutzung und Tool-Ergebnisse (Tool Use & Tool Results)

⚙️ Schritt 4: Ausführung der Tool-Funktion

• Ziel: Die von Claude angeforderte Tool-Funktion ausführen.
• Zugriff auf Tool-Nutzung: Die Antwort von Claude enthält einen Tool-Use-Block. Dieser wird über den Pfad response content at one abgerufen.
• Argumentsextraktion: Die benötigten Eingaben (Argument) befinden sich im input-Feld des Tool-Use-Blocks.
• Funktionsaufruf: Da die Tool-Funktion oft Schlüsselwortargument (keyword argument) erwartet, muss das extrahierte Argument-Dictionary mit dem Operator ** übergeben werden (z. B. get_current_date_time(**input)).

🔄 Schritt 5: Rückmeldung an Claude (Follow-up Request)

• Zweck: Das Ergebnis der Tool-Ausführung an Claude zurückzugeben, damit es die finale Antwort generieren kann.
• Inhalt des Requests: Der Follow-up Request muss den gesamten Konversationsverlauf enthalten:
• Ursprüngliche Benutzer-Nachricht.
• Assistent-Nachricht mit dem Tool-Use-Block.
• Neue Benutzer-Nachricht mit dem Tool-Result-Block.
• Wichtig: Das ursprüngliche Tool-Schema muss in jedem Request mit Tool-Nutzung mitgesendet werden, damit Claude die verfügbaren Funktionen kennt.

🛠️ Der Tool-Result-Block

• Definition: Ein spezieller Block, der innerhalb einer Benutzer-Nachricht platziert wird, um das Ergebnis der Tool-Ausführung an Claude zu übermitteln.
• Schlüssel-Eigenschaften:
• tool use ID: **Der wichtigste Schlüssel. ** Er verknüpft das Tool-Ergebnis eindeutig mit der ursprünglichen Tool-Nutzungsanfrage von Claude.
• Beispiel: Wenn Claude zwei Tool-Aufrufe macht (ID AB3 und ID PO9), müssen die beiden Tool-Result-Blöcke diese IDs exakt widerspiegeln.
• content: Der tatsächliche Output der Tool-Funktion (muss üblicherweise in einen String/JSON umgewandelt werden).
• is_error: Optional. Setzt auf WAHR, wenn die Tool-Funktion fehlschlägt (Standard ist FALSCH).

💡 Zusammenfassung des Prozesses

• Benutzer → Claude (Text-Nachricht).
• Claude → Assistent (Text-Block + Tool-Use-Block).
• Server → Führt Tool aus.
• Server → Claude (Vollständiger Verlauf + Benutzer-Nachricht mit Tool-Result-Block).
• Claude → Assistent (Finale Text-Antwort).

Takeaways

• Die Argumentsextraktion erfolgt aus dem input-Feld des Tool-Use-Blocks; Schlüsselwortargument müssen mit dem Operator ** übergeben werden.
• Das Tool-Ergebnis wird in einem speziellen Tool-Result-Block an Claude zurückgespielt, wobei der gesamte Konversationsverlauf mitgesendet werden muss.
• Der tool use ID ist der wichtigste Schlüssel, da er das Tool-Ergebnis eindeutig mit der ursprünglichen Tool-Nutzungsanfrage verknüpft.
• Das ursprüngliche Tool-Schema muss in jedem Request mit Tool-Nutzung mitgesendet werden, damit Claude die verfügbaren Funktionen kennt.