A2A – a2aproject

Agent2Agent (A2A) Protocol

<img src="https://img.shields.io/pypi/v/a2a-sdk" alt="PyPI - Version" class="ra0-md-img" loading="lazy" />
<img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg" alt="Apache License" class="ra0-md-img" loading="lazy" />
<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>

<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>

<!-- markdownlint-disable MD041 -->
<div style="text-align: center;">
<div class="centered-logo-text-group">
<img src="docs/assets/a2a_logo/color/SVG/a2a_color.svg" alt="Agent2Agent Protocol Logo" width="100">
<h1>Agent2Agent (A2A) Protocol</h1>
</div>
</div>

An open protocol enabling communication and interoperability between opaque agentic applications.*

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.

With A2A, agents can:

• Discover each other's capabilities.
• Negotiate interaction modalities (text, forms, media).
• Securely collaborate on long-running tasks.
• Operate without exposing their internal state, memory, or tools.

DeepLearning.AI Course

<img src="https://img.youtube.com/vi/4gYm0Rp7VHc/maxresdefault.jpg" alt="A2A DeepLearning.AI" class="ra0-md-img" loading="lazy" />

Join this short course on A2A: The Agent2Agent Protocol, built in partnership with Google Cloud and IBM Research, and taught by Holt Skinner, Ivan Nardini, and Sandi Besen.

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.

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

• 📚 Explore the Documentation:* Visit the Agent2Agent Protocol Documentation Site for a complete overview, the full protocol specification, tutorials, and guides.
• 📝 View the Specification:* A2A Protocol Specification
• Use the SDKs:
• 🐍 A2A Python SDK pip install a2a-sdk
• 🐿️ A2A Go SDK go get github.com/a2aproject/a2a-go
• 🧑‍💻 A2A JS SDK npm install @a2a-js/sdk
• ☕️ A2A Java SDK using maven
• 🔷 A2A .NET SDK using NuGet dotnet add package A2A
• 🦀 A2A Rust SDK cargo add a2a-lf
• 🎬 Use our samples to see A2A in action

Contributing

We welcome community contributions to enhance and evolve the A2A protocol!

• Questions & Discussions:* Join our GitHub Discussions or the A2A Discord server.
• Issues & Feedback:* Report issues or suggest improvements via GitHub Issues.
• Contribution Guide:* See our CONTRIBUTING.md for details on how to contribute.
• Private Feedback:* Use this Google Form.
• Partner Program:* Google Cloud customers can join our partner program via this form.

What's next

Protocol Enhancements

• Agent Discovery:*
• Formalize inclusion of authorization schemes and optional credentials directly within the AgentCard.
• Agent Collaboration:*
• Investigate a QuerySkill() method for dynamically checking unsupported or unanticipated skills.
• Task Lifecycle & UX:*
• Support for dynamic UX negotiation _within_ a task (e.g., agent adding audio/video mid-conversation).
• Client Methods & Transport:*
• Explore extending support to client-initiated methods (beyond task management).
• Improvements to streaming reliability and push notification mechanisms.

About

The A2A Protocol is an open source project under the Linux Foundation, contributed by Google. It is licensed under the Apache License 2.0 and is open to contributions from the community.