Multi-turn conversations with tools — Claude On Google Cloud

🎯 Hoofddoel

Het project is gericht op het koppelen van meerdere verschillende tools aan Claude, niet slechts één.

⚙️ Het Proces van Meerdere Tool Calls

Scenario: Een complexe vraag (bijv. "Wat is de datum over 103 dagen? ") vereist vaak meerdere tools.
Stap 1: Claude reageert met een tool use blok (vraagt om Tool 1).
Stap 2: De tool wordt uitgevoerd, en het resultaat wordt teruggekoppeld aan Claude.
Stap 3: Claude realiseert zich dat er nog meer informatie nodig is en reageert met een tweede tool use blok (vraagt om Tool 2).
Stap 4: De tweede tool wordt uitgevoerd, en het resultaat wordt teruggekoppeld aan Claude.
Stap 5: Claude heeft nu voldoende informatie om een definitief antwoord te geven aan de gebruiker.

💡 Belangrijk Inzicht

Bij het integreren van tool calling moet men altijd aannemen dat een gebruikersvraag meerdere tools achter elkaar kan vereisen.
De applicatie moet de respons van Claude controleren:
Als er geen tool use is → Dit is het definitieve antwoord.
Als er wel tool use is → De tool moet worden uitgevoerd, en de resultaten moeten teruggevoerd worden naar Claude.

🔄 Implementatie: De runConversation Functie

Er moet een lus (while loop) worden geïmplementeerd om het gesprek te beheren.
Logica van de lus:
Stuur de huidige conversiegeschiedenis naar Claude.
Controleer de respons van Claude.
Als Claude een tool vraagt → Voer de tool uit, voeg het resultaat toe aan de conversiegeschiedenis, en ga terug naar stap 1.
Als Claude geen tool vraagt → De conversatie is voltooid; lever het antwoord aan de gebruiker.

🛠️ Refactoring Stappen (Technische Aanpassingen)

Stap 1: Helper Functies Aanpassen
addUserMessage en addAssistantMessage moeten worden geüpgraded om niet alleen platte tekst te verwerken, maar ook volledige berichten die meerdere message blocks bevatten (zoals tekst én tool use).
Stap 2: De chat Functie Aanpassen
De chat functie moet een lijst van tool schemas accepteren en deze doorgeven aan de client.
De functie retourneert niet langer alleen de tekst van Claude, maar het hele bericht (om tool use blocks te kunnen behouden).
Nieuwe Helper Functie:
textFromMessage: Een functie die alle text uit alle text blocks binnen een gegeven bericht extraheert en samenvoegt.

Takeaways

Het koppelen van meerdere tools aan Claude is mogelijk om complexe vragen te beantwoorden die meerdere stappen vereisen.
De applicatie moet een lus (while loop) implementeren om het gesprek te beheren, waarbij de conversiegeschiedenis continu wordt bijgewerkt.
De logica vereist dat de respons van Claude wordt gecontroleerd: als er een tool use is, moet deze worden uitgevoerd en het resultaat teruggevoerd; anders is het antwoord definitief.
Functies moeten worden aangepast om niet alleen platte tekst, maar ook volledige berichten die zowel tekst als meerdere tool use blocks bevatten, te verwerken.