SDK inkeep-agents 无代码与TypeScript双形态构建AI智能体

很多团队想用 AI 智能体，却卡在两难：业务同学不会写代码，工程同学又不想被低代码工具锁死。Inkeep Agents 同时给出两条路——无代码可视化构建器，和一套 TypeScript SDK，两者通过双向同步保持一致，既让非技术同学能拖拽搭建，也让工程师能用代码精确控制。

项目基本信息

一、项目介绍

inkeep/agents 提供两种构建智能体的方式：其一是无代码可视化构建器（No-Code Visual Builder），业务同学拖拽即可搭出 AI 助手与多智能体工作流；其二是 TypeScript SDK，工程师用代码定义 agent 与 subAgent，并享受与可视化构建器的双向同步。底层支持 MCP 服务器与多智能体协作，可自托管。

二、核心优势

1. 双形态：无代码 + SDK，技术与非技术角色各取所需。
2. 双向同步：可视化改动与代码改动互相贯通，不会脱节。
3. 原生 MCP：内置 MCP 服务器支持，便于接入外部工具。
4. 多智能体：subAgent 机制天然支持协作式工作流。
5. 可自托管：满足数据驻留与合规要求。

三、适用场景

• 客服/文档类 AI 助手，业务与工程协同维护。
• 需要把既有工具通过 MCP 编排进 agent 的团队。
• 既想快速验证又不想被低代码锁死的项目。

四、安装教程

安装 TypeScript SDK：

npm install @inkeep/agents-sdk

常见报错：若 npm install 报 peer 依赖冲突，用 npm install @inkeep/agents-sdk --legacy-peer-deps 规避；无代码构建器无需安装，直接在 Inkeep 控制台使用。

五、使用示例

用 SDK 定义一个主 agent 与其子 agent：

import { agent, subAgent } from "@inkeep/agents-sdk";
import { consoleMcp } from "./mcp";

const helloAgent = subAgent({
  id: "hello-agent",
  name: "Hello Agent",
  description: "Says hello",
  canUse: () => [consoleMcp],
  prompt: `Reply to the user and console log "hello world"`,
});

export const basicAgent = agent({
  id: "basic-agent",
  name: "Basic Agent",
  defaultSubAgent: helloAgent,
  subAgents: () => [helloAgent],
});

真实运行：调用 basicAgent 时，它会按 defaultSubAgent 把任务交给 hello-agent，并通过 consoleMcp 在控制台输出 “hello world”，展示了子 agent 与工具的组合调用。

六、常见问题

Q：双形态会冲突吗？
A：不会，SDK 与可视化构建器通过双向同步保持同一份定义。

Q：许可协议能用在生产吗？
A：采用 Elastic License 2.0（含补充条款），需阅读条款确认商业使用范围。

Q：支持自托管吗？
A：支持，可部署在自有基础设施以满足数据合规。

七、总结

Inkeep Agents 用“无代码 + SDK 双向同步”打通了业务与工程的协作鸿沟，是少数同时照顾两类角色的智能体方案。其 Elastic License 2.0 在商用前需留意条款，整体仍是构建多智能体工作流的务实选择。