Использование тем в агенте данных Fabric (предварительный просмотр)

Используя topics, вы можете предоставлять большие тематические инструкции, которые помогают агенту данных Fabric генерировать SQL. Вместо того чтобы отправлять весь тематический контент вместе с каждым вопросом, агент данных ищет по нему и предоставляет инструменту NL2SQL только те части, которые релевантны к вопросу.

Используйте темы, когда у вас есть большой набор рекомендаций, которые можно организовать по темам. Например, вы можете создать разделы для продаж, запасов и удержания клиентов, а затем предоставить определения бизнеса и рекомендации по запросам, применимые к каждой теме.

Note

Темы находятся в режиме предварительного просмотра и доступны только для источников данных SQL в предварительном режиме выполнения.

Темы и инструкции по источникам данных

Темы и инструкции по источникам данных предоставляют различные виды контекста для инструментов генерации запросов:

Configuration Как агент данных использует его Когда его использовать
Темы Агент данных ищет содержимое темы и отправляет соответствующие разделы в NL2SQL. Используйте для объёмных инструкций, которые можно разделить по темам и которые нужны только тогда, когда вопрос относится к определённой теме.
Инструкции по источнику данных Агент данных отправляет инструкции инструменту генерации запросов каждый раз, когда использует источник данных. Используйте правила и контекст, которые должны применяться к каждому вопросу, отправляемому в источник данных.

Например, вместить определение финансового года по всей организации в инструкции источника данных, если каждый запрос должен его использовать. Разместите подробные рекомендации по расчёту удержания клиентов в теме удержания клиентов, если они нужны только для вопросов удержания.

Вы можете использовать темы и инструкции по источникам данных вместе. Когда вопрос требует обоих задач, NL2SQL получает инструкции по источнику данных и соответствующее содержание темы.

Добавьте инструкции по темам

Вы можете добавить до 1 миллиона символов тематического контента к каждому поддерживаемому источнику данных SQL.

  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.

Обзор полученных тем по этапам прохождения

После тестирования вопроса ознакомьтесь с шагом запуска Open Data Source Topic , чтобы узнать, какой контент выбрал агент данных. Ввод показывает путь заголовка и причину выбора темы. На выходе отображаются инструкции, предоставленные NL2SQL.

Скриншот шага запуска Open Data Source Topic с выбранным заголовком и полученными инструкциями.

Лучшие практики

  • Используйте заголовки, соответствующие терминам, которые люди используют в своих вопросах.
  • Держите каждую тему самостоятельной. Включите соответствующие бизнес-определения, таблицы, столбцы, отношения, фильтры и правила расчёта под тем же заголовком темы.
  • Используйте подзаголовки для разделения связанных сценариев в рамках широкой темы.
  • В инструкции по источнику данных добавляют правила, которые должны применяться к каждому вопросу SQL, вместо того чтобы повторять их в нескольких темах.
  • Избегайте дублирования или противоречия рекомендациям по темам и инструкциям по источникам данных.
  • Проверяйте прямые вопросы, альтернативные формулировки и вопросы, требующие содержания из разных тем.

Связанные материалы

  • Последнее обновление: