Protocolo A2A — IA Conversando com IA

Pense nisso como dois colegas de empresas diferentes trocando e-mails para concluir um projeto — exceto que ambos os colegas são agentes de IA, e o “e-mail” é um protocolo padrão chamado A2A.

A2A (Agente para Agente) é um padrão aberto (v1.0, mantido pela Linux Foundation) que permite que agentes de IA independentes conversem entre si. É como uma linguagem universal para IA: seja seu agente um Hermes, um bot LangChain, uma equipe CrewAI ou um agente Google ADK, todos conseguem se entender.

Quando Você Deve Usar A2A?

Você pode querer usar A2A quando:

• Seu Hermes no seu laptop precisar de ajuda de um Hermes em um servidor — cada um com sua própria memória, ferramentas e credenciais.
• Você quiser delegar uma tarefa a um agente especialista — como um que é muito bom em pesquisas na web ou em programação.
• Você quiser expor seu Hermes como um serviço para que agentes de outros frameworks possam enviar tarefas a ele.

Dica: Se você estiver executando vários agentes na mesma máquina, pule o A2A. Use subagentes em processo ou um quadro kanban. A2A é para cruzar máquinas, processos ou frameworks.

Habilitando A2A

Começar é simples. Execute:

hermes gateway setup

Depois escolha A2A. Ou edite ~/.hermes/config.yaml:

gateway:
  platforms:
    a2a:
      enabled: true
      extra:
        port: 9900

As ferramentas de saída (chamar outros agentes) estão desativadas por padrão. Ative-as com:

hermes tools

Chamando Outros Agentes (Saída)

Uma vez habilitado, seu Hermes ganha um conjunto de ferramentas:

• a2a_discover(url) — busca e resume o “Agent Card” de um colega (como um cartão de visitas para IA).
• a2a_call(agent, message, context_id?) — envia uma tarefa, recebe uma resposta.
• a2a_list() — vê colegas configurados e conversas salvas.
• a2a_history(context_id) — recupera uma conversa A2A passada.
• a2a_orchestrate(capability, message, mode?) — distribui uma tarefa para todos os colegas com uma certa habilidade.

Você pode configurar colegas conhecidos no config.yaml:

a2a_agents:
  researcher:
    url: "http://research-box.local:9900"
    auth: { type: bearer, token: "..." }
    timeout: 120
    capabilities: [web_search, research]

Então é só pedir ao seu Hermes: “Peça ao agente pesquisador para resumir as postagens de hoje do arXiv.” Ele cuida do resto.

Sendo Chamado (Entrada)

Com a plataforma habilitada, seu Hermes oferece:

• Agent Card em GET /.well-known/agent-card.json — anuncia o nome, as habilidades e os requisitos de autenticação do seu agente.
• JSON-RPC 2.0 em POST / — métodos padrão como SendMessage, GetTask, ListTasks e outros.
• Streaming SSE para respostas em tempo real.
• Notificações push (webhooks) para tarefas de longa duração, assinadas com HMAC-SHA256.

Tarefas de entrada são injetadas em uma sessão de gateway ativa — então seu agente funciona normalmente.

Resumo

A2A é o tradutor universal para agentes de IA. Ele permite que seu Hermes chame outros e seja chamado, entre máquinas e frameworks, usando um padrão limpo e aberto.

Dica prática: Comece pequeno. Habilite A2A, configure um colega (como um agente de pesquisa) e tente um único a2a_call. Assim que você vir funcionando, expanda para mais colegas e habilidades. Em pouco tempo você estará montando um time de IA.

---