# 创建并配置数据智能体

连接数据、配置业务知识，创建可供团队使用的数据分析助手。

数据智能体是你在 AskTable 中配置的数据分析助手。接好业务数据、补上指标口径后，同事就可以直接用自然语言提问，让它查数据、做计算并解释结果。

例如，为门店运营建一个智能体：绑定销售数据，写清销售额和退货口径，再挂上同比、环比分析技能。团队就能围绕同一套数据和方法提问，不必每次重新交代背景。

## 它能帮你做什么

- 找到问题涉及的表和字段，生成并执行数据查询。
- 在开启相应能力后，用 Python 做计算、把结果画成图表，或在问题不明确时向你澄清。
- 在管理员已配置、且智能体开启联网搜索时，查找公开信息作为分析参考。

具体能做哪些事取决于[能力开关](https://docs.asktable.com/agent/capabilities)和授权的数据范围。

## 数据、技能和使用入口怎么配合

| 配套内容                                                                                              | 解决什么问题                                                                          |
| ------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| [数据源](https://docs.asktable.com/data/connect)                                                     | 有哪些业务数据可供分析                                                                     |
| [业务文档](https://docs.asktable.com/agent/documents)与[知识偏好](https://docs.asktable.com/agent/profile) | 指标怎么算、业务规则是什么、回答怎样组织                                                            |
| [技能](https://docs.asktable.com/agent/skill)                                                       | 一类问题按什么方法分析；智能体在需要时读取技能正文                                                       |
| [频道](https://docs.asktable.com/integrations/feishu)                                               | 在飞书或 [Slack](https://docs.asktable.com/integrations/slack) 里主动提问；一个智能体同时只启用一个平台 |
| [定时任务](https://docs.asktable.com/integrations/scheduled-reports)                                  | 按计划执行分析并推送结果                                                                    |
| [网页嵌入](https://docs.asktable.com/integrations/embed)                                              | 在自有页面提供问数入口                                                                     |

这些入口共用智能体的分析配置；使用者能访问的数据还受各入口的人员授权或绑定角色约束。

## 智能体由哪几部分组成

打开一个智能体，顶部有 7 个标签页。配置类在「配置」，对外入口和运行记录是另外几个标签。

| 标签   | 管什么                        | 详见                                                                                                                                                                   |
| ---- | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 配置   | 数据源绑定、能力开关、技能、领域知识与分析偏好    | [基础设置与知识偏好](https://docs.asktable.com/agent/profile)                                                                                                                 |
| 文档   | 常驻的业务规则与口径文档               | [业务文档](https://docs.asktable.com/agent/documents)                                                                                                                    |
| 频道   | 选择飞书或 Slack，配置凭证、回复方式和人员权限 | [飞书](https://docs.asktable.com/integrations/feishu) · [Slack](https://docs.asktable.com/integrations/slack) · [飞书用户权限](https://docs.asktable.com/permissions/feishu) |
| 定时任务 | 按计划自动分析并推送                 | [定时分析报告](https://docs.asktable.com/integrations/scheduled-reports)                                                                                                   |
| 嵌入   | 嵌进自有网页，控制访客范围              | [网页嵌入](https://docs.asktable.com/integrations/embed)                                                                                                                 |
| 审计日志 | 每次提问的执行链路与状态               | [日志与用户反馈](https://docs.asktable.com/agent/logs-feedbacks)                                                                                                            |
| 用户反馈 | 用户的点赞与点踩，作为调优依据            | [日志与用户反馈](https://docs.asktable.com/agent/logs-feedbacks)                                                                                                            |

其中「配置」里的四项能力开关决定了智能体能做哪些事，是配置的重点，单独用一页说明：[能力开关详解](https://docs.asktable.com/agent/capabilities)。

## 开始前

- 权限：项目角色需要是「项目负责人」或「项目管理员」。普通项目成员可问数，但不能修改这些配置。
- 前置：项目里已有至少一个数据源。没有的话走 左侧主导航 → 「更多」→ 「数据源」→ 右上角「添加数据源」。
- 入口：左侧主导航 → 「更多」。这个按钮直接落到「智能体」页；也可以从数据工作区左侧栏点「智能体」。

## 创建智能体

**打开智能体列表**

左侧主导航 → 「更多」。页面标题是「智能体」，右上角一个「创建」按钮，左侧搜索框可以按名称搜索数据智能体。

**选模板，或从空白开始**

点「创建」，弹窗标题「创建数据智能体」，可以在模板里挑一个，也可以从空白开始。

- 选模板：卡片上给出模板名称和一句话描述，点下去就按该模板建好智能体，名称、描述、技能都已预置。
- 选「从空白创建」（自定义名称和描述，从零开始配置）：填名称（必填）和描述（可选），再点「创建」。

**接上数据源**

新建后直接进入详情页。顶部标签切到「配置」，在「数据源」区块点「添加」，弹出「选择数据源」，勾选后关闭。详细说明见[基础设置与知识偏好](https://docs.asktable.com/agent/profile)。

**按需补能力、技能、文档和偏好**

依次确认[能力开关](https://docs.asktable.com/agent/capabilities)、挂[技能](https://docs.asktable.com/agent/skill)、补[业务文档](https://docs.asktable.com/agent/documents)和[领域知识与分析偏好](https://docs.asktable.com/agent/profile)。

**回列表核对**

详情页面包屑第一级是「智能体」，点它回到列表。卡片上显示名称、描述、数据源引擎标签和创建时间（相对时间，形如 3 天前）。

### 内置智能体模板

创建弹窗里可选 9 个模板。模板只是只读起点，按它建出来的智能体可以自由改。

| 模板名称     | 描述                           |
| -------- | ---------------------------- |
| 门店经营分析师  | 专注零售门店经营数据分析，帮你发现门店运营中的机会与问题 |
| 电商数据盯盘助手 | 实时监控电商核心数据，第一时间发现异常和机会       |
| 财务数据分析师  | 深入分析财务数据，帮助把握经营状况，识别财务风险     |
| 市场洞察分析师  | 追踪市场动态，分析竞争格局，识别市场机会         |
| 供应链监控官   | 实时监控供应链各环节，及时发现风险和优化机会       |
| 用户增长分析师  | 追踪用户增长指标，分析增长策略效果，识别增长机会     |
| 高管数据助手   | 为高管提供一键式经营数据汇总，辅助快速决策        |
| 经营红黄灯分析师 | 为各业务线设置红黄灯预警规则，自动追踪指标健康度     |
| 数据质量守护者  | 主动监控数据质量，确保分析结果的准确性和可信度      |

## 关键约束

| 项目         | 值或默认                         | 在哪里改                          |
| ---------- | ---------------------------- | ----------------------------- |
| 数据源        | 可添加一个或多个                     | 详情页 → 「配置」 → 「数据源」 → 「添加」     |
| Python 解释器 | 默认开                          | 详情页 → 「配置」 → 「能力配置」           |
| 图表可视化      | 默认开                          | 详情页 → 「配置」 → 「能力配置」           |
| 用户澄清       | 默认开                          | 详情页 → 「配置」 → 「能力配置」           |
| 联网搜索       | 默认关；管理员未配置时开关禁用              | 详情页 → 「配置」 → 「能力配置」           |
| 领域知识与分析偏好  | 各 1024 个字符上限，失焦保存            | 详情页 → 「配置」 → 「偏好」             |
| 内置智能体模板    | 9 个，只读起点，按它建出的智能体可自由改        | 「创建」弹窗                        |
| 频道白名单      | 各平台独立，默认关闭；关闭时能联系该机器人的用户都可问数 | 详情页 → 「频道」 → 「人员权限」（需先启用对应平台） |

## 出问题怎么判断

| 现象                                 | 判定条件                          | 处理                                     |
| ---------------------------------- | ----------------------------- | -------------------------------------- |
| 保存被拒绝                              | 当前有效项目角色没有配置管理权限              | 由项目负责人或项目管理员修改配置或调整授权                  |
| 联网搜索开关点不动                          | 开关描述说明尚未配置联网搜索、需要管理员先在系统设置里配置 | 让系统管理员先在系统设置里配好联网搜索，再回来打开              |
| 上传 Excel 被拦，提示当前智能体未开启 Python 分析能力 | 该智能体的 Python 解释器是关的           | 回详情页 → 「配置」 → 「能力配置」把它打开，或换一个开了该能力的智能体 |
| 提问被拒绝，提示没有可查询的数据表或字段               | 该智能体的「数据源」区块为空                | 详情页 → 「配置」 → 「数据源」 → 「添加」补上            |
| 提问被拒绝，提示数据源中找不到表 X（schema Y）       | 这张表不在该智能体已绑定数据源的可访问范围内        | 用「数据源」区块确认数据源已挂上；表被策略挡掉时到「策略」里改规则      |
| 对话提示当前会话绑定的智能体已被删除                 | 这条会话绑定的智能体已被删除                | 新建对话；或到「智能体」列表确认目标智能体还在                |
| 对话提示当前会话绑定的角色已被删除                  | 这条会话绑定的角色已被删除                 | 重新选角色，或新建对话                            |

## 下一步

- 搞清四个能力开关各管什么：[能力开关详解](https://docs.asktable.com/agent/capabilities)
- 把反复交代的分析步骤固化成一份技能：[分析技能](https://docs.asktable.com/agent/skill)
- 让智能体记住你们的指标口径：[业务文档](https://docs.asktable.com/agent/documents)
- 用「人员」「角色」「策略」控制每个人能看到哪些库、表和行：[权限与数据范围](https://docs.asktable.com/permissions)