A2A Adapter
把 Python Agent、框架和本地 Agent CLI 包装成可通过 A2A 调用的服务器。
- Star 数
- ★ 108
- 最近更新
- 今天
- License
- Apache-2.0
- 主语言
- Python
- FA 评分
- 73/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code(部分支持)
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 希望让自定义 Python 函数接受 A2A 任务的开发者,可用 CallableAdapter 包装函数并通过 serve_agent() 启动服务。
- 不适合
- 需要适配器替你安装或登录底层 Agent 的用户
- 不能接受远程访问配置和令牌管理的团队
- 维护状态
- 近 30 天有提交最近提交 2026-11-20最新版本 v0.4.5(2026-11-19)
- 源码审查
- 73/100 · 存在缺口
这个 Agent 能做什么,适合哪些场景?
A2A Adapter 是面向 Python 3.11+ 的 SDK 和 CLI,用于把 Agent CLI、本地 Agent、工作流引擎、Python 框架或自定义函数暴露为 A2A Protocol 服务器。SDK 提供 ClaudeCodeAdapter、CodexAdapter、LangGraphAdapter、CallableAdapter 等适配器,也允许通过 BaseA2AAdapter 定义自定义适配器。serve_agent() 可启动服务器,to_a2a() 可将其挂载到现有 ASGI 应用;服务会生成 Agent Card,并处理 JSON-RPC、任务生命周期和流式响应。CLI 可启动 Claude Code、Codex、Pi、OpenClaw 或 DeepSeek Harness 等本地 Agent,底层 Agent 仍需由用户安装并配置。服务器默认绑定 127.0.0.1;远程访问需要自行配置绑定地址和认证令牌。
调用方通过 A2A 向服务器发送任务后,A2A Adapter 将请求交给选定的适配器,再由适配器调用底层 Agent、框架、工作流或 Python 函数,并把结果或支持的流式输出交还给 A2A 客户端。SDK 通过官方 A2A SDK 处理 Agent Card、JSON-RPC 和任务生命周期;Agent Card 默认位于 /.well-known/agent-card.json。Claude Code、Codex、Pi 等 CLI 适配器可保存会话状态,以便相关对话在服务器重启后继续。可选的推送通知会向配置的地址 POST 任务更新;推送通知默认关闭,私有网络地址默认拒绝。
- 希望让自定义 Python 函数接受 A2A 任务的开发者,可用 CallableAdapter 包装函数并通过 serve_agent() 启动服务。
- 已经在使用 LangGraph、LangChain 或 CrewAI 的团队,可为现有框架添加 A2A 接口。
- 需要让本地 Claude Code、Codex 或 Pi 接受远程 A2A 请求的开发者,可用 CLI 启动对应适配器。
- 使用 n8n 或 Ollama 的团队,可通过对应的 SDK 适配器把工作流或本地模型服务接入 A2A。
- 维护现有 ASGI 服务的开发者,可用 to_a2a() 将适配器挂载到应用,而不单独启动服务器。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
pip install a2a-adapterpip install "a2a-adapter[langgraph]"uv tool install a2a-adapteruv tool install "a2a-adapter[deepseek-harness]"
- 环境变量
DEEPSEEK_API_KEYA2A_AUTH_TOKEN- 运行环境
- Python 3.11+
如何安装或部署这个 Agent?
需要 Python 3.11+。作为项目 SDK,可安装核心包或选择框架 extras:
pip install a2a-adapter
pip install "a2a-adapter[langgraph]"安装 CLI 时可使用独立工具环境:
uv tool install a2a-adapterDeepSeek Harness 需单独安装额外依赖,并提供 DEEPSEEK_API_KEY:
uv tool install "a2a-adapter[deepseek-harness]"如何使用这个 Agent?
在 Python 项目中包装函数并启动服务器:
from a2a_adapter import CallableAdapter, serve_agent
async def my_agent(inputs: dict) -> str:
return f"Echo: {inputs['message']}"
adapter = CallableAdapter(func=my_agent, name="Echo Agent")
serve_agent(adapter, port=9000)服务器默认只监听本机。要接受远程连接,需配置主机地址并要求令牌:
import os
serve_agent(adapter, host="0.0.0.0", auth_token=os.environ["A2A_AUTH_TOKEN"])如需将其挂载到现有 ASGI 应用,可使用 to_a2a(adapter)。
用 CLI 启动已有的本地 Agent;先确保相应 Agent 已安装、可运行并完成登录:
a2a-adapter claude --port 9010
a2a-adapter codex --port 9011Agent 原生参数可放在 -- 之后:
a2a-adapter codex --port 9011 -- --model <model> --sandbox workspace-write这个 Agent 有哪些优点和局限?
- 同时提供可导入的 Python SDK 和 CLI,既能包装自有代码,也能快速暴露已有本地 Agent。
- 覆盖多个框架和运行对象,包括 LangGraph、LangChain、CrewAI、n8n、Ollama 与 Python callable。
- 通过官方 A2A SDK 处理 Agent Card、JSON-RPC、任务生命周期和流式传输,适配器可专注于调用底层 Agent。
- 支持挂载到现有 ASGI 应用;Claude Code、Codex 和 Pi 等适配器还提供会话持久化。
- 要求 Python 3.11+,CLI 模式还要求对应的底层 Agent 已单独安装并配置。
- 适配器的流式能力因目标而异;Codex、OpenClaw、n8n 和 CrewAI 等表中列出的适配器不支持流式输出。
- 服务器默认仅监听本机;远程连接需要用户配置 host 和认证令牌。
- 推送通知默认关闭,且私有网络接收地址默认会被拒绝;DeepSeek Harness 还需独立 extra 和 DEEPSEEK_API_KEY。
这个 Agent 与同类方案有什么区别?
相较于自行实现 A2A 服务器,A2A Adapter 提供现成的 AgentCard、JSON-RPC、任务生命周期处理及多种适配器;相较于直接运行本地 Agent CLI,它增加了 A2A 服务接口,但不会代替用户安装或配置底层 Agent。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| A2A Adapter 当前 | 73 · 存在缺口 | 代码库 / SDK | ★ 108 | 今天 | Python | — |
| ai4j — Java AI Agentic 开发套件 | 60 · 存在缺口 | 代码库 / SDK免费 + 模型费 | ★ 442 | 1 个月前 | Java | OpenAI API · Claude API |
| Agent2Agent (A2A) 协议 | 47 · 缺口较多 | 代码库 / SDK免费 | ★ 27k | 3 天前 | Shell | — |
| Agent Adapter 工具执行框架 | 72 · 存在缺口 | 代码库 / SDK免费 + 模型费 | ★ 13 | 3 天前 | Python | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
默认绑定 127.0.0.1、远程访问可要求 bearer token、推送通知默认关闭,并对推送目标做公网地址校验和连接时重检,体现了较好的权限与数据流控制(least_privilege 2、data_flow_transparency 3、external_effects 2)。但 Agent Card 例外于认证,且没有请求前的用户确认机制;异常文本可能含 URL、路径和令牌,虽默认只记日志且客户端错误泛化,仍需谨慎处理(user_confirmation 1、sensitive_data_handling 2)。依赖有下限和部分上限,未见全面锁定或漏洞缓解证据;CLI 可终止进程组,旧会话迁移/删除说明提供有限恢复路径(dependency_security 1、rollback 2)。README 和包元数据标明项目及 Apache-2.0,但发布者身份按题设未知(source_attribution 2)。
README、SKILL、CLI 和服务器代码在绑定地址、认证、推送默认行为及错误处理上基本一致;但展示的 CLI 源码只到参数解析中段,无法核对全体实现(self_consistency 2)。核心依赖声明了版本范围,部分框架可选安装,DeepSeek Harness 需额外预发布依赖;未见依赖可用性保障或完整锁定证据(dependency_availability 1)。任务失败默认给客户端通用信息并记录服务器日志,支持显式 UserFacingError,原始错误详情需主动开启,错误说明清晰(failure_messages 3)。
文档清楚面向 Python SDK 使用者与本地 CLI 用户,列出多框架场景、适配器选择及示例(audience_and_scenarios 3、trigger_precision 3)。产品边界和适配器职责有所说明,也披露流式、平台和特定集成限制,但样本不能确认完整能力矩阵(capability_boundaries 2)。Python 3.11+、隔离式 CLI 安装、操作系统差异、环境变量和工作目录说明具体;对部署环境、规模与生产运维要求仍有限(environment_fit 2)。
README 将 SDK、CLI、安全选项、配置和文档入口组织清楚,安装、升级、依赖额外项及基本运行方式具体(information_architecture 3、install_notes 3)。适配器命名大体一致,但文档中的广泛兼容宣称超出所给源码片段可逐项核实范围(naming_stability 2)。多种示例和决策表可用,错误说明与具体已知限制较充分(examples_and_faq 3、known_limitations 3)。LICENSE 与 pyproject 元数据一致且给出完整 Apache-2.0 文本(license 3);有版本号、变更日志入口和发布工作流,但未提供变更日志正文(versioning_changelog 2)。作者字段和项目渠道存在,维护责任、支持承诺及身份验证路径并不清楚(maintenance_responsibility 1)。
SDK/CLI 能把多类 agent 暴露为 A2A 服务,说明其相对直接集成有明显用途(marginal_value 3)。Agent Card、错误、认证、推送和状态目录的文档让输出可供集成者使用,但实际结果质量不能由静态材料确认(output_usability 2)。少量代码即可启动服务、隔离工具安装降低入门成本;依赖配置、会话状态和多个框架额外项仍增加维护成本(cost_benefit 2)。
主要操作主张能在 README、SKILL、包配置、CLI 和服务器片段中找到对应说明;但源码包不完整,无法逐项核验所有适配器行为(claim_traceability 2)。README 与 SKILL 对核心用法相互印证,配置和 CI 工作流提供部分旁证;测试源码只提供 fixtures 与一项需外部 CLI/网络的 E2E 说明,不能视为本次执行或结果验证(cross_source_corroboration 2)。材料区分默认值、可选配置、错误行为及已知限制,没有把静态审阅冒充运行验证(fact_inference_separation 3)。
- 远程部署前应单独评估 Agent Card 未认证可访问、底层 agent 的工具权限以及认证令牌配置;推送目标仅允许私网时会放宽 SSRF 防护。
- 异常详情可能进入服务端日志;推送接收端、会话持久化目录和底层 agent 配置都应纳入数据治理。
- 材料未包含完整源码、变更日志正文或依赖漏洞审查,且本评估未执行代码或测试。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
[0.4.5](https://github.com/hybroai/a2a-adapter/compare/v0.4.4...v0.4.5) (2026-11-19) Features * langgraph: resume an interrupted graph on the client's reply ([5195aa6](https://github.com/hybroai/a2a-adapter/commit/5195aa60fcc90e38cc524787f25085ae4490c235)) Bug Fixes * langgraph: report interrupted graphs as input-required ([bc4efe7](https://github.com/hybroai/a2a-adapter/commit/bc4efe7d9baeef91d36f45dfce42ba0a466c51d7))在 GitHub 查看 ↗ -
发布说明摘录
[0.4.4](https://github.com/hybroai/a2a-adapter/compare/v0.4.3...v0.4.4) (2026-11-16) Bug Fixes * extract LangChain messages from dictionary outputs ([5e2bc6c](https://github.com/hybroai/a2a-adapter/commit/5e2bc6cce74eb120250db11246fc9e8a6953bbd0)) * extract LangChain messages from dictionary outputs ([a60bd21](https://github.com/hybroai/a2a-adapter/commit/a60bd21b389855e3571df2652e4cc7816d417808)) * langgraph: select the final assistant reply ([2df40c9](https://github.com/hybroai/a2a-adapter/commit/2df40c9340998ee1951c50ae861c4b0bb49fef08)) …在 GitHub 查看 ↗ -
发布说明摘录
[0.4.3](https://github.com/hybroai/a2a-adapter/compare/v0.4.2...v0.4.3) (2026-11-15) Bug Fixes * enforce stream deadlines between buffered chunks ([99c816d](https://github.com/hybroai/a2a-adapter/commit/99c816db45e368637995b9fc263c71037b71c7c1)) * enforce stream deadlines between buffered chunks ([0222f4f](https://github.com/hybroai/a2a-adapter/commit/0222f4fb901dee6eb4dff6572058d37b8d7f4a37))在 GitHub 查看 ↗
常见问题
使用 CLI 时,适配器会替我安装或登录 Claude Code 等 Agent 吗?
服务器能否接受远程连接?
支持推送任务更新吗?
使用需要付费的模型或服务吗?
适配器会保存对话会话吗?
A2A Adapter 开源吗?
A2A Adapter 安全吗?
A2A Adapter 还在维护吗?
A2A Adapter 是谁开发的?
谢谢反馈,我们会据此改进页面。