跳转到内容

对比

aidy 只做一件事:基于产品已有的 HTTP API,让它变成 agent 原生。下面这些工具各有侧重,其中几个与 aidy 搭配得很好。本页按各自的侧重点介绍,具体功能请以它们的官方文档为准。

侧重点 工具来源 身份与审批 产出的面
LangGraph 以图的方式编排有状态的 agent,支持持久执行 自己编写的代码(Python 或 JS),或 MCP 服务 通过中断和检查点实现人工介入;身份和策略由你的图自行处理 agent 运行时;UI 和其他面需要自己构建
CopilotKit React 中的应用内 copilot 与 agent 化 UI 前端 action 以及接入的后端 agent 人工介入的 UI 流程;身份由你的应用负责 React UI 组件和 hooks
Stainless、Speakeasy 从 OpenAPI 生成 SDK 及相关产物 OpenAPI 凭据由调用方提供;SDK 和 MCP 服务以调用方身份调用你的 API 多语言 SDK、MCP 服务,以及因厂商而异的其他产物
Vercel AI SDK、Mastra 模型 provider、流式输出、工具调用、agent 循环(Mastra 另有工作流、记忆和 RAG) 自己编写的代码,或 MCP 服务 工具级的钩子和审批原语;身份和策略由你的应用负责 供你构建应用的库和 UI hooks
aidy 基于已有 API 让产品变成 agent 原生 用 x-aidy 标注的 OpenAPI 操作 每次调用都以已登录用户的身份进行,携带用户自己的凭据和签名断言;审批由代码中的目录策略决定,并绑定到确切参数的哈希 应用内 agent(AG-UI)、MCP 服务、CLI、skill.md、llms.txt、操作参考、联合搜索、知识问答、React 组件

LangGraph 是一个以显式状态图构建 agent 的框架。它擅长长时间运行的多步骤工作流:分支、重试、基于检查点的持久执行,以及通过中断等待人工处理。工具和图都在代码里定义。

适合的场景: 问题本身就是工作流,例如多 agent 研究流水线、很长的审批链、必须在重启后继续的流程。

与 aidy 组合。 aidy 不依赖 LangGraph,两者可以通过 延后任务 组合。一个 x-aidy 操作可以启动一次 LangGraph 运行,并返回 202 {"aidyTask": "<id>"}。aidy 暂停用户的运行、展示任务进度,在你的服务把结果发到 POST /aidy/v0/tasks/{taskId} 后继续。用户可以从产品的 agent、CLI 或 MCP 发起这个工作流,前面照常有审批。

CopilotKit 为应用内 copilot 提供 React 组件和 hooks:聊天界面、可供 agent 调用的前端 action、共享状态和生成式 UI。AG-UI 协议由它发起,它也通过 AG-UI 接入多种 agent 后端。

适合的场景: 用 React 打造定制的 copilot 体验,需要精细控制 UI、前端 action 和 agent 状态。

与 aidy 组合。 aidy 输出 AG-UI 1.0 事件流。它的运行端点 POST /aidy/v0/threads/{id}/runs 接受 AG-UI 的 RunAgentInput(会话消息,以及回应中断的 resume 条目),并以 AG-UI 事件作答,因此 AG-UI 客户端先用 POST /aidy/v0/threads 创建会话,就可以驱动 aidy。aidy 提供 agent 本身:从 API 派生的工具、以用户身份的调用和审批中断。aidy 尚未用 CopilotKit 自己的运行时测试过,依赖它之前请端到端检查审批中断和 resume 条目。@aidy-dev/react 是 aidy 自带的组件(Dock、审批卡片、表单、搜索面板),适合想要现成 UI 的团队。

Stainless 和 Speakeasy 从 OpenAPI 文档生成多种语言的高质量 SDK,并随 API 变化持续更新。两者也能从同一份文档生成 MCP 服务,并视厂商不同提供文档、CLI 或 Terraform provider 等更多产物。

适合的场景: 需要为 API 提供精良、地道的客户端库,或者为直接用自己的密钥调用 API 的开发者提供 MCP 服务。

与 aidy 组合。 它们和 aidy 都从 OpenAPI 出发,同一份标注过的文档可以同时供两者使用。区别在于侧重点。SDK 生成器产出的是供其他程序运行的客户端。aidy 则在你的产品内部为已登录用户运行一个 agent:它维持对话,让用户逐次审批写操作并看到确切参数,只执行这些参数,还提供搜索、知识问答和 UI 组件。它的 MCP 服务和 CLI 来自同一份目录,遵循同样的审批规则。

Vercel AI SDK 是一个 TypeScript 工具包,涵盖模型 provider、流式输出、结构化输出、工具调用和 agent 循环,并为 React 等框架提供 UI hooks。Mastra 是基于它构建的 TypeScript agent 框架,另外提供工作流、记忆、RAG 和评测。

适合的场景: 用 TypeScript 从零构建 AI 功能或 agent,并希望自己设计工具、提示词和流程。

与 aidy 组合。 aidy 内部使用 AI SDK 的 provider 包(@ai-sdk/openai-compatible、@ai-sdk/openai、@ai-sdk/anthropic),并在其上运行自己的循环,使重试、事件合并、审批和步数统计都由 aidy 掌控。你可以继续用 AI SDK 或 Mastra 构建定制的 AI 功能,而让 aidy 负责操作产品的那部分:工具来自你的 API,安全规则来自目录。见 模型。

当你已经有一个带 HTTP API 和授权模型的产品,希望用户及其 agent 用自然语言操作它、又不想再加一层业务逻辑时,aidy 是合适的选择:

  • 工具就是 UI 已经在调用的那些操作;
  • agent 能做的事与用户完全相同,因为每次调用都由你的 API 以该用户身份授权;
  • 写操作需要用户审批确切的参数,并由代码强制执行;
  • 一次标注同时得到应用内 agent、MCP、CLI、生成的文档和搜索。

如果你需要通用的 agent 框架、定制的工作流引擎或客户端 SDK,上面的工具正是为此而生,aidy 可以与它们并存。