氚云连接器
简介
氚云连接器 是氚云对外开放的业务执行入口，提供读取表单、写入数据和处理待办的能力，供外部 AI 平台调用，使 AI 在对话中完成的动作可实际作用于氚云业务系统。
- 支持平台：WorkBuddy、千问办公、豆包工作
- 接入协议：MCP
- 能力范围：业务数据读写、流程待办处理、组织数据匹配
与“将数据导出给 AI 分析”不同，连接器不迁移数据。AI 通过连接器在系统内执行操作，数据始终保留在氚云。
工作原理
一次调用的完整链路如下。
| 环节 | 承担的角色 |
|---|---|
| 外部 AI 平台 | 用户在对话中提出需求，平台负责理解与规划。 |
| 氚云连接器 | 按当前用户身份调用工具、技能与专家，管控权限与数据范围。 |
| 氚云业务系统 | 动作真实落库，校验与流程触发照常执行。 |
这条链路带来三项保障。
- 遵循系统业务逻辑：必填、公式、校验与流程触发均照常执行。
- 受用户角色权限约束：用户看不到的数据，AI 也无法获取，不会额外提权。
- 操作可追溯至操作人：AI 的动作记录在真实操作人名下，可在审计记录中查询。
这是“AI 执行任务”与“AI 对话”的区别：客户无需将数据导出，AI 可在系统内完成操作。
接入前提
在使用连接器之前，需要确认三项条件。
- 已开通氚云应用，系统内有可操作的表单与数据。
- 已开通
AI 升级包，因为连接器工具调用按次数计费消耗 AI 点数（详见下文“计费方式”）。 - 已在外部 AI 平台侧安装氚云连接器，并完成氚云账号授权。
各平台的连接器安装入口与授权流程不同，具体操作以对应平台的文档为准。授权时使用的账号身份，决定连接器能访问的数据范围。
能力清单
连接器共提供 18 项工具，按用途分为三类。
业务数据
覆盖“读取表单、查询数据、写入数据”的完整链路，具体如下。
| 操作 | 能力说明 |
|---|---|
新增 |
可存为草稿，或直接提交并触发流程；支持带子表明细。 |
修改 |
只更新指定字段及子表明细。 |
删除 |
删除指定数据，需人工二次确认。 |
查找 |
可查询关联数据、子表明细，支持汇总与分布统计，条数不限。 |
读写操作均遵循表单的校验与计算规则；支持写入附件与图片。
流程待办
覆盖“查看数量、查看明细、批量处理”的链路，具体如下。
| 操作 | 能力说明 |
|---|---|
查看 |
获取当前角色的待办数据，查看待办明细。 |
处理 |
审批、完善字段并填写审批意见，支持批量审批。 |
流转 |
支持 评论、转交、变更 或 加签 审批人。 |
限制：审批操作不可逆，目前仅 退回 操作暂不支持。
组织数据
覆盖人员与部门的查询与匹配，具体如下。
| 操作 | 能力说明 |
|---|---|
人员与部门 |
支持人员或部门名称与氚云系统 ID 互译。 |
匹配统计 |
可按人员维度或部门维度做精确口径匹配，并进行统计归类。 |
限制：仅支持只读操作，连接器不修改组织架构，只进行匹配与统计。
工具粒度是“业务动作”而不是“数据库操作”，这是 AI 能在系统中安全操作的前提。
能力分层
在外部平台上，氚云提供三层能力，逐层解决不同问题。
| 层级 | 内容 | 解决的问题 |
|---|---|---|
| 第一层：连接器工具 | 使 AI 可操作数据、处理待办。 | 能否操作。 |
| 第二层：技能 | 将沉淀的步骤固化为可复用资产，AI 按步骤执行。 | 执行是否正确。 |
| 第三层：专家 | 具备专业方法论，对业务目标负责，自行拆解与跟进。 | 由谁承担结果。 |
已上架的专家，可在 WorkBuddy 的 专家广场 搜索“氚云”并直接安装使用。
千问办公、豆包工作同样通过连接器接入：工具与专家能力一致，差异仅在于客户日常使用的办公平台。
典型场景
以下四个场景可直接在对话中验证。
| 场景 | 示例指令 | 用到的能力 |
|---|---|---|
| 定时任务报告 | “每天早上帮我总结昨天的工作进展，给出今天的工作建议。” | 业务数据、技能 |
| 生成汇报材料 | “基于氚云数据和这份 Excel，分析上个月业绩，生成一份 PPT。” | 业务数据、本地文件 |
| 自动录入数据 | “这是我与客户的沟通录音，帮我记下跟进记录。” | 业务数据（写）、语音 |
| 批量处理待办 | “分析待办里的报销单，没风险的通过，有风险的给我建议。” | 流程待办、批量审批 |
计费方式
连接器的工具被外部 AI 平台调用时，按 MCP 调用次数扣减 AI 点数。
| 计费项 | 规则 |
|---|---|
| 计价单位 | 按调用次数计，100 次 = 1 点数。 |
| 扣减方式 | 每次工具调用按次数累计，实际扣减可在 AI 能力中心>AI 调用日志 中查看。 |
连接器调用与氚云内部的 AI 助理、AI 组件 分开计费：内部能力按任务实际用量扣减 AI 点数，连接器按调用次数扣减 AI 点数。两类消耗均在 AI 点数额度内扣减。
使用限制汇总
| 限制项 | 说明 |
|---|---|
| 审批退回 | 暂不支持 退回 操作，其余审批动作可用。 |
| 审批不可逆 | 审批类操作一经执行无法撤销，批量审批前需确认范围。 |
| 组织数据 | 只读，不修改组织架构。 |
| 数据删除 | 需人工二次确认后才执行。 |
| 权限边界 | 严格按授权账号的身份与角色执行，不额外提权。 |
常见问题
AI 操作的数据是否可追溯
可以。AI 的每次动作均记录在真实操作人名下，可在业务系统的审计记录中查询。
连接器是否绕过权限
不会。连接器按当前授权用户身份执行，用户看不到的数据，AI 同样无法获取。
AI 写入的单据是否跳过校验
不会。读写操作均遵循表单原有的校验与计算规则，必填、公式与流程触发照常执行。
审批操作是否可撤回
不能。审批操作不可逆，建议在批量审批前核对待办范围。