配置智能体
配置前准备
本文适用于已有智能体的配置维护，需要具有该智能体的编辑权限。尚未创建时，先按 创建智能体 完成新建。
修改后是否需要发布，见 配置何时生效。
按配置任务定位：BI 资产、业务本体、Agent 知识、参考资料、技能与工具、对话体验 和 质量保障。
配置智能体
创建完成后，可在智能体卡片上点击「设置」，进入配置页。左侧导航按「基础配置」「能力与知识」「对话体验」「质量保障」「发布与集成」组织配置，右侧展示选中的内容。
配置页顶部提供以下操作：
| 操作 | 说明 |
|---|---|
| Agent 分析 | 查看权限范围内该智能体的使用分析。 |
| 用对话修改 | 为自己创建的智能体打开构建会话，通过自然语言提出修改要求。离开配置页前，先处理尚未保存的内容。 |
| 草稿测试、保存草稿、发布 | 测试并保存修改，确认后发布。具体操作见 测试、发布与授权。 |
基础配置
基本信息用于控制智能体在列表和对话中的展示方式，包含以下字段：
| 字段 | 说明 |
|---|---|
| 「头像」 | 选择或上传智能体的展示头像。 |
| 「名称」 | 必填，用于在列表中识别智能体，建议体现业务场景。 |
| 「描述」 | 说明用途和适用场景，应与实际配置保持一致。 |
| 角色指令 | 角色指令决定智能体的工作方式。编写时建议使用业务语言，说明具体场景、分析步骤和证据要求。 例如，门店经营分析助手可使用以下指令，并按实际数据和业务口径调整： 你是门店经营分析助手，帮助用户分析销售变化、识别异常并提出行动建议。分析前确认时间范围、门店范围和指标口径，仅使用已授权的数据。回答先给结论，再列关键数据、可能原因和建议行动。区分已验证的事实与推测；数据不足时说明缺失项，不编造数值。指令负责说明工作要求；实际数据访问还需配置资产、工具及相应权限。复杂、可复用的操作流程可整理为技能。 |
能力与知识
BI 资产
「BI资产」用于为智能体选择分析依据；实际访问还受 BI 权限及查数范围设置约束。推荐优先使用管理员配置好的组织 BI 环境，为业务分析智能体添加与业务场景相关的资产。
前提条件
使用的观远 BI 环境需为 8.2 及以上版本。
管理员已配置好组织 BI 环境，且当前用户在 BI 中拥有目标资源的访问权限，即可选择资产，无需单独配置个人连接。组织环境尚未配置时，请联系管理员完成 系统集成配置。
操作步骤
-
在智能体配置页点击「BI资产」，再点击「添加 BI 资产」，打开「选择观远 BI 数据资产」窗口。
-
在「连接」下拉框中优先选择管理员配置好的组织 BI 环境，切换到「数据集」「仪表板」或「指标」页签，选择要添加的资产类型。
-
通过左侧文件夹目录查找资产，或在搜索框中输入名称并点击「搜索」。点击资产条目，在右侧核对资产名称、资产 ID、路径和环境，避免选择同名但来自不同目录或环境的资源。
-
勾选需要添加的资产。可以选择多项，也可通过「全选」批量勾选；确认已选数量及底部的新增、移除数量后，点击「添加」。
数据集、仪表板和指标的添加流程相同，切换对应页签后按上述方式选择即可。建议优先添加与智能体业务目标相关的资产，例如会员经营分析所需的会员、交易数据集及经营仪表板。
-
返回「BI资产」页面，检查已添加的资源，点击「保存草稿」，通过「草稿测试」验证典型业务问题，确认数据可用且分析范围正确后再「发布」。详细操作见 测试与发布。
可按需开启「仅查已配置资源」。开启后，新会话不会搜索已选 BI 资源及业务本体数据源之外的资产。移除资产关联不会删除 BI 源数据。
补充场景：连接测试环境或个人环境
需要添加组织环境以外的资产时，可在「BI资产」页面点击「管理 BI 连接」，配置对应的个人连接。详细操作见 配置个人 BI 连接。确认「我的连接」中对应连接显示「已连接」后，再返回添加资产。
也可进入「探索」，在「推荐」或「Plugins」页签的「Connector」区域找到「观远 BI」，配置或管理个人连接。
业务本体
业务本体用于统一智能体的业务语言和分析框架。一个智能体最多绑定 1 个业务本体；如需更换，请先移除当前绑定。如尚未创建本体，可先参考 创建业务本体。
-
在智能体配置页点击「业务本体」，再点击右上角的「+」，打开「绑定业务本体」窗口。
-
搜索并选择一个业务本体，点击「确定」完成绑定。此时默认跟随「最新版本」。
-
在已绑定本体卡片右上角点击「最新版本」，按需保持跟随最新版本，或选择具体版本，如「V3」「V2」「V1」。选择「最新版本」时跟随本体的最新快照；选择具体版本时固定使用该版本。
-
点击「保存草稿」，通过「草稿测试」验证业务口径和分析效果，确认后再「发布」。
业务本体不是必选项，但涉及复杂口径、多对象关系或风险判断时，建议绑定。
Agent 知识
「Agent 知识」用于维护这个智能体工作中积累的稳定术语、口径、数据约定和有效方法。它面向该智能体的所有使用者，个人表达偏好应放在 个人记忆 中。
-
打开智能体配置页的「Agent 知识」，点击「添加 Agent 知识」。
-
选择「分类」，填写经过确认的知识内容。新建时默认分类为「其他」，单条内容最多 2000 个字符；内容为空时不能保存。填写完成后点击「保存」。
分类包括「术语与别名」「指标与计算口径」「时间与周期」「业务范围与数据约定」「分析约定」「展现与表达」和「其他」。例如，“本场景的销售额统一使用扣除退款后的支付金额”可放在「指标与计算口径」，但应先与实际数据口径核对。
-
保存后在列表检查内容。需要更正时，使用「编辑 Agent 知识」；不再适用时，使用「删除 Agent 知识」。
当系统从智能体对话中识别出可沉淀为 Agent 知识的内容时，会在「待确认建议」中展示。Agent 管理者可查看建议类型，点击「查看来源」核对上下文；确认适用于该智能体后点击「采纳」，不适用则点击「拒绝」。
Agent 知识保存后，后续检索即可读取最新内容，并向该智能体当前及未来的所有使用者共享，无需再发布智能体。其优先级低于用户指令、角色指令和个人记忆。不要写入仅适合个人使用的内容。删除知识后，后续检索不再返回该条知识。
参考资料
参考资料用于补充数据集和本体之外的业务知识，例如指标说明、管理制度、复盘模板和分析方法。参考资料可以上传本地文件，也可以引用钉钉或飞书在线文档。
添加在线文档前，需要先完成对应平台的连接。连接钉钉或飞书账号的操作，见 配置插件连接。
操作步骤如下：
-
在配置导航点击「参考资料」。
-
如需上传本地文件，点击「上传参考文件」添加文件快照。
-
如需引用在线文档，点击右上角「+」，打开「添加在线文档」。在「钉钉」或「飞书」页签中搜索文档，选择后点击「添加所选文档」。
未完成对应平台连接时，页面会提示先配置可用的工作区连接。
-
检查已添加的参考资料，点击「保存草稿」保留修改，测试后再点击「发布」。
文件修改随草稿保存，发布后才更新正式参考资料。上传完成或添加完成不等于已经应用到正式智能体。
技能与工具
「技能与工具」用于选择智能体可使用的技能及工具插件，例如文件处理、报告生成或外部工具调用。
- 点击「技能与工具」，打开「添加技能与工具」。
- 在「Skill」或「Plugin」中搜索并选择所需能力，确认选择。
- 检查已选列表和可用状态，完成草稿测试后发布。
需要获取或创建技能时，进入「探索」，具体操作见 Skills。已关联的技能可查看内容；需要修改源技能时，进入技能库处理。技能关联与源技能内容分别管理，修改共享技能可能影响其他引用它的智能体。
对话体验
对话体验
「对话体验」用于配置智能体进入对话时的引导内容，帮助用户理解这个智能体适合处理哪些问题。
| 配置项 | 说明 |
|---|---|
| 默认开场白 | 用户进入智能体对话时看到的第一条消息。建议说明智能体面向的业务场景、可处理的问题类型，以及用户可以提供哪些数据或范围条件。 |
| 预设问题 | 展示给用户的推荐提问，最多 4 条。用户点击预设问题后，问题会带入输入框，可继续补充或调整后再发送。 预设问题建议从客户日常会议、经营看板或管理动作中提炼，例如「本周销售额下降主要来自哪些门店？」「哪些商品库存最高？」。如果智能体面向固定业务场景，也可以把预设问题设计成从诊断到行动的连续路径，例如先定位异常，再拆解原因，最后生成行动建议。 |
模型与推理
「模型与推理」设置新交互式会话使用的初始模型与推理档位。
- 选择具体模型，或选择「跟随 Platform 默认」。
- 选择该模型支持的推理档位，并核对「原始配置」与「当前生效」的显示内容。
- 测试效果后，保存草稿并发布。
用户可在新会话发送首条消息前改选模型与推理档位；此处修改不会切换已开始会话的模型。若已保存的模型或档位不可用，页面会提示当前采用的默认设置，原配置仍会保留。
质量保障
「质量保障」包含「评测」和「自进化」两个入口，用于在发布前后持续检查智能体效果，并把评测结果转化为可审核的改进。
评测
「评测」用于使用固定任务和评分标准重复检查智能体表现。生产者可维护评测案例，选择被测模型和裁判模型运行评测，并通过得分、判定理由和被测回复判断当前配置是否满足预期。
需要创建案例、运行评测或查看评测结果时，见 智能体评测。
自进化
「自进化」根据失败评测、回复点踩或近期慢响应生成可审核的改进草稿。生成过程不会自动复评或修改正式资源，需要人工检查变更内容和影响范围后应用。
自进化适合处理评测中反复暴露的问题，例如回答格式不稳定、证据引用不足、角色指令约束不清晰或 Skill 处理流程需要优化。详细操作见 智能体自进化。
发布与集成
渠道入口
「渠道入口」用于将智能体接入企业聊天平台，或供第三方应用通过 API 调用；按接入方式查看 对接飞书机器人、对接钉钉机器人、对接企业微信 或 配置 API 接入。
发布授权
「发布授权」用于设置智能体的使用范围与成员协作权限，详细操作见 发布授权。
配置建议
- 名称和描述应体现业务场景，便于使用者快速识别。
- 能力边界应尽量清晰，避免单个智能体承担过多职责。
- 角色指令中应明确可用数据源和输出格式，以提升回答稳定性。
- 发布前建议通过典型问题测试回答质量，并覆盖异常输入。
配置完成后，按 草稿测试与发布流程 验证效果并发布。