Multi-turn conversations with tools

📝 Notes de Révision : Intégration de Multiples Outils avec Claude

Objectif Principal :

• Permettre à Claude d'utiliser plusieurs outils séquentiellement pour répondre à une requête complexe.

Principe de Fonctionnement (Workflow) :

• Hypothèse clé : Il faut toujours supposer que Claude pourrait vouloir utiliser plusieurs outils de suite.
• Processus en boucle :
• Soumission de la requête utilisateur à Claude.
• Claude répond avec une demande d'utilisation d'outil (Tool Use).
• Le code exécute l'outil demandé et renvoie le résultat à Claude.
• Claude analyse le résultat et détermine s'il a assez d'informations.
• Si non, Claude demande un nouvel outil (boucle continue).
• Si oui, Claude fournit une réponse finale à l'utilisateur (boucle terminée).

Implémentation Technique (Refactorisation) :

• Fonction runConversation : Doit implémenter une boucle (while loop) pour interroger Claude jusqu'à ce qu'il ne demande plus d'utilisation d'outils.
• Mise à jour des Helpers (add_user_message / add_assistant_message) :
• Doivent être modifiés pour accepter et traiter des blocs de message multiples (pas seulement du texte simple).
• Ils doivent pouvoir stocker l'intégralité de la réponse de Claude, y compris les blocs de type "Tool Use".
• Mise à jour de la fonction chat :
• Doit accepter une liste de schémas d'outils (tool schemas).
• Doit retourner l'intégral message reçu de Claude, et non seulement le bloc de texte (car le message peut contenir plusieurs blocs).
• Nouvelle fonction text_from_message :
• Permet d'extraire et de concaténer tout le texte présent dans les blocs de type "text" d'un message donné.

Concepts Clés à Retenir :

• Gestion des Blocs : Les réponses de Claude ne sont plus garanties d'être un simple bloc de texte ; elles peuvent contenir des blocs de texte ET des blocs d'utilisation d'outils.
• Itération : Le cœur de la solution réside dans une boucle qui continue d'appeler Claude tant que celui-ci demande des actions (outils).
• Flexibilité : Les fonctions d'aide doivent être suffisamment robustes pour gérer des entrées de type chaîne de caractères simples OU des objets de message complexes.

Takeaways

• L'objectif est de permettre à Claude d'utiliser plusieurs outils séquentiellement pour répondre à une requête complexe.
• Le processus repose sur une boucle (while loop) qui continue d'interroger Claude tant qu'il demande l'utilisation d'outils.
• Les réponses de Claude ne sont pas garanties d'être du texte simple, mais peuvent contenir des blocs de texte et des blocs d'utilisation d'outils.
• Les fonctions d'aide doivent être modifiées pour gérer la flexibilité entre les chaînes de caractères simples et les objets de message complexes.