通过使用主题,你可以提供大型基于主题的指令,帮助 Fabric 数据代理生成 SQL。 数据代理不会随每个问题发送所有主题内容,而是搜索内容,并只向NL2SQL工具提供与问题相关的部分。
如果你有大量可按主题组织的指导内容,请使用主题。 例如,你可以创建销售、库存和客户保留的部分,然后提供适用于每个主题的业务定义和查询指南。
注释
主题处于预览阶段,仅在 预览运行时对SQL数据源开放。
主题与数据源说明
主题和数据源指令为查询生成工具提供了不同类型的上下文:
| Configuration | 数据代理如何使用它 | 何时使用它 |
|---|---|---|
| 主题 | 数据代理会搜索主题内容,并将相关部分发送到 NL2SQL。 | 用于较长的指令,这类指令可以按主题划分,并且仅当问题与某个主题相关时才需要使用。 |
| 数据源说明 | 数据代理每次使用数据源时都会向查询生成工具发送指令。 | 用于设置必须应用于发送到数据源的每个查询的规则和上下文。 |
例如,如果每个查询都必须使用该定义,可以在数据源指令中放入全组织的财政年度定义。 如果有关如何计算客户留存的详细指导仅用于解答留存相关问题,请将其放在客户留存主题中。
你可以把主题和数据来源的说明结合使用。 当问题需要两者时,NL2SQL会接收数据源指令和相关主题内容。
添加基于主题的指令
你可以为每个支持的SQL数据源添加最多100万字符的主题内容。
打开你的 Fabric 数据代理,选择一个 SQL 数据源。
在数据源配置中,开放 数据源主题。
输入基于主题的说明。 使用Markdown标题将内容组织成不同的主题。
保存数据代理配置。
测试题目可以对应到单个主题,也可以是需要多个主题的题目。
主题内容结构
使用描述性的Markdown标题,让数据代理找到问题的正确部分。 将该学科的所有指导内容放在相应标题下。
## Customer retention
Use the CustomerSubscription table for retention questions.
### Retained customers
A customer is retained when IsActive is 1 and RenewalDate is after the reporting date.
### Churn rate
Calculate churn rate as the number of subscriptions canceled during the period divided by the number of active subscriptions at the start of the period.
## Inventory
Use the InventorySnapshot table for current inventory questions.
### Low-stock products
A product is low in stock when QuantityOnHand is less than ReorderPoint.
当用户询问流失时,数据代理可以检索客户留存指南,而无需将无关的库存指南发送给NL2SQL。
在运行步骤中回顾检索的主题
测试完问题后,查看 开放数据源主题 运行步骤,看看数据代理选择了哪些主题内容。 输入内容显示标题路径以及选择该主题的原因。 输出显示了提供给 NL2SQL 的指令。
最佳做法
- 使用与人们提问中使用的术语相符的标题。
- 保持每个主题独立。 在同一主题标题下包含相关的业务定义、表格、列、关系、筛选和计算规则。
- 使用小标题区分广泛主题中的相关情景。
- 在数据源指令中设置必须适用于每个SQL问题的规则,而不是在多个主题中重复。
- 避免在各主题和数据源说明中出现重复或相互矛盾的指导。
- 测试直接题、替代表达以及需要多个主题内容的题目。