# 业务文档

添加业务规则和指标定义，供智能体在回答时检索和引用。

业务文档用于说明表结构之外的业务规则，例如有效订单的定义、财年的起始月份和指标口径。智能体回答问题时会检索并引用这些内容。

文档和[技能](https://docs.asktable.com/agent/skill)不是一回事：技能是「怎么做分析」的方法，文档是「这个世界是什么样」的背景知识。

## 开始前

| 项目 | 要求                                       |
| -- | ---------------------------------------- |
| 权限 | 项目角色为「项目负责人」或「项目管理员」。普通项目成员可问数，但不能修改这些配置 |
| 入口 | 左侧主导航 → 「更多」→ 打开目标智能体 → 顶部标签「文档」         |

页面标题是「业务文档」，描述写着「沉淀业务知识，让智能体在问数时检索引用，回答更贴合你的业务」。左边是文档列表，右边是选中文档的详情。

## 新建和编辑

**点「新建文档」**

在「文档」标签页点「新建文档」打开创建弹窗。

**填标题和描述**

- **标题**：必填，最长 255 个字符。
- **描述**：必填，一句话说明这份文档管什么。
- **正文**：可以留空，之后再补。

**写正文**

在右侧详情面板里写正文，把规则、口径、例外情况写清楚。标题、描述、正文都是**失焦即保存**，不需要找保存按钮。

**补关键词**

详情面板里可以加**关键词**：输入后按回车或逗号添加，每个关键词右侧的 × 可以删掉。

关键词是给检索用的路标。用户提问里出现的说法和文档标题对不上时，关键词能把这份文档拉进候选。

**在列表里核对**

列表项显示标题和描述；加了关键词的会显示关键词数量角标。

## 它怎么被用到

你写的文档不是等人来翻的，而是进了智能体的检索范围：

1. 智能体收到问题后，先在语义层里做融合检索，业务文档是其中一类内容；
2. 命中的文档会带上路径和摘要片段进入上下文，摘要不够用时再读全文；
3. 从智能体的视角看，这些文档位于一个虚拟目录 `/documents/` 下，一份文档对应一个 `/documents/<标题>.md`。

所以**写得具体比写得长有用**：一份文档讲清一个口径，标题和关键词写准，比塞进一份大而全的手册更容易被检索到。

## 关键约束

| 项目     | 值或行为                                                     |
| ------ | -------------------------------------------------------- |
| 标题     | 必填，最长 255 字符                                             |
| 描述     | 必填                                                       |
| 正文     | 可为空                                                      |
| 关键词    | 回车或逗号分隔，可增删                                              |
| 保存方式   | 失焦即保存                                                    |
| 删除     | 在详情面板删除，确认后无法撤销                                          |
| 文档归属   | 挂在具体智能体上，只在该智能体的检索范围内生效                                  |
| 与技能的区别 | 文档是背景知识；[技能](https://docs.asktable.com/agent/skill)是分析方法 |

## 出问题怎么判断

| 现象       | 判定条件              | 处理                                         |
| -------- | ----------------- | ------------------------------------------ |
| 回答没用上文档  | 明明写了口径，答出来还是另一套算法 | 检查标题和关键词是否覆盖了用户的提问说法；把口径写得更具体              |
| 标题存不进去   | 提交时提示标题超长         | 压到 255 字符以内                                |
| 描述留空保存失败 | 描述为必填项            | 补一句话描述                                     |
| 改完没生效    | 离开输入框后回到原值        | 确认当前角色是「项目负责人」或「项目管理员」；普通项目成员可问数，但不能修改这些配置 |
| 想删掉写错的文档 | 详情面板删除后确认         | 确认后无法撤销，重要内容先备份到别处                         |

## 下一步

- 把分析方法也固化下来：[分析技能](https://docs.asktable.com/agent/skill)
- 让文档里的口径对上表结构：[表与字段备注](https://docs.asktable.com/data/semantics)
- 看它实际有没有引用到：[日志与用户反馈](https://docs.asktable.com/agent/logs-feedbacks)