智能体新建与配置
概述
智能体是 Data Agent 的核心功能之一，主要包含智能体创建与智能体测试两部分，支持用户快速构建业务场景对话逻辑并验证效果，确保 Data Agent 的准确性与流畅性。
前提条件
拥有 ChatBI 「编辑」权限的用户，才可进入「智能体管理」页面进行智能体配置相关操作。
智能体创建
入口：http://<your-domain>/agent/manage/dataset（私有化客户请将 <your-domain> 替换为实际环境地址）。
首次创建智能体时建议基于单表创建，在单表问答准确率达到 80% 后，再扩展其他表进行问答。
-
在「Data Agent > 智能体管理」页面，点击「新建智能体」。
-
填写基础信息，后续若要对基础信息进行修改，可参考 基础配置。
-
名称（必填）：业务视角简单概括当前业务智能体，会作为训练知识给到大模型，最多支持 30 个字符。
-
问答头像配置：默认为观远 logo，可以由用户自行上传图片，进行前台问答头像变更。
-
欢迎语配置（选填）：默认第一行为欢迎语标题，第二行开始为正文内容。欢迎语支持富文本编辑器与引用特定属性。
-
描述（选填）：帮助业务用户了解当前智能体可以解决哪些业务场景/问题，会作为训练知识给到大模型。
-
关联数据集（选填）：问数回答的数据范围，目前版本支持部分直连数据库和抽取数据集，数据集描述、数据集结构和字段注释会作为模型学习知识。
说明- 直连数据库支持：MySQL、Postgres、Starrocks、Doris、Hive、Presto、Trino 、SQL Server、ClickHouse、kylin
- 建议提前准备好至少一个可用数据集以提升问答效果。
展示效果：
-
-
完成智能体创建。
-
以上内容全部填写完成后，即可点击「完成」，完成智能体创建。 创建完成后默认进入智能体详情配置页，后续操作可参考 智能体详情配置。
-
（可选）如果想复用已有智能体的知识库，可以通过另存为的方式，快速复制新智能体。
智能体测试
创建完成一个新的智能体后，建议对当前智能体进行测试，智能体测试准确率直接影响 Data Agent 使用的准确性，请确保测试准确率达 90% 以上再启用智能体。
进入测试页面
在智能体详细配置页面，点击右上角的「测试」，进入到测试界面。
测试问答效果
导入问题
在测试页面，通过批量导入问题或添加单条问题来添加问题。
-
批量导入：批量导入时，下载 Excel 模板，将调研收集的用户问题及回答 SQL 填入，进行批量上传。
说明问题列表样例中的回答 SQL 非必填，可以仅上传测试问题。上传文件后即开始文件内所有问题条目的测试。
-
单条添加：逐条录入问题与回答 SQL，点击「确定」后即开始添加问题条目的测试。
说明- 回答 SQL 非必填，可以仅填写问题描述。
- 若创建智能体时已关联了数据集，则会在「新建问题」页面展示数据集与字段信息。
问题测试与批改
问题上传后系统会自动触发问题测试，大模型会根据当前的数据表和知识，批量生成针对当前问题的 SQL 结果，系统执行该 SQL 并检查其有效性。
SQL 有效性错误时
若 SQL 执行出错，界面会提示 SQL 有效性及批改结果错误。
-
点击问题右侧「批改」，可以看到当前大模型生成的 SQL 详情，在问答详情页面支持以下操作：
-
允许查看和复制消息 ID，提供给产研进行排查。
-
复制执行 SQL：点击「复制执行 SQL」后，系统会将数据库侧实际执行的 SQL 语句复制到剪贴板，可以将 SQL 粘贴到数据库中进行查询。
-
以下场景会进行报错提示：
- 当 AI 模型无法生成有效的 SQL 查询时，系统会显示具体的失败原因：" 问题回答失败，失败原因：xxxx"。此情况通常与模型理解问题或数据结构有关，请尝试重新描述您的需求。
- 当模型成功生成 SQL 但执行时遇到错误，系统会显示 SQL 验证错误信息：" 当前 SQL 有效性校验错误，错误原因：{xxxxx}"。常见原因包括语法错误、表名或字段名不存在、筛选条件错误等。
- 当 SQL 执行成功但未返回任何数据时，系统会提示可能的原因：" 当前查询无数据，请检查数据源是否更新正确、行列权限规则是否配置正确 "。这种情况下，建议检查数据源状态和权限配置。
-
-
维护答案集。
-
如果此时没有答案集，建议用户点击「复制到答案集并编辑」，将 SQL 改正后保存，此时该问题将存储一份正确的 SQL 作为答案。
-
如果已有答案集或已在答案集中维护了正确 SQL，点击「标记为错误并添加至样例集」，将本条问题加入知识库中。
-
-
返回列表页，勾选本条问题，点击「开始测试」重新测试。SQL 有效性正确后，点击「批改」将问题「标记为正确」。
SQL 有效性正确时
-
对于没有答案集的问题，需要点击右侧「批改」。问答详情页面支持的操作与 SQL 有效性错误时一致。
- 若数据结果正确，则点击「标记为正确」，本条测试问题判对，且大模型生成的 SQL 会自动录入到答案集中。
- 若数据结果错误，则先点击「复制到答案集并编辑」维护答案集，再点击「标记为错误并添加至样例集」，进行知识录入维护。
-
对于有答案集的问题，系统会进行大模型生成 SQL 的执行结果与答案集 SQL 的执行结果比对，两者数据必须完全一致，则系统自动判定批改结果为正确；如数据不一致，则系统批改结果为错误。
- 对于系统判对的问题，可以人工再核验一版数据，评估是否要修改判定结果。
- 对于系统判错的问题，则先点击「答案集」右上方「编辑」维护答案集，再点击「标记为错误并添加至样例集」进行知识录入维护。
启用智能体
在全部测试问题批改完成后，列表上方会生成测试准确率提示，建议智能体测试准确率 90% 及以上后再投入生产。
返回智能体详情配置页，点击「启用」，开启智能体。
其余操作
点击智能体右下角更多图标，可对智能体进行其他常用操作。
启用/停用
首次创建并测试完成的智能体，需要点击「启用」，将智能体上线。业务用户可在「问数智能体/洞察智能体」页面，看到全部已启用且有权限的智能体。
若该智能体需要下线，点击「停用」，下线当前智能体。停用的智能体会在智能体右上角展示「停用」状态，若想再次开启该智能体，点击「启用」即可。
重命名
点击「重命名」，重命名当前智能体名称。
另存为
点击「另存为」，可根据当前智能体配置快速创建一个新的智能体。
导入导出
支持主题导入与导出，方便私有化部署下的智能体迁移，例如将测试环境的智能体迁移至生产环境。
- 点击「导出」，将当前智能体的完整配置导出为文件，包含基础信息、数据集配置、知识库内容、功能开关设置等。
- 点击「导入」，上传智能体配置文件，快速在新环境中复现相同的智能体配置。
删除
点击「删除」，删除当前智能体，删除操作会进行二次确认以防误删。