Hands-On Tutorials
Tutorials
This section collects A2A tutorials from beginner to advanced. If you are new to A2A, complete the Python quickstart first, then pick later samples by language and scenario.
Python
| Tutorial | Description | Difficulty |
|---|---|---|
| A2A and Python Quickstart | Build a simple Python-based “echo” A2A server and client | Easy |
| ADK facts | Build and test a simple Personal Assistant agent with the Agent Development Kit (ADK) that can provide interesting facts | Easy |
| ADK agent on Cloud Run | Deploy, manage, and observe an ADK-based agent as a scalable, serverless service on Google Cloud Run | Easy |
| Multi-agent collaboration using A2A | Set up an orchestrator (host agent) that routes and manages requests among several specialized A2A-compatible agents | Easy |
| Airbnb and weather multi-agent | Build a complex multi-agent system where agents collaborate using A2A to plan a trip, finding both Airbnb accommodations and weather information | Medium |
| A2A client-server example using a remote ADK agent | See how a local A2A client agent discovers and consumes the capabilities of a separate, remote ADK-based agent (for example, a prime number checker) | Easy |
| Colab Notebook | Deploy A2A agents to Cloud Run from your browser, then evaluate their performance with Vertex AI | Easy |
Java
| Tutorial | Description | Difficulty |
|---|---|---|
| Weather Agent | Build a weather information agent using an MCP server | Easy |
| Content Writer Agent | Build a content writer agent that generates content from outlines | Easy |
| Content Editor Agent | Build a content editor agent that proof-reads and polishes content | Easy |
| Dice Agent (multi-transport) | Build a multi-transport agent that rolls dice and checks for prime numbers | Medium |
| Magic 8 Ball Agent (security) | Learn how to secure A2A servers with Keycloak using bearer token authentication, and configure a client to obtain and pass the token | Medium |
JavaScript
| Tutorial | Description |
|---|---|
| Movie research agent using JavaScript | Build an A2A agent with Node.js that uses the TMDB API to handle movie searches and queries |
C#/.NET
| Tutorial | Description |
|---|---|
| All .NET samples | Foundational samples showing how to build A2A clients and servers with the C#/.NET SDK, including an Echo agent |
Learning tips
- Beginners: read Key Concepts first, then complete the Python quickstart in order and get every step running locally.
- Developers: focus on the task lifecycle and executor design, verify streaming and multi-turn interactions, and compare with What’s New in A2A Protocol v1.0 .
- Enterprise teams: start with Enterprise-Ready Features and Multi-Tenancy , then fill in compatibility and observability tests.