Skip to main content
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 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.
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.

​
Pré-requisitos

​
Como conectar

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

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

Registre o aplicativo no Microsoft Entra ID

  1. Acesse 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.
3

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.
Cole o Valor do segredo no campo Client Secret. O ID do segredo não autentica.
4

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

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

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.

​
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

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.
O campo Client Secret recebeu o ID do segredo em vez do Valor. Crie um novo segredo e copie o Valor na hora.
A pessoa não é membro daquele workspace no Power BI. Peça ao administrador do BI para adicioná-la como Membro ou Visualizador.
Essa mensagem, sozinha, não indica que a conexão falhou. Confirme a permissão no workspace e tente a consulta de novo.
O conector não está ativado na sessão. Ative o Power BI no seletor de conectores da caixa de mensagem.
Faltou o consentimento do administrador no registro do aplicativo. Peça ao administrador do tenant para clicar em Conceder consentimento do administrador.
A mudança ainda está propagando. Espere 1–2 minutos e reconecte em Gerenciar conectores → Power BI → Reconectar.
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.