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

> Conecta Power BI a Tess para que los agentes consulten datasets, informes y workspaces en lenguaje natural.

El conector de **Microsoft Power BI** integra Tess con los workspaces, datasets, informes y paneles de Power BI. Una vez conectado, la IA consulta esos datos en lenguaje natural dentro de chats y agentes.

Power BI forma parte del ecosistema de [Connectors](/es/connectors) de Tess. La autenticación es **OAuth** con un **registro de aplicación en el Microsoft Entra ID** de tu organización. El registro se hace una vez. Cada persona usa el mismo Client ID y Client Secret, y entra con su propia cuenta de Microsoft.

<Info>
  **Cómo funciona el acceso.** El agente ve exactamente lo que ve la persona conectada en Power BI. Quien no es miembro de un workspace no lee el dataset de ese workspace a través de Tess. Tess no amplía permisos.
</Info>

## Requisitos previos

| Qué | Quién |
| - | - |
| Cuenta de Microsoft 365 con licencia de Power BI (Pro o superior) y acceso a los workspaces que el agente va a consultar | Quien va a conectar |
| Permiso para registrar una aplicación en Microsoft Entra ID ([portal.azure.com](https://portal.azure.com)) | TI |
| Permiso para conceder el consentimiento de administrador a los permisos de la API de Power BI | Administrador del tenant de Microsoft |

## Cómo conectar

<Warning>
  Este conector pide **consentimiento de administrador** en Microsoft Entra ID. Sin ese consentimiento, la pantalla de inicio de sesión de Microsoft pide una aprobación que la persona no puede dar sola.
</Warning>

<Steps>
  <Step title="Abre la pantalla del conector en Tess">
    1. En el chat, haz clic en **+** en la esquina inferior izquierda y elige **Conectores**.
    2. Haz clic en **Agregar conectores** (o **Administrar conectores**, si ya hay alguno) y selecciona **Microsoft Power BI**.
    3. La pantalla pide **Client ID** y **Client Secret**, y muestra la **URI de redirección** y la **lista de permisos** de la aplicación. Déjala abierta: vas a copiar la URI y revisar la lista en el paso de permisos.
  </Step>

  <Step title="Registra la aplicación en Microsoft Entra ID">
    1. Entra en [portal.azure.com](https://portal.azure.com) → **Microsoft Entra ID** → **Registros de aplicaciones** → **Nuevo registro**.
    2. Ponle un nombre, por ejemplo `Tess`.
    3. En **Tipos de cuenta compatibles**, usa cuentas solo en este directorio organizativo cuando vayan a conectar únicamente personas de tu organización, incluidos los invitados del tenant.
    4. En **URI de redirección**, elige la plataforma **Web** y pega la URI exactamente como la muestra la pantalla del conector. Si omites este paso, la conexión falla con `No reply address is registered for the application`. Se puede añadir después en **Autenticación** → **Agregar una plataforma** → **Web**.
    5. Haz clic en **Registrar**.
    6. En la **Información general** de la aplicación, copia el **Id. de aplicación (cliente)**. Ese es el **Client ID**.
  </Step>

  <Step title="Crea el secreto de cliente">
    1. En la aplicación, ve a **Certificados y secretos** → **Nuevo secreto de cliente**. Añade una descripción y elige la validez. Anota la fecha de caducidad: cuando el secreto venza, crea otro y vuelve a conectar.
    2. Copia el campo **Valor** en el momento. Solo aparece al crearlo. Al salir de la pantalla queda únicamente el **Id. del secreto**, que no es el secreto y no funciona en Tess.
    3. Si se perdió el valor, crea un secreto nuevo. No se puede recuperar el anterior.

    <Warning>
      Pega el **Valor** del secreto en Client Secret. El **Id. del secreto** no autentica.
    </Warning>
  </Step>

  <Step title="Concede los permisos de la API de Power BI">
    1. En la aplicación, ve a **Permisos de API** → **Agregar un permiso** → **Power BI Service** → **Permisos delegados**.

    2. Marca los permisos que lista la pantalla del conector:

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

    3. Haz clic en **Agregar permisos**.

    4. Haz clic en **Conceder consentimiento de administrador** para tu organización y confirma.

    Los permisos se añaden uno a uno por la búsqueda. No hay un campo para pegar la lista entera.
  </Step>

  <Step title="Completa la conexión en Tess">
    1. Vuelve a la pantalla del conector, pega el **Client ID** y el **Client Secret** (el Valor) y haz clic en **Continuar**.
    2. Entra con tu cuenta de Microsoft y acepta los permisos.
    3. La ventana de retorno confirma la conexión. Power BI aparece en la lista **Conectados**, con el indicador verde.

    Si acabas de cambiar el registro en Entra (URI, permisos o consentimiento), espera uno o dos minutos antes de intentarlo de nuevo. El cambio tarda en propagarse.
  </Step>

  <Step title="Prueba">
    1. Abre una nueva sesión de chat y activa el conector **Power BI** en el selector de conectores del cuadro de mensaje.
    2. Pregunta algo que podrías responder abriendo Power BI. Por ejemplo: qué datasets hay en tus workspaces.
    3. En la respuesta, abre el bloque de herramientas. El agente muestra las llamadas, como `Get groups`, `Get tables in group` y `DAX Query`. Si la llamada aparece y el dato vuelve, la conexión está lista.
  </Step>
</Steps>

## Quién ve qué

* **Cada persona conecta su propio Power BI.** El registro de la aplicación es de la organización. El inicio de sesión es individual. Quien no es miembro de un workspace recibe que la cuenta no tiene el permiso necesario, o que parte de los workspaces rechazó el acceso.
* Para dar acceso, el administrador de Power BI abre el workspace, va a **Administrar acceso** y añade a la persona como **Miembro** o **Lector**. El acceso a un informe por enlace compartido no da acceso al workspace.
* Si un dataset sigue sin responder aunque la persona sea miembro, el administrador de Power BI puede añadir la aplicación registrada como **Miembro** del workspace. Eso no sustituye el acceso de la persona conectada.
* Una persona de fuera de la organización entra como **invitado** del tenant, o con una cuenta en el dominio de la empresa. Compartir el inicio de sesión de un compañero registra las consultas a nombre de quien no las hizo. Prefiere un invitado o una cuenta de servicio con un responsable definido.

## Qué puedes hacer

* **Listar workspaces y datasets** que la cuenta conectada ya puede abrir
* **Consultar datos** de un dataset en lenguaje natural
* **Leer informes y paneles** visibles para esa cuenta

## Ejemplos de prompt

> 1. ¿Qué datasets hay en mis workspaces?
> 2. En el dataset de ventas, ¿qué productos se vendieron más esta semana?
> 3. Lista los informes del workspace comercial que puedo abrir.

## Solución de problemas

<AccordionGroup>
  <Accordion title="No reply address is registered for the application" icon="circle-exclamation">
    La aplicación no tiene la URI de redirección. En **Autenticación** → **Agregar una plataforma** → **Web**, pega la URI que muestra la pantalla del conector.
  </Accordion>

  <Accordion title="Fallo al conectar justo después de crear el secreto" icon="circle-exclamation">
    El campo Client Secret recibió el **Id. del secreto** en lugar del **Valor**. Crea un secreto nuevo y copia el Valor en el momento.
  </Accordion>

  <Accordion title="Conectó, pero el agente dice que no tiene permiso en el workspace" icon="user-shield">
    La persona no es miembro de ese workspace en Power BI. Pide al administrador de BI que la añada como Miembro o Lector.
  </Accordion>

  <Accordion title="Ningún workspace está en capacidad dedicada, Premium o Fabric" icon="circle-question">
    Este mensaje, por sí solo, no indica que la conexión haya fallado. Confirma el permiso en el workspace e intenta la consulta de nuevo.
  </Accordion>

  <Accordion title="El conector aparece conectado, pero la respuesta ignora Power BI" icon="circle-question">
    El conector no está activado en la sesión. Activa Power BI en el selector de conectores del cuadro de mensaje.
  </Accordion>

  <Accordion title="La pantalla de inicio de sesión de Microsoft pide aprobación de administrador" icon="user-shield">
    Falta el consentimiento de administrador en el registro de la aplicación. Pide al administrador del tenant que haga clic en **Conceder consentimiento de administrador**.
  </Accordion>

  <Accordion title="Fallo justo después de cambiar el registro en Entra" icon="circle-question">
    El cambio aún se está propagando. Espera 1–2 minutos y vuelve a conectar en **Administrar conectores** → **Power BI** → **Reconectar**.
  </Accordion>
</AccordionGroup>

<Note>
  Tess actúa con los permisos de la cuenta conectada. No amplía el acceso más allá de lo que esa cuenta ya puede hacer en Power BI.

  Los conectores implican acceso a sistemas externos. Conecta solo cuentas adecuadas al uso y revisa los permisos con atención.
</Note>


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