Handling message blocks

📝 Notes d'étude : Utilisation des Outils (Tool Use) avec Claude

Concepts Clés de l'Intégration des Outils

• Requête API avec Schéma d'Outil :
• Pour permettre à Claude d'utiliser un outil, la requête envoyée au serveur doit inclure un argument tools.
• Cet argument est une liste contenant les spécifications JSON (schémas) de tous les outils disponibles (ex. : get current datetime schema).

• Structure du Message Assistant (Multi-Bloc) :
• Lorsqu'un outil est appelé, le message de réponse de Claude n'est plus un simple bloc de texte. Il devient un message multi-bloc.
• Ce message contient deux types de blocs :
• Bloc de Texte (Text Block) : Contient le texte destiné à être affiché à l'utilisateur (ex. : "Je vais trouver l'heure actuelle pour vous. ").
• Bloc d'Utilisation d'Outil (Tool Use Block) : Indique au développeur que Claude souhaite exécuter une fonction. Il liste le nom de la fonction et les arguments nécessaires.

• Gestion de l'Historique de Conversation :
• Règle Critique : Claude ne stocke aucun historique de conversation.
• Le développeur doit gérer l'historique manuellement.
• Après l'exécution d'un outil, le résultat doit être renvoyé à Claude en incluant l'intégralité de l'historique de la conversation pour maintenir le contexte.

• Flux de Travail (Workflow) :
• Requête Utilisateur → Claude (avec Schéma d'Outil).
• Réponse Claude → Message Multi-Bloc (Texte + Bloc d'Utilisation d'Outil).
• Action Développeur → Exécuter la fonction identifiée dans le bloc d'utilisation d'outil.
• Réponse Système → Renvoyer le résultat à Claude (en incluant l'historique complet).

Takeaways

• L'intégration des outils nécessite une requête API incluant un argument tools contenant les spécifications JSON des fonctions disponibles.
• Lors d'un appel d'outil, Claude répond par un message multi-bloc composé d'un Bloc de Texte et d'un Bloc d'Utilisation d'Outil.
• Le développeur doit gérer l'historique de conversation manuellement, car Claude ne le stocke pas.
• Le flux de travail exige que le développeur exécute la fonction identifiée par Claude et renvoie le résultat en incluant l'historique complet.