开发与工程 typescript-sdk visual-builder mcp-servers multi-agent-workflows opentelemetry vercel-ai-sdk a2a

Inkeep Agents

用可视化画布或 TypeScript SDK 构建并同步 AI 助手与多智能体工作流。

源仓库: inkeep/agents
Star 数: ★ 1.5k
最近更新: 1 天前
License: NOASSERTION
主语言: TypeScript
FA 评分: 45/100 · 缺口较多

30 秒速览

运行形态: 网页应用代码库 / SDK自托管服务
可在哪里用: 通用 · 跨平台
费用: 有免费版，另有付费云服务
上手难度: 中 · 需要几步配置
开始前需要: VercelDockerVercel AI SDKShell / 命令行网络访问MCP Server
典型场景: 帮助中心负责人在 Visual Builder 中搭建面向客户的实时问答助手，并由工程团队继续用 SDK 维护。
不适合: 需要完全离线或本地模型运行的团队
不愿接受 ELv2 与补充条款限制的商业使用者
只想用单一语言 SDK、不需要可视化协作的团队
源码审查: 45/100 · 缺口较多 1 项安全控制未见

这个 Agent 能做什么，适合哪些场景？

Inkeep Agents 是一个用于构建 AI 助手和多智能体工作流的平台，提供 No-Code Visual Builder 与 TypeScript Agents SDK 两种创建方式，并支持双向同步。其组成包括负责配置、执行与评估的 agents-api，拖拽式 agents-manage-ui，声明式 @inkeep/agents-sdk，以及用于同步的 agents-cli。agents-api 管理 Agent、Sub Agent、MCP Server、Credentials 和 Project，跟踪对话状态并发出 OpenTelemetry traces。系统还提供 agents-ui 聊天组件库，并可通过 MCP、A2A 与 Vercel SDK API 触发；部署边界为 Vercel 或 Docker。底层使用 Vercel AI SDK 连接 LLM 提供商，并与 Vercel 的 useChat hook 兼容。

团队可在 agents-manage-ui 的拖拽画布中创建和管理 Agent，或在 TypeScript 中通过 @inkeep/agents-sdk 的 agent 与 subAgent 声明 Agent、子 Agent、提示词和可用 MCP 工具。SDK 与 Visual Builder 都会写入 agents-api；该 API 保存 Agent、Sub Agent、MCP Server、Credentials 和 Project 的配置，并提供 Agent 执行与评估。执行期间，API 跟踪对话状态并产生 OTEL traces。agents-cli 提供 inkeep push 与 inkeep pull，用于在 TypeScript SDK 代码和 Visual Builder 之间同步；agents-ui 则用于在 Web 应用中嵌入动态聊天界面。

帮助中心负责人在 Visual Builder 中搭建面向客户的实时问答助手，并由工程团队继续用 SDK 维护。
技术文档团队与开发团队共同维护产品文档助手：非技术成员在画布调整流程，工程师在 TypeScript 中定义子 Agent。
支持运营团队构建可更新 CRM、分流 helpdesk ticket 的自动化流程，并通过 MCP 工具连接所需能力。
企业内部为销售、市场、运营或支持人员部署 copilot，并在 agents-ui 中嵌入聊天体验。
需要由多个专门子 Agent 协作完成任务的工程团队，可用 agent 的 defaultSubAgent 和 subAgents 配置协调结构。

如何安装或部署这个 Agent？

所提供材料未给出可复制的安装命令、Node.js 版本、环境变量、凭据创建流程或 Docker/Vercel 部署配置，因此无法据此写出可靠的安装步骤。材料只明确提到可使用 Vercel 或 Docker 部署，并提供 agents-cli 的 inkeep push、inkeep pull 同步命令。

如何使用这个 Agent？

材料中的最小代码模式是从 @inkeep/agents-sdk 导入 agent 和 subAgent，使用 subAgent 定义 id、name、description、canUse 与 prompt，再使用 agent 定义顶层 Agent 的 id、name、description、defaultSubAgent 和 subAgents。随后可借助 inkeep push 或 inkeep pull 在代码与 Visual Builder 之间同步。所提供材料没有给出安装包命令、认证配置或实际执行 Agent 的首个命令/API 调用；这些是完成可运行示例所缺失的信息。

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

优点

Visual Builder 与 TypeScript SDK 可双向同步，允许非技术成员和工程团队在同一 Agent 定义上协作。
agents-api 将配置、执行、评估、对话状态与 OTEL traces 集中在同一服务边界内。
明确支持多 Agent 架构、MCP 工具与凭据管理，并提供 agents-ui 作为嵌入式聊天界面。
可通过 MCP、A2A 和 Vercel SDK API 触发，并可部署在 Vercel 或 Docker 上。

局限

材料未提供安装命令、运行时版本、环境变量、认证方式或端到端部署配置，初次落地仍需查阅其他资料。
核心实现依赖 Vercel AI SDK；虽然宣称可选 LLM 提供商，但未在材料中列出具体提供商、适配器或支持矩阵。
使用 MCP 工具时涉及凭据管理，但材料没有说明权限模型、密钥存储方式或故障处理机制。
许可在仓库元数据中标为 NOASSERTION，而 README 说明为 ELv2 并受 Supplemental Terms 约束；采用前应核对适用条款。

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

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

Agent	源码审查	形态 / 费用	Star	最近更新	主语言	完整支持的平台
Inkeep Agents 当前	45 · 缺口较多	网页应用免费版 + 付费版	★ 1.5k	1 天前	TypeScript	—
agentUniverse	30 · 缺口较多	代码库 / SDK免费 + 模型费	★ 2.4k	12 天前	Python	OpenAI API · Claude API
Context7 文档服务	56 · 缺口较多	命令行工具免费版 + 付费版	★ 64k	1 天前	TypeScript	—
Microsoft Agent Framework	49 · 缺口较多	代码库 / SDK免费 + 模型费	★ 15k	今天	Python	OpenAI API

FollowAgents 如何评估这个 Agent？

FollowAgents 源码审查 · FARS-2.1

缺口较多

45/ 100 五分制 2.3 / 5

信任安全 10/29

可靠稳定 8/14

适用触发 9/18

规范维护 8/18

有效结果 7/13

证据核验 3/8

查看各维度的扣分理由

信任安全10 / 29 · 1.7/5

证据显示：仓库包含大量依赖覆盖（package.json 中的 pnpm overrides 列表），表明对依赖安全有一定关注；README 提到 MCP 工具和凭据管理，暗示有敏感数据处理机制；存在 CI 工作流（如 auto-format）和版本控制（changesets），支持回滚。但缺少用户确认机制、数据流透明度的详细文档、最小权限原则的明确说明。扣分原因：未提供用户确认或数据流透明度的具体实现或文档；敏感数据处理仅提及凭据管理，未深入；外部影响（如 MCP 工具调用）缺乏安全边界说明；回滚仅依赖版本控制，未提供数据回滚方案；来源归属仅通过作者字段，未验证。

可靠稳定8 / 14 · 2.9/5

证据显示：仓库结构清晰，多个包（agents-api, agents-sdk 等）职责明确，自洽性较好；依赖通过 pnpm-lock.yaml 锁定，且有大量 overrides 修复已知漏洞，依赖可用性较好；但失败消息方面，README 和代码中未提供详细的错误处理或用户可理解的失败提示。扣分原因：失败消息缺乏具体示例或文档；自洽性虽好但未达到完美，因为部分文档可能不完整。

适用触发9 / 18 · 2.5/5

证据显示：README 明确列出了多种使用场景（客户体验代理、内部 copilot、工作流自动化），受众广泛；环境适配方面，支持 Vercel 和 Docker 部署，且兼容 Vercel AI SDK；但能力边界和触发精度方面，文档未详细说明代理的能力限制或触发条件。扣分原因：能力边界未明确，触发精度仅提及 MCP、A2A 等协议，未深入细节。

规范维护8 / 18 · 2.2/5

证据显示：信息架构清晰，README 提供了架构概览和组件说明；安装说明在 README 中有快速开始链接，但未提供详细步骤；命名稳定性方面，包名和版本号存在，但未说明命名约定；示例和 FAQ 有代码示例，但缺少 FAQ；已知限制未明确列出；许可证为 ELv2 和补充条款，但元数据为 NOASSERTION；版本控制和变更日志有 changesets 配置，但未提供 CHANGELOG 文件；维护责任通过作者和社区链接体现，但未明确。扣分原因：安装说明不详细，命名稳定性未说明，已知限制缺失，版本控制有但未展示实际变更日志，维护责任不明确。

有效结果7 / 13 · 2.7/5

证据显示：输出可用性方面，提供了 UI 组件库和 SDK，输出可直接用于构建聊天界面；边际价值方面，提供了无代码和代码两种方式，具有差异化价值；成本效益方面，开源免费，但部署和运维成本未评估。扣分原因：成本效益缺乏具体分析，边际价值虽好但未量化。

证据核验3 / 8 · 1.9/5

证据显示：README 中的声明（如 2-way sync）有代码和文档支持，但未提供测试结果或独立验证；跨来源佐证方面，仅依赖仓库内部文档，未引用外部验证；事实与推断分离方面，README 区分了功能描述和架构说明，但部分声明可能基于推断。扣分原因：缺乏测试证据和外部佐证，事实与推断分离不严格。

风险与缓解建议

源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
仓库元数据许可证为 NOASSERTION，实际许可证为 ELv2 和补充条款，需确认合规性。
未提供用户确认机制，代理可能自动执行外部操作，需谨慎部署。
敏感数据处理仅提及凭据管理，未详细说明加密和存储方式。
依赖安全虽有 overrides，但未提供漏洞扫描报告或安全审计。
回滚仅依赖版本控制，未提供数据回滚或迁移回滚方案。

证据充分度：低评估于 2026年8月9日审查版本 b31e5d14a9d4 评估后仓库已有新提交，评分可能未覆盖最新改动

评估证据 README.md LICENSE.md package.json workflows/auto-format.yml workflows/claude-code-review.yml

查看完整评分方法 →

常见问题

它能否只用代码，而不使用可视化画布？

可以。材料展示了 @inkeep/agents-sdk 中 agent 和 subAgent 的 TypeScript 声明方式；代码与 Visual Builder 被描述为可双向同步。

能接入哪些模型提供商？

材料说明底层使用 Vercel AI SDK 与 LLM 提供商交互，并称可选择 LLM 提供商，但未列出具体厂商或模型。

怎样把 Agent 接入应用？

可使用 agents-ui 在 Web 应用中嵌入聊天界面；材料也列出 MCP、A2A 与 Vercel SDK API 作为触发途径。

自托管是否有据可依？

有。材料明确称可自托管，并列出 Docker 和 Vercel 作为简化部署方式；但没有提供部署清单或配置细节。

费用和许可证如何判断？

材料未给出价格。README 将框架描述为 ELv2 且受 Supplemental Terms 约束，并另提到 Inkeep Cloud waitlist 与 Enterprise，使用前应审阅相关条款。

Inkeep Agents

30 秒速览

这个 Agent 能做什么，适合哪些场景？

如何安装或部署这个 Agent？

如何使用这个 Agent？

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

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

FollowAgents 如何评估这个 Agent？

最近版本

常见问题

相关 Agents

agentUniverse

Context7 文档服务

Microsoft Agent Framework

TanStack AI