Pular para o conteúdo
Voltar para Sistemas de agentes e padrões

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.

25 minutos0 de 4 objetivos concluídos

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

Pergunta 1 de 4O que é uma ferramenta de front-end no AG-UI?

Próximo: Pergunta 2 de 4

Pergunta 2 de 4Por que o A2UI renderiza a partir de um catálogo em vez de executar o markup do agente?
Pergunta 3 de 4O que um evento STATE_DELTA do AG-UI carrega?
Pergunta 4 de 4O cliente recebe TEXT_MESSAGE_CONTENT para um messageId que nunca teve um TEXT_MESSAGE_START. O que acontece?

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.