Sistemas de agentes e padrões · Capítulo 2 de 8
A2A: agentes que delegam a agentes
Como um agente encontra outro pelo seu Agent Card e lhe entrega uma tarefa que pode acompanhar até o fim.
Objetivos
- Leia o Agent Card do agente de Pagamentos.A fazer
- Acompanhe uma tarefa de WORKING, passando por INPUT_REQUIRED, até COMPLETED.A fazer
- Responda a um id de tarefa que não é seu e veja a resposta ser rejeitada.A fazer
- Coloque a troca em ordem.A fazer
Passo 1 de 4: A leitura
Um par, não uma ferramenta
O A2A (Agent2Agent, protocolo 1.0) conecta agentes que partes diferentes executam. No capítulo anterior, o agente de suporte chamava ferramentas em um servidor MCP: funções com um schema, executadas exatamente como chamadas. Pelo A2A, ele entrega trabalho a outro agente, que decide como fazê-lo com seu próprio modelo, suas ferramentas e sua memória. Quem chama vê apenas a tarefa e seus resultados.
O Agent Card
Cada servidor A2A tem um Agent Card. Um agente público o serve em /.well-known/agent-card.json, onde qualquer pessoa pode lê-lo sem uma credencial. Ele dá o nome do agente e de suas skills, lista suas interfaces (URL, binding como JSONRPC, versão de protocolo), diz se ele faz streaming e declara como se autenticar, aqui com um bearer token por comerciante. Cada requisição leva um cabeçalho A2A-Version; um servidor recusa uma versão que seu card não lista (erro -32009).
Mensagens, tarefas e artefatos
O cliente chama SendMessage com uma mensagem feita de partes: texto para o modelo do outro agente, e partes de dados com um media type para valores em que ele pode confiar, como o id do pedido e o valor. A resposta é uma mensagem ou, para um trabalho que leva tempo, uma tarefa: um id, um contextId que agrupa uma conversa e um estado como TASK_STATE_WORKING, INPUT_REQUIRED ou COMPLETED. Os resultados chegam como artefatos na tarefa, separados do chat.
INPUT_REQUIRED pausa a tarefa até o cliente responder. A resposta é uma nova mensagem que indica o mesmo taskId e o mesmo contextId. O servidor mantém as tarefas de cada comerciante separadas: uma resposta que indica uma tarefa que não pertence a este comerciante recebe -32001, task not found, e nada é executado.
Streaming ou polling
Com SendStreamingMessage, o servidor envia server-sent events: primeiro a tarefa, depois atualizações de status e de artefatos, até a tarefa pausar ou terminar. Sem streaming, SendMessage responde quando a tarefa pausa ou termina; com returnImmediately, responde na hora, e o cliente faz polling com GetTask.
O que você faz aqui
O agente de suporte da Halden e o agente de Pagamentos rodam o SDK oficial de JavaScript do A2A (@a2a-js/sdk 1.3.0) nesta página, cada um guiado por um modelo LangChain roteirizado. Leia o card, acompanhe a tarefa de reembolso pelos seus estados e responda você mesmo à pergunta dela. Depois ative Interceptar e aponte sua resposta para a tarefa de outro comerciante. Um passo opcional mostra o agente de Pagamentos chegando ao seu livro-razão via MCP, onde o input_required do MCP vira o INPUT_REQUIRED da tarefa A2A.
Passo 2 de 4: Experimente: Uma tarefa através de uma fronteira
Uma tarefa através de uma fronteira
Três passos, uma ação cada, e depois dois opcionais. O diagrama abaixo dos passos tem uma coluna por participante e uma linha por mensagem, de cima para baixo. A linha grossa tracejada é a fronteira entre organizações.
Modo:RealSimuladoReal: o SDK de JavaScript do A2A (@a2a-js/sdk 1.3.0, A2A 1.0), cliente e servidor, e o SDK do MCP no passo opcional A2A com MCP rodam nesta página. Simulado: as decisões dos agentes são roteirizadas, a menos que você conecte um modelo, os pagamentos são simulados e os dados são fictícios.
Passo 3 de 4: Verificação
Verificação
Coloque em ordem a troca A2A do reembolso.
Arraste os itens, ou use os botões de seta, para colocá-los em ordem.
- Posição 1: SendMessage com o pedido de reembolso.
- Posição 2: GET do Agent Card.
- Posição 3: Tarefa em TASK_STATE_COMPLETED, com o comprovante do reembolso como artefato.
- Posição 4: SendMessage com a resposta, na mesma tarefa.
- Posição 5: Tarefa em TASK_STATE_INPUT_REQUIRED.
- Posição 6: Tarefa em TASK_STATE_WORKING.
Passo 4 de 4: O que você já sabe fazer
O que você já sabe fazer
- Ler um Agent Card e escolher uma skill e uma interface.
- Enviar uma mensagem e acompanhar os estados de uma tarefa até seus artefatos, por streaming ou por polling.
- Responder a uma tarefa em INPUT_REQUIRED com uma resposta no mesmo taskId e contextId.
- Explicar quando usar A2A em vez de MCP.