# 配置语义与标准问答

语义配置用来补充业务口径，帮助智能体理解资料和问题。知识库详情的“语义配置”包含面向结构化查询的 **NL2SQL** 和面向文件检索问答的 **RAG**。先选择与你的资料类型对应的区域。

| 你遇到的问题 | 优先选择 |
| --- | --- |
| 回答文档问题时误解业务术语或适用条件 | RAG 业务规则 |
| 同一类问题需要采用经过确认的答案 | RAG 标准问答 |
| 统计口径、表连接或结构化查询有偏差 | NL2SQL 对应配置项 |

## RAG：补充文件业务规则

业务规则用于说明怎样理解关联文件中的内容，例如某个术语的含义或规则适用范围。

1. 切换到 RAG，进入业务规则，点击新建。
2. 填写规则标识，选择关联文件。
3. 用自然语言写清适用条件、解释和排除情况。
4. 保存后确认列表中的规则，再用典型问题验证。


```{figure} /assets/images/agents/guide-5-hd/37-rag-rule-form.png
:alt: 新建 RAG 业务规则：标识用于识别配置，关联文件确定适用资料，规则正文解释业务口径。
:class: agent-guide-image
:figclass: agent-guide-shot

新建 RAG 业务规则：标识用于识别配置，关联文件确定适用资料，规则正文解释业务口径。
```


标识最多 50 字符，表单要求小写英文字母、下划线或横线，例如 `product_term_rule`。关联文件支持搜索、多选；只有完成解析与嵌入的文件才可选择。找不到刚上传的文件时，先回到知识页检查处理状态。

规则示例：“本文档中的‘有效订单’指已支付且未全额退款的订单；取消订单不纳入统计。此定义只适用于本文件说明的业务。”

## RAG：设置标准问答

标准问答用于维护经过业务确认的问法和答案。进入 RAG 的标准问答，点击新建。


```{figure} /assets/images/agents/guide-5-hd/38-rag-standard-qa-form.png
:alt: 标准问答表单：选择文件、使用方式，再填写标准问题、相似问题和标准答案。
:class: agent-guide-image
:figclass: agent-guide-shot

标准问答表单：选择文件、使用方式，再填写标准问题、相似问题和标准答案。
```


| 字段 | 填写方法 |
| --- | --- |
| 标准问答标识（必填） | 最多 50 字符，使用小写英文字母、下划线或横线 |
| 标准问答说明 | 可选，最多 200 字符，说明覆盖范围 |
| 关联文件（必填） | 搜索并多选已处理文件；答案应来自所选资料 |
| 使用方式（必填） | 选择参考使用或强制使用，区别见下表 |
| 标准问题（必填） | 用户最常用的问法 |
| 相似问题 | 输入一种等价问法后点击添加，可继续补充 |
| 标准答案（必填） | 填写经过业务确认、可用于回答用户的内容 |

| 使用方式 | 含义 | 适合的情况 |
| --- | --- | --- |
| 参考使用 | 结合文件和其他语义配置综合判断 | 答案还需要结合用户具体条件 |
| 强制使用 | 查询意图、业务对象和关键条件一致时，直接使用标准答案 | 适用范围明确、答案已固定的口径 |

“相似问题”应保持相同业务对象、期间和关键条件。例如“本期收入是多少”与“上期收入是多少”不能仅因句式相似就设置为同一答案。

保存后至少测试三种问题：标准问题、等价问法、关键条件不同的问题。前两者检查一致性，后者检查是否误套答案。

(nl2sql-semantics)=

## NL2SQL：解释结构化查询口径

NL2SQL 将自然语言问题转为结构化查询。先导入并检查业务表，再进入对应配置项维护口径。

| 配置入口 | 用途 | 配置前准备 |
| --- | --- | --- |
| 指标 | 解释“销售额、有效客户数”等统计口径 | 指标定义、单位、计算与过滤条件 |
| 业务规则 | 说明查询时必须遵守的业务条件 | 适用对象、包含和排除条件 |
| 表关联 | 说明多张表如何关联 | 关联字段及一对一／一对多关系 |
| 标准问答 | 为典型查询建立经确认的参考 | 常见问题、期望口径和可核对结果 |
| 高级配置 | 维护表字段说明、强制约束和动态查询 | 准备字段含义、过滤条件和只读查询 |

进入所需配置项，按当前表单选择关联数据并填写业务定义，提交后返回列表核对。不要把 RAG 的文件问答字段直接套用于结构化配置；两者的资料对象和表单不同。

例如配置“净销售额”时，应同时确认金额单位、退款扣除方式和时间字段，再用一个小时间段对照源表计算结果。

## 导入与导出语义

页面提供导入语义和导出语义入口，用于交换配置。导出后检查得到的文件；导入时按当前文件格式要求选择，并核对目标知识库中的关联文件或表是否匹配。导入后仍需检查列表和实际问答，不要将文件提交成功等同于业务口径验证完成。

## 结构化配置操作指南

- [指标与筛选条件](nl2sql-metrics.md)：基础指标、派生公式、AND／OR 条件组。
- [业务规则、表关联与标准问答](nl2sql-rules.md)：业务解释、JOIN 预览与只读 SQL。
- [高级配置](nl2sql-advanced.md)：表字段说明、强制约束、动态查询和结果处理。

```{toctree}
:maxdepth: 1
:hidden:

nl2sql-metrics
nl2sql-rules
nl2sql-advanced
```