Conceito

O assistente de IA do HubCount BI Studio: modos e o que ele faz

Conheça o assistente de IA do HubCount BI Studio: os modos Agente, Planejamento e Pergunta, o que ele cria no projeto, o histórico e o limite de conversas.

Descreva o que você quer, com as suas palavras: o assistente cria e ajusta cubos, medidas, gráficos e dashboards do projeto aberto. Ou só responde perguntas sobre o projeto, sem mudar nada. Cada conversa pertence a um projeto.

Use quando você sabe o resultado que quer, mas não quer montar cada peça à mão, ou quando quer entender o que já existe no projeto.

Abrir o assistente

Abra o projeto.
Clique no ícone de estrelas do menu lateral (Abrir Assistente IA do projeto) ou no ícone de balões da barra superior (Abrir chat). O chat abre numa aba do projeto, chamada Chat IA.
Com a conversa vazia, o assistente mostra Como posso ajudar neste projeto? e quatro sugestões. Clique numa sugestão para enviar o pedido, ou escreva o seu na caixa de mensagem.
Aperte Enter para enviar. Para quebrar a linha sem enviar, use Ctrl + Enter.

Clicar no ícone de balões de novo, com a aba do chat à frente, fecha a aba. Fora de um projeto, o painel do chat pede para você escolher o projeto antes de conversar.

Os três modos

O seletor de modo fica no canto esquerdo de baixo da caixa de mensagem. O modo padrão é Agente. O modo vale para a conversa aberta até você trocar.

Modo	O que o assistente faz	Ferramentas que ele pode usar
Agente	Executa ações e pode criar objetos no projeto.	Todas: leitura e criação ou edição.
Planejamento	Cria um plano em Markdown para revisão antes da execução.	Só leitura, mais perguntas e plano.
Pergunta	Responde e analisa sem modificar o projeto.	Só leitura.

Agente

No modo agente, o assistente faz as mudanças no projeto, em etapas. Ele pode:

criar um projeto novo e criar cubos a partir de conexões que já existem;
criar ou atualizar um cubo de API (ele testa a requisição) e, em bancos de dados, listar objetos, ver a estrutura e uma amostra das tabelas, rodar consultas, validar e aplicar o rascunho do cubo;
reescrever a consulta SQL de um cubo de banco de dados que já existe;
configurar os campos do cubo, criar campos calculados e medidas;
criar e editar gráficos (colunas, colunas empilhadas, linhas, linhas empilhadas, área, cartão, pizza, rosca, funil, barras horizontais, tabela e tabela de dados), as séries de cada gráfico e filtros de gráfico;
criar e editar tabelas dinâmicas;
montar dashboards: criar, renomear e apagar dashboards, abas e visões, e colocar gráficos, títulos e textos em Markdown no lugar certo.

Enquanto trabalha, a conversa mostra cada etapa num bloco Ferramentas executadas, com o nome da etapa e se terminou. Clique no bloco para ler o retorno técnico de cada ferramenta. Para interromper, clique em Parar geração. O que já foi criado fica no projeto; o HubCount BI Studio só para de pedir novas etapas.

Conversa no modo Agente: o pedido para criar um gráfico de colunas com o lucro bruto por unidade, três blocos de ferramentas executadas (gráfico, séries e dashboard) e a resposta final do assistente

O assistente é orientado a seguir algumas regras, que ajudam a entender o resultado:

Reaproveitar o que já existe e criar só o que falta. Se a medida já existe, ele usa a medida.
Seguir a ordem do HubCount BI Studio: cubo, campos, medida, gráfico, série, dashboard. Um gráfico só mostra dados depois que recebe uma série.
Deixar o período por conta do calendário do dashboard, não do gráfico. Por isso ele não cria filtro de período.

O HubCount BI Studio também limita o trabalho: o assistente para depois de 12 rodadas seguidas de ferramentas, ou depois de 3 erros seguidos de ferramentas, para não entrar em loop. Nesses casos aparece um aviso em vermelho no alto da conversa. Peça o que faltou numa mensagem nova.

Pergunta

O modo pergunta responde e analisa sem mudar nada no projeto. Use para entender os cubos, tirar dúvidas sobre os dados ou pedir sugestões antes de criar. Ele pode olhar uma amostra dos dados de uma medida ou do banco para responder.

Se o assistente achar que a resposta pede uma mudança, ele avisa e sugere trocar para o modo Agente.

Planejamento

Para pedidos grandes, como “monte um dashboard de metas por unidade”, o modo planejamento escreve um plano para você revisar antes de qualquer mudança. Ele olha o projeto, e só depois pergunta ou planeja.

Troque o modo para Planejamento e envie o pedido.
Se faltar uma decisão sua, o assistente mostra um cartão Pergunta de planejamento. Escolha uma opção ou escreva em Outra resposta..., e clique em Responder.
Nas perguntas opcionais, o cartão também tem o botão Não sei. O contador no topo do cartão mostra quantas perguntas ainda faltam.
Com tudo respondido, o assistente cria o plano e mostra um botão Abrir plano na aba na conversa. O plano também abre sozinho numa aba Plano da IA, em segundo plano.
Na aba do plano, leia o texto. Use Editar para mudar o plano, Voltar ao chat para voltar à conversa, ou Executar plano para executar.

Ao clicar em Executar plano, o HubCount BI Studio volta para o chat, troca para o modo Agente e envia o plano como pedido. O plano guarda o que você editou. Ele existe só enquanto o HubCount BI Studio está aberto: se você recarregar a página ou fechar o aplicativo, o plano some. Se precisar dele depois, copie o texto.

Quando você pede algo grande no modo Agente, o HubCount BI Studio pode sugerir o planejamento com o aviso Esse pedido parece grande. Quer transformar em plano antes de executar?, acima da caixa de mensagem. Usar planejamento troca o modo. Continuar no agente esconde o aviso nesta conversa.

Anexar imagens

Anexe uma imagem quando o pedido é visual, como o rascunho de um dashboard ou o print de um relatório que você quer reproduzir.

Clique no ícone de imagem da caixa de mensagem (Anexar imagem), arraste a imagem para a caixa ou cole com Ctrl + V.
Formatos: PNG, JPEG, WEBP e GIF. Até 5 MB por imagem e até 5 imagens por mensagem.
Para tirar uma imagem antes de enviar, use o X da miniatura (Remover imagem).

Caixa de mensagem com a miniatura de uma imagem anexada, com o X para remover, o seletor de modo Agente e o botão de enviar ativo

O envio da mensagem espera o upload da imagem terminar. Se algum arquivo passar do limite ou não for aceito, aparece um aviso amarelo dentro da caixa, com o motivo.

Conversas e histórico

Cada conversa fica salva no projeto, com um título que a IA escreve a partir da sua primeira mensagem. Ela é do projeto, não da sua conta: outras pessoas do escritório que abrirem o chat do mesmo projeto veem as mesmas conversas. Os ícones no canto superior direito do chat:

Ícone	O que faz
Ver histórico de conversas	Abre a lista Conversas, agrupada em Hoje, Últimos 7 dias e Mais antigas. Clique numa conversa para voltar a ela.
Nova conversa	Começa uma conversa vazia. Se já existe uma conversa vazia, o HubCount BI Studio reaproveita essa.
Limpar conversa	Esvazia a conversa aberta, depois de pedir confirmação.

Lista Conversas aberta, com a busca Buscar conversas, o grupo Hoje e uma conversa com o título e o começo da última mensagem

Na lista, a busca Buscar conversas... procura no título e na última mensagem. O HubCount BI Studio carrega as 5 conversas mais recentes do projeto. Conversas mais antigas não aparecem na lista.

Limite mensal de conversas

O assistente não gasta créditos por mensagem. O HubCount controla o uso por conversa: cada conversa nova conta 1 no limite mensal de conversas do escritório, e as mensagens da mesma conversa não contam. O limite vem do módulo contratado e recomeça a cada mês do calendário.

O que conta: a conversa que nasce quando você envia a primeira mensagem. Clicar em Nova conversa sozinho não conta, porque a conversa só é criada no servidor com a primeira mensagem.
Quem divide o limite: o escritório inteiro. Entram na soma as conversas de todos os projetos e de todas as pessoas, e também as do chat do HubCount BI Web.
O que não conta: criar um projeto com IA, o SQL com IA e a análise de gráfico do dashboard. Os três rodam sem abrir uma conversa salva.
Quando o limite acaba: ao enviar a primeira mensagem de uma conversa nova, o chat mostra o aviso em vermelho no alto da conversa:

Seu plano atingiu o limite mensal de conversas com a IA. Fale com o suporte ou altere o plano contratado.

O HubCount confere o limite só quando cria a conversa. Uma conversa que já estava aberta continua respondendo, e o assistente volta a abrir conversas novas no mês seguinte. Para abrir mais conversas antes disso, fale com o suporte da HubCount para alterar o módulo contratado.

Assistente do Studio, chat do Web e análise de gráfico

São três recursos de IA diferentes, com usos diferentes.

Assistente do HubCount BI Studio (esta página): fica na aba Chat IA do projeto, para quem monta dashboards. Cria e muda cubos, medidas, gráficos e dashboards no modo Agente, ou responde perguntas sobre o projeto. Não tem menção com @. Cada conversa nova conta no limite mensal.
Chat do HubCount BI Web: fica no botão do cabeçalho do dashboard, no HubCount BI Web. Serve para perguntar sobre os dados da empresa e ver gráficos na conversa. Tem menção com @. Cada conversa nova conta no mesmo limite mensal. Veja Como perguntar ao assistente de IA no HubCount BI Web.
Análise de gráfico: um texto curto que explica um gráfico. No HubCount BI Studio é um bloco do dashboard, com os modos padrão e avançado. Não muda o projeto e não conta no limite mensal de conversas. Veja Como gerar uma análise com IA num dashboard e Como pedir uma análise de gráfico à IA no HubCount BI Web.

Dicas e problemas comuns

O assistente criou algo diferente do que você queria. Diga o que mudar na mesma conversa. Para um recomeço limpo, abra uma conversa nova.
Confira os números. Abra as medidas que ele criou e veja o tipo de cálculo, o campo de valor e o campo de data. Veja Medidas.
Consultas ao banco de dados. O assistente é instruído a rodar só consultas de leitura, mas o HubCount BI Studio não bloqueia outros comandos. Cadastre a conexão com um usuário do banco que só tenha permissão de leitura.
Os nomes das etapas aparecem em português, mesmo com o HubCount BI Studio em inglês. Os rótulos dos blocos de ferramentas ainda não são traduzidos.
O erro apareceu em vermelho no alto do chat. Leia a mensagem: ela diz se foi um limite do HubCount BI Studio (12 rodadas, 3 erros seguidos), o limite mensal de conversas (veja Limite mensal de conversas) ou uma falha do servidor. Tente de novo em instantes.
A conversa ficou longa e as respostas pioraram. Abra uma conversa nova para um assunto novo. Quando a conversa passa do limite do modelo, o chat avisa A conversa ficou longa demais. Comece uma conversa nova.
Sua sessão expirou. O chat avisa Sua sessão expirou. Entre novamente para continuar. Entre de novo no HubCount BI Studio.

Para escrever pedidos melhores, veja Como pedir bem à IA. Para começar um projeto novo com a IA, veja Como criar um projeto com dashboard pronto usando IA.