Handling message blocks

Studiennotizen: Werkzeugnutzung (Tool Use) mit Claude

• Tool-Schema: Um Claude über verfügbare Funktionen zu informieren, muss ein JSON-Schema (Tool Schema) im Request mitgesendet werden.
• Request-Struktur: Der Server sendet die Anfrage an Claude, wobei die Benutzerbotschaft und das Tool Schema (als Liste von Schemas unter dem Schlüssel tools) enthalten sind.
• Mehrblockige Nachricht (Multi-block Message): Wenn Claude ein Werkzeug nutzen möchte, erhält der Entwickler keine einfache Textantwort, sondern eine Nachricht mit mehreren Blöcken.
• Inhalt der Antwort: Die Antwort besteht typischerweise aus zwei Blöcken:
• Text Block: Enthält Text, der dem Benutzer angezeigt wird (z. B. eine Erklärung).
• Tool Use Block: Weist den Entwickler an, eine spezifische Funktion aufzurufen. Dieser Block listet den Funktionsnamen und die notwendigen Argument/Inputs auf.
• Entwickler-Rolle: Der Entwickler muss den Tool Use Block erkennen, die entsprechende Funktion ausführen und anschließend die Ergebnisse an Claude zurücksenden.
• Verlauf-Management: Claude speichert keine Gesprächshistorie. Der Entwickler muss den gesamten Verlauf manuell verwalten.
• Historie-Update: Um den Kontext zu erhalten, muss der gesamte Inhalt der Antwort von Claude (sowohl der Text Block als auch der Tool Use Block) in die Gesprächshistorie aufgenommen werden.
• Implementierung: Hilfsfunktionen (z. B. add user message, add assistant message) müssen angepasst werden, um Nachrichten mit mehreren Blöcken korrekt zu verarbeiten.

Takeaways

• Werkzeugnutzung erfordert das Senden eines JSON-Schemas (Tool Schema) im Request.
• Claude antwortet bei Tool-Nutzung mit einer Mehrblock-Nachricht, bestehend aus einem Text Block und einem Tool Use Block.
• Der Entwickler muss den Tool Use Block erkennen, die entsprechende Funktion ausführen und die Ergebnisse an Claude zurücksenden.
• Der gesamte Gesprächsverlauf muss manuell verwaltet und aktualisiert werden, da Claude keine Gesprächshistorie speichert.