使用说明
MCP和A2A(ADK/代理引擎)
这个存储库包含我对三个谷歌代码实验室的复制品,这些实验室专注于 模型上下文协议(MCP) 和 代理人对代理人(A2A) 通信使用 代理开发工具包(ADK) 和 代理引擎.
每个codelab都位于自己的文件夹中,其中包含 自己的README、可运行代码和a 视频漫游 占位符。
📁 存储库结构
mcp-a2a-codelabs/
├─ codelab-1-multi-agents-adk-a2a/ # Create multi-agent system with ADK, deploy to Agent Engine, start A2A
│ ├─ README.md
│ └─ ... (code & assets)
├─ codelab-2-currency-agent-mcp-a2a/ # Getting started with ADK, MCP, and A2A (Currency Agent)
│ ├─ README.md
│ └─ ... (code & assets)
├─ codelab-3-a2a-purchasing-concierge/ # Intro to A2A with Action Engine (Purchasing Concierge)
│ ├─ README.md
│ └─ ... (code & assets)
└─ README.md # (this file)
🎯 任务目标
- 练习 主控程序 (模型的工具/资源暴露)以及 A2A (代理到代理协议)。
- 使用 套件 在本地构建和运行代理 部署到代理引擎 如有需要。
- 生成可运行的工件+ 视频演练 对于每个代码实验室。
🔗 Codelabs(来源)
-
代码实验室1: 使用ADK创建多代理系统,在agent Engine中部署,开始使用A2A https://codelabs.developers.google.com/codelabs/create-multi-agents-adk-a2a#0
-
代码实验室2: 开始使用ADK、MCP和A2A(货币代理) https://codelabs.developers.google.com/codelabs/currency-agent#0
-
代码实验室3: A2A行动引擎入门(采购礼宾) https://codelabs.developers.google.com/intro-a2a-purchasing-concierge#0
每个codelab的子README中都记录了确切的指令、环境变量和命令。
🧰 先决条件(高级)
- 最近 python 和 Node.js 工具链(根据每个代码实验室的要求)。
- 访问 代理引擎 (如果部署是演习的一部分)。
- 代码实验室中提到的任何API密钥或项目配置。
- 推荐:虚拟环境(
venv/conda)或每个codelab的npm/yarn工作区。
有关精确的版本、环境变量和运行脚本,请参阅每个文件夹的README。
🚀 如何跑步(快速入门)
# 1) Clone this repo
git clone <your-repo-url> mcp-a2a-codelabs
cd mcp-a2a-codelabs
# 2) Choose a codelab
cd codelab-1-multi-agents-adk-a2a # or codelab-2-... / codelab-3-...
# 3) Follow the local README for environment setup & run commands
# (e.g., create venv, install deps, set env vars, start agents/services)
🎥 视频演练(占位符)
- (Codelab 1视频: )[https://youtu.be/KMCOmMYH7mw]
- (Codelab 2视频: )[#]
- (Codelab 3视频: *)[#]
每个子文件夹README都包含视频演示的简短议程以及录制过程中使用的确切命令。
✅ 可交付成果清单
-
[ ]
codelab-1-multi-agents-adk-a2a/- []代码在本地编译/运行
- []代理引擎部署(如果适用)
- []README,包括步骤、环境变量和示例输出
- [ ] 已添加视频链接
-
[ ]
codelab-2-currency-agent-mcp-a2a/- []代码在本地编译/运行
- []MCP/A2A流程已验证
- []README,包括步骤、环境变量和示例输出
- [ ] 已添加视频链接
-
[ ]
codelab-3-a2a-purchasing-concierge/- []代码在本地编译/运行
- []A2A动作引擎交互已验证
- []README,包括步骤、环境变量和示例输出
- [ ] 已添加视频链接
🧪 验证与证据
每个子README包括:
- 设置和运行 说明(可复制粘贴)。
- 配置 (环境变量、密钥、项目ID)。
- 屏幕截图/日志 成功运行和A2A互动。
- 故障排除 常见错误的注意事项。
📄 许可证
选择适合您的课程或组织的许可证。例子:
MIT License — see LICENSE file for details.
🙌 致谢
- ADK、MCP、A2A和代理引擎的谷歌代码实验室和文档。
- 课程工作人员负责作业设计和评估标准。
提示: 保留子文件夹README 独立的--应该有人能够通过只跟踪该文件来端到端地运行每个codelab。