Añadir tablas Azure SQL como fuente de conocimiento

Cuando integras tablas Azure SQL como fuente de conocimiento, bases a tu agente en los datos estructurados almacenados en tu base de datos Azure SQL. Tu agente puede responder preguntas leyendo las tablas que selecciones, usando las credenciales de conexión y permisos disponibles para el creador.

Note

Para añadir tablas Azure SQL como fuente de conocimiento, debes tener permiso para acceder a la base de datos y las tablas subyacentes. La falta o la falta de permisos insuficientes pueden impedir que servidores, bases de datos o tablas sean visibles o seleccionables durante la configuración.

Prerequisites

• Una Azure SQL Database o Azure SQL Managed Instance a la que tu organización pueda acceder desde Power Platform.

• Credenciales que puedan conectarse a la base de datos y leer las tablas que planeas añadir (por ejemplo, Microsoft Entra ID o autenticación SQL, dependiendo de cómo esté configurada tu conexión).

• Acceso a Copilot Studio y permiso para editar al agente.

• Acceso a la red configurado para que Power Platform pueda acceder a tu servidor Azure SQL. Por ejemplo, reglas de cortafuegos que permiten servicios de Azure, o conectividad privada según lo requiera tu organización.

Permisos y autenticación

El conocimiento de Azure SQL utiliza la conexión SQL de Power Platform que creas o seleccionas durante la configuración. En tiempo de ejecución, el agente depende de la autenticación Microsoft del usuario agente y del acceso concedido a través de esa ruta de conexión.

• Los usuarios solo reciben respuestas basadas en datos a los que el creador puede acceder mediante la conexión configurada y los permisos de la base de datos del creador.

• Si no aparecen tablas durante la configuración, verifica que la conexión tenga éxito fuera de Copilot Studio y que la cuenta pueda listar y leer esas tablas.

Prepara tu base de datos Azure SQL

Los agentes de Copilot Studio soportan bases de datos Azure SQL o SQL Server. Antes de añadir tablas, asegúrate de que tus tablas tengan la siguiente configuración:

• Aclara los nombres de las columnas, evitando también abreviaturas crípticas. Por ejemplo, use CustomerName en lugar de CustNm.
• Claves primarias definidas para cada tabla. El agente utiliza claves primarias para identificar filas y devolver resultados.
• Datos descriptivos, que ayudan al agente a entender el contexto de los datos y responder preguntas con mayor precisión. Por ejemplo, use OrderDate en lugar de Date1.

Añadir tablas Azure SQL a tu agente

Para añadir tablas Azure SQL como fuente de conocimiento, completa los siguientes pasos:

1. Abre tu agente de Copilot Studio.

2. Seleccione la pestaña Crear.

3. En el panel de componentes, selecciona Conocimiento.

4. En el cuadro de diálogo Añadir conocimiento, selecciona Azure SQL (o SQL Server, según la etiqueta que aparezca en tu entorno).

5. Crea o selecciona una conexión a tu base de datos Azure SQL:

   • Si aún no tienes conexión, selecciona Crear nueva conexión (o Añadir conexión).

   • Introduce el nombre del servidor y el nombre de la base de datos de tu recurso Azure SQL.

   • Elige el tipo de autenticación que requiere tu organización, inicia sesión o proporciona las credenciales, y crea la conexión.

   • Si ya existe una conexión, elícela de la lista y continúa.

6. Localiza una o más tablas para añadir. Usa el campo de búsqueda para reducir la lista si es necesario, y luego selecciona las tablas que quieres que use el agente.

   Note

   Solo añade tablas que el agente necesita para responder a las preguntas de los usuarios. Utiliza tablas bien nombradas con nombres claros de columnas para que el agente pueda interpretar los datos de forma más fiable.

7. Revise el nombre y la descripción del conocimiento. Proporciona una descripción detallada, ya que la descripción ayuda a la orquestación del agente y le ayuda a comprender el contexto de la fuente de conocimiento.

8. Seleccione Agregar al agente para terminar de agregar el origen de conocimiento.

Después de añadir la fuente de conocimiento

Después de añadir Azure SQL:

• Confirma que la fuente de conocimiento aparece en la página de Conocimiento del agente con la conexión y las tablas seleccionadas que elegiste.

• Publica el agente para que la fuente de conocimiento esté disponible en la experiencia publicada.

• Pon a prueba a tu agente con preguntas que deban responderse de las tablas seleccionadas. Por ejemplo, "Muéstrame los cinco principales clientes por ventas totales del mes pasado." Si los resultados devueltos están vacíos o son incorrectos, asegúrate de que la tabla contiene los datos esperados y que la consulta se alinea con tu esquema.

Tip

Crea una vista diagnóstica en Azure SQL que devuelva un conjunto de datos pequeño y conocido. Utiliza este conjunto de datos para confirmar que la conexión funciona antes de usar tablas de producción.

Mejora la calidad de las respuestas

Nombres claros y descripciones ayudan al agente a entender cuándo y cómo usar tus datos de Azure SQL.

• Utiliza un nombre específico de fuente de conocimiento que refleje el dominio de negocio (por ejemplo, "Pedidos de cliente – Azure SQL") en lugar de una etiqueta genérica.

• Redacta una descripción detallada que explique qué datos contienen las tablas, qué preguntas de negocio responden y cualquier filtro o relación importante.

• Selecciona solo las tablas relevantes. Tablas adicionales pueden diluir la conexión a tierra y dificultar que el agente elija los datos correctos.

• Prefiero un esquema legible. Las tablas y columnas con nombres amigables para los negocios suelen dar mejores respuestas que los nombres técnicos opacos.

Descripción de ejemplo

El siguiente ejemplo muestra el tipo de descripción que ayuda a la orquestación generativa a seleccionar la fuente de conocimiento adecuada:

Azure SQL knowledge for Contoso order management. Incluye Clientes, Pedidos y mesas de OrderLines. Utiliza esta fuente para preguntas sobre el estado del pedido, historial de pedidos, compras de clientes, cantidades de productos pedidos e ingresos por cliente o fecha. No lo uses para inventario disponible ni para el seguimiento de transportistas.