Comment les appels d'outils d'un assistant atteignent Asterobot, comment il suit ce qui se passe par les événements et le journal, et où les réponses sont coupées.
Ce n'est pas vous qui appelez les outils, c'est l'assistant. Savoir comment ils se comportent aide à lire ce qu'il rapporte et à comprendre pourquoi il redemande parfois quelque chose.
Comment un appel atteint Asterobot
Un appel d'outil est la même requête qu'Asteroboard enverrait, vérifiée de la même façon. Quand l'assistant se trompe dans un argument, la réponse lui dit ce qui ne va pas, avec les mêmes mots que les erreurs d'Asteroboard, et il corrige son appel. Quand Asterobot refuse quelque chose, l'assistant lit le refus : un appel pour déplacer un bot qui n'existe pas répond 404 Not Found: bot not found.
Les arguments d'un outil sont les champs que vous rempliriez dans Asteroboard : le nom du bot, la clé du réglage, le message à envoyer. Pour deux actions, envoyer un message sur la connexion d'un bot et copier un paquet, un champ porte le même nom que le bot, et l'assistant passe alors tout le formulaire dans un seul argument body. Il peut demander à Asterobot la forme exacte de n'importe quelle action avec l'outil describe-operation, qui répond aussi pour les actions cachées, en disant pourquoi elles le sont.
Trois outils bien à lui
En plus des actions d'Asterobot, l'assistant reçoit trois outils dont Asteroboard n'a pas besoin :
| Outil | Ce qu'il fait |
|---|---|
describe-operation |
Chaque argument et la forme des réponses d'une action, quand la courte description ne suffit pas. |
watch-events |
Les événements qu'Asterobot publie : un bot qui change d'état, un message sur sa connexion, un téléchargement qui avance, un réglage qui change. Chaque appel renvoie les événements après une position, attend jusqu'à 30 secondes le premier quand il n'y en a pas encore, et répond avec la position d'où continuer. |
read-logs |
Le journal d'Asterobot lui-même, celui de Serveur > Console, à partir d'un niveau choisi. |
Asterobot garde les 500 derniers événements de chaque sorte. Quand un assistant revient après qu'autant sont passés, watch-events lui dit combien il en a manqué, pour qu'il regarde à nouveau plutôt que de supposer qu'il ne s'est rien passé.
Les actions qui se terminent plus tard
Connecter un bot, lancer un paquet ou envoyer un message répond tout de suite ; ce qui en résulte arrive plus tard sous forme d'événement. La réponse à un tel appel nomme l'événement à surveiller et la position d'où le surveiller, pour que l'assistant suive le résultat sans deviner. C'est pourquoi un assistant à qui l'on demande de connecter un bot rapporte en général la connexion un peu plus tard, une fois qu'il a vu l'état du bot changer.
Les grandes réponses
Une réponse plus grande que mcp.maxResponseBytes, 100 000 octets par défaut, est réduite pour rester lisible : des entrées entières sont retirées à la fin de la plus grande liste qu'elle contient, et l'assistant apprend combien, et quel argument restreint cette action quand elle en a un. Quand il n'y a rien à retirer, la réponse est une erreur qui demande à l'assistant de restreindre sa requête. Les deux réponses concernées en pratique sont le catalogue des messages du jeu, qui prend un argument name pour ne renvoyer qu'un message, et les requêtes SQL, où LIMIT fait l'affaire.
Les actions cachées
Deux actions sont cachées à tous les assistants sauf si vous les autorisez : arrêter Asterobot et remettre tous les réglages à zéro. Trois ne sont jamais des outils, parce qu'un assistant n'en a pas l'usage : le flux d'événements en direct qu'utilise Asteroboard (l'assistant a watch-events à la place), et l'export ou l'import d'un paquet sous forme de zip. Réglages MCP explique comment cacher d'autres actions, ou autoriser celles qui le sont.
Le protocole du jeu
L'assistant peut lister chaque message du jeu qu'un bot peut envoyer, avec chacun de ses champs, par le même catalogue qu'utilise l'onglet d'envoi de messages d'un bot, et en envoyer un sur la connexion d'un bot. Asterobot vérifie le message contre la définition du jeu lui-même avant qu'il parte, si bien qu'un champ erroné n'atteint jamais le jeu. Le catalogue donne la forme d'un message, pas son rôle : la référence du protocole Dofus l'a, et vous pouvez indiquer une de ses pages à l'assistant. Ce que l'assistant peut envoyer est ce qu'un script peut envoyer ; voir Envoyer des messages.
Suite : Réglages MCP.