配置数据代理

数据代理允许用户通过自然语言与数据交互。 为了提高结果的准确性,请添加业务上下文,以帮助智能体理解问题并构建查询。 这种上下文帮助你创建反映组织流程、场景和业务逻辑的定制解决方案,使代理产生的洞察既准确又符合上下文。

本文介绍了你可以用来增强数据代理的配置。

数据代理模式选择

模式选择控制数据代理可以使用数据源中哪些对象来回答问题。 所选模式为查询生成提供上下文,并限制生成的查询仅限于批准对象。

添加数据源后,使用 资源管理器 查看并选择其可用的对象。 您可以:

  • 搜索特定的模式元素。
  • 使用复选框选择单个元素。
  • 选择父级项目以自动选择其所有子项目。
  • 选择 “全部选择 ”以使数据源中所有可用元素向数据代理开放。

你可以选择的对象取决于数据源类型。 关于每种类型的模式选择选项,请参见“在 Fabric 数据代理中添加和配置数据源”。

只选择数据代理需要的对象来回答其预期问题。 聚焦模式减少歧义,帮助代理将问题引导到合适的数据源,并提升查询生成。 更多指导请参见 改进数据代理查询生成的最佳实践。

截图展示了如何搜索、选择单个表格以及一次选择多个元素。

数据代理说明

数据代理说明指导代理生成对用户问题的准确相关响应。 这些说明可以指定要确定优先级的数据源、概述如何处理某些类型的查询,并提供有用的术语或上下文来解释用户意向。

请使用以下推荐格式来编写有效的代理级指令:


## Objective
// Describe the overall goal of the agent. 
// Example: "Help users analyze retail sales performance and customer behavior across regions."

## Data sources
// Specify which data sources the agent should consider, and in what order of priority.
// Example: "Use 'SalesLakehouse' for product and transaction data. Use 'CRMModel' for customer demographics."

## Key terminology
// Define terms or acronyms the agent may encounter in user queries.
// Example: "'GMV' refers to Gross Merchandise Value."

## Response guidelines
// Set expectations for how the agent should format or present answers.
// Example: "Present results as a short summary followed by a table of the supporting data."

## Handling common topics
// Provide special handling rules or context for frequently asked topics.
// Example: "When asked about customers, use the 'ChurnModelScoring' Lakehouse to get customer details. Then, list any open support tickets"

向数据代理添加数据代理级别说明的屏幕截图

数据源说明

当代理将问题路由到特定数据源时,将应用数据源说明。 这些说明提供了构建精确查询(无论是在 SQL、DAX 还是 KQL 中)所需的上下文,以便代理可以检索准确的信息。

本部分应包括特定于数据源的指南,例如相关表、列、关系以及回答常见或复杂问题所需的任何查询逻辑。 提供的上下文越多,代理就越能生成准确且有意义的查询。

使用以下模板作为起点:

## General knowledge
// Share general background information the agent should consider when querying this data source.

## Table descriptions
// Describe key tables and important columns within those tables.

## When asked about
// Provide query-specific logic or table preferences for certain topics. 
// Example: "When asked about shoe sales, always use the SalesProduct table."

向数据代理添加数据源级别说明的屏幕截图

数据源描述

数据源描述帮助创建者为每个数据源提供高层次的背景信息,使数据代理能够智能地引导问题。 说明应汇总数据源包含的内容、可以回答的问题类型,以及任何有助于将其与其他源区分开来的业务特定细微差别。 代理在其推理过程中使用此信息来确定哪个源与用户的查询最相关。

向数据代理添加数据源说明的屏幕截图。

注释

数据代理还会考虑描述、模式和示例查询等元数据,以确定在回答特定问题时应使用哪个数据源。

数据源示例查询

示例查询,也称为少数样本示例,是数据代理工具用来提升生成查询质量的。 它们允许创建者传递代理在形成响应时可以引用的示例查询逻辑。 使用数据源时,相应的工具会自动查找用户问题最相关的示例查询,并将前三个查询传递给数据代理工具。 这些示例合并到生成过程中,帮助代理生成更准确且上下文适当的查询结果。

向数据代理添加示例查询的屏幕截图

模式对象描述(预览)

对于SQL数据源,模式对象描述为数据源模式中的表、列及其他元素提供业务上下文。 数据代理利用这些描述来解释大型或模糊的模式,理解每个元素所代表的含义,从而帮助生成更准确的查询。

注释

模式对象描述只有在数据代理使用 预览运行时才可用。

在数据代理的模式对象描述窗格中编辑表描述的截图。

想了解如何添加和管理描述,请参见添加模式对象描述(预览)。

主题(预览)

主题为NL2SQL提供了大型基于主题的指令。 数据代理会搜索与用户问题相关的内容,并仅将匹配的部分发送给NL2SQL工具。

当你的指令内容较多、可以按主题组织,并且仅在问题与该主题相关时才适用时,请使用主题。 请改用数据源指令来提供上下文和规则;每当代理查询数据源时,你都必须发送这些内容。

注释

当数据代理使用 预览运行时,主题仅对SQL数据源开放。

数据源主题编辑器的截图,显示Markdown主题指令和大纲。

要了解如何组织和添加基于主题的指令,请参见“在 Fabric 数据代理中使用主题(预览)”。

后续步骤