Настройка агента данных

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

В этой статье описаны конфигурации, которые вы можете использовать для улучшения вашего Data Agent.

Выбор схемы агента данных

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

После добавления источника данных используйте Проводник , чтобы просмотреть и выбрать доступные объекты. Можно сделать следующее:

• Ищите конкретный элемент схемы.
• Используйте галочки для выбора отдельных элементов.
• Выберите элемент на уровне родителя, чтобы автоматически выбрать все его дочерние элементы.
• Выберите «Выбрать все», чтобы все доступные элементы в источнике данных были доступны агенту данных.

Объекты, которые можно выбрать, зависят от типа источника данных. Для доступных опций выбора схемы для каждого типа см. раздел «Добавить и настроить источники данных в агенте данных 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."

Описание источника данных

Описания источников данных помогают создателям предоставлять общий контекст о каждом источнике данных, чтобы агент мог интеллектуально направлять вопросы. Описание должно содержать сводные сведения о том, что содержит источник данных, на какие вопросы он может ответить, и любые нюансы, относящиеся к бизнесу, которые помогают отличить его от других источников. Агент использует эти сведения в процессе анализа, чтобы определить, какой источник является наиболее релевантным для запроса пользователя.

Замечание

Агент данных также учитывает метаданные, такие как описание, схема и примерные запросы, чтобы определить, какой источник данных использовать при ответе на конкретный вопрос.

Примеры запросов источника данных

Запросы-примеры, также известные как few-shot-примеры, используются инструментами агента данных для повышения качества генерируемых запросов. Они позволяют создателям передавать пример логики запроса, на которую агент может ссылаться при формировании ответа. При использовании источника данных соответствующий инструмент автоматически ищет наиболее релевантные запросы к вопросу пользователя и передает первые три в средство агента данных. Эти примеры включаются в процесс создания, помогая агенту создавать более точные и контекстно соответствующие результаты запроса.

Описания объектов схемы (Предварительный просмотр)

Для SQL-источников данных описания объектов схемы предоставляют бизнес-контекст для таблиц, столбцов и других элементов в схеме источника данных. Агент данных использует эти описания для интерпретации больших или неоднозначных схем и понимания того, что представляет каждый элемент, что помогает ему генерировать более точные запросы.

Замечание

Описания объектов схемы доступны только тогда, когда ваш агент данных использует среду предварительного просмотра.

Чтобы узнать, как добавлять и управлять описаниями, смотрите раздел «Добавить описания объектов схемы (Предварительный просмотр).

Темы (Предварительный обзор)

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

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

Замечание

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

Чтобы научиться организовывать и добавлять инструкции на основе тем, смотрите раздел «Использовать темы в агенте данных Fabric (предварительный просмотр).

Дальнейшие шаги

• концепция агента данных
• Добавляйте и настраивайте источники данных в агенте Fabric