Usar temas en un agente de datos de Fabric (vista previa)

Al usar temas, puedes proporcionar instrucciones grandes basadas en temas que ayuden a un agente de datos Fabric a generar SQL. En lugar de enviar todo el contenido temático con cada pregunta, el agente de datos busca el contenido y proporciona a la herramienta NL2SQL solo las partes relevantes para la pregunta.

Utiliza temas cuando dispongas de un conjunto amplio de orientación que puedas organizar por tema. Por ejemplo, puedes crear secciones para ventas, inventario y retención de clientes, y luego proporcionar las definiciones de negocio y la guía de consultas que se aplican a cada tema.

Note

Los temas están en versión preliminar y solo están disponibles para fuentes de datos SQL en el entorno de ejecución preliminar.

Temas e instrucciones sobre fuentes de datos

Los temas e instrucciones de fuentes de datos proporcionan diferentes tipos de contexto a las herramientas de generación de consultas:

Configuración Cómo lo utiliza el agente de datos Cuándo usarlo
Temas El agente de datos busca el contenido del tema y envía las secciones relevantes a NL2SQL. Usa instrucciones grandes que puedas dividir por temas y que solo necesitas cuando una pregunta esté relacionada con un tema.
Instrucciones del origen de datos El agente de datos envía las instrucciones a la herramienta de generación de consultas cada vez que utiliza la fuente de datos. Úsala para reglas y contexto que deben aplicarse a cada pregunta enviada a la fuente de datos.

Por ejemplo, pon una definición de año fiscal a nivel organizacional en las instrucciones de la fuente de datos si todas las consultas deben usarla. Incluya una guía detallada para calcular la retención de clientes en un tema de retención si la orientación es necesaria solo para preguntas sobre retención.

Puedes usar temas e instrucciones sobre la fuente de datos de forma conjunta. Cuando una pregunta requiere ambos, NL2SQL recibe las instrucciones de la fuente de datos y el contenido relevante del tema.

Añadir instrucciones basadas en temas

Puedes añadir hasta 1 millón de caracteres de contenido temático a cada fuente de datos SQL soportada.

  1. Abre tu agente de datos Fabric y selecciona una fuente de datos SQL.

  2. En la configuración de la fuente de datos, abre Temas de la fuente de datos.

  3. Introduce tus instrucciones basadas en el tema. Utiliza encabezados de Markdown para organizar el contenido en temas distintos.

  4. Guarda la configuración del agente de datos.

  5. Preguntas de examen que corresponden a temas individuales y preguntas que requieren más de un tema.

    Captura de pantalla del editor de temas de fuentes de datos mostrando instrucciones sobre temas de Markdown y un esquema.

Estructura del contenido del tema

Utiliza encabezados descriptivos de Markdown para que el agente de datos pueda encontrar la sección correcta para una pregunta. Mantén todas las indicaciones de una materia bajo el encabezado correspondiente.

## 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.

Cuando un usuario pregunta por el churn, el agente de datos puede recuperar la guía de retención de clientes sin enviar la guía de inventario no relacionada a NL2SQL.

Revisa los temas recuperados en run steps

Después de probar una pregunta, revisa el paso de ejecución de Temas de Fuentes de Datos Abiertos para ver qué contenido temático ha seleccionado el agente de datos. La entrada muestra la ruta de encabezados y el motivo por el que se seleccionó el tema. La salida muestra las instrucciones proporcionadas a NL2SQL.

Captura de pantalla del paso de la ejecución Open Data Source Topic mostrando la ruta seleccionada y las instrucciones recuperadas.

procedimientos recomendados

  • Utiliza encabezados que coincidan con los términos que la gente usa en sus preguntas.
  • Mantén cada tema independiente. Incluye las definiciones empresariales relevantes, tablas, columnas, relaciones, filtros y reglas de cálculo bajo el mismo encabezado temático.
  • Utiliza subtítulos para separar escenarios relacionados dentro de un tema amplio.
  • Pon reglas que deban aplicarse a cada pregunta de SQL en las instrucciones de la fuente de datos en lugar de repetirlas en varios temas.
  • Evita duplicar o contradecir las directrices entre temas y las instrucciones de la fuente de datos.
  • Examina preguntas directas, formulaciones alternativas y preguntas que requieran contenido de varios temas.

Contenido relacionado

  • Last updated on