> 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/administracao-e-configuracao/artefatos/conectores/fabriciq.md).

# FabricIQ

O conector Fabric IQ permite que agentes do Power OMNI utilizem recursos do Microsoft Fabric por meio do protocolo MCP (Model Context Protocol).

{% hint style="info" %}

### **IMPORTANTE**

**Antes de configurar o conector do FabricIQ, conclua as etapas da documentação** [**Permissão Foundry User**](https://docs.poweromni.ai/permissao-foundry-user)**. Essa permissão é necessária para que os usuários possam utilizar o agente do FabricIQ pelo Power Omni.**
{% endhint %}

Com esse conector, os agentes podem consultar informações corporativas utilizando linguagem natural através de recursos disponibilizados pelo **Microsoft Fabric IQ**, incluindo:

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

O conector cria uma ponte entre o agente do Power OMNI e os recursos do Fabric, permitindo que o modelo utilize dados estruturados para responder perguntas, gerar análises e auxiliar usuários em processos de tomada de decisão.

{% hint style="warning" %}
**Atenção: Microsoft Fabric IQ está em preview.** 
{% endhint %}

## Como funciona

O fluxo de utilização do Fabric IQ no Power OMNI:

<table><thead><tr><th width="229">Etapa</th><th>Descrição</th></tr></thead><tbody><tr><td>Criar conector</td><td>Configura o acesso ao recurso do Microsoft Fabric IQ.</td></tr><tr><td>Selecionar item Fabric</td><td>Define qual recurso será utilizado: Data Agent, Semantic Model ou Ontology.</td></tr><tr><td>Vincular ao agente</td><td>Disponibiliza o conector para utilização pelo agente.</td></tr><tr><td>Realizar consultas</td><td>O agente utiliza MCP para consultar informações do Fabric.</td></tr></tbody></table>

O conector pode ser utilizado diretamente pelo agente.

A utilização de uma **Toolbox é opcional** e pode ser adotada apenas quando houver necessidade de organizar diversos recursos, como conectores, ferramentas e Skills.

### Acessar o menu Conectores

No Portal de Administração do Power OMNI:

{% stepper %}
{% step %}

#### Acesse Artefatos

{% endstep %}

{% step %}

#### Selecione Conectores

{% endstep %}

{% step %}

#### Clique em Criar

{% endstep %}
{% endstepper %}

### Criar um conector Fabric IQ

### Tipo de Conector

Selecione: **Conector de Fabric IQ**

Após selecionar essa opção, serão exibidas as configurações específicas do Microsoft Fabric.

#### Selecione o projeto.

#### Informe um nome para identificar o conector.

Recomendações:

<table><thead><tr><th width="243">Nome</th><th>Objetivo</th></tr></thead><tbody><tr><td>fabric-vendas</td><td>Consultas relacionadas a vendas</td></tr><tr><td>fabric-financeiro</td><td>Consultas financeiras</td></tr><tr><td>fabric-clientes</td><td>Informações de clientes</td></tr></tbody></table>

#### Descrição

A descrição informa ao agente quando esse conector deve ser utilizado.

Uma descrição clara melhora a identificação do momento correto para utilizar a ferramenta.

Exemplo:

> Consulta informações de vendas, faturamento e clientes disponíveis no Microsoft Fabric.

Evite descrições genéricas:

> Conector Fabric

### Tipo de item Fabric

O Fabric IQ permite conectar diferentes tipos de recursos.

<table><thead><tr><th width="287">Tipo</th><th width="532">Descrição</th></tr></thead><tbody><tr><td>Data Agent</td><td>Agente de dados criado no Microsoft Fabric</td></tr><tr><td>Ontology</td><td>Estrutura de entidades e relacionamentos do Fabric</td></tr><tr><td>Power BI Semantic Model</td><td>Modelo semântico do Power BI</td></tr></tbody></table>

### Configuração de conexão

Ao configurar a conexão, existem duas opções:

#### Importar conexão existente

Utiliza uma conexão criada anteriormente no projeto.

Indicado quando vários conectores precisam compartilhar a mesma configuração.

#### Criar nova conexão

Cria uma nova configuração de autenticação.

#### Nome da conexão

Exemplo:

```
fabric-vendas-prod
```

### Métodos de autenticação

#### Token do Entra ID do usuário

Utiliza o token do usuário autenticado no Power OMNI.

Esse método permite respeitar controles de acesso existentes no Fabric.

#### OAuth2 (App Entra próprio)

Permite autenticação utilizando um aplicativo registrado no Microsoft Entra.

No Power OMNI, essa opção está em **implementação**.

Quando disponível, será necessário configurar:

<table><thead><tr><th width="264">Campo</th><th>Descrição</th></tr></thead><tbody><tr><td>Tenant ID</td><td>Identificador do tenant Microsoft Entra</td></tr><tr><td>Client ID</td><td>Identificador da aplicação registrada</td></tr><tr><td>Client Secret</td><td>Segredo da aplicação</td></tr></tbody></table>

### Política de Aprovação

Define se uma execução utilizando o conector precisa de aprovação.

<table><thead><tr><th width="330">Opção</th><th>Descrição</th></tr></thead><tbody><tr><td>Nunca (execução automática)</td><td>O agente executa chamadas automaticamente.</td></tr><tr><td>Sempre requer aprovação</td><td>O usuário precisa aprovar antes da execução.</td></tr></tbody></table>

### Vincular o conector ao agente

Após criar o conector:

{% stepper %}
{% step %}

#### Acesse Artefatos > Agentes

{% endstep %}

{% step %}

#### Crie ou edite um agente

{% endstep %}

{% step %}

#### Acesse os relacionamentos do agente

{% endstep %}

{% step %}

#### Selecione o conector Fabric IQ

{% endstep %}

{% step %}

#### Salve as alterações

{% endstep %}
{% endstepper %}

O agente poderá utilizar o Fabric IQ quando identificar que a solicitação depende das informações disponibilizadas pelo conector.

### Uso opcional com Toolbox

O Fabric IQ não depende de uma Toolbox para funcionar.

A Toolbox pode ser utilizada quando existir necessidade de organizar diferentes recursos em um único agrupamento.

<table><thead><tr><th width="292">Toolbox</th><th>Recursos</th></tr></thead><tbody><tr><td>Análise Comercial</td><td>Fabric IQ + Busca Web + Skills</td></tr><tr><td>Atendimento</td><td>SharePoint + Fabric IQ + APIs</td></tr></tbody></table>

### Limitações atuais

* Microsoft Fabric IQ está em preview.
* A autenticação OAuth2 utilizando aplicativo próprio do Entra está em implementação no Power OMNI.
* Recursos e comportamentos podem sofrer alterações durante o período de preview.

### Solução de problemas

<details>

<summary>O agente não utiliza o Fabric IQ</summary>

Verifique:

* o conector foi vinculado ao agente;
* as alterações foram salvas;
* a pergunta possui relação com o recurso Fabric configurado;
* o usuário possui permissão no Fabric.

</details>

<details>

<summary>Erro de permissão</summary>

Verifique:

* acesso ao workspace do Fabric;
* publicação do Data Agent;
* permissões do modelo semântico;
* permissões da Ontology.

</details>

<details>

<summary>O conector não consegue acessar o item Fabric</summary>

Confirme:

* se o workspace está correto;
* se o item Fabric existe;
* se a conexão foi configurada corretamente;
* se o usuário possui acesso ao recurso.

</details>

{% hint style="info" %}

### Precisa de ajuda?

Se tiver dúvidas para configurar o conector Fabric IQ, procure o suporte do Power OMNI.
{% endhint %}