> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tess.im/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Power BI

> Conecte o Power BI à Tess para que agentes consultem datasets, relatórios e workspaces em linguagem natural.

O conector do **Microsoft Power BI** integra a Tess aos workspaces, datasets, relatórios e dashboards do Power BI. Depois de conectado, a IA consulta esses dados em linguagem natural dentro de chats e agentes.

O Power BI faz parte do ecossistema de [Connectors](/pt/connectors) da Tess. A autenticação é **OAuth** com um **registro de aplicativo no Microsoft Entra ID** da sua organização. O registro é feito uma vez. Cada pessoa usa o mesmo Client ID e Client Secret, e entra com a própria conta Microsoft.

<Info>
  **Como funciona o acesso.** O agente enxerga exatamente o que a pessoa conectada enxerga no Power BI. Quem não é membro de um workspace não lê o dataset dele pela Tess. A Tess não amplia permissões.
</Info>

## Pré-requisitos

| O que | Quem |
| - | - |
| Conta Microsoft 365 com licença Power BI (Pro ou superior) e acesso aos workspaces que o agente vai consultar | Quem vai conectar |
| Permissão para registrar um aplicativo no Microsoft Entra ID ([portal.azure.com](https://portal.azure.com)) | TI |
| Permissão para conceder consentimento de administrador às permissões da API do Power BI | Administrador do tenant Microsoft |

## Como conectar

<Warning>
  Este conector pede **consentimento de administrador** no Microsoft Entra ID. Sem esse consentimento, a tela de login da Microsoft pede uma aprovação que a pessoa não consegue dar sozinha.
</Warning>

<Steps>
  <Step title="Abra a tela do conector na Tess">
    1. No chat, clique no **+** no canto inferior esquerdo e escolha **Conectores**.
    2. Clique em **Adicionar conectores** (ou **Gerenciar conectores**, se já houver algum) e selecione **Microsoft Power BI**.
    3. A tela pede **Client ID** e **Client Secret** e mostra a **URI de redirecionamento** e a **lista de permissões** do aplicativo. Deixe essa tela aberta: você vai copiar a URI e conferir a lista no passo das permissões.
  </Step>

  <Step title="Registre o aplicativo no Microsoft Entra ID">
    1. Acesse [portal.azure.com](https://portal.azure.com) → **Microsoft Entra ID** → **Registros de aplicativo** → **Novo registro**.
    2. Dê um nome, por exemplo `Tess`.
    3. Em **Tipos de conta com suporte**, use contas somente neste diretório organizacional quando só pessoas da sua organização, inclusive convidados do tenant, forem conectar.
    4. Em **URI de redirecionamento**, escolha a plataforma **Web** e cole a URI exatamente como a tela do conector mostra. Se pular esta etapa, a conexão falha com `No reply address is registered for the application`. Dá para adicionar depois em **Autenticação** → **Adicionar uma plataforma** → **Web**.
    5. Clique em **Registrar**.
    6. Na **Visão geral** do aplicativo, copie o **ID do aplicativo (cliente)**. Esse é o **Client ID**.
  </Step>

  <Step title="Crie o segredo do cliente">
    1. No aplicativo, vá em **Certificados e segredos** → **Novo segredo do cliente**. Dê uma descrição e escolha a validade. Anote a data de expiração: quando o segredo vencer, crie outro e reconecte.
    2. Copie o campo **Valor** na hora. Ele só aparece no momento da criação. Ao sair da tela, sobra apenas o **ID do segredo**, que não é o segredo e não funciona na Tess.
    3. Se o valor se perdeu, crie um novo segredo. Não há como recuperar o anterior.

    <Warning>
      Cole o **Valor** do segredo no campo Client Secret. O **ID do segredo** não autentica.
    </Warning>
  </Step>

  <Step title="Conceda as permissões da API do Power BI">
    1. No aplicativo, vá em **Permissões de API** → **Adicionar uma permissão** → **Power BI Service** → **Permissões delegadas**.

    2. Marque as permissões que a tela do conector lista:

       * `Report.Read.All`
       * `Dataset.Read.All`
       * `Dashboard.Read.All`
       * `Workspace.Read.All`
       * `Content.Create`
       * `Dataflow.Read.All`
       * `offline_access`

    3. Clique em **Adicionar permissões**.

    4. Clique em **Conceder consentimento do administrador** para a sua organização e confirme.

    As permissões entram uma a uma pela busca. Não há campo para colar a lista inteira.
  </Step>

  <Step title="Conclua a conexão na Tess">
    1. Volte à tela do conector, cole o **Client ID** e o **Client Secret** (o Valor) e clique em **Continuar**.
    2. Entre com a sua conta Microsoft e aceite as permissões.
    3. A janela de retorno confirma a conexão. O Power BI aparece na lista **Conectados**, com indicador verde.

    Se você acabou de alterar o registro no Entra (URI, permissões ou consentimento), aguarde um ou dois minutos antes de tentar de novo. A mudança leva um tempo para propagar.
  </Step>

  <Step title="Teste">
    1. Abra uma nova sessão de chat e ative o conector **Power BI** no seletor de conectores da caixa de mensagem.
    2. Pergunte algo que você conseguiria responder abrindo o Power BI. Por exemplo: quais datasets existem nos seus workspaces.
    3. Na resposta, abra o bloco de ferramentas. O agente mostra as chamadas, como `Get groups`, `Get tables in group` e `DAX Query`. Se a chamada aparece e o dado volta, a conexão está pronta.
  </Step>
</Steps>

## Quem enxerga o quê

* **Cada pessoa conecta o próprio Power BI.** O registro do aplicativo é da organização. O login é individual. Quem não é membro de um workspace recebe que a conta não tem a permissão necessária, ou que parte dos workspaces recusou o acesso.
* Para liberar, o administrador do Power BI abre o workspace, vai em **Gerenciar acesso** e adiciona a pessoa como **Membro** ou **Visualizador**. Acesso a um relatório por link compartilhado não dá acesso ao workspace.
* Se um dataset continua sem responder mesmo com a pessoa como membro, o administrador do Power BI pode adicionar o aplicativo registrado como **Membro** do workspace. Isso não substitui o acesso da pessoa conectada.
* Uma pessoa de fora da organização entra como **convidado** do tenant, ou com uma conta no domínio da empresa. Compartilhar o login de um colaborador registra as consultas no nome de quem não as fez. Prefira convidado ou uma conta de serviço com dono definido.

## O que você pode fazer

* **Listar workspaces e datasets** que a conta conectada já consegue abrir
* **Consultar dados** de um dataset em linguagem natural
* **Ler relatórios e dashboards** visíveis para essa conta

## Exemplos de prompt

> 1. Quais datasets existem nos meus workspaces?
> 2. No dataset de vendas, quais produtos mais venderam esta semana?
> 3. Liste os relatórios do workspace comercial que eu consigo abrir.

## Resolução de problemas

<AccordionGroup>
  <Accordion title="No reply address is registered for the application" icon="circle-exclamation">
    O aplicativo não tem a URI de redirecionamento. Em **Autenticação** → **Adicionar uma plataforma** → **Web**, cole a URI que a tela do conector mostra.
  </Accordion>

  <Accordion title="Falha ao conectar logo depois de criar o segredo" icon="circle-exclamation">
    O campo Client Secret recebeu o **ID do segredo** em vez do **Valor**. Crie um novo segredo e copie o Valor na hora.
  </Accordion>

  <Accordion title="Conectou, mas o agente diz que não tem permissão no workspace" icon="user-shield">
    A pessoa não é membro daquele workspace no Power BI. Peça ao administrador do BI para adicioná-la como Membro ou Visualizador.
  </Accordion>

  <Accordion title="Nenhum workspace está em capacidade dedicada, Premium ou Fabric" icon="circle-question">
    Essa mensagem, sozinha, não indica que a conexão falhou. Confirme a permissão no workspace e tente a consulta de novo.
  </Accordion>

  <Accordion title="O conector aparece conectado, mas a resposta ignora o Power BI" icon="circle-question">
    O conector não está ativado na sessão. Ative o Power BI no seletor de conectores da caixa de mensagem.
  </Accordion>

  <Accordion title="A tela de login da Microsoft pede aprovação de administrador" icon="user-shield">
    Faltou o consentimento do administrador no registro do aplicativo. Peça ao administrador do tenant para clicar em **Conceder consentimento do administrador**.
  </Accordion>

  <Accordion title="Falha logo após alterar o registro no Entra" icon="circle-question">
    A mudança ainda está propagando. Espere 1–2 minutos e reconecte em **Gerenciar conectores** → **Power BI** → **Reconectar**.
  </Accordion>
</AccordionGroup>

<Note>
  A Tess age com as permissões da conta conectada. Ela não amplia acessos além do que essa conta já pode fazer no Power BI.

  Conectores envolvem acesso a sistemas externos. Conecte apenas contas adequadas ao uso e revise as permissões com cuidado.
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.