FabricIQ

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

IMPORTANTE

Antes de configurar o conector do FabricIQ, conclua as etapas da documentação Permissão Foundry User. Essa permissão é necessária para que os usuários possam utilizar o agente do FabricIQ pelo Power Omni.

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.

Atenção: Microsoft Fabric IQ está em preview.

Como funciona

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

Etapa	Descrição
Criar conector	Configura o acesso ao recurso do Microsoft Fabric IQ.
Selecionar item Fabric	Define qual recurso será utilizado: Data Agent, Semantic Model ou Ontology.
Vincular ao agente	Disponibiliza o conector para utilização pelo agente.
Realizar consultas	O agente utiliza MCP para consultar informações do Fabric.

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:

1

Acesse Artefatos

2

Selecione Conectores

3

Clique em Criar

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:

Nome	Objetivo
fabric-vendas	Consultas relacionadas a vendas
fabric-financeiro	Consultas financeiras
fabric-clientes	Informações de clientes

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.

Tipo	Descrição
Data Agent	Agente de dados criado no Microsoft Fabric
Ontology	Estrutura de entidades e relacionamentos do Fabric
Power BI Semantic Model	Modelo semântico do Power BI

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:

Campo	Descrição
Tenant ID	Identificador do tenant Microsoft Entra
Client ID	Identificador da aplicação registrada
Client Secret	Segredo da aplicação

Política de Aprovação

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

Opção	Descrição
Nunca (execução automática)	O agente executa chamadas automaticamente.
Sempre requer aprovação	O usuário precisa aprovar antes da execução.

Vincular o conector ao agente

Após criar o conector:

1

Acesse Artefatos > Agentes

2

Crie ou edite um agente

3

Acesse os relacionamentos do agente

4

Selecione o conector Fabric IQ

5

Salve as alterações

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.

Toolbox	Recursos
Análise Comercial	Fabric IQ + Busca Web + Skills
Atendimento	SharePoint + Fabric IQ + APIs

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

O agente não utiliza o Fabric IQ

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.

Erro de permissão

Verifique:

• acesso ao workspace do Fabric;

• publicação do Data Agent;

• permissões do modelo semântico;

• permissões da Ontology.

O conector não consegue acessar o item Fabric

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.

Precisa de ajuda?

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