> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/analytics/pt-br/dashboard-studio/creating-dashboards/ai-dashboards.md). # Criando painéis com IA Descreva o que você quer monitorar em linguagem simples e deixe o Assistente de IA criar um painel com base em SQL que você revisa no canvas antes de salvá-lo O Assistente de IA cria um painel do Dashboard Studio a partir de uma descrição em linguagem natural. Você descreve o que quer monitorar. O assistente faz perguntas de esclarecimento e, então, gera os painéis e o SQL por trás deles. O resultado abre em um canvas ao lado do chat, onde é executado sobre os seus próprios dados. Nada é salvo até você clicar **Salvar**. Este assistente está integrado ao Dashboard Studio. Ele é separado do assistente de IA do Navixy em toda a plataforma, que responde a perguntas da conta e cria fluxos do IoT Logic. Use-o quando você sabe o que quer ver, mas não quais tabelas ou consultas o produzem. Se preferir criar painéis e escrever consultas você mesmo, veja [Criando painéis](/docs/analytics/pt-br/dashboard-studio/creating-dashboards.md). {% embed url="" %} Criar um painel personalizado com um Assistente de IA integrado {% endembed %} ## O que o Assistente de IA faz O assistente escreve o SQL para você. Ele gera um painel completo: o layout dos painéis, os tipos de visualização e uma consulta por trás de cada painel de dados. Cada consulta é executada no seu banco de dados do IoT Query. Ele produz os mesmos tipos de visualização que você pode adicionar da galeria de painéis: blocos de valor único, gráficos de barras, gráficos de pizza, tabelas, painéis de texto e mapas. Ele também pode gerar tipos que a galeria de painéis não oferece, como séries temporais e gráficos de linha, que são renderizados corretamente depois de salvos. Todo painel é um ponto de partida, não um resultado final. O assistente gera SQL a partir de uma descrição sem verificar primeiro os nomes das suas colunas. Assim, um painel pode referenciar uma coluna que não existe nos seus dados. O canvas executa cada painel para que você detecte esses erros antes de salvar. ### O que ele não faz O assistente cria painéis. Ele não responde a perguntas pontuais sobre a sua frota no chat. Peça a ele o que você quer acompanhar ao longo do tempo e, então, leia a resposta nos painéis que ele cria. Uma pergunta como "quais veículos estão offline agora" vira um painel, e não uma resposta no chat. Toda consulta que ele escreve lê os seus dados. O assistente nunca altera, adiciona nem exclui nada no seu banco de dados do IoT Query. Ele funciona apenas no painel atualmente no canvas. O assistente cria e revisa esse painel por meio da conversa, e não pode abrir um painel que você salvou em uma conversa anterior para alterá-lo. Edite esses no editor de painéis, em vez disso. ## Antes de começar Você precisa do seguinte: * Acesso ativo ao IoT Query e Dashboard Studio disponível na sua conta. Veja [Como acessar o Dashboard Studio](/docs/analytics/pt-br/dashboard-studio.md#how-to-access-dashboard-studio). * uma função de administrador ou editor. Qualquer pessoa pode abrir o assistente e revisar um resultado no canvas, mas somente administradores e editores podem salvar um. * Uma janela do navegador em tamanho real. O chat e o canvas foram feitos para larguras de desktop. {% hint style="info" %} Em uma conta de demonstração, o painel é salvo no seu navegador em vez de no seu banco de dados. Ele desaparece quando os dados de demonstração são redefinidos, e ninguém mais pode vê-lo. O histórico do chat de demonstração nunca é salvo. {% endhint %} ## Como criar um painel {% stepper %} {% step %} ### Abrir o assistente Abra o Dashboard Studio e vá para **Início**. Em **Primeiros passos**, encontre o **Assistente de IA** cartão e clique em **Começar a conversar**. Na primeira visita, o chat se abre com o título **O que você quer monitorar?** e quatro prompts de exemplo. Clicar em um prompt preenche a caixa de mensagem sem enviá-lo. Depois que a conversa começa, a transcrição substitui essa tela e os prompts de exemplo deixam de aparecer. {% endstep %} {% step %} ### Descreva o que você quer monitorar Digite sua solicitação em linguagem natural, por exemplo "Acompanhe a quilometragem do veículo ao longo do último mês". Pressione **Enter** para enviá-la, ou **Shift+Enter** para uma nova linha. Seja específico sobre a métrica, os veículos, o período e os tipos de painel que você quer. Dizer isso no início encurta a conversa. Enquanto o assistente trabalha, uma linha de status acima do campo de composição informa a etapa em que ele chegou. Ela vai de "Enviando sua mensagem…" até "O assistente está trabalhando…" e "Resposta pronta", e mostra o tempo decorrido ao lado. {% endstep %} {% step %} ### Responda às perguntas de esclarecimento O assistente pergunta apenas sobre o que você ainda não declarou. Uma primeira mensagem detalhada pode deixar uma única pergunta, enquanto uma curta deixa várias. Responda no chat. Ele então lista os painéis que planeja criar, junto com o título do painel, e pede para você confirmar. Responda para confirmar ou descreva o que mudar. {% endstep %} {% step %} ### Revise o resultado no canvas O assistente retorna um cartão de resultado com o título **Resultado pronto**, com o título do painel e a contagem de seus painéis. O canvas se abre ao lado do chat e executa o SQL de cada painel sobre os seus próprios dados. Nenhum painel é criado nesta etapa. Verifique a linha de status e os painéis individuais conforme descrito em [O que verificar no canvas](#what-to-check-on-the-canvas). {% endstep %} {% step %} ### Salvar o painel Clique em **Salvar** no canvas. Na caixa de diálogo **Salvar painel** escolha a seção em que o painel deve ficar e, então, clique em **Salvar**. O Dashboard Studio salva o painel e mostra uma confirmação com um botão **Abrir** . {% endstep %} {% endstepper %} Se o resultado não for o que você queria, continue a conversa. Descreva o que mudar, e o assistente reconstrói o painel no canvas. **Desfazer** reverte a última alteração recebida pelo canvas. ## Trabalhando no canvas O canvas é o espaço de trabalho entre a resposta do assistente e um painel salvo. Ele comporta um painel por vez. Salvar não o esvazia: o painel permanece no canvas, agora vinculado à cópia salva. Ele muda apenas quando você coloca outro resultado ali ou limpa o chat. | Controle | O que ele faz | | ---------------------- | -------------------------------------------------------------------------------------------------------------- | | **Salvar** | Abre a caixa de diálogo **Salvar painel** . Desativado até que o canvas execute o painel. | | **Desfazer** | Reverte a última alteração que o canvas recebeu da conversa. | | Renomear | Clique no ícone de lápis ao lado do título para renomear o painel antes de salvá-lo. | | **Exportar como JSON** | Baixa o esquema do painel, para que você possa importá-lo em outro lugar ou mantê-lo fora do Dashboard Studio. | | Maximizar e restaurar | Expande o canvas para a janela inteira e, depois, o retorna ao lado do chat. | | **Ocultar canvas** | Recolhe o canvas. **Mostrar canvas** no cabeçalho do chat o traz de volta. | | Arraste o divisor | Altera quanto espaço vai para o chat e quanto vai para o canvas. | O cartão de resultado na transcrição traz suas próprias ações. **Novo painel** coloca esse resultado no canvas por conta própria, substituindo o que quer que o canvas estivesse exibindo. Quando um resultado já é o que está no canvas, o mesmo botão passa a dizer **Abrir no canvas** e traz o canvas de volta à vista sem alterá-lo. **Adicionar ao rascunho** aparece enquanto o canvas contém um resultado diferente e mescla os painéis desse resultado nele, para que você possa construir um único painel ao longo de várias respostas. **Ver SQL** e **Ver JSON** abrem a consulta e o esquema gerados, cada um com um botão de cópia. Um resultado que o assistente retorna como um único widget é renderizado na transcrição como um painel ao vivo. Clique em **Mostrar dados** para executar a consulta desse painel isoladamente, sem abrir o canvas. ## O que verificar no canvas O canvas é a única etapa que executa o SQL gerado sobre os seus dados, então é ali que consultas quebradas aparecem. Uma linha de status acima dos painéis informa o que aconteceu. Quando todo painel funciona, ela mostra "Todos os painéis carregados: 9." Quando alguns falham, ela nomeia cada número, por exemplo "Painéis carregados: 7 de 9. Painéis com falha: 2. Verifique-os antes de salvar." Uma terceira mensagem significa que o canvas não conseguiu validar alguns painéis de forma alguma: "Painéis não verificados: 2. Nenhum SQL para executar." Esses painéis nunca foram testados contra os seus dados, então verifique-os você mesmo antes de salvar. Verifique cada painel individualmente também. Um painel pode carregar com sucesso e ainda mostrar algo errado. Ele pode agrupar por um campo diferente do que você tinha em mente, por exemplo. {% hint style="info" %} Os painéis com falha não impedem **Salvar**. Se apenas um painel estiver errado, você pode salvar o painel e corrigir a consulta desse painel no editor de painéis depois. Para ajuda com uma consulta com falha, veja [Escrevendo consultas SQL](/docs/analytics/pt-br/dashboard-studio/writing-sql-queries.md). {% endhint %} Os dados dos painéis no canvas podem ficar em cache por até cinco minutos, então os valores podem ficar atrás de um painel carregado recentemente. Consultas com falha nunca ficam em cache, então um painel com falha sempre é executado novamente. ## Para onde vão os painéis salvos A **Salvar painel** caixa de diálogo **pergunta em qual seção o painel deve ficar.** Painéis de IA **pergunta em qual seção o painel deve ficar.** é sempre a primeira entrada e a padrão. O resto da lista são as seções que você já tem. Quando você ainda não tiver nenhuma **seção**, a entrada mostra Painéis de IA (nova seção) **Atenção** painel de texto. Ele informa que o painel foi gerado por IA e que os resultados podem conter imprecisões. Ele também inclui o ID do trabalho e o horário de geração. O painel vem do assistente, e não do Dashboard Studio, então sua redação pode mudar. Ele é salvo com o painel. Remova-o no editor de painéis se você não quiser. Depois de salvo, o painel se comporta como qualquer outro. Você pode renomeá-lo, editar seus painéis e consultas, movê-lo para uma seção diferente ou exportá-lo. ### Atualizando um painel que você já salvou Depois de salvar, o canvas permanece conectado a esse painel. Continue conversando com o assistente, e **Salvar** atualiza a cópia salva no próprio lugar, em vez de criar uma segunda. A dica de ferramenta do botão diz "Atualize o painel salvo com suas alterações", e a confirmação informa que o painel foi atualizado. Para criar um painel separado, clique **Novo painel** em outro cartão de resultado. Isso substitui o canvas por um rascunho que não tem vínculo com a cópia salva, então o próximo **Salvar** cria um novo painel. ## Lendo o botão Salvar A **Salvar** botão é desativado com mais frequência do que parece, e a dica de ferramenta diz o motivo. | Dica de ferramenta | O que fazer | | ----------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | | "Disponível quando o canvas tiver executado este painel. Verifique o status acima dos painéis." | Aguarde os painéis terminarem de ser executados. | | "Um painel precisa de pelo menos um painel" | Peça ao assistente para adicionar um painel. | | "Este painel está salvo. Altere algo no canvas para salvá-lo novamente." | Nada mudou desde o último salvamento. | | "Salve este painel com a função de Editor" | Sua função não pode salvar. Peça a um administrador ou editor para salvá-lo. | | "Atualize o painel salvo com suas alterações" | Clicar salva suas alterações sobre a cópia que você salvou anteriormente. | ## Iniciando uma nova conversa **Limpar chat** no cabeçalho do chat esvazia a transcrição e inicia uma nova conversa. O assistente não se lembra do que vocês discutiram antes, e qualquer coisa no canvas é limpa junto com ela. A caixa de diálogo de confirmação declara ambos os efeitos antes de você confirmar. Use isso quando o assistente tiver se fixado em uma abordagem que você quer que ele abandone, ou quando você quiser começar um painel não relacionado do zero. Salve ou exporte qualquer coisa no canvas primeiro, porque limpar a conversa a descarta. Limpar não afeta os painéis que você já salvou. ## Limitações conhecidas | Limitação | Detalhe | | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Uma conversa por vez** | O chat mantém uma única conversa. **Limpar chat** inicia uma nova, e a transcrição mantém apenas os 100 turnos mais recentes. | | **Salvar requer uma função** | Qualquer pessoa pode abrir o assistente e revisar um resultado. Somente administradores e editores podem salvar, renomear ou editar um painel. | | **Contas de demonstração salvam localmente** | Em uma conta de demonstração, os painéis salvos vão para o seu navegador, não para o seu banco de dados. Eles desaparecem quando os dados de demonstração são redefinidos. | | **O histórico nem sempre é salvo** | Em uma conta de demonstração, e em um espaço de trabalho onde as tabelas de chat não estão configuradas, a página avisa que o histórico do chat não está sendo salvo e pode ser perdido quando o serviço reiniciar. | | **As contagens de painéis diferem** | O cartão de resultado conta todos os painéis. A linha de status do canvas conta apenas os painéis que executam SQL, então um painel com um painel de texto mostra um a menos. | | **Ordenação na seção** | Os painéis salvos ficam acima de qualquer painel que você adicionar manualmente à mesma seção. Reordene-os arrastando no editor do menu. | | **Projetado para desktop** | O chat e o canvas são voltados para larguras de desktop. | | **Comprimento da mensagem** | Uma única mensagem pode ter até 4.000 caracteres. | | **Taxa de mensagens** | Até 20 mensagens por minuto. Além disso, o assistente pede que você aguarde antes de enviar novamente. | {% hint style="warning" %} Evite excluir ou renomear a **pergunta em qual seção o painel deve ficar.** seção. As seções são mantidas em vez de apagadas quando você exclui uma, então um salvamento que tenta recriá-la entra em conflito com a cópia excluída e falha. Restaure-a no **menu Editar**, depois salve novamente. Renomeá-la tem o efeito oposto: o próximo salvamento não reconhece mais a seção, cria uma segunda seção ao lado dela, e a renomeada deixa de receber novos painéis. **pergunta em qual seção o painel deve ficar.** ao lado dela, e a renomeada deixa de receber novos painéis. {% endhint %} ## Próximos passos * [**Criando painéis**](/docs/analytics/pt-br/dashboard-studio/creating-dashboards.md): Crie um painel manualmente, adicione painéis e organize o layout. * [**Escrevendo consultas SQL**](/docs/analytics/pt-br/dashboard-studio/writing-sql-queries.md): Padrões de consulta para cada tipo de visualização e ajuda com um painel que falha ao carregar. * [**Painéis prontos**](/docs/analytics/pt-br/dashboard-studio/built-in-dashboards.md): Painéis prontos para importar em vez de criar um. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://navixy.com/docs/analytics/pt-br/dashboard-studio/creating-dashboards/ai-dashboards.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.