Cómo usar el conector de Power BI

El conector de Power BI de LLM Pulse te permite cargar tus datos de visibilidad en IA en Power BI Desktop. Úsalo para crear paneles de menciones, citaciones, visibilidad, sentimiento y comparativas con competidores.

Con el conector de Power BI puedes:

• Cargar tus métricas de visibilidad en IA en Power BI Desktop
• Crear y actualizar paneles de menciones, citaciones, visibilidad, sentimiento y competidores
• Escribir consultas personalizadas sobre tus datos de LLM Pulse
• Programar actualizaciones automáticas para mantener los informes al día

Este conector es actualmente un conector personalizado privado en beta. Esto significa que instalas un archivo de conector en Power BI Desktop en lugar de seleccionar LLM Pulse en la lista de conectores integrados de Microsoft.

Antes de empezar

Necesitas:

• Un plan Scale o superior. El conector se autentica con una clave de API, disponible en los planes Scale y Enterprise.
• Una clave de API de LLM Pulse. Abre el menú del perfil en la parte inferior izquierda de la aplicación, ve a Claves de API y crea una si todavía no tienes una. Las claves empiezan por llmpulse_.
• Power BI Desktop en Windows. La configuración del conector personalizado y la creación de informes se hacen en Power BI Desktop.
• El archivo de conector LLMPulse.mez. Descárgalo desde la página Integraciones de la aplicación (Utilidades > Integraciones > Power BI) o directamente desde el enlace de descarga del conector.

Instala el conector

1. Cierra Power BI Desktop.
2. Copia LLMPulse.mez en:

   Documents\Power BI Desktop\Custom Connectors

1. Abre Power BI Desktop.
2. Ve a File > Options and settings > Options > Security.
3. En Data Extensions, permite las extensiones personalizadas para las pruebas beta.
4. Reinicia Power BI Desktop.

Conecta tus datos

1. En Power BI Desktop, abre Get data.
2. Busca LLM Pulse.
3. Selecciona el conector y haz clic en Connect.
4. Pega tu clave de API de LLM Pulse.
5. Deja vacíos los campos opcionales para explorar tus proyectos.
6. Elige un proyecto.
7. Selecciona Timeseries - last 30 days o una de las tablas auxiliares.

Tablas disponibles

La beta actual incluye:

• Timeseries - last 30 days: métricas diarias por fecha y actor (tu proyecto o un competidor)
• Metrics: métricas resumidas, resumen de prompts, Share of Voice, fuentes principales, tráfico de crawlers de IA y tráfico de referencia de IA
• Dimensions: competidores, etiquetas/colecciones, prompts, ejecuciones de prompts, fuentes, menciones, citaciones, categorías de sentimiento, modelos, configuraciones regionales y catálogo de bots de IA
• Search Console: resumen, series temporales, consultas principales y páginas principales cuando tu proyecto tiene una propiedad conectada
• Citation intelligence: grupos de citaciones por URL, dominio o host
• AI Model Insights: resumen de modelos, distribución de posiciones y disponibilidad de resultados de AI Overview
• Content and Workflow: respuestas de IA, registros de sentimiento, recomendaciones y tareas de GEO Writer
• Webhooks: suscripciones activas a webhooks
• API Endpoint Catalog: tabla de referencia de todos los endpoints de la API REST disponibles para el conector

Métricas disponibles

La tabla de series temporales incluye:

Campo	Qué mide
mentions	Respuestas de IA que mencionan al actor
citations	Respuestas de IA que citan al actor
responses	Total de ejecuciones de prompts
visibility	Proporción de consultas en las que aparece el actor
aivisibilityscore	Puntuación de visibilidad ponderada por posición
avg_position	Posición media de citación
avgmentionposition	Posición media de la mención
citation_rate	Proporción de respuestas que citan al actor
sentimentverypositive	Proporción de sentimiento muy positivo
sentiment_positive	Proporción de sentimiento positivo
sentiment_neutral	Proporción de sentimiento neutro
sentiment_negative	Proporción de sentimiento negativo
sentimentverynegative	Proporción de sentimiento muy negativo
net_sentiment	Balance general del sentimiento

Rangos de fechas y filtros personalizados

Para usar un rango o un filtro personalizado, crea una consulta en blanco y llama directamente al conector:

let
    Source = LLMPulse.Contents(
        123,
        90,
        "week",
        "mentions,visibility,citation_rate,ai_visibility_score"
    )
in
    Source

Sustituye 123 por el ID de tu proyecto. El segundo valor es el número de días y el tercero es la granularidad: "day", "week" o "month".

Para endpoints que no aparecen en una tabla de navegación predeterminada, usa LLMPulse.Table(...):

let
    Source = LLMPulse.Table(
        "/metrics/top_sources",
        [project_id = 123, #"range" = 90, per_page = 100],
        "data"
    )
in
    Source

Los usuarios avanzados pueden llamar a endpoints GET y POST con LLMPulse.Api(...):

let
    Source = LLMPulse.Api(
        "/prompts",
        "POST",
        [],
        [project_id = 123, prompts = {"best CRM software"}]
    )
in
    Source

Información útil

• Los porcentajes usan una escala de 0 a 1 en Power BI. Un valor de visibilidad del 45 % aparece como 0.45, por lo que el formato de porcentaje de Power BI funciona correctamente.
• Las tablas de navegación paginadas cargan 100 filas por defecto. Usa LLMPulse.Table(...) con page y per_page para paginar más datos.
• Las operaciones DELETE no se ejecutan desde el conector de Power BI. Usa directamente la API REST para operaciones destructivas, como eliminar una suscripción a un webhook.
• El conector es una beta privada. Es posible que tengas que aprobar la carga de conectores personalizados en Power BI Desktop.
• La actualización programada necesita una puerta de enlace. Como todavía no es un conector integrado certificado, la actualización en Power BI Service requiere la puerta de enlace de datos local con el conector instalado.

Actualización programada

Para actualizar en Power BI Service:

1. Instala la puerta de enlace de datos local en un equipo Windows que permanezca conectado.
2. Copia LLMPulse.mez en una carpeta que pueda leer la cuenta de servicio de la puerta de enlace.
3. En la aplicación de la puerta de enlace, activa los conectores personalizados y elige esa carpeta.
4. En Power BI Service, activa los conectores personalizados para el clúster de la puerta de enlace.
5. Crea un origen de datos con el conector de LLM Pulse y tu clave de API.
6. Configura la actualización programada en el modelo semántico.

Solución de problemas

El conector no aparece

Confirma que el archivo está en Documents\Power BI Desktop\Custom Connectors, que las extensiones personalizadas están activadas y que has reiniciado Power BI Desktop.

La autenticación falla

Comprueba que tu clave de API empieza por llmpulse_, que no se ha revocado y que pertenece a una cuenta con un plan Scale o superior.

El gráfico está vacío

Prueba un rango más largo, cambia de granularidad diaria a semanal y elimina los filtros restrictivos.

La actualización programada falla

Confirma que el equipo de la puerta de enlace está conectado, que el archivo del conector está instalado en la carpeta de conectores personalizados de la puerta de enlace y que la clave de API está configurada en las credenciales de Power BI Service.