Protocollo A2A — IA che parla con IA

Immagina due colleghi di aziende diverse che si scambiano email per portare a termine un progetto — solo che entrambi i colleghi sono agenti AI, e la “email” è un protocollo standard chiamato A2A.

A2A (Agent-to-Agent) è uno standard aperto (v1.0, gestito dalla Linux Foundation) che permette ad agenti AI indipendenti di parlare tra loro. È come un linguaggio universale per l’AI: che il tuo agente sia un Hermes, un bot LangChain, una squadra CrewAI o un agente Google ADK, possono capirsi tutti.

Quando Dovresti Usare A2A?

Potresti voler usare A2A quando:

• Il tuo Hermes sul laptop ha bisogno di aiuto da un Hermes su un server — ognuno con la propria memoria, strumenti e credenziali.
• Vuoi delegare un compito a un agente specializzato — come uno che è particolarmente bravo nelle ricerche web o nella programmazione.
• Vuoi esporre il tuo Hermes come servizio così che gli agenti di altri framework possano inviargli compiti.

Consiglio: Se stai eseguendo più agenti sulla stessa macchina, salta A2A. Usa invece sub-agent in-process o una bacheca kanban. A2A serve per attraversare macchine, processi o framework.

Abilitare A2A

Iniziare è semplice. Esegui:

hermes gateway setup

Poi scegli A2A. Oppure, modifica ~/.hermes/config.yaml:

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

Gli strumenti in uscita (per chiamare altri agenti) sono disattivati di default. Attivali con:

hermes tools

Chiamare Altri Agenti (In Uscita)

Una volta abilitato, il tuo Hermes riceve una serie di strumenti:

• a2a_discover(url) — recupera e riassume la “Agent Card” di un peer (come un biglietto da visita per l’AI).
• a2a_call(agent, message, context_id?) — invia un compito, ricevi una risposta.
• a2a_list() — mostra i peer configurati e le conversazioni salvate.
• a2a_history(context_id) — richiama una conversazione A2A passata.
• a2a_orchestrate(capability, message, mode?) — distribuisci un compito a tutti i peer con una certa abilità.

Puoi configurare i peer conosciuti in config.yaml:

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

Poi basta chiedere al tuo Hermes: “Chiedi all’agente ricercatore di riassumere le pubblicazioni di arXiv di oggi.” Si occuperà del resto.

Essere Chiamabili (In Entrata)

Con la piattaforma abilitata, il tuo Hermes offre:

• Agent Card su GET /.well-known/agent-card.json — pubblicizza nome, abilità e requisiti di autenticazione del tuo agente.
• JSON-RPC 2.0 su POST / — metodi standard come SendMessage, GetTask, ListTasks e altri.
• Streaming SSE per risposte in tempo reale.
• Notifiche push (webhook) per compiti di lunga durata, firmate con HMAC-SHA256.

I compiti in entrata vengono iniettati in una sessione gateway live — quindi il tuo agente funziona come al solito.

Riepilogo

A2A è il traduttore universale per gli agenti AI. Permette al tuo Hermes di chiamare altri e di essere chiamato, attraverso macchine e framework, usando uno standard aperto e pulito.

Consiglio pratico: Inizia in piccolo. Abilita A2A, configura un peer (come un agente di ricerca) e prova una singola a2a_call. Una volta che vedi che funziona, espandi a più peer e abilità. Costruirai una squadra AI in un attimo.

---