# Microsoft Fabric

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

### 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2F8JRCHU54JalNQarPSoSl%2Fimage.png?alt=media&#x26;token=5ac9a1bb-0054-432f-9710-ee1d729c0c7a" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FkWrn9KZpvzvLb87ooRto%2Fimage.png?alt=media&#x26;token=d03e36d3-60d0-454b-b08e-8c08329f8872" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2F3olj6jTeXleWZL5mBi8q%2Fimage.png?alt=media&#x26;token=6df12862-0f5a-4c81-8fa5-4a3d48a4f9e7" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FXSfHsA79trvY3Iev97hw%2Fimage.png?alt=media&#x26;token=c470270c-2255-422d-b973-d9ef8636b48d" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FDF5VUshEmXLTliadwbMB%2Fimage.png?alt=media&#x26;token=c6716710-c17f-4da4-9115-d8dd05760822" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2Fo9j6Kiliv4d4nD46a4tp%2Fimage.png?alt=media&#x26;token=09330bbf-bfe4-4d1c-9f5b-3bad58ff5e24" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FdgkI3eYbiUwDRh8v3GWs%2Fimage.png?alt=media&#x26;token=ce22e0f1-97ef-45e2-8e6d-05e2d3a872d2" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FWY9BoyDmH98ddEXVaZi9%2Fimage.png?alt=media&#x26;token=1c4306fd-736d-4da6-a636-b3b730331972" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FUNMbNdc7cp7DbYvNv0Ms%2Fimage.png?alt=media&#x26;token=a5f999f2-4fae-47cf-ad2a-69b19abf640a" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FjfI9cxGOBVwc5BGsx9Kp%2Fimage.png?alt=media&#x26;token=318c6166-171c-4027-8fa1-53eb623cafb3" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FUQgYBogvXKKwfTJDQWH2%2Fimage.png?alt=media&#x26;token=bb79c1ec-c30b-42a3-b309-8134599be1b9" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FbZ4vOcKxHpmPCPLHYIIf%2Fimage.png?alt=media&#x26;token=d2cc49d3-9f00-416c-ba43-140996f09ac0" alt=""></p>

2. Publicação:

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

   <figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FOWHlGHpyFivr0OyjU1g1%2Fimage.png?alt=media&#x26;token=1cec49d0-db5d-477b-8e54-f786bf6e2ed1" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FbrM8JyVD75yDSQJTSkiz%2Fimage.png?alt=media&#x26;token=2fd34f0f-d601-4f2f-b99e-1c784557a60a" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FeB1ATyOLeKCwIdNrJ3jv%2Fimage.png?alt=media&#x26;token=bade05b6-e3c9-4a3d-9814-91fd07161a91" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FL2FLzRZPdBBbY8BOrc7S%2Fimage.png?alt=media&#x26;token=d6288443-e99d-47b8-8f18-e91db4e76bf4" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2F96wtU8gI6SwZrCm0mhJ5%2Fimage.png?alt=media&#x26;token=a3ee48e8-4076-4ba4-a093-ec4923dd3f0f" 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". ![](https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2F1TyhtpDvYCb9SPcl9Nse%2Fimage.png?alt=media\&token=73548a9f-09c7-48f0-a065-b2303a73b024)
3. Preencha as informações:

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FCrPZ2Dh6oKrJTAHt3Wqb%2Fimage.png?alt=media&#x26;token=ac18afce-397f-4d3d-9ebf-e9848a948532" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FamjuaF151TcvHA81fYhk%2Fimage.png?alt=media&#x26;token=b4c6cfb5-9633-46a1-882b-b085581290ad" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FL4K5R6Uf9aetaU2nuaTO%2Fimage.png?alt=media&#x26;token=a18bb63d-47f3-4f61-8e04-811b99b61ecf" alt=""><figcaption></figcaption></figure> <figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FWCCF3DUQQmwcvtmlNRSn%2Fimage.png?alt=media&#x26;token=2b4d8cd3-e213-42ea-bc09-244833c03227" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FqjVHI9DiVDuV00lfjjvZ%2Fimage.png?alt=media&#x26;token=816634af-f5a9-4582-b704-a4ec4f5a374d" 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>](https://docs.poweromni.ai/suporte)<mark style="color:purple;">.</mark>