Systèmes d'agents et standards · Chapitre 3 sur 8
Agents et interfaces : AG-UI et A2UI
Diffuser le travail d'un agent vers une app avec AG-UI, et laisser un agent décrire des composants d'interface sûrs avec A2UI.
Objectifs
- Regardez le flux d'événements AG-UI d'une exécution jusqu'au bout.À faire
- Confirmez le remboursement par un outil front-end.À faire
- Injectez un composant hors du catalogue A2UI et voyez-le refusé.À faire
- Réussissez la vérification.À faire
Étape 1 sur 4 : La lecture
AG-UI : le travail de l'agent en flux
MCP relie un agent à des outils et A2A à d'autres agents. AG-UI (Agent–User Interaction protocol) le relie à l'app qu'utilise une personne. L'app envoie un RunAgentInput (id de thread, id d'exécution, messages, état et outils que l'app propose) et lit en retour un flux d'événements, ici sous forme de server-sent events.
Une exécution commence par RUN_STARTED et se termine par RUN_FINISHED ou RUN_ERROR. Le texte arrive en TEXT_MESSAGE_START, puis en fragments TEXT_MESSAGE_CONTENT, puis en TEXT_MESSAGE_END. Les appels d'outils arrivent de la même façon : TOOL_CALL_START, TOOL_CALL_ARGS, TOOL_CALL_END, et TOOL_CALL_RESULT pour les outils que l'agent a exécutés. L'état partagé circule en STATE_SNAPSHOT, l'état complet, ou en STATE_DELTA, une liste d'opérations JSON Patch. Le client officiel, @ag-ui/client 1.0.2, vérifie le schéma et l'ordre de chaque événement avant de l'appliquer.
Les outils front-end
Certains outils appartiennent à l'app : un bouton de confirmation, un sélecteur de date. L'app les liste dans RunAgentInput.tools. Quand l'agent en appelle un, l'exécution se termine avec cet appel en attente ; l'app exécute l'outil, ici en interrogeant le client, et lance l'exécution suivante avec le résultat comme message d'outil. La réponse de la personne entre dans la conversation, et l'agent décide quoi en faire.
A2UI : des interfaces sous forme de données
A2UI (protocole v0.9) permet à un agent de décrire un morceau d'interface sans envoyer de code. createSurface ouvre une surface et nomme le catalogue qu'elle utilise ; updateComponents envoie une liste plate de composants qui se désignent les uns les autres par id ; updateDataModel envoie les valeurs auxquelles ils sont liés. L'app n'affiche que des composants de son propre catalogue, ici sept types : Card, Column, Row, List, Text, Button et Divider. Avec la validation stricte, @a2ui/web_core 0.12.0 refuse un type inconnu et la surface reste telle quelle, si bien qu'un agent, ou un prompt qui l'a trompé, ne peut pas faire exécuter de nouveau code à l'app.
Ce que vous faites ici
Un client interroge le chat de support sur le double prélèvement. Par AG-UI, regardez le flux d'événements, puis confirmez le remboursement sur la carte que dessine l'app. Passez ensuite le lab à A2UI, où l'agent construit une carte de remboursement à partir de messages. Activez Intercepter, retenez le message updateComponents et ajoutez un composant Script : web_core le refuse.
Étape 2 sur 4 : Essayez : Un agent construit un écran
Un agent construit un écran
Quatre étapes, une action chacune, puis deux facultatives. Le lab sous les étapes dessine chaque message comme une ligne, de haut en bas. Tant qu'un lab A2UI est ouvert, un arbre sous le lab montre les composants que l'agent a envoyés, reliés par id.
Mode :RéelSimuléRéel : le client et le cœur d'AG-UI (@ag-ui/client et @ag-ui/core 1.0.2) et la bibliothèque centrale d'A2UI (@a2ui/web_core 0.12.0) tournent dans cette page, avec les SDK MCP et A2A dans les deux workflows. Simulé : les décisions de l'agent sont scriptées, sauf si vous connectez un modèle, et la boutique et la commande sont fictives.
Étape 3 sur 4 : Vérification
Vérification
Ensuite : Question 2 sur 4
Étape 4 sur 4 : Ce que vous savez faire maintenant
Ce que vous savez faire maintenant
- Lire un flux d'événements AG-UI et dire ce que fait chaque événement.
- Utiliser un outil front-end pour faire intervenir une personne dans l'exécution d'un agent.
- Décrire une surface A2UI : createSurface, updateComponents et updateDataModel.
- Expliquer comment le catalogue d'A2UI protège une app d'une UI fabriquée par un agent.