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, disponível a partir do plano Scale.
• 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. Esta opção permite carregar conectores personalizados sem validação nem avisos. Os conectores personalizados podem ignorar níveis de privacidade, gerir credenciais e enviá-las através de HTTP. Ative-a apenas se confiar plenamente no conector. Um conector assinado de confiança pode ser carregado sem esta opção quando estiver disponível uma versão assinada.
5. 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. Para carregar um conector não certificado, o Power BI Desktop pode exigir a opção permissiva de Data Extensions indicada acima. Ative-a apenas se confiar no conector.
• 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.