> 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/microsoft-fabric.md).

# Microsoft Fabric

{% hint style="warning" %}

#### **IMPORTANTE**

\
**Antes de configurar o conector Microsoft Fabric, 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 Fabric pelo Power Omni.**
{% endhint %}

### Pré-requisitos <a href="#prerequisites" id="prerequisites"></a>

* Uma capacidade paga do F2 ou superior do Fabric ou uma capacidade do Power BI Premium por capacidade (P1 ou superior) com o Microsoft Fabric habilitado
* As [Configurações de locatário do agente de dados do Fabric](https://docs.poweromni.ai/portal-de-administracao-e-configuracoes/artefatos/conectores/microsoft-fabric#habilitar-as-configuracoes-de-servicos-de-ia-copilot-e-azure-openai) estão habilitadas.
* O [Processamento entre áreas geográficas de IA](https://docs.poweromni.ai/portal-de-administracao-e-configuracoes/artefatos/conectores/microsoft-fabric#habilitar-as-configuracoes-de-servicos-de-ia-copilot-e-azure-openai) está habilitado.
* O [Armazenamento entre áreas geográficas de IA](https://docs.poweromni.ai/portal-de-administracao-e-configuracoes/artefatos/conectores/microsoft-fabric#habilitar-as-configuracoes-de-servicos-de-ia-copilot-e-azure-openai) está habilitado.
* Pelo menos um destes, com dados: um armazém, um lakehouse, um ou mais modelos semânticos do Power BI, um banco de dados KQL ou uma ontologia.
* Os [Modelos semânticos do Power BI pela opção de locatário dos pontos de extremidade XMLA](https://docs.poweromni.ai/portal-de-administracao-e-configuracoes/artefatos/conectores/microsoft-fabric#enable-integration-of-power-bi-semantic-models-via-xmla-endpoints) estão habilitados para as fontes de dados do modelo semântico do Power BI.
* Permissão Foundry user nos usuários que vão utilizar o agente. [**Permissão Foundry User**](https://docs.poweromni.ai/permissao-foundry-user)**.**

### Parte 1: Pré-requisitos de Permissão no Microsoft Fabric

Para que o recurso de Agente de Dados do Fabric funcione e possa ser consumido pelo Power Omni, um administrador deve habilitar as seguintes configurações do Microsoft Fabric.

> 1. **Entrar no Microsoft Fabric** com uma conta de administrador.
> 2. **Abra o portal de administração**:
>    * Selecione o ícone de engrenagem no canto superior direito.
>    * Selecione **Portal de Administração**.
> 3. **Navegar até as Configurações de Locatário**:
>    * No Portal de Administração, selecione **Configurações de Locatário** no painel de navegação à esquerda.

* ### Habilitar as Configurações de Serviços de IA (Copilot e Azure OpenAI)

Esta configuração é essencial para que os recursos de IA, incluindo o Agente de Dados, funcionem corretamente.

1. **Usuários podem usar o Copilot e outros recursos do Azure OpenAI**

<figure><img src="/files/fSZXI9TZbAehmsZ1Irgn" alt=""><figcaption></figcaption></figure>

2. **Os dados enviados ao OpenAI do Azure podem ser processados fora da sua região geográfica da capacidade, do limite de conformidade ou da instância de nuvem nacional**

<figure><img src="/files/pM6vMw74vjTAsaD59W3k" alt=""><figcaption></figcaption></figure>

3. **Dados enviados para o Azure OpenAI podem ser armazenados fora da região geográfica da capacidade, do limite de conformidade ou da instância de nuvem nacional**

<figure><img src="/files/dQ7k6O9zQTiXMwguVOUp" alt=""><figcaption></figcaption></figure>

* ### Habilitar as configurações de locatário do agente de dados do Fabric <a href="#enable-fabric-data-agent-tenant-settings" id="enable-fabric-data-agent-tenant-settings"></a>

Por padrão, este recurso está desativado no nível do *tenant* e deve ser ativado para permitir que os usuários criem e compartilhem itens de Agente de Dados do Fabric.

1. **Os usuários podem criar e compartilhar tipos de item do Agente de dados**

<figure><img src="/files/CpzoKCdZA24xbaVTwfv9" alt=""><figcaption></figcaption></figure>

* ### Habilitar a integração de modelos semânticos do Power BI por meio de pontos de extremidade XMLA <a href="#enable-integration-of-power-bi-semantic-models-via-xmla-endpoints" id="enable-integration-of-power-bi-semantic-models-via-xmla-endpoints"></a>

Se sua organização armazena dados em diferentes regiões geográficas, as configurações de processamento e armazenamento geográfico cruzado para IA devem estar habilitadas para garantir o acesso aos dados.

1. **Permitir pontos de extremidade XMLA e análise no Excel com modelos semânticos locais**

<figure><img src="/files/Nm1BYbTthiRcvl726kYQ" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %} <mark style="color:$danger;">Importante: Pode levar até uma hora para que as alterações entrem em vigor.</mark>
{% endhint %}

### Parte 2: Criação do Agente de Dados no Microsoft Fabric

O Agente de Dados do Fabric é o item que atua como um sistema de perguntas e respostas conversacionais para seus dados.

#### 2.1 Criando o Item

1. No seu Workspace do Fabric, clique em "+ Novo item" e procure por "Agente de Dados" (*Data Agent*).

<figure><img src="/files/UBxImwR1Z2sugdL69pxZ" alt=""><figcaption></figcaption></figure>

2. Dê um nome ao seu agente (Ex: "Agente de Vendas e Faturamento").

<figure><img src="/files/ZlyWG2WqWZForur0UGeJ" alt=""><figcaption></figcaption></figure>

#### 2.2 Configurando as Fontes de Dados

1. Adicionar Fontes: No Agente de Dados, selecione a opção para adicionar fontes de dados. Você pode adicionar até cinco fontes de dados no total, em qualquer combinação dos tipos suportados.

<figure><img src="/files/nYFyQ7EnFmRTe9mAs5TH" alt=""><figcaption></figcaption></figure>

2. Escolha: Selecione uma ou mais fontes, como um *Lakehouse* ou um *Modelo Semântico* do Power BI.

<figure><img src="/files/ZGma1mIOtwHsnadcWtcC" alt=""><figcaption></figcaption></figure>

3. Após adicionar as fontes, o Explorer no painel esquerdo é preenchido com as tabelas disponíveis.
   * Use as caixas de seleção para tornar as tabelas disponíveis para a IA.
   * Dica Essencial: Use nomes descritivos para tabelas e colunas (Ex: `DadosDeVendas` é melhor que `TabelaA`). Isso ajuda a IA a gerar consultas mais precisas.

<figure><img src="/files/IlTRE6jb8cBCzthxu2bj" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
&#x20;<mark style="color:purple;">Observação</mark>

<mark style="color:purple;">Você só precisa da permissão de Leitura para adicionar um modelo semântico do Power BI como uma fonte de dados. A permissão de gravação não é necessária porque o agente de dados do Fabric emite consultas somente leitura.</mark>
{% endhint %}

#### 2.3 Refinamento Comportamental do Agente

1. Fornecer Instruções:

<figure><img src="/files/eOUZ2m8RybxxtnbEWuN2" alt=""><figcaption></figcaption></figure>

* Selecione Instruções do Agente de Dados para abrir o painel de configuração.
* Você pode escrever até 15.000 caracteres de texto em inglês para guiar o comportamento da IA.
* Exemplos de Uso: Você pode especificar a fonte de dados exata a ser usada para determinados tipos de perguntas. Exemplos de opções de fonte de dados podem envolver a orientação da IA a ser usada

  * Modelos semânticos do Power BI para consultas financeiras
  * um lakehouse para dados de vendas
  * um banco de dados KQL para métricas operacionais

  Essas instruções garantem que a IA gere consultas apropriadas, seja SQL, DAX ou KQL, com base em suas diretrizes e no contexto das perguntas.
* Teste o desempenho do agente

<p align="center"> <img src="/files/vyYsE46CfLYQAvQ7ESAL" alt=""></p>

2. Publicação:

   * Após testar e validar o desempenho, selecione Publicar.

   <figure><img src="/files/KjrWdI2FhRmCMFcHjP6v" alt=""><figcaption></figcaption></figure>

   * A publicação cria uma versão publicada (para compartilhamento e consumo) e mantém uma versão de rascunho (para refinamento).

   <figure><img src="/files/jO81IS0eERrXwViLvCkc" alt=""><figcaption></figcaption></figure>

   * Descrição: Fornece contexto quando o agente aparece em outras experiências. A descrição é usada por outros sistemas orquestradores de IA (como o Power Omni) para invocar o agente corretamente.

   <figure><img src="/files/4rXPTTMidNMBjbDxaCTR" alt=""><figcaption></figcaption></figure>

* Após o agente de dados ser publicado, clique em Exibir detalhes da publicação

<figure><img src="/files/G2n9R6TFaXuOCSzhRczN" alt=""><figcaption></figcaption></figure>

* Irá aparecer a URL publicada, copie a URL ela será usada para fazermos a conexão dentro do Power Omni.

### Parte 3: Configuração do Conector no Power Omni

O Power Omni irá consumir o Agente de Dados do Fabric que você acabou de criar.

#### 3.1 Criação do Conector Fabric

<figure><img src="/files/t0YU921Pdmw4rZTPzvHT" alt=""><figcaption></figcaption></figure>

1. Acesse o Portal de Administração do Power Omni e navegue até Conectores.
2. Clique em "Adicionar Conector" e selecione o tipo "Conector Microsoft Fabric". ![](/files/tLzdpfVgVxxdBsJfFGnM)
3. Preencha as informações:

<figure><img src="/files/XgjwNxrIsDKxHzh8AsB4" alt=""><figcaption></figcaption></figure>

* Selecione o projeto.
* Nome do Conector: Nome interno para identificação (Ex: "Análise de Vendas").
* Descrição da Ferramenta: Descreva a função do conector para o Agente de IA (Ex: "Use esta ferramenta para consultar métricas de vendas, faturamento e estoque em tempo real.").

<figure><img src="/files/mV9AP4dOIzaChCikJ1Ee" alt=""><figcaption></figcaption></figure>

* Em configuração de conexão: Seleciona criar Nova conexão.
* Preencha um nome para a Conexão, pois caso queira utilizar posteriormente a mesma conexão em outro conector é só Importar Conexão Existente utilizando o nome dela.
* E cole a URL que foi copiada dentro do Fabric na opção de URL do Fabric Data Agent, onde ele irá identificar automáticamente o  Workspace ID e Artifact ID.
* Clique em "Salvar".

#### 3.2 Relacionamento do Conector ao Agente

O último passo é dar a permissão de uso do novo conector ao seu Agente de IA.

1. Acesse Artefatos > Agentes no Portal de Administração.

<div align="left"><figure><img src="/files/yVp4YD1cjhig2rx7uv01" alt=""><figcaption></figcaption></figure> <figure><img src="/files/0pTQ6y6wABVJw0HQwr1l" alt=""><figcaption></figcaption></figure></div>

2. Selecione o Agente de IA que fará perguntas ao Fabric.
3. Navegue até a aba Relacionamentos > *Conectores*.
4. Localize e adicione o Conector do Microsoft Fabric recém-criado.

<figure><img src="/files/bDbf01CF1YbPgXPHnMIt" alt=""><figcaption></figcaption></figure>

5. Clique em "Salvar".
6. Lembre-se também de dar permissão ao um usuário, grupo ou workspace para visualizar aquele agente!

#### ✅ Resultado Final

O Agente de IA está agora conectado ao seu ambiente de dados. Quando um usuário perguntar, por exemplo, "Qual foi o faturamento total no último trimestre?", o Agente irá:

1. Reconhecer a intenção (baseado na "Descrição da Ferramenta").
2. Chamar o Agente de Dados do Fabric.
3. O Agente do Fabric traduzirá a pergunta em SQL/DAX/KQL.
4. O Agente receberá os dados do Fabric e os formatará como uma resposta em linguagem natural para o usuário.

> <mark style="color:purple;">Qualquer duvida em relação ao procedimento de integração do Microsoft Fabric, entre em contato com o</mark> [<mark style="color:purple;">Suporte</mark>](/suporte.md)<mark style="color:purple;">.</mark>