前置配置
在开始配置之前，请先确认以下内容：- 已按 配置 AI 提供商 完成模型供应商配置；
- 已创建一个可以作为助手使用的数字专家；
- 该数字专家已经发布；
- 如果你希望助手帮助你创建或修改数字专家，建议额外准备一个专门的“编写助手”数字专家；
- 如果配置租户级默认助手，需要具备租户管理员权限；
- 如果配置组织级助手，需要先切换到目标组织，并具备相应管理权限。
在“设置 / 助手”页面中，通常只有当前作用域内已经发布的数字专家才能被选中。
如何配置 Xpert AI 助手
进入“设置 / 助手”页面后，按照下面步骤进行配置。1. 选择助手入口
常见入口包括：- 工作空间助手：用于工作空间和 Studio 中的共享助手；
- ChatBI 助手：用于 ChatBI 页面中的助手。
2. 启用助手
打开当前入口中的“启用”开关。3. 选择数字专家
在数字专家选择框中，选中你希望绑定的数字专家。 建议按场景选择：- 如果用于工作空间中的创建、修改数字专家，优先选择一个“编写助手”数字专家；
- 如果用于 ChatBI，对应选择一个偏数据分析或业务问答的数字专家。
4. 填写助手页面地址
填写助手聊天界面的访问地址。 例如：5. 保存配置
点击“保存”后，该入口就会使用你刚刚绑定的数字专家。不同助手入口怎么选
工作空间助手
适合以下场景：- 在工作空间里通过聊天创建新的数字专家；
- 在 Studio 中继续修改当前数字专家草稿；
- 帮助你补充知识库、工具集、提示词或工作流结构。
ChatBI 助手
适合以下场景：- 在 ChatBI 页面中回答分析问题；
- 围绕指标、模型、数据解释等场景进行对话；
- 提供一个固定的数据分析助手入口。
如何准备“编写助手”数字专家
如果你希望工作空间助手帮助你创建或修改数字专家，建议单独准备一个“编写助手”数字专家，而不是直接复用业务专家。 常见做法是：- 使用平台提供的编写助手模板创建一个新的数字专家；
- 可直接参考同目录示例文件：
./xpert-authoring-assistant.yaml； - 或者基于同类 YAML DSL 模板创建一个专门用于“数字专家编写”的数字专家；
- 配置完成后先发布，再到“设置 / 助手”中把它绑定给工作空间助手。
租户默认与组织覆盖
助手支持两层配置方式：租户默认
适合作为全租户统一使用的默认助手。 例如：- 全公司默认都使用同一个工作空间共享助手；
- 所有组织默认都使用同一个 ChatBI 助手。
组织覆盖
适合某个组织有单独需求时使用，例如不同组织使用不同的工作空间助手或 ChatBI 助手。 当组织级配置存在时，系统会优先使用组织级配置；如果组织没有单独配置，则回退到租户默认配置。配置完成后可以做什么
在工作空间中新增数字专家
如果工作空间助手绑定的是“编写助手”数字专家，用户就可以直接在聊天中描述需求，例如：帮我创建一个售后客服专家帮我创建一个合同审查专家
在 Studio 中修改当前数字专家
如果你已经打开某个数字专家的 Studio，助手还可以继续协助你修改当前草稿，例如：- 补充知识库；
- 调整提示词；
- 增加工具集；
- 修改工作流结构。
使用时需要注意
- 如果当前数字专家还只是草稿，没有发布，通常不能直接在助手设置中选中它。
- 如果 Studio 里存在未保存修改，助手可能不会直接覆盖当前草稿。
- 如果你希望助手专门负责“创建和修改数字专家”，最好给它单独准备一个编写助手，而不是直接复用业务专家。
- 如果入口打开后仍提示未配置，请检查是否已经启用、是否已选中数字专家，以及当前组织是否命中了正确的配置层级。
常见问题
为什么我的数字专家没有出现在助手可选列表里？
常见原因包括：- 还没有发布；
- 当前不在正确的租户或组织作用域；
- 当前入口无权访问这个数字专家。
为什么我已经绑定了助手，但工作空间里还是不能用？
建议检查：- 助手是否已经启用；
- 是否绑定到了正确的数字专家；
- 助手页面地址是否正确；
- 当前组织是否被组织覆盖配置替换。