Os quatro formatos de dados A2A principais
A2A organiza a comunicação em torno de quatro tipos de objetos principais, cada um representando uma fase distinta no fluxo de trabalho:
- Cartão de agente. Um pequeno arquivo JSON (agent.json) que descreve publicamente a identidade, os recursos, os métodos de autenticação e a assinatura digital opcional de um agente. Outros agentes leem esses cartões para descobrir potenciais colaboradores e verificar a confiança.
- Tarefa. Uma solicitação de trabalho estruturada que inclui um único
task_iduma carga útil de entrada e metadados sobre prioridade, expiração ou modalidades necessárias. A tarefa define o que precisa ser feito e serve como âncora para toda a comunicação subsequente. - Mensagem. Um fluxo de atualizações de status e informações intermediárias sobre a tarefa. As mensagens carregam indicadores de progresso, solicitações de informações adicionais ou notas contextuais e normalmente são transmitidas por fluxos SSE ou gRPC.
- Artefato. O resultado da tarefa concluída. Os artefatos podem conter texto, arquivos ou dados estruturados. Eles finalizam a transação e podem ser armazenados, validados ou encadeados em outra tarefa para processamento posterior.
Em uma troca típica, o agente solicitante primeiro recupera um cartão de agente para confirmar as capacidades e os protocolos suportados de outro agente. O agente solicitante é denominado cliente, e o agente que está interrogando sobre os serviços é chamado de servidor, mas estes não são estados permanentes: um agente pode atuar como cliente em um contexto e como servidor em outro e, na verdade, os dois podem trocar de papéis no decorrer de uma única interação.
De qualquer forma, o agente cliente emite um createTask solicitação, que o agente servidor reconhece retornando uma task_id. À medida que a tarefa é executada, o provedor transmite objetos Message que indicam o status ou solicitam esclarecimentos. Quando o trabalho é concluído — ou se falhar — o provedor emite um ou mais objetos Artefato, junto com um código de conclusão.
