A2A — agent-to-agent
Wiki runtime · Manuel agent · Spec A2A officielle
A2A Specificat = protocole agent ↔ agent : JSON-RPC, Agent Card, skills {agent}:{facet}.
Trois usages, même wire :
| Usage | Déclaration YAML | Appelant |
|---|---|---|
| Délégation intra-projet | capacity.kind: agent | Agent parent du même project.yaml |
| Exposition publique | trigger external-gateway | Partenaire / UI / autre projet |
| Délégation entrante | trigger delegation-gateway | Autre runtime authentifié |
Protocole industry : Agent2Agent (A2A) — Linux Foundation, complémentaire de MCP (agent-to-tool).
Le YAML kind: agent ne change pas. Seul le runtime change : tâche A2A, pas d'appel in-process.
Fiches
| Fiche | Sujet |
|---|---|
| yaml-model.md | external-gateway, facade → Agent Card |
| delegation.md | YAML kind: agent (target + scope: [id, …]) |
| internal-delegation.md | Flux parent → enfant (tâche A2A) |
| payload.md | values → message A2A ; retour artefact |
| delegation-gateway.md | Délégation entrante depuis un autre runtime |
| public-invocation.md | Flux HTTP / JSON-RPC entrant public |
| inter-project.md | Contrats entre projets (pas kind: agent) |
| security.md | Auth JWT, mTLS, anti-patterns |
vs MCP vs exposition réseau
kind: agent | MCP (kind: mcp) | external-gateway | delegation-gateway | |
|---|---|---|---|---|
| Cible | Agent même projet | Serveur outillage | Appelant externe / autre projet | Agent distant authentifié |
| Wire | A2A | MCP | A2A | A2A |
| Auth | JWT utilisateur forwardé | Session MCP / OAuth outil | OAuth / clé API | mTLS ou JWT |
| Contrat | Instruction + facette (skill) | Tools / prompts / resources | Façade + trigger | Payload + agents[] du trigger |
Intra-projet vs public
Intra-projet (kind: agent) | Public (external-gateway) | |
|---|---|---|
| Scope | Même project.yaml | Inter-projets / partenaires |
| Découverte | Services cluster (DNS / ACH) | Agent Card publiée |
| Skill | {target}:{facet} (un id de scope[]) | Facettes listées sur le trigger |
| Auth | JWT utilisateur forwardé | OAuth / clé API |
Exemples YAML
Délégation : project-reference/03-code-assistant.yaml, 04-multi-agent-writer.yaml, 10-deal-room.yaml.
Public : project-reference/06-api-service.yaml.
Cycles : project-reference/00-smoke-test.yaml.