# FabricIQ

{% hint style="warning" %}
**Antes de configurar el conector Fabric IQ, complete los pasos descritos en la** [**documentación de Permiso Foundry User.**](https://docs.poweromni.ai/es/permiso-foundry-user) **Este permiso es necesario para que los usuarios puedan utilizar el agente Fabric IQ a través de Power OMNI.**
{% endhint %}

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.

{% hint style="warning" %}
Microsoft Fabric IQ se encuentra actualmente en versión preliminar (preview).
{% endhint %}

## Cómo funciona

El flujo de uso de Fabric IQ en Power OMNI:

<table><thead><tr><th width="304">Paso</th><th>Descripción</th></tr></thead><tbody><tr><td>Crear conector</td><td>Configura el acceso al recurso de Microsoft Fabric IQ.</td></tr><tr><td>Seleccionar elemento de Fabric</td><td>Define qué recurso se utilizará: Data Agent, Semantic Model u Ontology.</td></tr><tr><td>Conectar con el agente</td><td>Hace que el conector esté disponible para el uso del agente.</td></tr><tr><td>Ejecutar consultas</td><td>El agente utiliza MCP para consultar información de Fabric.</td></tr></tbody></table>

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:

{% stepper %}
{% step %}
#### Acceda a **Artefactos**
{% endstep %}

{% step %}
#### Seleccione **Conectores**
{% endstep %}

{% step %}
#### Haga clic en **Crear**
{% endstep %}
{% endstepper %}

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

<table><thead><tr><th width="312">Nombre</th><th>Propósito</th></tr></thead><tbody><tr><td>fabric-sales</td><td>Consultas relacionadas con ventas</td></tr><tr><td>fabric-finance</td><td>Consultas financieras</td></tr><tr><td>fabric-customers</td><td>Información de clientes</td></tr></tbody></table>

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

<table><thead><tr><th width="317">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td>Data Agent</td><td>Agente de datos creado en Microsoft Fabric</td></tr><tr><td>Ontology</td><td>Estructura de entidades y relaciones de Fabric</td></tr><tr><td>Power BI Semantic Model</td><td>Modelo semántico de Power BI</td></tr></tbody></table>

### 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-prod
```

### Mé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:

<table><thead><tr><th width="301">Campo</th><th>Descripción</th></tr></thead><tbody><tr><td>Tenant ID</td><td>Identificador del tenant de Microsoft Entra</td></tr><tr><td>Client ID</td><td>Identificador de la aplicación registrada</td></tr><tr><td>Client Secret</td><td>Secreto de la aplicación</td></tr></tbody></table>

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

{% stepper %}
{% step %}
#### Acceda a **Artefactos > Agentes**
{% endstep %}

{% step %}
#### Cree o edite un agente
{% endstep %}

{% step %}
#### Acceda a las relaciones del agente
{% endstep %}

{% step %}
#### Seleccione el **conector Fabric IQ**
{% endstep %}

{% step %}
#### Guarde los cambios
{% endstep %}
{% endstepper %}

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.

<table><thead><tr><th width="301">Toolbox</th><th>Recursos</th></tr></thead><tbody><tr><td>Análisis Comercial</td><td>Fabric IQ + Búsqueda en la Web + Skills</td></tr><tr><td>Atención al Cliente</td><td>SharePoint + Fabric IQ + APIs</td></tr></tbody></table>

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

<details>

<summary>El agente no utiliza Fabric IQ</summary>

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.

</details>

<details>

<summary>Error de permiso</summary>

Verifique:

* el acceso al workspace de Fabric;
* el estado de publicación del Data Agent;
* los permisos del Semantic Model;
* los permisos de Ontology.

</details>

<details>

<summary>El conector no puede acceder al elemento de Fabric</summary>

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.

</details>

{% hint style="info" %}
## ¿Necesita ayuda?

Si tiene dudas sobre la configuración del conector Fabric IQ, comuníquese con el Soporte de Power OMNI.
{% endhint %}