Antes de configurar el conector Fabric IQ, complete los pasos descritos en la documentación de Permiso Foundry User. Este permiso es necesario para que los usuarios puedan utilizar el agente Fabric IQ a través de Power OMNI.
Con este conector, los agentes pueden consultar información de negocio usando lenguaje natural mediante los recursos proporcionados por Microsoft Fabric IQ, entre ellos:
- Data Agent
- Power BI Semantic Model
- Ontology
El conector crea un puente entre el agente de Power OMNI y los recursos de Fabric, permitiendo que el modelo utilice datos estructurados para responder preguntas, generar análisis y apoyar a los usuarios en los procesos de toma de decisiones.
Microsoft Fabric IQ se encuentra actualmente en versión preliminar (preview).
Cómo funciona
El flujo de uso de Fabric IQ en Power OMNI:
| Paso | Descripción |
|---|---|
| Crear conector | Configura el acceso al recurso de Microsoft Fabric IQ. |
| Seleccionar elemento de Fabric | Define qué recurso se utilizará: Data Agent, Semantic Model u Ontology. |
| Conectar con el agente | Hace que el conector esté disponible para el uso del agente. |
| Ejecutar consultas | El agente utiliza MCP para consultar información de Fabric. |
El conector puede ser utilizado directamente por el agente.
El uso de un Toolbox es opcional y puede adoptarse solo cuando exista la necesidad de organizar múltiples recursos, como conectores, herramientas y Skills.
Acceso al menú Conectores
En el Portal de Administración de Power OMNI:
Creación de un conector Fabric IQ
Tipo de conector
Seleccione Fabric IQ Connector.
Después de seleccionar esta opción, se mostrarán los campos de configuración específicos de Microsoft Fabric.
Proyecto
Seleccione el proyecto de Microsoft Foundry en el que se creará el conector.
Nombre
Ingrese un nombre para identificar el conector.
| Nombre | Propósito |
|---|---|
| fabric-sales | Consultas relacionadas con ventas |
| fabric-finance | Consultas financieras |
| fabric-customers | Información de clientes |
Descripción
La descripción informa al agente cuándo debe utilizarse este conector.
Una descripción clara mejora la identificación del momento correcto para usar la herramienta.
Ejemplo:
Consulta información de ventas, ingresos y clientes disponible en Microsoft Fabric.
Evite descripciones genéricas:
Fabric Connector
Tipo de elemento de Fabric
Fabric IQ permite conectar diferentes tipos de recursos.
| Tipo | Descripción |
|---|---|
| Data Agent | Agente de datos creado en Microsoft Fabric |
| Ontology | Estructura de entidades y relaciones de Fabric |
| Power BI Semantic Model | Modelo semántico de Power BI |
Configuración de la conexión
Al configurar la conexión, existen dos opciones:
Importar conexión existente
Utiliza una conexión creada previamente en el proyecto.
Recomendado cuando varios conectores necesitan compartir la misma configuración.
Crear nueva conexión
Crea una nueva configuración de autenticación.
Ejemplo:
fabric-sales-prodMétodos de autenticación
Token de Entra ID del usuario
Utiliza el token del usuario autenticado en Power OMNI.
Este método respeta los controles de acceso existentes configurados en Fabric.
OAuth2 (Custom Entra App)
Permite la autenticación mediante una aplicación registrada en Microsoft Entra.
Esta opción se encuentra actualmente en implementación en Power OMNI.
Cuando esté disponible, se requerirán los siguientes campos:
| Campo | Descripción |
|---|---|
| Tenant ID | Identificador del tenant de Microsoft Entra |
| Client ID | Identificador de la aplicación registrada |
| Client Secret | Secreto de la aplicación |
Política de aprobación
Define si una ejecución que utiliza el conector requiere aprobación.
Nunca (ejecución automática)
El agente ejecuta las llamadas automáticamente.
Requerir aprobación siempre
El usuario debe aprobar antes de la ejecución.
Conectar el conector al agente
Después de crear el conector:
El agente puede utilizar Fabric IQ siempre que identifique que la solicitud depende de información proporcionada por el conector.
Uso opcional de Toolbox
Fabric IQ no requiere un Toolbox para funcionar.
Un Toolbox puede utilizarse cuando exista la necesidad de organizar diferentes recursos en un único grupo.
| Toolbox | Recursos |
|---|---|
| Análisis Comercial | Fabric IQ + Búsqueda en la Web + Skills |
| Atención al Cliente | SharePoint + Fabric IQ + APIs |
Limitaciones actuales
- Microsoft Fabric IQ se encuentra actualmente en versión preliminar (preview).
- La autenticación OAuth2 mediante una aplicación Entra personalizada se encuentra en implementación en Power OMNI.
- Las funcionalidades y comportamientos pueden cambiar durante el período de preview.
Solución de problemas
El agente no utiliza Fabric IQ
Verifique:
- que el conector fue vinculado al agente;
- que los cambios fueron guardados;
- que la pregunta está relacionada con el recurso de Fabric configurado;
- que el usuario tiene permiso en Fabric.
Error de permiso
Verifique:
- el acceso al workspace de Fabric;
- el estado de publicación del Data Agent;
- los permisos del Semantic Model;
- los permisos de Ontology.
El conector no puede acceder al elemento de Fabric
Confirme:
- que el workspace es el correcto;
- que el elemento de Fabric existe;
- que la conexión fue configurada correctamente;
- que el usuario tiene acceso al recurso.