在 Fabric 数据代理中使用主题(预览)

通过使用主题,你可以提供大型基于主题的指令,帮助 Fabric 数据代理生成 SQL。 数据代理不会随每个问题发送所有主题内容,而是搜索内容,并只向NL2SQL工具提供与问题相关的部分。

如果你有大量可按主题组织的指导内容,请使用主题。 例如,你可以创建销售、库存和客户保留的部分,然后提供适用于每个主题的业务定义和查询指南。

注释

主题处于预览阶段,仅在 预览运行时对SQL数据源开放。

主题与数据源说明

主题和数据源指令为查询生成工具提供了不同类型的上下文:

Configuration 数据代理如何使用它 何时使用它
主题 数据代理会搜索主题内容,并将相关部分发送到 NL2SQL。 用于较长的指令,这类指令可以按主题划分,并且仅当问题与某个主题相关时才需要使用。
数据源说明 数据代理每次使用数据源时都会向查询生成工具发送指令。 用于设置必须应用于发送到数据源的每个查询的规则和上下文。

例如,如果每个查询都必须使用该定义,可以在数据源指令中放入全组织的财政年度定义。 如果有关如何计算客户留存的详细指导仅用于解答留存相关问题,请将其放在客户留存主题中。

你可以把主题和数据来源的说明结合使用。 当问题需要两者时,NL2SQL会接收数据源指令和相关主题内容。

添加基于主题的指令

你可以为每个支持的SQL数据源添加最多100万字符的主题内容。

  1. 打开你的 Fabric 数据代理,选择一个 SQL 数据源。

  2. 在数据源配置中,开放 数据源主题。

  3. 输入基于主题的说明。 使用Markdown标题将内容组织成不同的主题。

  4. 保存数据代理配置。

  5. 测试题目可以对应到单个主题,也可以是需要多个主题的题目。

    数据源主题编辑器的截图,显示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问题的规则,而不是在多个主题中重复。
  • 避免在各主题和数据源说明中出现重复或相互矛盾的指导。
  • 测试直接题、替代表达以及需要多个主题内容的题目。