From c2ce3587ebd23cf21d8140c81e2d29781b4ea167 Mon Sep 17 00:00:00 2001 From: Holt Skinner <13262395+holtskinner@users.noreply.github.com> Date: Thu, 19 Feb 2026 11:35:13 -0600 Subject: [PATCH] docs: Revise README with badges and improved content Updated README to enhance clarity and add badges for version and license. Improved the introduction and getting started sections for better user guidance. --- profile/README.md | 148 +++++++++++++++++++++++++++++++++++----------- 1 file changed, 113 insertions(+), 35 deletions(-) diff --git a/profile/README.md b/profile/README.md index d118775..6c60083 100644 --- a/profile/README.md +++ b/profile/README.md @@ -1,50 +1,128 @@ # Agent2Agent (A2A) Protocol -

- Agent2Agent Protocol Logo -

+[![PyPI - Version](https://img.shields.io/pypi/v/a2a-sdk)](https://pypi.org/project/a2a-sdk) +[![Apache License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE) + + Ask Code Wiki + -

- An open standard for seamless communication and interoperability between AI agents -

+
+
+ 🌐 Language +
+
+ English + | 简体中文 + | 繁體中文 + | 日本語 + | 한국어 + | हिन्दी + | ไทย + | Français + | Deutsch + | Español + | Italiano + | Русский + | Português + | Nederlands + | Polski + | العربية + | فارسی + | Türkçe + | Tiếng Việt + | Bahasa Indonesia + | অসমীয়া +
+
+
+
-

- Documentation | - Specification | - Discussions -

+ +
+
+ Agent2Agent Protocol Logo +

Agent2Agent (A2A) Protocol

+
+
-The Agent2Agent (A2A) Protocol is an open standard designed to facilitate communication and interoperability between independent, potentially opaque AI agent systems. In an ecosystem where agents might be built using different frameworks, languages, or by different vendors, A2A provides a common language and interaction model, enabling agents to discover capabilities, negotiate modalities, and collaborate on complex tasks. +**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 + +[![A2A DeepLearning.AI](https://img.youtube.com/vi/4gYm0Rp7VHc/maxresdefault.jpg)](https://goo.gle/dlai-a2a) + +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). + +**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 -- 📚 Read the [Documentation](https://a2a-protocol.org) for guides and tutorials -- 🔍 Review the [Specification](https://github.com/a2aproject/A2A/blob/main/docs/specification.md) for protocol details -- 💻 Use our SDKs to start building: - - [Python SDK](https://github.com/a2aproject/a2a-python) - - [JavaScript/TypeScript SDK](https://github.com/a2aproject/a2a-js) - - [Java SDK](https://github.com/a2aproject/a2a-java) - - [Go SDK](https://github.com/a2aproject/a2a-go) - - [.NET SDK](https://github.com/a2aproject/a2a-dotnet) - -## Project Structure - -- [A2A](https://github.com/a2aproject/A2A) - Core protocol specification and technical documentation -- [a2a-python](https://github.com/a2aproject/a2a-python) - Official Python SDK implementation -- [a2a-js](https://github.com/a2aproject/a2a-js) - Official JavaScript/TypeScript SDK implementation -- [a2a-java](https://github.com/a2aproject/a2a-java) - Official Java SDK implementation -- [a2a-go](https://github.com/a2aproject/a2a-go) - Official Go SDK implementation -- [a2a-dotnet](https://github.com/a2aproject/a2a-dotnet) - Official C#/.NET SDK implementation -- [a2a-samples](https://github.com/a2aproject/a2a-samples) - Example agents, clients, and multi-agent workflows -- [a2a-inspector](https://github.com/a2aproject/a2a-inspector) - Validation tools for A2A-enabled agents -- [a2a-tck](https://github.com/a2aproject/a2a-tck) - Technology Compatibility Kit for implementation testing +- 📚 **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/) +- Use the SDKs: + - [🐍 A2A Python SDK](https://github.com/a2aproject/a2a-python) `pip install a2a-sdk` + - [🐿️ A2A Go SDK](https://github.com/a2aproject/a2a-go) `go get github.com/a2aproject/a2a-go` + - [🧑‍💻 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 + - [🔷 A2A .NET SDK](https://github.com/a2aproject/a2a-dotnet) using [NuGet](https://www.nuget.org/packages/A2A) `dotnet add package A2A` +- 🎬 Use our [samples](https://github.com/a2aproject/a2a-samples) to see A2A in action ## Contributing -We welcome contributions of all kinds! Whether you want to fix bugs, improve documentation, or propose new protocol extensions, please see our [contributing guide](CONTRIBUTING.md) to get started. +We welcome community contributions to enhance and evolve the A2A protocol! + +- **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). +- **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). + +## What's next + +### Protocol Enhancements -Have questions? Join the discussion in our [community forum](https://github.com/orgs/a2aproject/discussions). +- **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 Agent2Agent (A2A) Protocol is an open source project hosted by [The Linux Foundation](https://lfprojects.org), originally contributed by Google, and open to contributions from the entire community. +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.