配置与管理
业务文档
添加业务规则和指标定义，供智能体在回答时检索和引用。
业务文档用于说明表结构之外的业务规则，例如有效订单的定义、财年的起始月份和指标口径。智能体回答问题时会检索并引用这些内容。
文档和技能不是一回事：技能是「怎么做分析」的方法，文档是「这个世界是什么样」的背景知识。
开始前
| 项目 | 要求 |
|---|---|
| 权限 | 项目角色为「项目负责人」或「项目管理员」。普通项目成员可问数，但不能修改这些配置 |
| 入口 | 左侧主导航 → 「更多」→ 打开目标智能体 → 顶部标签「文档」 |
页面标题是「业务文档」，描述写着「沉淀业务知识，让智能体在问数时检索引用，回答更贴合你的业务」。左边是文档列表，右边是选中文档的详情。
新建和编辑
点「新建文档」
在「文档」标签页点「新建文档」打开创建弹窗。
填标题和描述
- 标题：必填，最长 255 个字符。
- 描述：必填，一句话说明这份文档管什么。
- 正文：可以留空，之后再补。
写正文
在右侧详情面板里写正文，把规则、口径、例外情况写清楚。标题、描述、正文都是失焦即保存，不需要找保存按钮。
补关键词
详情面板里可以加关键词：输入后按回车或逗号添加，每个关键词右侧的 × 可以删掉。
关键词是给检索用的路标。用户提问里出现的说法和文档标题对不上时，关键词能把这份文档拉进候选。
在列表里核对
列表项显示标题和描述；加了关键词的会显示关键词数量角标。
它怎么被用到
你写的文档不是等人来翻的，而是进了智能体的检索范围：
- 智能体收到问题后，先在语义层里做融合检索，业务文档是其中一类内容；
- 命中的文档会带上路径和摘要片段进入上下文，摘要不够用时再读全文；
- 从智能体的视角看，这些文档位于一个虚拟目录
/documents/下，一份文档对应一个/documents/<标题>.md。
所以写得具体比写得长有用：一份文档讲清一个口径，标题和关键词写准，比塞进一份大而全的手册更容易被检索到。
关键约束
| 项目 | 值或行为 |
|---|---|
| 标题 | 必填，最长 255 字符 |
| 描述 | 必填 |
| 正文 | 可为空 |
| 关键词 | 回车或逗号分隔，可增删 |
| 保存方式 | 失焦即保存 |
| 删除 | 在详情面板删除，确认后无法撤销 |
| 文档归属 | 挂在具体智能体上，只在该智能体的检索范围内生效 |
| 与技能的区别 | 文档是背景知识；技能是分析方法 |
出问题怎么判断
| 现象 | 判定条件 | 处理 |
|---|---|---|
| 回答没用上文档 | 明明写了口径，答出来还是另一套算法 | 检查标题和关键词是否覆盖了用户的提问说法；把口径写得更具体 |
| 标题存不进去 | 提交时提示标题超长 | 压到 255 字符以内 |
| 描述留空保存失败 | 描述为必填项 | 补一句话描述 |
| 改完没生效 | 离开输入框后回到原值 | 确认当前角色是「项目负责人」或「项目管理员」；普通项目成员可问数，但不能修改这些配置 |
| 想删掉写错的文档 | 详情面板删除后确认 | 确认后无法撤销，重要内容先备份到别处 |