2025-04-28 15:12:35 -05:00
# Agent2Agent (A2A) Protocol
2025-06-09 15:17:59 -04:00
[](https://pypi.org/project/a2a-sdk)
2025-04-25 15:15:12 -07:00
[](LICENSE)
2025-11-18 09:07:56 -08:00
< a href = "https://codewiki.google/github.com/a2aproject/a2a" >
< img src = "https://www.gstatic.com/_/boq-sdlc-agents-ui/_/r/Mvosg4klCA4.svg" alt = "Ask Code Wiki" height = "20" >
< / a >
2025-03-25 15:15:56 -07:00
docs: Auto-translate README and Wiki (#1326)
Added language badges to the README for easier access to translated
versions: German, Spanish, French, Japanese, Korean, Portuguese, and
Russian 20 languages.
System will auto-update translation for README and Wiki when this
repository updated, and support multiple languages google/bing SEO
search, and it's open source project, we can change web or local file
mode.
The updated links can be previewed in my forked repository:
https://github.com/openaitx-system/A2A/tree/Auto_translate_README_and_Wiki
Demo links :
-
[Español](https://openaitx.github.io/view.html?user=a2aproject&project=A2A&lang=es)
-
[简体中文](https://openaitx.github.io/view.html?user=a2aproject&project=A2A&lang=zh-CN)
-
[日本語](https://openaitx.github.io/view.html?user=a2aproject&project=A2A&lang=ja)
-
[한국어](https://openaitx.github.io/view.html?user=a2aproject&project=A2A&lang=ko)
-
[Français](https://openaitx.github.io/view.html?user=a2aproject&project=A2A&lang=fr)
..
<img width="1178" height="537" alt="Image"
src="https://github.com/user-attachments/assets/7cd54a88-59c1-455f-9c7d-2db7f05b2962
" />
If this doesn't align with your expectations, feel free to close this
PR. Thanks for your time! 🙌
---------
Co-authored-by: Holt Skinner <13262395+holtskinner@users.noreply.github.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
2026-01-30 01:00:33 +08:00
< div style = "text-align: left;" >
< details >
< summary > 🌐 Language< / summary >
< div >
< div style = "text-align: center;" >
< a href = "https://openaitx.github.io/view.html?user=a2aproject&project=A2A&lang=en" > English< / a >
| < a href = "https://openaitx.github.io/view.html?user=a2aproject&project=A2A&lang=zh-CN" > 简体中文< / a >
| < a href = "https://openaitx.github.io/view.html?user=a2aproject&project=A2A&lang=zh-TW" > 繁體中文< / a >
| < a href = "https://openaitx.github.io/view.html?user=a2aproject&project=A2A&lang=ja" > 日本語< / a >
| < a href = "https://openaitx.github.io/view.html?user=a2aproject&project=A2A&lang=ko" > 한국어< / a >
| < a href = "https://openaitx.github.io/view.html?user=a2aproject&project=A2A&lang=hi" > हिन्दी< / a >
| < a href = "https://openaitx.github.io/view.html?user=a2aproject&project=A2A&lang=th" > ไทย< / a >
| < a href = "https://openaitx.github.io/view.html?user=a2aproject&project=A2A&lang=fr" > Français< / a >
| < a href = "https://openaitx.github.io/view.html?user=a2aproject&project=A2A&lang=de" > Deutsch< / a >
| < a href = "https://openaitx.github.io/view.html?user=a2aproject&project=A2A&lang=es" > Español< / a >
| < a href = "https://openaitx.github.io/view.html?user=a2aproject&project=A2A&lang=it" > Italiano< / a >
| < a href = "https://openaitx.github.io/view.html?user=a2aproject&project=A2A&lang=ru" > Русский< / a >
| < a href = "https://openaitx.github.io/view.html?user=a2aproject&project=A2A&lang=pt" > Português< / a >
| < a href = "https://openaitx.github.io/view.html?user=a2aproject&project=A2A&lang=nl" > Nederlands< / a >
| < a href = "https://openaitx.github.io/view.html?user=a2aproject&project=A2A&lang=pl" > Polski< / a >
| < a href = "https://openaitx.github.io/view.html?user=a2aproject&project=A2A&lang=ar" > العربية< / a >
| < a href = "https://openaitx.github.io/view.html?user=a2aproject&project=A2A&lang=fa" > فارسی< / a >
| < a href = "https://openaitx.github.io/view.html?user=a2aproject&project=A2A&lang=tr" > Türkçe< / a >
| < a href = "https://openaitx.github.io/view.html?user=a2aproject&project=A2A&lang=vi" > Tiếng Việt< / a >
| < a href = "https://openaitx.github.io/view.html?user=a2aproject&project=A2A&lang=id" > Bahasa Indonesia< / a >
| < a href = "https://openaitx.github.io/view.html?user=a2aproject&project=A2A&lang=as" > অসমীয়া< / a >
< / div >
< / div >
< / details >
< / div >
2025-09-05 12:29:31 -05:00
<!-- markdownlint - disable MD041 -->
< div style = "text-align: center;" >
< div class = "centered-logo-text-group" >
< img src = "docs/assets/a2a-logo-black.svg" alt = "Agent2Agent Protocol Logo" width = "100" >
< h1 > Agent2Agent (A2A) Protocol< / h1 >
< / div >
< / div >
2025-05-20 07:38:15 -07:00
2025-05-09 12:50:37 -05:00
**An open protocol enabling communication and interoperability between opaque agentic applications.**
2025-03-25 15:15:56 -07:00
2025-05-09 12:50:37 -05:00
The Agent2Agent (A2A) protocol addresses a critical challenge in the AI landscape: enabling gen AI agents, built on diverse frameworks by different companies running on separate servers, to communicate and collaborate effectively - as agents, not just as tools. A2A aims to provide a common language for agents, fostering a more interconnected, powerful, and innovative AI ecosystem.
2025-03-25 15:15:56 -07:00
2025-05-09 12:50:37 -05:00
With A2A, agents can:
2025-03-25 15:15:56 -07:00
2025-05-09 12:50:37 -05:00
- Discover each other's capabilities.
- Negotiate interaction modalities (text, forms, media).
2026-01-08 17:55:51 +01:00
- Securely collaborate on long-running tasks.
2025-05-09 12:50:37 -05:00
- Operate without exposing their internal state, memory, or tools.
2025-03-25 15:15:56 -07:00
2026-02-11 10:39:23 -06:00
## DeepLearning.AI Course
2025-04-09 01:53:20 -04:00
2026-02-11 10:39:23 -06:00
[](https://goo.gle/dlai-a2a)
2026-02-11 10:40:02 -06:00
Join this short course on [A2A: The Agent2Agent Protocol ](https://goo.gle/dlai-a2a ), built in partnership with Google Cloud and IBM Research, and taught by [Holt Skinner ](https://github.com/holtskinner ), [Ivan Nardini ](https://github.com/inardini ), and [Sandi Besen ](https://github.com/sandijean90 ).
2026-02-11 10:39:23 -06:00
**What you'll learn:**
- **Make agents A2A-compliant:** Expose agents built with frameworks like Google ADK, LangGraph, or BeeAI as A2A servers.
- **Connect agents:** Create A2A clients from scratch or using integrations to connect to A2A-compliant agents.
- **Orchestrate workflows:** Build sequential and hierarchical workflows of A2A-compliant agents.
- **Multi-agent systems:** Build a healthcare multi-agent system using different frameworks and see how A2A enables collaboration.
- **A2A and MCP:** Learn how A2A complements MCP by enabling agents to collaborate with each other.
2025-04-09 01:53:20 -04:00
2025-05-09 12:50:37 -05:00
## Why A2A?
As AI agents become more prevalent, their ability to interoperate is crucial for building complex, multi-functional applications. A2A aims to:
- **Break Down Silos:** Connect agents across different ecosystems.
- **Enable Complex Collaboration:** Allow specialized agents to work together on tasks that a single agent cannot handle alone.
- **Promote Open Standards:** Foster a community-driven approach to agent communication, encouraging innovation and broad adoption.
- **Preserve Opacity:** Allow agents to collaborate without needing to share internal memory, proprietary logic, or specific tool implementations, enhancing security and protecting intellectual property.
### Key Features
- **Standardized Communication:** JSON-RPC 2.0 over HTTP(S).
- **Agent Discovery:** Via "Agent Cards" detailing capabilities and connection info.
- **Flexible Interaction:** Supports synchronous request/response, streaming (SSE), and asynchronous push notifications.
- **Rich Data Exchange:** Handles text, files, and structured JSON data.
- **Enterprise-Ready:** Designed with security, authentication, and observability in mind.
## Getting Started
2025-07-16 21:04:47 +01:00
- 📚 **Explore the Documentation:** Visit the [Agent2Agent Protocol Documentation Site ](https://a2a-protocol.org ) for a complete overview, the full protocol specification, tutorials, and guides.
- 📝 **View the Specification:** [A2A Protocol Specification ](https://a2a-protocol.org/latest/specification/ )
2025-07-03 11:09:02 -04:00
- Use the SDKs:
- [🐍 A2A Python SDK ](https://github.com/a2aproject/a2a-python ) `pip install a2a-sdk`
2025-11-11 16:37:02 -05:00
- [🐿️ A2A Go SDK ](https://github.com/a2aproject/a2a-go ) `go get github.com/a2aproject/a2a-go`
2025-07-03 11:09:02 -04:00
- [🧑💻 A2A JS SDK ](https://github.com/a2aproject/a2a-js ) `npm install @a2a-js/sdk`
- [☕️ A2A Java SDK ](https://github.com/a2aproject/a2a-java ) using maven
2025-07-31 15:56:55 +01:00
- [🔷 A2A .NET SDK ](https://github.com/a2aproject/a2a-dotnet ) using [NuGet ](https://www.nuget.org/packages/A2A ) `dotnet add package A2A`
2025-06-24 03:48:32 +09:00
- 🎬 Use our [samples ](https://github.com/a2aproject/a2a-samples ) to see A2A in action
2025-05-09 12:50:37 -05:00
## Contributing
We welcome community contributions to enhance and evolve the A2A protocol!
2025-06-24 03:48:32 +09:00
- **Questions & Discussions:** Join our [GitHub Discussions ](https://github.com/a2aproject/A2A/discussions ).
- **Issues & Feedback:** Report issues or suggest improvements via [GitHub Issues ](https://github.com/a2aproject/A2A/issues ).
2025-05-09 12:50:37 -05:00
- **Contribution Guide:** See our [CONTRIBUTING.md ](CONTRIBUTING.md ) for details on how to contribute.
- **Private Feedback:** Use this [Google Form ](https://goo.gle/a2a-feedback ).
- **Partner Program:** Google Cloud customers can join our partner program via this [form ](https://goo.gle/a2a-partner ).
2025-04-28 15:12:35 -05:00
## What's next
2025-03-25 15:15:56 -07:00
2025-05-09 12:50:37 -05:00
### Protocol Enhancements
2025-04-09 01:53:20 -04:00
2025-04-28 15:12:35 -05:00
- **Agent Discovery:**
2025-06-03 15:08:50 -05:00
- Formalize inclusion of authorization schemes and optional credentials directly within the `AgentCard` .
2025-04-28 15:12:35 -05:00
- **Agent Collaboration:**
2025-06-03 15:08:50 -05:00
- Investigate a `QuerySkill()` method for dynamically checking unsupported or unanticipated skills.
2025-04-28 15:12:35 -05:00
- **Task Lifecycle & UX:**
2025-06-03 15:08:50 -05:00
- Support for dynamic UX negotiation _within_ a task (e.g., agent adding audio/video mid-conversation).
2025-04-28 15:12:35 -05:00
- **Client Methods & Transport:**
2025-06-03 15:08:50 -05:00
- Explore extending support to client-initiated methods (beyond task management).
- Improvements to streaming reliability and push notification mechanisms.
2025-04-09 01:53:20 -04:00
2025-04-28 15:12:35 -05:00
## About
2025-04-09 01:53:20 -04:00
2025-12-05 12:56:36 -08:00
The A2A Protocol is an open source project under the Linux Foundation, contributed by Google. It is licensed under the [Apache License 2.0 ](LICENSE ) and is open to contributions from the community.