工作区能力包

文档版本：1.1 状态：与当前后端实现一致（capability、workspace_capabilities API、对话工具门控） 表述：面向产品、运营与管理员，说明工作区「助手能力包」是什么、如何映射到助手工具；实现名见 实现对照。

关联：

• 产品规格.md §3.5（运行时工具）、§3.6（MCP 与扩展）、§4.2.4（平台插件）
• 技能组成规范.md（技能 permissions.tools 与能力包关系）
• 机制索引.md
• 用户侧说明：help/product-features/data-integration.md（数据连接与预定义查询）

1. 结论先说

助手能力包是工作区管理员为成员开通的、助手在 消息 里可调用的 工具类能力 开关。它 不等于 一个工具函数：同一能力包可对应多个工具，或只扩展已有工具的行为。

Cadau 采用三层模型：

硬性约定：

• 新能力优先 挂到现有工具；只有治理边界独立时才新增工具。
• 管线能力（识图、知识文档注入、技能召回、记忆检索）默认 不进能力包，除非需单独开通或合规门控。

2. 现有能力包

2.1 basic_documents — 基础文档工具

2.2 office_documents — 办公文档工具

关闭 基础文档工具 时，办公文档读取 自动级联关闭。

2.3 http_integration — 联网请求

不为每个业务 API 单独拆工具；业务路径与鉴权由 技能操作正文 描述。

2.4 code_execution — 脚本执行

2.5 data_integration — 数据连接（数据集成）

管理端子功能（用户侧入口 数据连接 整页，与知识文档目录同壳）：数据连接、数据资源、谁可以使用、变更定义、变更审批。

2.6 data_visualization — 数据图表

关闭 基础文档工具 时，数据图表 自动级联关闭。

3. 能力包关系

flowchart LR
  subgraph packs [工作区能力包]
    B[basic_documents]
    O[office_documents]
    H[http_integration]
    CE[code_execution]
    DI[data_integration]
    DV[data_visualization]
  end
  subgraph tools [模型工具]
    FR[file_read]
    FW[file_write]
    OD[office_document]
    HTTP[http_request]
    RS[run_script]
    DS[data_source_invoke]
    CH[chart]
  end
  B --> FR
  B --> FW
  O --> FR
  O --> OD
  H --> HTTP
  CE --> RS
  B --> CE
  DI --> DS
  B --> DV
  DV --> CH

4. 不进能力包的基础能力

用户智能体在 消息 中默认具备（帮助智能体 模式除外）：

能力包主要覆盖 可能出站或需单独合规审批 的行为。

5. MCP 与插件接入规则

6. 二期候选（预登记）

7. 管理员界面约定

8. 实现对照

9. 扩展能力包时的决策清单

1. 管理员是否需要 单独开通？否 → 管线能力。
2. 能否 复用现有工具？能 → 只扩展实现。
3. 是否 高风险/出站？是 → 独立能力包 + 审计。
4. 是否仅为某业务 API？是 → 技能 + http_request。
5. MCP 接入后 用户可见工具名 是否保持不变？应尽量不变。