> For the complete documentation index, see [llms.txt](https://docs.poweromni.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.poweromni.ai/en/administration-and-configuration/artifacts/connectors/fabriciq.md).

# FabricIQ

The Fabric IQ connector allows Power OMNI agents to use Microsoft Fabric resources through the MCP (Model Context Protocol).

{% hint style="warning" %}
**Before configuring the Fabric IQ connector, complete the steps described in the** [**Foundry User Permission documentation.**](https://docs.poweromni.ai/en/foundry-user-permission) **This permission is required so users can use the Fabric IQ agent through Power OMNI.**
{% endhint %}

With this connector, agents can query business information using natural language through resources provided by **Microsoft Fabric IQ**, including:

* **Data Agent**
* **Power BI Semantic Model**
* **Ontology**

The connector creates a bridge between the Power OMNI agent and Fabric resources, allowing the model to use structured data to answer questions, generate analysis, and support users in decision-making processes.

{% hint style="warning" %}
Microsoft Fabric IQ is currently in preview.
{% endhint %}

## How it works

The Fabric IQ usage flow in Power OMNI:

<table><thead><tr><th width="304">Step</th><th>Description</th></tr></thead><tbody><tr><td>Create connector</td><td>Configures access to the Microsoft Fabric IQ resource.</td></tr><tr><td>Select Fabric item</td><td>Defines which resource will be used: Data Agent, Semantic Model, or Ontology.</td></tr><tr><td>Connect to agent</td><td>Makes the connector available for agent usage.</td></tr><tr><td>Run queries</td><td>The agent uses MCP to query information from Fabric.</td></tr></tbody></table>

The connector can be used directly by the agent.

Using a **Toolbox is optional** and can be adopted only when there is a need to organize multiple resources, such as connectors, tools, and Skills.

### Accessing the Connectors menu

In the Power OMNI Administration Portal:

{% stepper %}
{% step %}

#### Access **Artifacts**

{% endstep %}

{% step %}

#### Select **Connectors**

{% endstep %}

{% step %}

#### Click **Create**

{% endstep %}
{% endstepper %}

### Creating a Fabric IQ Connector

#### Connector Type

Select **Fabric IQ Connector**.

After selecting this option, the specific Microsoft Fabric configuration fields will be displayed.

#### Project

Select the Microsoft Foundry project where the connector will be created.

#### Name

Enter a name to identify the connector.

<table><thead><tr><th width="312">Name</th><th>Purpose</th></tr></thead><tbody><tr><td>fabric-sales</td><td>Sales-related queries</td></tr><tr><td>fabric-finance</td><td>Financial queries</td></tr><tr><td>fabric-customers</td><td>Customer information</td></tr></tbody></table>

#### Description

The description informs the agent when this connector should be used.

A clear description improves the identification of the correct moment to use the tool.

Example:

> Queries sales, revenue, and customer information available in Microsoft Fabric.

Avoid generic descriptions:

> Fabric Connector

### Fabric Item Type

Fabric IQ allows connecting different types of resources.

<table><thead><tr><th width="317">Type</th><th>Description</th></tr></thead><tbody><tr><td>Data Agent</td><td>Data agent created in Microsoft Fabric</td></tr><tr><td>Ontology</td><td>Fabric entities and relationship structure</td></tr><tr><td>Power BI Semantic Model</td><td>Power BI semantic model</td></tr></tbody></table>

### Connection Configuration

When configuring the connection, there are two options:

#### Import Existing Connection

Uses a connection previously created in the project.

Recommended when multiple connectors need to share the same configuration.

#### Create New Connection

Creates a new authentication configuration.

Example:

```
fabric-sales-prod
```

### Authentication Methods

#### User Entra ID Token

Uses the authenticated user's token from Power OMNI.

This method respects existing access controls configured in Fabric.

#### OAuth2 (Custom Entra App)

Allows authentication using an application registered in Microsoft Entra.

This option is currently under implementation in Power OMNI.

When available, the following fields will be required:

<table><thead><tr><th width="301">Field</th><th>Description</th></tr></thead><tbody><tr><td>Tenant ID</td><td>Microsoft Entra tenant identifier</td></tr><tr><td>Client ID</td><td>Registered application identifier</td></tr><tr><td>Client Secret</td><td>Application secret</td></tr></tbody></table>

### Approval Policy

Defines whether an execution using the connector requires approval.

#### Never (automatic execution)

The agent executes calls automatically.

#### Always require approval

The user must approve before execution.

### Connect the Connector to the Agent

After creating the connector:

{% stepper %}
{% step %}

#### Access **Artifacts > Agents**

{% endstep %}

{% step %}

#### Create or edit an agent

{% endstep %}

{% step %}

#### Access the agent relationships

{% endstep %}

{% step %}

#### Select the **Fabric IQ connector**

{% endstep %}

{% step %}

#### Save the changes

{% endstep %}
{% endstepper %}

The agent can use Fabric IQ whenever it identifies that the request depends on information provided by the connector.

### Optional Toolbox Usage

Fabric IQ does not require a Toolbox to work.

A Toolbox can be used when there is a need to organize different resources into a single group.

<table><thead><tr><th width="301">Toolbox</th><th>Resources</th></tr></thead><tbody><tr><td>Commercial Analysis</td><td>Fabric IQ + Web Search + Skills</td></tr><tr><td>Customer Service</td><td>SharePoint + Fabric IQ + APIs</td></tr></tbody></table>

### Current Limitations

* Microsoft Fabric IQ is currently in preview.
* OAuth2 authentication using a custom Entra application is under implementation in Power OMNI.
* Features and behaviors may change during the preview period.

### Troubleshooting

<details>

<summary>The agent does not use Fabric IQ</summary>

Check:

* the connector was linked to the agent;
* the changes were saved;
* the question is related to the configured Fabric resource;
* the user has permission in Fabric.

</details>

<details>

<summary>Permission Error</summary>

Check:

* access to the Fabric workspace;
* Data Agent publication status;
* Semantic Model permissions;
* Ontology permissions.

</details>

<details>

<summary>The connector cannot access the Fabric item</summary>

Confirm:

* the workspace is correct;
* the Fabric item exists;
* the connection was configured correctly;
* the user has access to the resource.

</details>

{% hint style="info" %}

## Need Help?

If you have questions about configuring the Fabric IQ connector, contact Power OMNI Support.
{% endhint %}