Sistemas de agentes e padrões · Capítulo 3 de 8
Agentes e interfaces: AG-UI e A2UI
Transmitir o trabalho de um agente a um app com AG-UI, e deixar um agente descrever componentes de interface seguros com A2UI.
Objetivos
- Acompanhe o fluxo de eventos AG-UI de uma execução até o fim.A fazer
- Confirme o reembolso por meio de uma ferramenta de front-end.A fazer
- Injete um componente fora do catálogo A2UI e veja-o ser recusado.A fazer
- Passe na verificação.A fazer
Passo 1 de 4: A leitura
AG-UI: o trabalho do agente como um fluxo
O MCP conecta um agente a ferramentas, e o A2A a outros agentes. O AG-UI (Agent–User Interaction protocol) o conecta ao app que uma pessoa usa. O app envia um RunAgentInput (id da thread, id da execução, mensagens, estado e as ferramentas que o app oferece) e lê de volta um fluxo de eventos, aqui como server-sent events.
Uma execução começa com RUN_STARTED e termina com RUN_FINISHED ou RUN_ERROR. O texto chega como TEXT_MESSAGE_START, depois fragmentos TEXT_MESSAGE_CONTENT, depois TEXT_MESSAGE_END. As chamadas de ferramenta chegam do mesmo jeito: TOOL_CALL_START, TOOL_CALL_ARGS, TOOL_CALL_END, e TOOL_CALL_RESULT para ferramentas que o agente executou. O estado compartilhado se move como STATE_SNAPSHOT, o estado inteiro, ou STATE_DELTA, uma lista de operações JSON Patch. O cliente oficial, @ag-ui/client 1.0.2, confere o schema e a ordem de cada evento antes de aplicá-lo.
Ferramentas de front-end
Algumas ferramentas pertencem ao app: um botão de confirmar, um seletor de data. O app as lista em RunAgentInput.tools. Quando o agente chama uma delas, a execução termina com essa chamada pendente; o app executa a ferramenta, aqui perguntando ao cliente, e inicia a próxima execução com o resultado como uma mensagem de ferramenta. A resposta da pessoa passa a fazer parte da conversa, e o agente decide o que fazer com ela.
A2UI: interfaces como dados
O A2UI (protocolo v0.9) permite que um agente descreva um pedaço de interface sem enviar código. createSurface abre uma superfície e indica o catálogo que ela usa; updateComponents envia uma lista plana de componentes que se referem uns aos outros por id; updateDataModel envia os valores aos quais eles se vinculam. O app renderiza apenas componentes do seu próprio catálogo, aqui sete tipos: Card, Column, Row, List, Text, Button e Divider. Com validação estrita, @a2ui/web_core 0.12.0 recusa um tipo desconhecido e a superfície fica como estava, então um agente, ou um prompt que o enganou, não consegue fazer o app executar código novo.
O que você faz aqui
Um cliente pergunta ao chat de suporte sobre a cobrança em dobro. Pelo AG-UI, acompanhe o fluxo de eventos e depois confirme o reembolso no card que o app desenha. Depois mude o lab para A2UI, onde o agente monta um card de reembolso a partir de mensagens. Ative Interceptar, retenha a mensagem updateComponents e adicione um componente Script: o web_core o recusa.
Passo 2 de 4: Experimente: Um agente monta uma tela
Um agente monta uma tela
Quatro passos, uma ação cada, e depois dois opcionais. O lab abaixo dos passos desenha cada mensagem como uma linha, de cima para baixo. Enquanto um lab A2UI está aberto, uma árvore abaixo do lab mostra os componentes que o agente enviou, ligados por id.
Modo:RealSimuladoReal: o cliente e o core do AG-UI (@ag-ui/client e @ag-ui/core 1.0.2) e a biblioteca core do A2UI (@a2ui/web_core 0.12.0) rodam nesta página, com os SDKs do MCP e do A2A nos dois fluxos de trabalho. Simulado: as decisões do agente são roteirizadas, a menos que você conecte um modelo, e a loja e o pedido são fictícios.
Passo 3 de 4: Verificação
Verificação
Próximo: Pergunta 2 de 4
Passo 4 de 4: O que você já sabe fazer
O que você já sabe fazer
- Ler um fluxo de eventos AG-UI e dizer o que cada evento faz.
- Usar uma ferramenta de front-end para colocar uma pessoa dentro da execução de um agente.
- Descrever uma superfície A2UI: createSurface, updateComponents e updateDataModel.
- Explicar como o catálogo do A2UI protege um app de uma UI feita por um agente.