Agent Adapter 工具执行框架

把 Python 工具接入不同智能体框架,并通过统一执行器管理审批、预算与追踪。

Star 数
★ 13
最近更新
3 天前
License
Apache-2.0
主语言
Python

30 秒速览

运行形态
代码库 / SDK开发框架命令行工具
可在哪里用
通用 · 跨平台OpenAI API · Claude APICodex · Claude Code(部分支持)
费用
软件免费,模型调用费用自付
上手难度
中 · 需要几步配置
开始前需要
Python 3.11+PydanticShell / 命令行网络访问本地文件系统MCP Server
典型场景
需要在 LangGraph 与 CrewAI 等框架之间迁移、又想复用同一批 Python 工具的工程团队。
不适合
  • 需要开箱即用托管服务的团队
  • 必须在 TypeScript 中直接编写核心工具的团队
官网
agent-adapter.veloceai.in ↗ 来自 GitHub 仓库设置
维护状态
近 30 天有提交最近提交 2026-11-18最新版本 v1.2.0(2026-11-18)

这个 Agent 能做什么,适合哪些场景?

Agent Adapter 是一个与具体框架无关的 Python SDK,要求 Python 3.11 或更高版本。开发者可用 @aa.tool 将普通 Python 函数注册为工具,执行器会校验参数并应用配置的审批、预算、缓存、重试和成本记录。LangChain、CrewAI、Google ADK 等框架以及 OpenAI、Gemini、Anthropic 模型接口通过可选适配器接入;工具也可经 MCP、HTTP、A2A 或 AG-UI 暴露。它提供 Flow 图编排和 run_tool_loop 智能体循环,并可输出事件、账本记录和 OpenTelemetry 追踪。可将其作为库嵌入服务或脚本,也可运行 HTTP 服务、MCP 服务和仅绑定本机的运行查看器。

通过 @aa.tool 或 registry.wrap() 注册 Python 函数,并在启动时检查工具 schema;调用 aa.call、aa.acall 或 Executor.run 时,执行器验证参数,再按配置运行 guards、预算检查、审批、缓存、重试和超时处理。run_tool_loop 会驱动模型端口反复请求工具调用直至模型给出回答;Flow 和 FlowRunner 可执行带路由、并行分支、合并及人工暂停的流程。框架适配器、模型 API、MCP 和 HTTP 接口把调用送入同一执行管线。执行结果包括工具返回值、调用成本、事件和追踪;可选 viewer 展示运行记录、流程图、时间线及聊天界面。

  1. 需要在 LangGraph 与 CrewAI 等框架之间迁移、又想复用同一批 Python 工具的工程团队。
  2. 需要对退款等高风险工具调用进行人工审批,并将待审批调用存入 SQLite 以便稍后恢复的服务团队。
  3. 希望给每次运行设置调用次数或金额上限,并记录工具成本的应用开发者。
  4. 需要把 Python 工具通过 MCP 或 HTTP 提供给其他语言客户端的团队。
  5. 需要构建可路由、并行执行、暂停等待人工的智能体流程,并在本地查看运行记录的开发者。

如何安装或部署这个 Agent?

需要 Python 3.11 或更高版本。基础包依赖 Pydantic;使用模型端口或框架适配器时,安装相应可选 extra。README 没有规定必须使用哪家模型服务,也没有提供凭据要求的统一规则;实际凭据取决于所选模型提供方。

如何使用这个 Agent?

将工具注册到默认 registry,并通过默认 executor 调用。若使用需要凭据的模型或提供方 SDK,按该提供方配置凭据;下面的基础调用不需要模型 API 密钥。

这个 Agent 有哪些优点和局限?

优点
  • 同一 Python 工具可通过多个框架适配器复用,审批、预算和执行规则集中在同一执行器。
  • DeferredApproval 可将待审批调用保存在 SQLite,并在之后恢复;审批令牌绑定具体调用且只能使用一次。
  • 包含 Flow、run_tool_loop、MCP/HTTP 接口以及本地运行查看器,能覆盖从工具执行到流程调试的多种集成方式。
  • 核心只依赖 Pydantic,模型和框架集成按可选 extra 安装并延迟导入。
局限
  • 要求 Python 3.11+;核心工具仍需以 Python 函数编写,其他语言需通过 MCP 或 HTTP 客户端接入。
  • 框架、模型提供方、持久化存储和 guard 后端通常需要各自安装 extra,部分集成还需单独环境。
  • 使用 OpenAI、Gemini、Anthropic 等在线模型时,凭据和模型调用费用由用户按提供方承担;README 未给出统一成本估算。
  • 配置与部署方式取决于所需功能;README 展示了多种后端与存储选项,完整生产配置需要进一步选择和设置。

这个 Agent 与同类方案有什么区别?

相较于直接使用 LangChain、CrewAI 或 ADK 各自的工具格式,Agent Adapter 将工具注册和执行管线放在框架之外,并提供这些框架的适配器。若应用不需要智能体框架,也可直接用它的执行器、run_tool_loop 或 Flow。

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
Agent Adapter 工具执行框架 当前 72 · 存在缺口 代码库 / SDK免费 + 模型费 ★ 13 3 天前 Python OpenAI API · Claude API
AG2:开源智能体操作系统 75 · 表现良好 代码库 / SDK免费 + 模型费 ★ 5.1k 1 天前 Python OpenAI API
mcp-agent 60 · 存在缺口 开发框架免费 + 模型费 ★ 8.6k 9 个月前 Python Claude.ai · OpenAI API · Claude API
Pocket Flow 45 · 缺口较多 代码库 / SDK免费 + 模型费 ★ 11k 3 个月前 Python —

FollowAgents 如何评估这个 Agent?

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

安全文档与代码显示默认拒绝(无审批端口时 confirm 调用被拒)、一次性审批绑定 run/call/参数摘要、HTTP 服务器默认要求认证、日志脱敏与崩溃文本隐藏,审批与沙箱设计较完整。但 least_privilege 仅得 2:沙箱文档明确不隔离宿主内核,LocalSubprocessSandbox 仅开发用,且 code_tool 依赖审批端口强度;data_flow_transparency 得 2:有事件目录与 OTel,但未提供完整数据流图或每个外部调用的数据去向清单;sensitive_data_handling 得 2:有 PIIGuard 与脱敏,但 Presidio/NeMo 为可选且需额外模型,未证明默认覆盖;dependency_security 得 2:依赖有上下界并提及 h11 CVE,但未提供 SBOM、锁定文件或漏洞扫描证据;external_effects 得 2:有预算、限流、超时与副作用确认,但重试与超时后线程继续运行的副作用风险仅文档提示;rollback 得 1:仅审批可恢复与审计日志,缺少工具副作用回滚或补偿机制;source_attribution 得 2:LICENSE/NOTICE 与作者信息存在,但发布者身份未经验证,归属仅部分可核。

可靠稳定9 / 14 · 3.2/5

self_consistency 得 2:README、AGENTS.md、SKILL.md 与 pyproject 在版本、Python 要求、安装方式上大体一致,但 README 称 21 个框架而 AGENTS.md 列出更多,且部分示例依赖未展示文件;dependency_availability 得 2:可选依赖有明确版本范围并说明独立环境冲突,但未提供锁定文件或已解析依赖树,无法静态确认可安装;failure_messages 得 2:错误类型分层(AdapterError、ToolUsageError、ConfigError 等)且 CLI 返回码有定义,但部分错误文本与恢复建议仅见于文档,代码样本中未全部展示。

适用触发15 / 18 · 4.2/5

audience_and_scenarios 得 3:README、SKILL.md 与 AGENTS.md 覆盖脚本、服务、框架、多语言与无框架场景,受众明确;capability_boundaries 得 3:安全文档明确列出适配器不提供沙箱、密钥库、内容审核与按用户限流,边界清晰;trigger_precision 得 2:SKILL.md 的 description 触发条件较宽泛(任何 agent 工具需求),可能过度触发,且未给出排除条件;environment_fit 得 2:支持 Python 3.11–3.13 与多种后端,但部分框架需独立环境、Windows 本地沙箱有已知限制,跨平台适配未完全验证。

规范维护15 / 18 · 4.2/5

information_architecture 得 3:README 分层清晰,docs 按 get-started/how-to/concepts/reference 组织,项目布局说明完整;install_notes 得 3:安装命令、extras 表、独立环境说明与 doctor 检查齐全;naming_stability 得 2:有 API 稳定性策略链接,但样本中未展示具体版本化命名规则或弃用流程;examples_and_faq 得 3:大量可运行示例、代码巡览与演示链接;known_limitations 得 3:安全文档与沙箱文档明确列出不提供的能力与残余风险;license 得 3:Apache-2.0 LICENSE 与 NOTICE 存在,pyproject 使用 SPDX 表达式;versioning_changelog 得 2:有版本号与 CHANGELOG 链接,但样本未包含 CHANGELOG 内容或语义化版本承诺细节;maintenance_responsibility 得 1:发布者为未验证的 Veloce AI,无维护者列表、安全联系渠道或 SLA,仅作者字段。

有效结果9 / 13 · 3.5/5

output_usability 得 2:工具输出结构化(结果、成本、追踪),但需用户自行接入执行器与审批端口,开箱即用程度中等;marginal_value 得 2:统一执行器与跨框架适配有明确价值,但同类框架与 SDK 竞争激烈,差异化依赖未验证的集成质量;cost_benefit 得 2:核心仅依赖 pydantic,可选 extras 按需安装,但多框架集成增加维护与冲突成本,且未提供性能或成本基准。

证据核验5 / 8 · 3.1/5

claim_traceability 得 2:多数声明可追溯到 README、安全文档或代码,但覆盖率 90%、21 框架等数字未在样本中给出可复现的验证命令或报告;cross_source_corroboration 得 2:README、AGENTS.md、SKILL.md 与 pyproject 相互印证版本与安装,但测试与 CI 仅展示工作流文件,未展示实际测试结果;fact_inference_separation 得 2:文档区分“适配器保证”与“应用必须做”,但部分安全声明(如 fail closed)依赖未展示的代码路径,静态审查无法完全区分事实与推断。

风险与缓解建议
  • 发布者身份未经验证,维护责任与安全联系渠道不明确,生产采用前应独立核实。
  • 沙箱不隔离宿主内核,LocalSubprocessSandbox 仅限开发;code_tool 的安全性完全取决于审批端口强度。
  • 同步工具超时后线程可能继续运行,重试可能重复副作用;文档已提示但未提供自动补偿。
  • 可选依赖众多且部分需独立环境,未提供锁定文件或 SBOM,安装冲突与漏洞状态需自行验证。
  • 覆盖率 90%、21 框架等声明在样本中缺少可复现的验证报告,静态审查无法确认。
证据充分度:低 评估于 2026年11月13日 审查版本 8152babd9977 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

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

FARS

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

最近版本

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

  1. v1.2.0 v1.2.0: VoxCat voice, shared board, template documents
    发布说明摘录
    Voice, video and robots, agents that share what they find, and documents filled from many model calls. ```bash pip install -U agent-adapter pip install -U "agent-adapter[voice-cloud]" # hosted speech-to-text and text-to-speech ``` Highlights - VoxCat, our own voice pipeline (agent_adapter.voice). Phone calls (Twilio, Telnyx, Plivo, Vonage), browser calls over WebRTC, and the local mic. Spoken approvals before side effects, and nothing is done twice when the caller interrupts. It is fast with any speech-to-text and text-to-speech, open models included: its own end of turn (`Eager …
    在 GitHub 查看 ↗
  2. v1.1.1 v1.1.1: DSPy 3.5 support
    发布说明摘录
    DSPy 3.5 support. Agent Adapter now works with DSPy 3.5 and 3.4. ```bash pip install -U "agent-adapter[dspy]" ``` Added - dspy_compress_prompt(prompt, policy) in agent_adapter.integrations.dspy, and the "dspy" compression format for the lm15 messages in a DSPy 3.5 Prompt. It takes what Adapter.format returns on DSPy 3.5 or 3.4 and gives back the same kind. Fixed …
    在 GitHub 查看 ↗
  3. v1.1.0
    发布说明摘录
    The first public release: open source under Apache-2.0 and published on PyPI. Added - Guardrails. PIIGuard: a dependency-free guard hook for emails, phone numbers, cards (Luhn), IBANs (mod-97) and API keys or secrets. It blocks, redacts tool results and model replies, or sends flagged tool calls to one-use approval (confirm=guard.confirm). It fails closed and never logs content. - CallableGuard(fn) for any guard service; PresidioGuard (extra presidio) and NemoGuard (extra nemo); ContentGuard, TextGuard and GuardVerdict to write your own. …
    在 GitHub 查看 ↗

常见问题

使用它一定要选择某个智能体框架吗?
不需要。可直接调用 Executor,使用 run_tool_loop,或通过 FlowRunner 运行流程;框架集成是可选项。
它本身是否免费,模型调用是否收费?
项目采用 Apache-2.0 许可。若选择在线模型提供方,模型费用和凭据由相应提供方决定;README 没有给出统一价格。
危险工具调用如何等待人工批准?
可将工具标记为 confirm=True,并配置 DeferredApproval.sqlite 等审批端口;待处理调用可稍后恢复,已使用的审批不能重复使用。
能否从其他语言调用这些 Python 工具?
README 提供 MCP 与 HTTP 服务及 TypeScript 客户端,并列出 Python、C#、Go、Rust、Ruby、Java、Kotlin、Swift 和 PHP 客户端示例。
Agent Adapter 工具执行框架 官网是什么?
Agent Adapter 工具执行框架 的 GitHub 仓库填写的官网是 https://agent-adapter.veloceai.in。这个链接由仓库作者设置;源码在 GitHub(VeloceAI/agent-adapter)。
Agent Adapter 工具执行框架 开源吗?
开源。源码在 GitHub(VeloceAI/agent-adapter),许可证是 Apache-2.0。
Agent Adapter 工具执行框架 安全吗?
FollowAgents 的 FARS 评审(2026年11月13日)给 Agent Adapter 工具执行框架 的“信任与安全”打了 19/29 分。评审检查的 8 项安全措施没有完全缺失的。评审之后仓库已有更新。
Agent Adapter 工具执行框架 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-18,在最近 30 天内。最新版本是 v1.2.0(2026-11-18)。
Agent Adapter 工具执行框架 是谁开发的?
Agent Adapter 工具执行框架 由 GitHub 账号 VeloceAI 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

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

相关核心概念