Sistemas de agentes y estándares · Capítulo 3 de 8
Agentes e interfaces: AG-UI y A2UI
Transmitir el trabajo de un agente a una app con AG-UI, y dejar que un agente describa componentes de interfaz seguros con A2UI.
Objetivos
- Mira el flujo de eventos AG-UI de una ejecución hasta el final.Pendiente
- Confirma el reembolso mediante una herramienta de front-end.Pendiente
- Inyecta un componente fuera del catálogo de A2UI y mira cómo se rechaza.Pendiente
- Supera la comprobación.Pendiente
Paso 1 de 4: La lectura
AG-UI: el trabajo del agente como un flujo
MCP conecta un agente con herramientas y A2A con otros agentes. AG-UI (Agent–User Interaction protocol) lo conecta con la app que usa una persona. La app envía un RunAgentInput (id de thread, id de ejecución, mensajes, estado y las herramientas que ofrece la app) y lee de vuelta un flujo de eventos, aquí como server-sent events.
Una ejecución empieza con RUN_STARTED y termina con RUN_FINISHED o RUN_ERROR. El texto llega como TEXT_MESSAGE_START, luego fragmentos TEXT_MESSAGE_CONTENT, luego TEXT_MESSAGE_END. Las llamadas a herramientas llegan igual: TOOL_CALL_START, TOOL_CALL_ARGS, TOOL_CALL_END, y TOOL_CALL_RESULT para las herramientas que ejecutó el agente. El estado compartido se mueve como STATE_SNAPSHOT, el estado entero, o STATE_DELTA, una lista de operaciones JSON Patch. El cliente oficial, @ag-ui/client 1.0.2, revisa el esquema y el orden de cada evento antes de aplicarlo.
Herramientas de front-end
Algunas herramientas pertenecen a la app: un botón de confirmar, un selector de fecha. La app las lista en RunAgentInput.tools. Cuando el agente llama a una, la ejecución termina con esa llamada pendiente; la app ejecuta la herramienta, aquí preguntándole al cliente, y empieza la siguiente ejecución con el resultado como mensaje de herramienta. La respuesta de la persona pasa a ser parte de la conversación, y el agente decide qué hacer con ella.
A2UI: interfaces como datos
A2UI (protocolo v0.9) permite que un agente describa una pieza de interfaz sin enviar código. createSurface abre una superficie y nombra el catálogo que usa; updateComponents envía una lista plana de componentes que se refieren entre sí por id; updateDataModel envía los valores a los que se vinculan. La app renderiza solo componentes de su propio catálogo, aquí siete tipos: Card, Column, Row, List, Text, Button y Divider. Con validación estricta, @a2ui/web_core 0.12.0 rechaza un tipo desconocido y la superficie queda como estaba, así que un agente, o un prompt que lo engañó, no puede hacer que la app ejecute código nuevo.
Qué haces aquí
Un cliente pregunta en el chat de soporte por el cobro doble. Por AG-UI, mira el flujo de eventos y luego confirma el reembolso en la tarjeta que dibuja la app. Después cambia el laboratorio a A2UI, donde el agente arma una tarjeta de reembolso a partir de mensajes. Activa Interceptar, retén el mensaje updateComponents y agrega un componente Script: web_core lo rechaza.
Paso 2 de 4: Pruébalo: Un agente arma una pantalla
Un agente arma una pantalla
Cuatro pasos, una acción cada uno, y luego dos opcionales. El laboratorio debajo de los pasos dibuja cada mensaje como una fila, de arriba abajo. Mientras haya un laboratorio A2UI abierto, un árbol debajo del laboratorio muestra los componentes que envió el agente, unidos por id.
Modo:RealSimuladoReal: el cliente y el core de AG-UI (@ag-ui/client y @ag-ui/core 1.0.2) y la librería core de A2UI (@a2ui/web_core 0.12.0) se ejecutan en esta página, con los SDK de MCP y A2A en los dos flujos de trabajo. Simulado: las decisiones del agente siguen un guion a menos que conectes un modelo, y la tienda y el pedido son ficticios.
Paso 3 de 4: Comprobación
Comprobación
Siguiente: Pregunta 2 de 4
Paso 4 de 4: Lo que ya puedes hacer
Lo que ya puedes hacer
- Leer un flujo de eventos AG-UI y decir qué hace cada evento.
- Usar una herramienta de front-end para poner a una persona dentro de la ejecución de un agente.
- Describir una superficie A2UI: createSurface, updateComponents y updateDataModel.
- Explicar cómo el catálogo de A2UI protege una app de la UI hecha por agentes.