Como escrever bons pedidos para a IA do HubCount

Esta página reúne pedidos prontos para o assistente de IA do HubCount BI Studio e explica o que colocar neles para a resposta sair certa. Os exemplos usam o projeto Resultado Comercial 2026, da Contabilidade Exemplo e vinculado à Aurora Comércio Ltda, com o cubo Vendas (campos data, unidade, receita, custo, meta e o calculado lucro_bruto) e o dashboard Visão executiva.

Sugestões da tela inicial

Com a conversa vazia, o assistente mostra Como posso ajudar neste projeto? e quatro sugestões. Clicar numa sugestão envia o pedido no modo que estiver escolhido, então troque o modo antes se precisar.

Sugestão	Melhor modo	Observação
Crie um dashboard de vendas completo	Planejamento	É um pedido grande. O plano deixa você revisar antes de criar.
Explique os cubos deste projeto	Pergunta	Só lê o projeto.
Monte uma análise por região	Agente	Só funciona se o cubo tiver um campo de região (ou outra categoria parecida).
Sugira gráficos para acompanhar o desempenho	Pergunta	Boa para descobrir ideias antes de pedir a criação.

O que incluir no pedido

O assistente trabalha com os objetos do projeto: cubo, campos, medidas, gráficos e dashboards. Quanto mais o pedido fala a língua desses objetos, melhor.

Inclua	Por quê	Exemplo
O cubo, a medida ou o dashboard pelo nome	O assistente reaproveita o que existe. O nome exato evita criar uma cópia.	“Use a medida Receita do cubo Vendas.”
O número que você quer ver	Define a medida e o cálculo (soma, média, contagem, máximo, mínimo).	“Soma da receita”, “média do ticket”.
Como abrir o número	“Por unidade” ou “por vendedor” vira um campo de agrupamento na medida e o drilldown no gráfico.	“Receita por unidade, com drilldown.”
O tipo de gráfico	Sem tipo, ele escolhe. Tipos: colunas, colunas empilhadas, linhas, linhas empilhadas, área, cartão, pizza, rosca, funil, barras horizontais, tabela e tabela de dados.	“Em colunas empilhadas.”
Onde colocar	Dashboard, aba e visão. Dá para pedir também uma pasta para o gráfico na lista de gráficos.	“No dashboard Visão executiva, na aba Detalhes.”
O formato do valor	Moeda, número, número sem decimais, percentual ou horas.	“Mostre em percentual.”
Uma restrição fixa, se for o caso	Vira um filtro dentro da medida.	“Uma medida só com a unidade Varejo.”

Exemplos por tarefa

Tarefa	Modo	Pedido
Dashboard completo	Planejamento	“Monte um dashboard de metas por unidade, com o realizado contra a meta, a receita por mês e o ranking das unidades.”
Entender o projeto	Pergunta	“Explique o que cada cubo deste projeto guarda e quais medidas existem.”
Conferir um número	Pergunta	“Mostre o total da medida Receita e diga quais campos ela usa.”
Campo calculado	Agente	“No cubo Vendas, crie o campo calculado Resultado sobre a meta: receita menos meta.”
Medida	Agente	“Crie uma medida de custo médio por mês: média do campo custo, pela data, aberta por unidade.”
Medida com filtro	Agente	“Crie uma medida Receita do Varejo: soma da receita só da unidade Varejo.”
Gráfico simples	Agente	“Crie um gráfico de colunas com a receita por mês, com drilldown por unidade.”
Conta entre medidas	Agente	“Crie um gráfico de linha com a margem bruta por mês: lucro bruto dividido pela receita, em percentual.”
Cartão	Agente	“Crie um cartão com o lucro bruto do período.”
Tabela dinâmica	Agente	“Crie uma tabela dinâmica com as unidades nas linhas, os meses nas colunas e a soma da receita nos valores.”
Filtro	Agente	“Crie um filtro de gráfico por unidade, de seleção múltipla, e coloque no topo do dashboard Visão executiva.”
Organizar o dashboard	Agente	“No dashboard Visão executiva, crie a aba Detalhes e coloque nela a tabela dinâmica, com um título de seção Resultado por unidade.”
Texto no dashboard	Agente	“Adicione no topo da aba Resumo um texto explicando que os valores estão em reais.”
Organizar os gráficos	Agente	“Coloque os gráficos de receita numa pasta chamada Receita.”
Banco de dados	Pergunta	“Na conexão ERP, liste as tabelas de pedidos e mostre uma amostra das colunas.”
Consulta SQL	Agente	“Atualize a consulta do cubo Pedidos para trazer o total por cliente e por mês em 2026.”
Reproduzir um rascunho	Agente	Anexe a imagem e escreva: “Monte um dashboard parecido com este rascunho, usando os dados do cubo Vendas.”

Para gráficos que mostram um número por categoria, como receita por unidade, o assistente cria a medida com campo de agrupamento e liga o drilldown no gráfico. Se o seu pedido diz só “receita”, ele cria a medida sem agrupamento.

Boas práticas

• Um objetivo por pedido. “Crie o gráfico de receita por mês” funciona melhor que cinco tarefas numa frase só. Para pedidos grandes, use o modo Planejamento.
• Olhe antes de criar. No modo Pergunta, pergunte que gráficos fazem sentido para os seus dados. Depois peça para criar no modo Agente.
• Cite os campos pelo nome que você vê. O assistente enxerga os campos mapeados, os não mapeados e os calculados. Se um campo não está marcado no cubo, peça para ele mapear antes.
• Corrija em seguida. Se o resultado veio diferente, diga o que mudar na mesma conversa: “troque para linha” ou “use o custo, não a meta”.
• Peça o resumo. No fim, pergunte “o que você criou e o que ficou de fora?”. O assistente informa o que criou, atualizou, validou ou não executou.
• Confira os números. Abra as medidas criadas e veja o tipo de cálculo, o campo de valor e o campo de data. Veja Medidas.
• Recomece quando precisar. Para um assunto novo, abra uma conversa nova (Nova conversa). Ela começa sem o histórico da anterior e conta 1 no limite mensal de conversas do escritório (veja Limite mensal de conversas). Por isso, para ajustes pequenos, continue na mesma conversa.

O que o assistente não faz

• Criar conexões com bancos, arquivos ou APIs. Cadastre a conexão antes e informe o nome dela.
• Criar demonstrações financeiras, tabelas de coorte, relacionamentos entre cubos, agendamento de atualização ou blocos de análise inteligente. Faça na tela do HubCount BI Studio.
• Escolher o período que o cliente vai ver. Isso é do calendário do dashboard.
• Garantir que um número está certo. Ele monta o cálculo que você pediu. A conferência é sua.
• Garantir que uma consulta ao banco só lê dados. Ele é instruído a rodar só consultas de leitura, mas o HubCount BI Studio não bloqueia outros comandos. Use uma conexão com um usuário só de leitura.

Pedidos para a análise com IA

O bloco de análise inteligente do dashboard também aceita um pedido escrito. É outro recurso: ele explica um gráfico, não cria nada. No bloco, escolha o modo Avançado e escreva em Prompt da IA. Pedidos que funcionam bem dizem o que comparar, o período e o formato da resposta:

• “Compare a receita de cada unidade no último trimestre com o trimestre anterior. Responda em até três tópicos e termine com uma recomendação.”
• “Aponte os meses em que a receita ficou abaixo da meta e a diferença em reais.”

Guarde os pedidos que funcionaram em Galeria de Prompts. Veja Como gerar uma análise com IA num dashboard.

Quando o resultado não é o esperado

O que você viu	Causa provável	O que pedir
Gráfico vazio	Gráfico sem série, ou série sem medida	“Adicione ao gráfico X a série com a medida Receita.”
Número zerado	Data errada na medida, ou filtro que não pega nenhuma linha	“Mostre a medida Receita e diga qual campo de data ela usa.”
Um gráfico novo igual a um que já existia	O pedido não citou o nome	“Edite o gráfico Receita por mês em vez de criar outro.”
O gráfico não abre por unidade	Medida sem campo de agrupamento ou drilldown desligado	“Ligue o drilldown por unidade no gráfico X.”
A IA parou no meio	Limite de 12 rodadas ou 3 erros seguidos	Peça só o que faltou, numa mensagem nova.
Pedido de IA grande demais	Muitas tarefas numa frase	Use o modo Planejamento e execute o plano.