Log and progress notifications

Notes de cours : Journalisation et Notifications de Progression

• Objectif : Améliorer l'expérience utilisateur (UX) lors de l'exécution d'appels d'outils longs (ex. : recherche), en fournissant un retour sur l'état du processus.
• Mécanisme côté Serveur (MCP) :
• La fonction d'outil reçoit un argument context (automatiquement inclus comme dernier argument).
• Cet objet context fournit des méthodes pour communiquer avec le client :
• info : Utilisée pour émettre des messages de journalisation (logs).
• report progress : Utilisée pour signaler l'avancement de l'exécution.
• L'appel de ces méthodes envoie automatiquement un message au client.
• Mécanisme côté Client :
• Le client doit implémenter des fonctions de rappel (callbacks) spécifiques :
• Un callback pour recevoir les messages de journalisation.
• Un callback pour recevoir les mises à jour de progression.
• Ces callbacks sont transmis à la fonction d'outil.
• Affichage et Utilisation :
• Le client détermine comment afficher les informations (ex. : affichage dans un terminal pour une application CLI, ou mise à jour dans une interface web).
• Note importante : La journalisation et les notifications de progression sont des améliorations de l'UX et ne sont pas obligatoires ; elles peuvent être ignorées par l'utilisateur.

Takeaways

• L'objectif est d'améliorer l'expérience utilisateur (UX) en fournissant un retour sur l'état des processus longs.
• Le mécanisme côté serveur utilise l'argument context pour émettre des messages via info (journalisation) et report progress (avancement).
• Le côté client doit implémenter et transmettre des fonctions de rappel (callbacks) spécifiques pour recevoir les logs et les mises à jour de progression.
• La journalisation et les notifications de progression sont des améliorations de l'UX et ne sont pas obligatoires.