Handling message blocks

📝 Lernnotizen: Tool Use und Multi-Block-Nachrichten

**1. Tool Schema und API-Anfrage**

• Um Claude über verfügbare Funktionen zu informieren, wird ein Tool Schema (JSON Schema) in die API-Anfrage aufgenommen.
• Dieses Schema wird über das Schlüsselwort tools als Liste von Spezifikationen übergeben.

**2. Struktur der Antwort (Multi-Block-Nachricht)**

• Wenn Claude ein Tool nutzen möchte, ändert sich die Struktur der Antwort. Die Nachricht enthält nicht mehr nur einen Textblock.
• Die Nachricht besteht aus einer Liste von Inhaltsblöcken (content list).
• Text Block: Enthält den Text, der dem Benutzer angezeigt wird (z. B. eine Einleitung zur Suche nach der Zeit).
• Tool Use Block: Ist eine Anweisung an den Entwickler. Er listet:
• Den Namen der Funktion, die aufgerufen werden soll (z. B. get_current_data).
• Die notwendigen Argumente (Inputs) für diese Funktion.

**3. Verwaltung der Gesprächshistorie**

• Wichtig: Claude speichert keine Gesprächshistorie. Diese muss vom Entwickler manuell verwaltet werden.
• Historie aktualisieren: Nach Erhalt der Antwort von Claude (die den Text Block und den Tool Use Block enthält), muss diese gesamte Antwort als neue Assistant-Nachricht zur Nachrichtenliste hinzugefügt werden.
• Dies stellt sicher, dass die Historie korrekt aufgebaut ist, bevor die Funktion tatsächlich ausgeführt wird.

**4. Nächste Schritte (Entwicklung)**

• Die Hilfsfunktionen (add_user_message, add_assistant_message) müssen aktualisiert werden, um Nachrichten zu verarbeiten, die mehrere Inhaltsblöcke enthalten.

Takeaways

• Das Tool Schema (JSON Schema) wird über das Schlüsselwort tools in die API-Anfrage aufgenommen, um Claude über verfügbare Funktionen zu informieren.
• Bei Tool-Nutzung besteht die Antwort aus einer Multi-Block-Nachricht, die Text- und Tool-Use-Blöcke enthält.
• Der Tool Use Block ist eine Anweisung an den Entwickler, die aufzurufende Funktion und deren notwendige Argumente auflistet.
• Claude speichert keine Gesprächshistorie; diese muss vom Entwickler manuell verwaltet werden.
• Die gesamte Antwort von Claude (inkl. Tool Use Block) muss als neue Assistant-Nachricht zur Historie hinzugefügt werden.