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

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

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 Hubviz Studio só para de pedir novas etapas.

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 Hubviz 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 Hubviz 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.

Ao clicar em Executar plano, o Hubviz 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 Hubviz 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 Hubviz 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).

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: outros criadores do workspace 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 Hubviz Studio reaproveita essa.
Limpar conversa	Esvazia a conversa aberta, depois de pedir confirmação.

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

Créditos de IA

O assistente do Hubviz Studio não usa créditos de IA. Você pode abrir quantas conversas quiser, mandar quantas mensagens quiser e usar os três modos sem gastar crédito. O mesmo vale para a análise de gráfico, o relatório e os slides com IA, o SQL com IA e o “criar com IA”.

Os créditos de IA do plano são só do chat do Hubviz Web: cada conversa nova nesse chat usa um crédito, e as mensagens da mesma conversa não usam. Veja como funcionam o limite do mês, os créditos extras e o aviso de créditos esgotados em Como perguntar ao assistente de IA no Hubviz Web.

Quando os créditos do chat acabam, só o chat do Hubviz Web bloqueia conversas novas. O assistente do Hubviz Studio e as outras funções de IA continuam funcionando.

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 Hubviz Studio	Chat do Hubviz Web	Análise de gráfico
Quem usa	Criadores	Quem tem acesso ao assistente no workspace	Criadores (no dashboard) e leitores (no Web)
Onde fica	Aba Chat IA, dentro do projeto	Botão do cabeçalho do dashboard, no Hubviz Web	Bloco do dashboard, no Hubviz Studio. Ícone de IA no gráfico, no Hubviz Web
Serve para	Criar e mudar cubos, medidas, gráficos e dashboards, ou perguntar sobre o projeto	Perguntar sobre os dados publicados e ver gráficos na conversa	Um texto curto que explica um gráfico
Muda o projeto	Sim, no modo Agente	Não	Não
Usa crédito de IA	Não	Sim, 1 por conversa nova	Não
Quais dados vê	A configuração do projeto e as amostras que pede	Os dados publicados do projeto	Os dados do gráfico
Menção com @	Não	Sim	Não
Modos	Agente, Planejamento e Pergunta	Não tem	Padrão e avançado no Studio. Tom do texto no Web

Veja o passo a passo dos outros dois em Como perguntar ao assistente de IA no Hubviz Web, Como pedir uma análise de gráfico à IA no Hubviz Web e Como gerar uma análise com IA num dashboard.

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.
• A conversa ficou longa e as respostas pioraram. Abra uma conversa nova para um assunto novo.
• Consultas ao banco de dados. O assistente é instruído a rodar só consultas de leitura, mas o Hubviz 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 Hubviz 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 Hubviz Studio (12 rodadas, 3 erros seguidos) ou uma falha do servidor. Tente de novo em instantes.

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.