Como utilizar o conector do Power BI

O conector do Power BI da LLM Pulse permite-lhe carregar os seus dados de visibilidade em IA para o Power BI Desktop. Utilize-o para criar dashboards de menções, citações, visibilidade, sentimento e comparações com concorrentes.

Com o conector do Power BI, pode:

• Carregar as suas métricas de visibilidade em IA para o Power BI Desktop
• Criar e atualizar dashboards de menções, citações, visibilidade, sentimento e concorrentes
• Escrever consultas personalizadas sobre os seus dados da LLM Pulse
• Agendar a atualização automática para que os relatórios se mantenham atualizados

Atualmente, este conector é um conector personalizado em beta privado. Isto significa que instala um ficheiro de conector no Power BI Desktop, em vez de selecionar a LLM Pulse na lista de conectores incorporados da Microsoft.

Antes de começar

Precisa de:

• Um plano Scale ou superior. O conector autentica-se com uma chave de API.
• Uma chave de API da LLM Pulse. Abra o menu de perfil no canto inferior esquerdo da aplicação, vá a Chaves de API e crie uma, caso ainda não o tenha feito. As chaves começam por llmpulse_.
• Power BI Desktop no Windows. A configuração do conector personalizado e a criação de relatórios são feitas no Power BI Desktop.
• O ficheiro de conector LLMPulse.mez. Transfira-o a partir da página Integrações na aplicação (Utilitários > Integrações > Power BI) ou diretamente através da ligação de transferência do conector.

Instalar o conector

1. Feche o Power BI Desktop.
2. Copie LLMPulse.mez para:

   [Documents]\Microsoft Power BI Desktop\Custom Connectors

1. Abra o Power BI Desktop.
2. Vá a File > Options and settings > Options > Security.
3. Em Data Extensions, selecione (Not Recommended) Allow any extension to load without validation or warning e, em seguida, OK.
4. Reinicie o Power BI Desktop.

Ligar os seus dados

1. No Power BI Desktop, abra Get data.
2. Procure LLM Pulse.
3. Selecione o conector e clique em Connect.
4. Cole a sua chave de API da LLM Pulse.
5. Deixe os campos opcionais em branco para explorar os seus projetos.
6. Escolha um projeto.
7. Escolha Timeseries - last 30 days ou uma das tabelas auxiliares.

Tabelas disponíveis

A versão beta atual inclui:

• Timeseries - last 30 days: métricas diárias por data e por entidade monitorizada (o seu projeto ou um concorrente)
• Metrics: métricas de resumo, resumo de Prompts, Share of Voice, principais fontes, tráfego de crawlers de IA e tráfego de referência de IA
• Dimensions: concorrentes, tags/coleções, Prompts, execuções de Prompts, fontes, menções, citações, categorias de sentimento, modelos, idiomas e catálogo de bots de IA
• Search Console: resumo, séries temporais, principais consultas e principais páginas quando o seu projeto tem uma propriedade associada
• Citation intelligence: grupos de citações por URL, domínio ou host
• AI Model Insights: resumo de modelos, distribuição de posições e disponibilidade de resultados de AI Overview
• Content and Workflow: respostas de IA, registos de sentimento, recomendações e tarefas do GEO Writer
• Webhooks: subscrições de webhooks ativas
• API Endpoint Catalog: uma tabela de referência para cada endpoint da API REST disponível para o conector

Métricas disponíveis

A tabela de séries temporais inclui:

Campo	O que mede
mentions	Respostas de IA que mencionam a entidade monitorizada
citations	Respostas de IA que citam a entidade monitorizada
responses	Total de execuções de Prompts
visibility	Proporção de consultas em que a entidade monitorizada aparece
aivisibilityscore	Pontuação de visibilidade ponderada pela posição
avg_position	Posição média de citação
avgmentionposition	Posição média de menção
citation_rate	Proporção de respostas que citam a entidade monitorizada
sentimentverypositive	Proporção de sentimento muito positivo
sentiment_positive	Proporção de sentimento positivo
sentiment_neutral	Proporção de sentimento neutro
sentiment_negative	Proporção de sentimento negativo
sentimentverynegative	Proporção de sentimento muito negativo
net_sentiment	Equilíbrio geral de sentimento

Intervalos de datas e filtros personalizados

Para um intervalo ou filtro personalizado, crie uma consulta em branco e chame o conector diretamente:

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

Substitua 123 pelo ID do seu projeto. O segundo valor é o número de dias e o terceiro valor é a granularidade: "day", "week" ou "month".

Para endpoints que não são expostos como tabela predefinida do navegador, utilize LLMPulse.Table(...):

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

Os utilizadores avançados podem chamar endpoints GET e POST com LLMPulse.Api(...):

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

Bom saber

• As percentagens usam uma escala de 0 a 1 no Power BI. Um valor de visibilidade de 45% aparece como 0.45, para que a formatação de percentagem do Power BI funcione corretamente.
• As tabelas de navegador paginadas carregam as primeiras 100 linhas por predefinição. Utilize LLMPulse.Table(...) com page e per_page para paginação mais profunda.
• As operações DELETE não são executadas a partir do conector do Power BI. Utilize a API REST diretamente para operações destrutivas, como eliminar uma subscrição de webhook.
• O conector está em beta privado. Poderá ser necessário autorizar o carregamento de conectores personalizados no Power BI Desktop.
• A atualização agendada precisa de um gateway. Como este ainda não é um conector incorporado certificado, a atualização do Power BI Service requer o gateway de dados no local com o conector instalado.

Atualização agendada

Para atualizar no Power BI Service:

1. Instale o gateway de dados no local numa máquina Windows que permaneça ligada.
2. Copie LLMPulse.mez para uma pasta que a conta de serviço do gateway possa ler.
3. Na aplicação do gateway, ative os conectores personalizados e escolha essa pasta.
4. No Power BI Service, ative os conectores personalizados para o cluster do gateway.
5. Crie uma origem de dados com o conector da LLM Pulse e a sua chave de API.
6. Configure a atualização agendada no modelo semântico.

Resolução de problemas

O conector não aparece
Confirme que o ficheiro está em [Documents]\Microsoft Power BI Desktop\Custom Connectors, que a opção de segurança Data Extensions indicada acima está selecionada e que o Power BI Desktop foi reiniciado.

A autenticação falha
Verifique se a sua chave de API começa por llmpulse_, se não foi revogada e se pertence a uma conta no plano Scale ou superior.

O gráfico está vazio
Experimente um intervalo mais longo, mude a granularidade de diária para semanal e remova os filtros restritivos.

A atualização agendada falha
Confirme que a máquina do gateway está online, que o ficheiro do conector está instalado na pasta de conectores personalizados do gateway e que a chave de API está definida nas credenciais do Power BI Service.