multi-agent-a2a
Skill194 starsChanged 4 months agoMITView on GitHub
Help a learner compose agents as networked services using the open Agent-to-Agent (A2A) protocol — expose an agent as an A2A server and consume a remote agent as a peer. Use for Lesson 7 tasks: multi-agent orchestration and A2A client/server wiring.
- Reads credentials
We split this skill into the rules it gives an agent
3 rules. About 0 are common, 2 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 20
Agents as services: instead of one process holding every agent, each agent can be exposed over A2A and called remotely — enabling reuse, …
- Very specific: line 32
Start the server, then run the client.
- Distinctive: line 34
Keep the preview caveat visible when advising on production use.
≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Multi-agent & A2A
Guidance for composing agents over the Agent-to-Agent (A2A) protocol (Lesson 7).
Guardrails (always apply)
- Terminology: A2A (Agent-to-Agent) — an open protocol for agents to call each other as peers.
- Uses preview packages:
agent-framework-a2a,a2a-sdk, anduvicorn(pinned inrequirements.txtwith a preview note). Present these as preview, not GA. - Config via
.env:A2A_HOST,A2A_PORT,A2A_SERVER_URL. Modelsgpt-5.1/gpt-5-codex.
Concepts a learner should grasp
- Agents as services: instead of one process holding every agent, each agent can be exposed over A2A and called remotely — enabling reuse, independent scaling and cross-team composition.
- Server vs client: the server publishes an agent (with an agent card) over A2A; the client
discovers and calls it as a peer using
A2AAgent. - Orchestration: a coordinating agent can delegate sub-tasks to specialised remote agents.
Worked example in this repo (validated live)
lesson-7-multi-agent-a2a/a2a_server.py— exposes a Foundry agent over A2A (default port 9000).lesson-7-multi-agent-a2a/a2a_client.py— consumes the remote agent as a peer and prints its response. This pair was validated end-to-end against a live Foundry agent.
How to help
- Start the server, then run the client; confirm
A2A_SERVER_URLmatches the server's host/port. - Adapt the server's underlying agent (instructions/tools) rather than rewriting the A2A plumbing.
- Keep the preview caveat visible when advising on production use.
Validate
python -m py_compileon both server and client.- Client should reach the running server and return a real model response.
References
lesson-7-multi-agent-a2a/README.md
In this repository24 other files it gives its agents.
- AGENTS.mdAGENTS.md
- translations/bn/AGENTS.mdAGENTS.md
- translations/cs/AGENTS.mdAGENTS.md
- translations/da/AGENTS.mdAGENTS.md
- translations/en/AGENTS.mdAGENTS.md
- translations/es/AGENTS.mdAGENTS.md
- translations/hu/AGENTS.mdAGENTS.md
- translations/id/AGENTS.mdAGENTS.md
- translations/ko/AGENTS.mdAGENTS.md
- translations/lt/AGENTS.mdAGENTS.md
- translations/mr/AGENTS.mdAGENTS.md
- translations/ms/AGENTS.mdAGENTS.md
- translations/nl/AGENTS.mdAGENTS.md
- translations/pa/AGENTS.mdAGENTS.md
- translations/pt-BR/AGENTS.mdAGENTS.md
- translations/pt-PT/AGENTS.mdAGENTS.md
- translations/th/AGENTS.mdAGENTS.md
- translations/tl/AGENTS.mdAGENTS.md
- translations/vi/AGENTS.mdAGENTS.md
- agent-evaluationSkill
- foundry-agent-basicsSkill
- hosted-agent-deploymentSkill
- mcp-integrationSkill
- microsoft-toolboxSkill
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
Reviews can't be read right now.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

