A2A Adapter

把 Python Agent、框架和本地 Agent CLI 包装成可通过 A2A 调用的服务器。

Star 数
★ 108
最近更新
今天
License
Apache-2.0
主语言
Python

30 秒速览

运行形态
代码库 / SDK命令行工具自托管服务
可在哪里用
通用 · 跨平台Codex · Claude Code(部分支持)
上手难度
中 · 需要几步配置
开始前需要
Python 3.11+a2a-sdk对应 CLI 适配器所需的 Claude Code、Codex、Pi、OpenClaw 或 DeepSeek HarnessShell / 命令行网络访问本地文件系统MCP Server
典型场景
希望让自定义 Python 函数接受 A2A 任务的开发者,可用 CallableAdapter 包装函数并通过 serve_agent() 启动服务。
不适合
  • 需要适配器替你安装或登录底层 Agent 的用户
  • 不能接受远程访问配置和令牌管理的团队
维护状态
近 30 天有提交最近提交 2026-11-20最新版本 v0.4.5(2026-11-19)

这个 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 任务更新;推送通知默认关闭,私有网络地址默认拒绝。

  1. 希望让自定义 Python 函数接受 A2A 任务的开发者,可用 CallableAdapter 包装函数并通过 serve_agent() 启动服务。
  2. 已经在使用 LangGraph、LangChain 或 CrewAI 的团队,可为现有框架添加 A2A 接口。
  3. 需要让本地 Claude Code、Codex 或 Pi 接受远程 A2A 请求的开发者,可用 CLI 启动对应适配器。
  4. 使用 n8n 或 Ollama 的团队,可通过对应的 SDK 适配器把工作流或本地模型服务接入 A2A。
  5. 维护现有 ASGI 服务的开发者,可用 to_a2a() 将适配器挂载到应用,而不单独启动服务器。

安装与配置要点

摘自下方的安装和使用说明,以项目 README 的最新说明为准。

安装 / 启动命令
  • pip install a2a-adapter
  • pip install "a2a-adapter[langgraph]"
  • uv tool install a2a-adapter
  • uv tool install "a2a-adapter[deepseek-harness]"
环境变量
DEEPSEEK_API_KEY A2A_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-adapter

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

Agent 原生参数可放在 -- 之后:

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?

FollowAgents 源码审查 · FARS-2.1
存在缺口
73/ 100 五分制 3.7 / 5
本评测基于 2026年11月11日 的源码;此后该项目发布了 4 个正式版本,尚未复审。分数与结论只代表评测时的版本。 最近版本 ↓
信任安全 18/29
可靠稳定 9/14
适用触发 15/18
规范维护 15/18
有效结果 10/13
证据核验 6/8
查看各维度的扣分理由
信任安全18 / 29 · 3.1/5

默认绑定 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)。

可靠稳定9 / 14 · 3.2/5

README、SKILL、CLI 和服务器代码在绑定地址、认证、推送默认行为及错误处理上基本一致;但展示的 CLI 源码只到参数解析中段,无法核对全体实现(self_consistency 2)。核心依赖声明了版本范围,部分框架可选安装,DeepSeek Harness 需额外预发布依赖;未见依赖可用性保障或完整锁定证据(dependency_availability 1)。任务失败默认给客户端通用信息并记录服务器日志,支持显式 UserFacingError,原始错误详情需主动开启,错误说明清晰(failure_messages 3)。

适用触发15 / 18 · 4.2/5

文档清楚面向 Python SDK 使用者与本地 CLI 用户,列出多框架场景、适配器选择及示例(audience_and_scenarios 3、trigger_precision 3)。产品边界和适配器职责有所说明,也披露流式、平台和特定集成限制,但样本不能确认完整能力矩阵(capability_boundaries 2)。Python 3.11+、隔离式 CLI 安装、操作系统差异、环境变量和工作目录说明具体;对部署环境、规模与生产运维要求仍有限(environment_fit 2)。

规范维护15 / 18 · 4.2/5

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

有效结果10 / 13 · 3.8/5

SDK/CLI 能把多类 agent 暴露为 A2A 服务,说明其相对直接集成有明显用途(marginal_value 3)。Agent Card、错误、认证、推送和状态目录的文档让输出可供集成者使用,但实际结果质量不能由静态材料确认(output_usability 2)。少量代码即可启动服务、隔离工具安装降低入门成本;依赖配置、会话状态和多个框架额外项仍增加维护成本(cost_benefit 2)。

证据核验6 / 8 · 3.8/5

主要操作主张能在 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 配置都应纳入数据治理。
  • 材料未包含完整源码、变更日志正文或依赖漏洞审查,且本评估未执行代码或测试。
证据充分度:低 评估于 2026年11月11日 审查版本 2ba323eb00d9 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/a2a-adapter.svg?lang=zh)](https://followagents.com/zh/agents/a2a-adapter)
<a href="https://followagents.com/zh/agents/a2a-adapter"><img src="https://followagents.com/badge/a2a-adapter.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v0.4.5
    发布说明摘录
    [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 查看 ↗
  2. v0.4.4
    发布说明摘录
    [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 查看 ↗
  3. v0.4.3
    发布说明摘录
    [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 吗?
不会。README 要求先单独安装底层 Agent、确认命令可用,并完成其登录流程;若命令不在 PATH,可通过 --executable 指定路径。
服务器能否接受远程连接?
可以。SDK 可绑定 host="0.0.0.0",并配置 auth_token;CLI 支持 --host 和 --auth-token。README 建议通过 A2A_AUTH_TOKEN 环境变量提供令牌。
支持推送任务更新吗?
支持,但默认关闭。启用 push_notifications 后,私有网络、localhost 和云元数据地址仍会被拒绝,除非另行启用 allow_private_push_urls。
使用需要付费的模型或服务吗?
README 没有说明软件或底层 Agent 的费用。DeepSeek Harness 适配器明确要求 DEEPSEEK_API_KEY,但来源未说明该密钥对应服务的收费情况。
适配器会保存对话会话吗?
Claude Code 和 Codex 按工作目录与 A2A contextId 保存会话,Pi 在每个工作目录保存单个会话;这些会话可在服务器重启后续用。
A2A Adapter 开源吗?
开源。源码在 GitHub(hybroai/a2a-adapter),许可证是 Apache-2.0。
A2A Adapter 安全吗?
FollowAgents 的 FARS 评审(2026年11月11日)给 A2A Adapter 的“信任与安全”打了 18/29 分。评审检查的 8 项安全措施没有完全缺失的。评审之后仓库已有更新。
A2A Adapter 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-20,在最近 30 天内。最新版本是 v0.4.5(2026-11-19)。
A2A Adapter 是谁开发的?
A2A Adapter 由 GitHub 账号 hybroai 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念