技能、工具与 MCP 说明文档
技能概述
技能是创建 Decision Agent 完成特定任务的核心能力组件，相当于 Decision Agent 的 “动力系统”，主要包含以下四类：
| 技能类型 | 定义与作用 |
|---|---|
| MCP（Model Context Protocol） | 开放通用的模型上下文协议标准，用于连接 AI 模型与各类数据源 / 工具，替代碎片化 Agent 代码集成，提升 AI 系统可靠性与效率 |
| 工具 | Agent 可调用的封装式功能 / 服务，通过上传符合 OpenAPI 3.0 规范的 JSON/YAML 算子文件创建 |
| 技能 Agent | 供其他 Decision Agent 调用的专业能力模块，不直接与用户交互，提供可复用的封装能力 |
创建技能的方法
根据业务需求，可通过以下三种方式创建技能，具体差异与适用场景如下，其中算子工厂提供【工具】和【MCP】两种方式：
| 创建方式 | 操作说明 | 适用场景 |
|---|---|---|
| 工具 | 导入外部工具文件，直接省略工具创建流程 | 已有符合 OpenAPI 规范的外部工具，需快速接入 |
| MCP | 接入外部 MCP 服务，通过统一协议连接数据源 / 工具 | 需标准化集成多类外部服务，降低代码开发成本 |
| Agent | 基于模型（大 / 小 / 多模态）、知识库、记忆等功能构建，发布时需选择 “发布为技能 Agent” | 需实现复杂业务任务，需多资源协同的场景 |
【工具】和【MCP】的核心差异
| 对比维度 | 工具 | MCP |
|---|---|---|
| 维护方式 | 需在算子平台维护（支持新增 / 禁用） | 视为 “工具箱”，工具由 MCP 服务器提供，算子平台无法控制 |
| 调用规范 | 仅需满足 HTTP 规范 | 需遵循 MCP 固定传参格式 |
| 接入便捷性 | 接入流程较繁琐 | 仅需提供 MCP URL 即可动态获取工具信息，简化开发 |
工具&工具箱概述
工具是智能体执行具体任务（如计算、搜索、操作）的原子能力单元，工具箱是集中管理工具集合的功能模块，支持新建工具箱、导入工具、测试调用、管理工具状态等操作，适用于统一维护多类工具的场景。
关键术语
| 术语 | 含义 |
|---|---|
| 工具 | 智能体执行具体任务（如计算、搜索、操作）的原子能力单元 |
| 工具箱 | 工具的集合容器，一个工具箱可包含多个工具 |
| OpenAPI | 工具箱技术选型之一，支持接入现有 HTTP 服务，需符合 OpenAPI 规范 |
场景1：新建工具箱
- 进入工具箱列表页：进入「算子工厂」>「算子管理」 >「工具」页面
- 发起新建：点击页面右上角【新建工具箱】
- 填写配置信息：
- 工具箱名称（必填）
- 工具箱描述（必填）
- 工具箱业务类型（必选，例：“数据查询”）
- 工具箱技术选型（二选一，选择后不可修改）：
- OpenAPI：接入现有 HTTP 服务
- 函数计算：在线编写自定义代码，平台托管运行
- 完成创建：点击【确定】
场景2：导入工具至工具箱
- 进入目标工具箱：新建工具箱后将自动进入工具箱详情页面，也可以从工具箱列表点击工具箱名称进入
- 发起导入：点击【导入工具】，选择导入方式：
- 选择 OpenAPI 格式的文件导入
- 从已有算子导入
- 完成导入：按所选方式上传文件或选择算子，完成导入（导入后的工具将显示在工具箱列表中）
场景3：测试工具箱中的工具
- 进入调试页面：在工具箱的工具列表中，找到目标工具，点击【调试】
- 填写测试参数：
- 在 “输入” 区域填写 header 中的 Authorization 信息
- 填写 body 中的参数（例：agent_name - 智能体名称、session_id - 会话 ID）
- 执行测试：点击【运行】，查看调试结果
场景4：管理工具箱中的工具
- 进入目标工具箱：从工具列表点击工具箱名称进入
- 执行管理操作：
- 启用 / 禁用：点击工具右侧的状态开关（禁用后工具无法调试或调用）
- 删除工具：点击工具对应的【删除】
- 其他操作：支持工具下架、权限配置、编辑等（点击对应按钮即可）
场景5：导入工具箱
- 进入工具箱列表页：进入「算子工厂」>「算子管理」 >「工具」页面
- 发起导入：点击页面右上角【导入工具箱】，选择导入方式：
- 选择 OpenAPI 格式的文件导入
- 选择从ADP导出的文件导入
- 完成导入：按所选方式上传文件，完成导入（导入后的工具箱将显示在工具箱列表中）
MCP 概述
MCP 注册通信模式
MCP Server 注册时需指定通信模式，本期仅开放以下两种模式：
| 通信模式 | 适用场景 | 配置要求 |
|---|---|---|
| SSE（Server-Sent Events） | MCP Server 以 Web 服务形式暴露，需支持事件流和实时响应 | 配置 URL、HTTP headers（例：Authorization） |
| Streamable HTTP | 需在一次 HTTP 请求中分批次实时返回数据（例：大模型推理、长文本生成） | 配置 URL、HTTP headers（例：Authorization） |
说明：Stdio 模式（本地进程交互）及其他扩展模式暂不开放，后续将通过插件机制支持 WebSocket、gRPC 等协议。
MCP 创建方式
新建模式
- 连接已有 MCP 服务：接入客户已部署的外部 MCP 服务
- 从工具箱添加：把现有工具箱里的工具以MCP协议的方式对外提供使用
导入模式
- 选择 OpenAPI 格式的文件导入
- 选择从ADP导出的文件导入
场景1：新建 MCP
- 进入MCP列表页：进入「算子工厂」>「算子管理」 >「MCP」页面
- 选择新建方式（二选一）：
- 连接已有 MCP 服务：直接接入外部服务
- 从工具箱添加：把现有工具箱里的工具以MCP协议的方式对外提供使用
- 填写配置信息：按页面提示填写 MCP 服务名称、描述、通信模式、URL、headers 等参数，点击【确定】
- 调试验证：
- 进入 MCP 调试页面，填写测试参数
- 点击【运行】，查看服务功能是否正常
- 后续管理：
- 返回 MCP 列表页面，可对目标 MCP 执行查看、编辑、发布、导出、权限配置、删除等操作
场景2：导入 MCP
- 进入MCP列表页：进入「算子工厂」>「算子管理」 >「MCP」页面
- 选择待导入的本地文件，完成导入（导入后的MCP将显示在MCP列表中）