ProcurementPrices 语义模型。名称和业务字段仅用于演示，请替换为实际值。操作涉及 Xpert 和 Data Xpert 两个界面；先确认两边选择的是同一组织。
本文说明完整流程。需要逐项配置时，可阅读下面两份配套教程：
- 初始化组织本体助理与建模助理：工作空间、环境变量、MCP 工具集、模板和绑定检查。
- 配置并发布业务助理：新建与编辑、用户组、模型资源、发布及普通成员验收。
1. 先分清要配置的对象
能使用助理、能编辑助理、能查询数据，是三种不同的权限。 发布到某个工作空间不代表全组织都能使用；分享助理也不会自动授予它所涉及的全部数据权限。
只做采购价格查询时，不必先建成本体实体和关系，也不必为了业务助手单独初始化组织本体助理。若希望由 AI 协助建模，初始化组织语义模型建模助理即可；已有可用模型时可以直接进入业务助理配置。
2. 准备运行条件
2.1 检查租户本体运行时
由SUPER_ADMIN 打开 Data Xpert 的 系统管理 → 平台初始化 → 租户本体运行时。
- 选择现有的租户本体工作空间；没有合适空间时，先在本页创建。
- 点击 初始化本体运行时，等待处理完成。
- 分别检查运行凭据状态和 Data Xpert AI Tools 插件状态。
- 如果提示“需要重启 Xpert”，由运维人员按部署方式重启 Xpert API 实例，再刷新状态，直到插件显示就绪。
2.2 准备组织助理的共享工作空间
组织内置助理应放在当前组织中、初始化人可写的组织共享工作空间。- 在 Xpert 打开工作空间下拉菜单，创建或选择专用空间，例如“组织助理”。
- 打开 设置 → 通用 → 工作空间访问。
- 开启 组织共享工作空间，点击 更新。
- 回到 Data Xpert 初始化向导，在目标工作空间中选择该空间。
组织共享允许本组织成员查看和编辑该空间中的资源，已发布 Assistant 的使用授权仍单独检查。建议为组织助理使用专用共享空间；不要为了让采购员聊天，就把存有其他私有资源的业务工作空间改成组织共享。
2.3 初始化组织语义模型建模助理
仍由SUPER_ADMIN 打开 当前组织语义模型建模助理 页签：
- 选择工作空间：选择上一步的组织共享空间，点击 下一步。
- 创建环境：确认环境名称，例如“语义模型 Workbench”。保留向导提供的变量定义；不要把管理员个人令牌填成所有人共用的固定值。
- 导入 Xpert DSL：开启 启用助理绑定，选择当前组织可用的协同模型，模板选择 语义模型建模助理。
- 确认 Xpert 名称和发布说明，点击 开始初始化。
- 等待成功提示，检查状态为“已配置”，当前工作空间与所选空间一致。
2.4 需要本体助理时再初始化
打开 当前组织本体助理，选择同一共享空间，依次完成 创建环境 → 创建 MCP 工具集 → 导入 Xpert DSL。使用本体助理模板，选择可用模型，开启绑定后开始初始化。 MCP 工具集负责连接 Data Xpert 的本体能力。沿用部署提供的连接参数；若缺少 MCP 地址，应由管理员修正服务配置后重试。 例如：在资源详情或本体工作台中询问“这张采购订单关联哪些供应商？”或“当前资源有哪些可用 Action？”时，使用组织本体助理。涉及执行动作时，还要满足该动作的权限、策略和审批条件。编辑本体定义草稿另有管理权限要求，能打开助理不代表能修改本体。 本节完成标志： 所需插件就绪、组织助理绑定启用，且模型工作台能够打开对应助理。无需每个成员重新初始化一套组织助理。3. 配置业务域、用户组和人员权限
先确定“谁维护”和“谁使用”，再授权。- 在 Xpert 的 设置 → 用户组 中创建“采购用户组”，加入需要查价的成员。用户组是人员集合，不要求与公司部门一一对应。
- 在 Data Xpert 的 治理 → 业务域 中选择“采购”域，在 成员与权限 中给该组授予消费者
consumer。没有目标域时，由具备业务域管理权限的人员创建。 - 为建模人员授予模型所在工作空间的创作权限，以及采购域的发布者
publisher；管理本域授权的人员使用域管理员domain_admin。 - 检查成员的平台功能权限。业务域角色不会自动授予查询、建模等产品功能，也不会代替数据源绑定和凭据检查。
BUSINESS_AREA_MANAGE 是平台级业务域管理权限，不应作为“让采购员查价”的常规授权方式。业务域父子关系用于分类，父域授权不会自动继承给子域。个人授权、用户组授权和平台权限可能同时生效，撤销一条授权后还应检查其他来源。
授予“采购域消费者”，意味着可以消费该域内符合条件的已发布资源，并不只限于本教程的一个模型。如果同域模型包含不同敏感级别的数据，应先合理拆分业务域。后面的助理资源列表只限制这个助理，不会收回用户通过其他入口已有的数据权限。
4. 完善并发布语义模型
4.1 准备可查询模型
在 Data Xpert 进入目标 AI 工作空间 → 数据智能 → 语义模型。没有现成模型时，先按数据分析快速开始完成数据源绑定、模型创建、维度和度量配置。 本例需要一个可按物料或图号查价的模型。至少明确查询键、价格字段、币种、价格是否含税，以及同一物料出现多条价格时的筛选口径。不要把单价简单求和当作查价结果。4.2 在模型工作台中使用建模助理
- 打开
ProcurementPrices，等待草稿显示“已同步”。 - 打开右侧助理面板，选中相关数据立方体、维度或度量。
- 先检查结构，再要求修改。可输入：
请先检查当前模型的物料维度、价格度量和关联关系，列出影响查价的问题。先不要修改或发布。确认方案后，再输入：
按刚才确认的方案修改当前模型草稿，说明改动的对象和校验结果。不要发布。
- 检查变更内容和质量提示，等待草稿重新同步。
- 运行模型校验，并用已知物料做查询核对。
4.3 发布到正确的业务域
将模型归属到“采购”业务域，校验通过后执行 发布，确认存在已发布版本。业务消费使用已发布模型；草稿修改需要再次发布才会成为新的消费版本。 在查询实验室验证一个已知结果。编辑区中的SELECT 1 AS value 之类示例只用于演示，不代表系统已为你的业务模型生成了查询。可以手写、使用模板，或请助理协助生成适合当前模型的 SQL / MDX，再运行并核对结果。
本节完成标志： 模型已发布到采购域，已知物料的价格、币种和筛选条件与业务记录一致。
5. 创建采购查价业务助理
进入 Data Xpert 的 AI 工作空间 → 目标工作空间 → 助理智能体。这个空间用于维护业务助理，不必与组织建模助理所在的共享空间相同。 操作账号需要具备业务助理管理权限、目标工作空间的写权限，以及目标业务域的发布权限。 点击 创建业务助理，选择 业务模板。若修改现有助手，在列表中点击该行的 … → 编辑。本教程使用业务模板流程；“平台新建”和“绑定已有”是其他创建方式。5.1 填写基本信息
“团队”决定助理的业务展示范围，不等于向全组织开放。实际使用人群在“资源与权限”中配置。关闭菜单显示也不等于撤销使用权限。
5.2 配置能力
- 打开 能力配置。
- 选择插件提供的 Business assistant with data-xpert tools 模板。
- 选择当前工作空间中为该助理准备的可用环境。环境名称可能是
Ontology Runtime、“语义模型 Workbench”或自定义名称，以实际配置为准；名称本身不代表数据权限。 - MCP 实例选择 自动创建默认 MCP 工具集，或选择管理员已准备的兼容实例。
- 在可编辑的业务指令中明确查价范围和口径，例如：
使用已授权的采购模型按物料查价，返回价格、币种、含税口径和有效条件。匹配多条记录时先说明差异并让用户补充条件，不要合计单价。找不到授权数据时说明原因，不编造价格。模板提供工具能力，业务指令定义如何回答，真正的数据访问仍由资源和调用者权限控制。
5.3 选择使用人群和资源
打开 资源与权限：- 在 可访问用户组 中选中“采购用户组”。确认按钮处于选中状态，不要把“列出了候选组”误认为已经授权。
- 在 可访问资源 中勾选
ProcurementPrices对应资源。部分列表显示datax-semantic-model-<模型 ID>，应核对模型 ID 后选择。 - 确认已选资源数量与计划一致，只勾选助手完成任务所需的资源。
5.4 检查并发布
- 点击 保存草稿 保存配置；草稿保存不等于发布。
- 点击 检查并发布，查看准备状态、模板、扩展能力和资源检查结果。
- 有失败项时先修复，再 重新检查。
- 确认业务范围、资源数量和发布说明，点击发布按钮；修改已有助手时按钮为 发布修改。
- 等待“业务助理和助理智能体已创建并发布”等成功提示，确认列表中发布状态为“已发布”、菜单状态为“已启用”。
6. 用普通成员账号验收
请使用测试账号和已知样例数据，分别验证“允许”和“拒绝”。管理员看到入口或助手回复一句“你好”，都不能证明普通成员已经具备正确的查询权限。
授权成员从菜单打开“采购查价助手”，可先问：
请查询物料 123456 的采购价格，并说明币种、是否含税和适用条件。如果有多条记录，请先列出差异。确认返回数据来自预期模型，并与已知业务记录一致。若只返回能力介绍，继续执行一次真实查询再判定成功。用户组、模型归属或资源列表调整后，应重新验证相关场景。
7. 常见问题
完成后，继续阅读语义模型工作台、语义模型助手、查询实验室或本体工作室。