WebAPI 集成
金蝶云星空 WebAPI 集成：让 AI 安全地读写业务数据
简要回答
金蝶云星空提供基于 HTTP 的 WebAPI，可以登录、按单据查询、查看、保存、提交、审核。让 AI 接入的稳妥做法是：默认只读，通过专用接口账号和最小权限查询，所有写入走保存加提交的草稿流程并由人工确认。模型和中间层都可以部署在企业内网。
越来越多金蝶用户想把 AI 助手接到云星空：问库存、问订单交期、让系统起草采购申请。技术上最常见的入口就是 WebAPI。云星空的开放接口按业务对象（表单标识）组织，例如物料 BD_Material、销售订单 SAL_SaleOrder、采购订单 PUR_PurchaseOrder、生产订单 PRD_MO、即时库存 STK_Inventory，调用方通过登录接口取得会话后，再调用查询、保存等方法。
但「能调通」和「能放心用」是两回事。接口账号权限给多大，AI 生成的查询条件错了怎么办，写入后怎么追溯，这些都需要在架构层面提前设计。
云星空 WebAPI 的常用能力
常用方法包括：登录验证（可使用应用 ID 与应用密钥方式的第三方登录授权，具体以所用版本的开放平台文档为准）、单据查询 ExecuteBillQuery、单据查看 View、保存 Save、批量保存 BatchSave、提交 Submit、审核 Audit、反审核 UnAudit、删除 Delete 等。查询接口可按字段列表、过滤条件、排序和分页取数。
不同版本的接口细节、字段名和权限要求有差异，开发前应以你所用云星空版本的官方文档和实际 BOS 表单字段为准，不要照搬网上示例。
- ExecuteBillQuery：按表单标识、字段列表、过滤条件取数，适合做 AI 查数
- View：按内码或编码查看单据完整内容
- Save 与 Submit：创建或修改单据并提交，适合做草稿生成
- Audit：审核动作，建议只保留给人工，不交给 AI 触发
AI 智能体的典型架构
推荐三层：最上层是对话或工作台入口，中间是工具层，把云星空 WebAPI 封装成少数几个明确的工具，例如查库存、查订单状态、查 BOM、起草采购申请；最下层是部署在内网的开源模型，负责理解问题、选择工具、整理结果。模型本身不直接拿到数据库连接或接口密钥。
工具层负责参数校验、字段白名单、分页上限和日志。用户问「某物料现在还有多少库存」，模型只能产生受限的查询参数，工具层再拼装并执行 ExecuteBillQuery，把返回结果连同使用的过滤条件一起展示出来，用户能看到系统到底查了什么。
- 专用接口账号，权限按岗位拆分，不使用管理员账号
- 字段与表单白名单，禁止任意表单、任意字段读取
- 查询条件、返回行数和耗时全部记录日志
- 写入只创建草稿或暂存单据，提交与审核由人完成
典型场景
查询类最容易见效：采购员问某供应商的在途采购订单，计划员问某物料的现存量与可用量，销售问某客户订单的交付状态。这些问题以前要打开多个报表、导出再核对，现在一句话得到带来源的答案。
写入类要谨慎：例如根据缺料情况起草采购申请单，通过 Save 写成暂存状态，采购主管在云星空里审阅修改后再提交。这样既节省录入时间，又不破坏原有的审批流和权限控制。
安全、合规与数据位置
接口调用建议只在内网或专线上发生，模型服务器与云星空之间通过受控网关访问。如果你使用的是金蝶云星空的公有云或专属云版本，还需要确认接口的网络开放策略和调用频率限制，并让企业自己的信息安全部门审批。
涉及员工、客户个人信息的字段，应在工具层脱敏或不开放；日志与对话记录按企业数据分类分级要求保存。是否需要等级保护或其他备案，由企业合规部门依据法规判断，我们提供的是数据不出内网的技术条件。
什么时候用金蝶自带能力就够了
如果你的需求只是常规报表、固定看板或审批流提醒，云星空自带的报表、BI 与消息功能通常已经够用，不必引入大模型。金蝶自身的 AI 助手也在持续更新，先试用官方能力是合理的第一步。
当你需要跨系统（ERP、MES、质量、文档）提问，或要求私有化部署、自定义工具和审批规则时，再考虑独立的 AI 智能体层会更合适。
常见问题
金蝶云星空 WebAPI 需要额外购买授权吗？
授权和开放策略因版本与合同而异，请向金蝶或你的实施伙伴确认。我们建议在立项前先确认接口调用的授权范围和并发限制。
AI 可以直接审核单据吗？
不建议。我们的默认设计是 AI 只读、写入只到草稿或暂存，审核和提交由有权限的人在云星空内完成，保持审批留痕。
接口账号应该怎么设置权限？
为 AI 工具建立专用用户，按只读场景授予对应业务对象的查看权限，不使用管理员账号，并限制可访问的组织与数据范围。
模型能不能自己写 SQL 直接查云星空数据库？
不推荐。直接查库绕过了云星空的权限和业务口径，也不利于升级。优先使用 WebAPI 或受控的只读视图。
二次开发的插件和 WebAPI 怎么选？
需要在云星空内部改变界面或业务规则时用 BOS 插件，需要从外部系统读写数据时用 WebAPI。AI 智能体通常属于后者。
相关指南
金蝶 K/3 WISE 升级：用私有化 AI 缩短评估、迁移与验证周期
K/3 WISE 老用户如何升级到云星空：数据迁移、二开梳理、报表重建，以及用私有化 AI 缩短评估和测试周期。
金蝶云星空 + 企业微信/钉钉金蝶 + 企业微信/钉钉机器人：在聊天窗口里问 ERP
在企业微信或钉钉里问金蝶：查库存、查订单、审批提醒。机器人怎么接、权限怎么控、数据如何留在内网。
金蝶云星空 BOM 与 MRP金蝶 BOM 与 MRP 痛点：计划结果为什么总不对，AI 怎么帮忙排查
金蝶 MRP 运算结果看不懂、BOM 版本混乱、缺料反复出现？梳理常见原因，以及私有化 AI 如何帮助排查。
金蝶 KIS金蝶 KIS 用户能用 AI 吗：小型制造企业的务实路径
KIS 专业版与云版用户想用 AI：哪些值得做，哪些用现有功能就够，数据放哪里，预算有限时如何起步。
用友 U8 / U9 Cloud用友 U8 / U9 Cloud 的 AI 集成：数据不出厂的做法
在用友 U8、U9 Cloud 上落地私有化 AI：用自然语言查库存、采购、生产订单与缺料，数据不出厂，默认只读，写入需人工确认。
用友 BIP用友 BIP 之上的企业 AI：私有化问答与智能体
用友 BIP 之上如何加 AI：基于开放平台与 API 做自然语言查询和智能体，开源模型本地部署，权限沿用 BIP 角色，写入需人工审批。