# 从零搭建一个可用的智能体

从连接数据到交给团队使用，搭建一个回答准确的智能体。

使用指南 · 模块: getting-started · 使用者 / 管理人员 · 部署形态：资料未说明 · 已确认产品版本：资料未说明 · 来源：编辑整理 · 按产品 4.2.76-1110（CLI 0.0.18）核对；私有部署的旧版本可能不包含近期变化。

本教程从连接数据开始，搭建一个团队可以放心使用的智能体，并用真实问题验证。以门店销售分析为例，按你的业务替换即可。

## 准备

- 连接数据源需要项目负责人或项目管理员。普通成员可以从第 2 步开始，使用已有的数据源。
- 一份只读的数据库账号，或整理好的 Excel / CSV 文件。
- 5 到 10 个团队真正关心的业务问题，以及答案的参考值，用于验证。

## 步骤

**连接数据，只选需要的表**

按[连接数据源](https://docs.asktable.com/data/connect)添加数据源。只勾选回答业务问题需要的表，例如订单表、门店表、商品表。等待元数据解析完成。

**写表和字段备注**

打开数据源，为每张表写一句「一行代表什么」，为常用字段写清单位、编码含义和口径，例如「amount：实付金额，单位为分，已扣除优惠券」。和分析无关的 ID、技术字段可以隐藏。见[表与字段备注](https://docs.asktable.com/data/semantics)和[字段隐藏与脱敏](https://docs.asktable.com/data/hidden-fields)。

这一步对准确性的影响最大。

**创建智能体并选择数据源**

在「智能体」中「创建」，选择接近的模板（例如「门店经营分析师」）或从空白创建。在「配置」→「数据源」中添加刚才的数据源。描述写清它能回答什么问题，见[创建并配置智能体](https://docs.asktable.com/agent/overview)。

**写业务口径**

在「文档」中为每个关键指标写一份[业务文档](https://docs.asktable.com/agent/documents)，例如「销售额 = 实付金额 - 退款，按支付日期统计」。在「配置」→「偏好」中写下所有问题都适用的背景和回答风格，见[基础设置与知识偏好](https://docs.asktable.com/agent/profile)。

**挂上分析方法**

团队有固定的分析套路（例如周报格式、异常排查步骤）时，写成[技能](https://docs.asktable.com/agent/skill)挂载到智能体。确认[能力开关](https://docs.asktable.com/agent/capabilities)中的「用户澄清」保持开启。

**用真实问题测试**

在对话中选择这个智能体，逐个提问准备好的问题，对照参考值核对结果，并查看执行的 SQL。

答错时按原因补充：

| 原因         | 补充到                                                                      |
| ---------- | ------------------------------------------------------------------------ |
| 选错字段或理解错编码 | 表与字段备注                                                                   |
| 口径不对       | 业务文档                                                                     |
| 步骤或格式不符合要求 | 技能                                                                       |
| 有固定写法的复杂查询 | [训练集](https://docs.asktable.com/data/manage#%E8%AE%AD%E7%BB%83%E9%9B%86) |

修改后用同一批问题重新测试，直到结果可靠。

**设置权限并分享**

如果不同的人只能看不同范围的数据，先由管理员配置[数据权限](https://docs.asktable.com/permissions)。然后在「智能体」列表中把智能体分享给指定同事或项目全员。

**接入团队常用的工具**

按需把智能体接入[飞书](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)到业务系统。

## 检查结果

- 准备的问题都能得到正确结果，并能在 SQL 中看到正确的口径。
- 同事用自己的账号提问时，只能看到其数据权限允许的数据。
- 上线后定期查看[日志与用户反馈](https://docs.asktable.com/agent/logs-feedbacks)，把答错的问题补充进备注、文档或技能。

## 下一步

- 写出准确问题的方法，可以分享给同事：[怎样问出准确的结果](https://docs.asktable.com/question-tips)
- 按部门和地区限制数据范围：[按部门和地区设计数据权限](https://docs.asktable.com/permissions/design)