# 技能、工具与 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：新建工具箱
1. 进入工具箱列表页：进入「算子工厂」>「算子管理」 >「工具」页面
2. 发起新建：点击页面右上角【新建工具箱】
3. 填写配置信息：
    - 工具箱名称（必填）
    - 工具箱描述（必填）
    - 工具箱业务类型（必选，例：“数据查询”）
    - 工具箱技术选型（二选一，选择后不可修改）：
        - OpenAPI：接入现有 HTTP 服务
        - 函数计算：在线编写自定义代码，平台托管运行
4. 完成创建：点击【确定】

## 场景2：导入工具至工具箱
1. 进入目标工具箱：新建工具箱后将自动进入工具箱详情页面，也可以从工具箱列表点击工具箱名称进入
2. 发起导入：点击【导入工具】，选择导入方式：
    - 选择 OpenAPI 格式的文件导入
    - 从已有算子导入
3. 完成导入：按所选方式上传文件或选择算子，完成导入（导入后的工具将显示在工具箱列表中）

## 场景3：测试工具箱中的工具
1. 进入调试页面：在工具箱的工具列表中，找到目标工具，点击【调试】
2. 填写测试参数：
    - 在 “输入” 区域填写 header 中的 Authorization 信息
    - 填写 body 中的参数（例：agent_name - 智能体名称、session_id - 会话 ID）
3. 执行测试：点击【运行】，查看调试结果

## 场景4：管理工具箱中的工具
1. 进入目标工具箱：从工具列表点击工具箱名称进入
2. 执行管理操作：
    - 启用 / 禁用：点击工具右侧的状态开关（禁用后工具无法调试或调用）
    - 删除工具：点击工具对应的【删除】
    - 其他操作：支持工具下架、权限配置、编辑等（点击对应按钮即可）

## 场景5：导入工具箱
1. 进入工具箱列表页：进入「算子工厂」>「算子管理」 >「工具」页面
2. 发起导入：点击页面右上角【导入工具箱】，选择导入方式：
    - 选择 OpenAPI 格式的文件导入
    - 选择从ADP导出的文件导入
3. 完成导入：按所选方式上传文件，完成导入（导入后的工具箱将显示在工具箱列表中）

---

# 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 创建方式
### 新建模式
1. 连接已有 MCP 服务：接入客户已部署的外部 MCP 服务
2. 从工具箱添加：把现有工具箱里的工具以MCP协议的方式对外提供使用

### 导入模式
1. 选择 OpenAPI 格式的文件导入
2. 选择从ADP导出的文件导入

## 场景1：新建 MCP
1. 进入MCP列表页：进入「算子工厂」>「算子管理」 >「MCP」页面
2. 选择新建方式（二选一）：
    - 连接已有 MCP 服务：直接接入外部服务
    - 从工具箱添加：把现有工具箱里的工具以MCP协议的方式对外提供使用
3. 填写配置信息：按页面提示填写 MCP 服务名称、描述、通信模式、URL、headers 等参数，点击【确定】
4. 调试验证：
    - 进入 MCP 调试页面，填写测试参数
    - 点击【运行】，查看服务功能是否正常
5. 后续管理：
    - 返回 MCP 列表页面，可对目标 MCP 执行查看、编辑、发布、导出、权限配置、删除等操作

## 场景2：导入 MCP
1. 进入MCP列表页：进入「算子工厂」>「算子管理」 >「MCP」页面
2. 选择待导入的本地文件，完成导入（导入后的MCP将显示在MCP列表中）