分析智能体用于组织特定业务主题的数据、语义知识和业务知识，并向使用者提供自然语言分析入口。
您可以在数据工作台中创建和维护智能体，配置其数据范围、描述及对话界面，并进行测试。业务使用者通过分析工作台选择智能体，开展日常分析。
位置 | 主要用途 |
数据工作台 > 智能体 | 创建、配置和测试分析智能体 |
分析工作台 > 分析智能体 | 查找智能体、查看知识范围并发起正式任务，详见 使用分析智能体 |
前提条件
已进入需要创建智能体的工作空间。
已准备好与业务场景相关的数据表、逻辑视图、指标模型或实体等资产。
已明确智能体的业务用途、可回答的问题和数据范围。
进入管理页面
1. 登录 DataBuddy 控制台。
2. 进入目标工作空间。
3. 如当前位于分析工作台，通过左下角工作空间菜单中的 切换平台 入口选择 数据工作台。
4. 在数据工作台左侧导航中单击 智能体，进入分析智能体列表。
在列表搜索框中输入名称关键词，根据卡片中的名称、负责人和描述找到目标智能体，再单击卡片进入详情。
详情页面同时提供测试对话区域和配置面板。配置面板包含以下页签：
说明：
管理页的页签名称为知识数据库；分析工作台中供使用者浏览的入口名称为数据知识库。
创建分析智能体
步骤 1：打开创建页面
1. 在数据工作台左侧导航中单击智能体。
2. 在分析智能体列表中单击创建智能体。
3. 进入创建分析智能体页面。
创建流程包含配置基础信息和数据健康度检查两个步骤。
步骤 2：配置基础信息
配置项 | 说明 | 填写建议 |
智能体名称 | 页面提供预置名称，可修改 | 使用业务主题和分析用途命名，便于使用者区分 |
空间数据 | 选择关联到智能体的数据资产 | 仅选择回答目标业务问题所需要的资产 |
智能体描述 | 说明智能体的作用和分析范围 | 描述适用对象、可回答的问题、数据粒度和主要限制 |
优先计算资源配置 | 配置计算资源选择方式 | 根据数据来源和工作空间资源选择，页面可显示动态选择 |
名称、空间数据和智能体描述在创建页面中带有必填标记。
选择空间数据
1. 在选择数据区域切换到目标类型：指标模型、数据表、逻辑视图、实体。
2. 使用 搜索数据关键词 定位资产。
3. 勾选需要关联的资产。
4. 在右侧 已选择 区域核对名称与数量。
说明：
不要仅因名称相似就添加资产。应核对字段、数据粒度、所属业务及关联关系，避免引入无关数据。
编写智能体描述
推荐结构：面向谁、分析什么、可以回答什么、使用范围或约束。
示例：
面向零售运营人员的订单分析助手，基于订单商品明细分析订单量、商品金额和运费。支持比较不同时间段的变化，并解释订单粒度与商品明细粒度的区别。仅开展只读分析。
描述区域提供 增强提示词 入口，可辅助完善描述。使用辅助生成内容时，请核对其是否与实际数据、字段及业务口径一致。
注意：
描述或问题中的“只读”等文字用于表达任务约束，不替代数据源及连接器的权限配置。
步骤 3：执行数据健康度检查
配置完成后，单击下一步，进入数据健康度检查。
页面展示评估对象、表和视图等数量、待完善项，以及评估详情。
检查区域 | 关注内容 |
元数据描述完整性 | 查看表描述和字段描述相关评估提示；显示暂不支持时，不能据此判断描述完整性 |
智能体描述与路由 | 描述是否明确回答边界，是否有助于匹配问题 |
业务语义推荐 | 查看与业务语义相关的推荐区域及提示 |
查看检查结果
1. 核对评估对象是否与所选资产一致。
2. 展开评估详情，查看结果及建议。
3. 根据具体提示决定是否完善配置。
4. 需要返回修改时，单击上一步。
说明：
某个对象显示暂不支持时，不应将其理解为检查通过。应结合该对象类型和具体评估项判断。
智能体描述建议需要人工审核。请核对建议中的指标、数量和业务能力是否有对应的数据及字段支持。
步骤 4：完成创建
1. 核对基础信息和健康检查结果。
2. 单击完成创建。
3. 进入新智能体页面后，检查名称、描述及关联知识。
4. 使用测试对话验证数据范围和回答口径。
检查页面同时提供 上一步 和 稍后完善 入口。是否允许继续创建，应以当前页面的校验和按钮状态为准；待完善项不等于已经获得全部质量保证。
管理基本信息与计算资源
查看基本信息
1. 打开目标智能体。
2. 选择 智能体详情 页签。
3. 查看名称、负责人、描述及优先计算资源。
修改名称与描述
1. 在对应字段旁单击编辑图标。
2. 修改内容。
3. 按页面提示保存。
4. 返回详情核对更新结果。
说明：
名称保持简洁，描述明确业务范围。不要将创建时间、测试用途等管理信息作为业务智能体的主要说明。
查看和调整优先计算资源
在智能体详情中找到 优先计算资源，查看当前选择。
页面可显示动态选择。
如需指定资源，打开下拉框，依据当前提供的选项配置。
调整后应重新执行典型问题，核对数据访问和查询结果。
注意：
可选计算资源以当前工作空间提供的选项为准。
测试分析智能体
1. 在数据工作台中打开目标智能体。
2. 在左侧测试对话区域输入典型问题。
3. 单击 发送。
4. 查看返回结果；如包含 SQL，核对数据来源、过滤条件与统计口径。
5. 根据测试结果调整智能体配置，再次验证。
建议测试的问题类型：
测试类型 | 验证目的 |
数据范围 | 是否能正确说明当前有哪些数据及其粒度 |
简单聚合 | 行数、去重数量、金额等基础查询是否符合口径 |
时间过滤 | 使用的日期字段和起止边界是否准确 |
指标解释 | 是否正确引用业务知识中的定义 |
不适用问题 | 数据不支持时是否明确说明，而不是推测结果 |
只读基础测试示例：
基于已关联的订单明细视图，统计总记录行数和去重订单数，返回 SQL，并说明这两项统计的粒度差异。不要修改数据。
删除分析智能体
在管理页面的 智能体详情 页签底部可找到 删除智能体。
删除前，请先确认：
当前选中的是确实不再使用的智能体。
团队成员、常见问题或定时任务不再依赖该智能体。
需要保留的配置信息已经妥善记录。
如决定删除，应阅读系统确认提示，核对影响范围后再执行。
注意：
删除前请确认对历史任务、产物和关联资产的影响，以及是否支持恢复。实际影响和恢复条件应以当前确认提示及相关服务说明为准。
常见问题
分析智能体与工作空间有什么区别？
工作空间是进入产品的组织范围；分析智能体是在其中配置的业务分析入口。多个业务主题可以分别配置智能体。
为什么需要填写描述，而不是只选择数据？
数据范围说明“可以访问什么”，智能体描述说明“适合回答什么”。清晰的描述有助于使用者选择合适入口，也便于检查问题与业务范围是否匹配。
健康检查显示待完善项，是否代表创建一定失败？
不一定。请查看具体评估项和当前按钮状态。能够完成创建不代表所有问题都已解决，仍应完善描述、元数据和语义知识并完成测试。
健康检查显示“暂不支持”，是否代表该对象检查通过？
不是。该提示表示当前评估项未给出受支持的检查结论，不能将其作为质量通过的依据。
为什么管理页面中的对话没有正式任务记录？
该区域是测试运行入口。需要保存并返回日常分析任务时，请前往分析工作台使用智能体。
