Integração com CIA – BI CIGAM
BI > BI Menu > Integração com CIA – BI CIGAM
Índice
- 1 Palavras-Chave
- 1.1 Direitos Usuários
- 1.2 Template
- 1.3 Assuntos Disponíveis CIA BI CIGAM
- 1.4 Explorando a Tela de Criação de Prompt da CIA no BI CIGAM
- 1.5 Exemplo Prático de Prompt com a CIA do BI CIGAM
- 1.6 Customização de Assuntos, Métricas e Dimensões
- 1.7 🛠️ Boas Práticas para Criar Prompts na CIA do BI CIGAM
- 1.8 Assistente Virtual CIGAM | Chatbot WIKI | Dúvidas Integração CIA do BI CIGAM
Palavras-Chave
Prompt Inteligente. Assuntos CIA BI.Prompt em voz.Linguagem Natural CIA BI CIGAM.Dashboard com IA.Criar dashboards com IA.Como usar CIA no BI CIGAM. IA BI CIGAM.
CIA do BI CIGAM é um recurso que une tecnologia de Inteligência Artificial à análise de dados, permitindo que usuários transformem perguntas em linguagem natural em dashboards dinâmicos, interativos e totalmente personalizados.
Essa inovação tem como propósito tornar a análise acessível a todos, independentemente do nível de conhecimento técnico em BI ou modelagem de dados. CIA interpretar, organizar e apresenta as informações de forma clara e visual.
Esse modelo quebra barreiras no processo tradicional de análise, de maneira intuitiva e prática, oferecendo ganhos diretos de tempo, precisão e autonomia.
IMPORTANTE:
- Esta documentação tem como objetivo explicar de forma clara e prática o funcionamento da CIA do BI CIGAM.
- É importante destacar que a criação de dashboards através da CIA do BI CIGAM deve ser realizada exclusivamente pela aplicação do BI WEB.
- As configurações a seguir para utilização da CIA devem ser realizadas por um usuário desenvolvedor da aplicação, de preferência com o apoio de uma consultoria especializada, garantindo assim a implementação correta da ferramenta.
- A Integração com a CIA no BI CIGAM vai estar disponível a partir das versões disponíveis no mês de Outubro/2025.Mais detalhes, acesse: Versões produto.
Direitos Usuários
Para que o usuário possa fazer os prompts é necessário que tenha direitos aos assuntos.
Os grupos de usuários estão ligados a fontes de dados disponíveis no Menu de Downloads ao instalar os dashboard padrões.
Esses direitos também estão relacionados aos Assuntos/Fontes customizados que está sendo abordado no tópico: Customização de Assuntos, Métricas e Dimensões.
Deste modo é importante que usuário precisa esteja vinculado ao grupo de direitos correspondente em seu perfil de acesso.
Caso acesse esta tela e ela apareça em branco, você ainda pode fazer o download na própria tela, que os direitos serão baixados normalmente:
- Mais detalhes de como encontrar essas configurações: Usuários.
Template
No Menu Configurações no BI Desktop Template precisa estar com definida como "Padrão".
Assuntos Disponíveis CIA BI CIGAM
A CIA do BI CIGAM já está integrada a um conjunto de assuntos estratégicos, que possibilitam a criação de prompts inteligentes e dashboards dinâmicos.E atualmente, os usuários podem explorar informações relacionadas a:
Os assuntos disponíveis e serão disponibilizadas os assuntos aos usuários de acordo com as configurações de usuários conforme explicado anteriormente. Estes assuntos já permitem uma ampla gama de análises estratégicas, oferecendo ao usuário uma ferramenta eficaz para suporte à gestão.
Explorando a Tela de Criação de Prompt da CIA no BI CIGAM
Acessando o BI pela aplicação Web, na segunda aba temos a opção "Criar Dashboard".
O usuário é direcionado para a tela da CIA do BI CIGAM, onde ocorre a criação do prompt,ou seja, a formulação do texto que será interpretada pela Inteligência Artificial da Aplicação.
Nesta aba temos as seguintes funcionalidades:
Microfone:permite que o usuário dicte o prompt por voz interpretando a fala e transforma em texto facilitando a criação de dashboards de forma rápida e intuitiva principalmente pelo Mobile.
Filtros Globais:Garante que os filtros definidos no ambiente do BI Web como período, filial ou grupo de produtos,sejam automaticamente aplicados ao dashboard gerado pela CIA. Isso assegura consistência nas análises e evita a necessidade de repetir configurações já existentes.
Assuntos:A partir do assunto informado, a CIA identifica automaticamente as métricas relevantes , as dimensões e os filtros mais apropriados para refinar os dados de acordo com o prompt criado pelo o usuário.
Além disso, o assunto serve como referência para a IA evitar ambiguidades e propor visualizações mais precisas. Quando o assunto não é informado, a CIA , ela vai tentar inferir o contexto com base nos termos utilizados, mas isso pode gerar interpretações menos assertivas. Por isso, informar o assunto de forma clara e objetiva é essencial para aproveitar todo o potencial da ferramenta na construção de dashboards estratégicos e funcionais.
Exemplo Prático de Prompt com a CIA do BI CIGAM
- Assunto Financeiro – Modelo de Prompt Genérico para Demonstração
Quando usamos a inteligência artificial na criação do prompt, ela funciona melhor quando recebe instruções claras. Se não informarmos com precisão o que queremos avaliar, o resultado poderá ficar vago ou aberto a interpretações diferentes.
É como no exemplo do prompt acima: Embora pareça completo, ele não está totalmente claro. Esse pedido pode se encaixar em pelo menos dois assuntos diferentes, como vendas ou financeiro, por exemplo.
Isso significa que a CIA precisa de mais contexto para entregar exatamente o que o usuário necessita.
Com base no mesmo prompt e ainda dentro do assunto Financeiro, vamos aprimorar a solicitação para que a CIA do BI CIGAM entregue um dashboard mais completo e alinhado ao objetivo da análise:
Este exemplo atende aos objetivos da análise de Contas à Receber, pois define claramente o assunto (contas com vencimento neste ano), inclui indicadores relevantes (inadimplência mensal, tempo médio de recebimento e projeção de recebimentos até o fim do ano), e especifica visualizações adequadas ao assunto.
Acessando o ícone de Opções:
,serão habilitados os seguintes campos:
No qual temos:
Um exemplo seria clicar em um item dentro do dashboard para complementá-lo.
Neste caso, solicitado a inclusão da dimensão "Portador" no item Recebimento por Faixa Dias.
Ao incluir uma nova dimensão, automaticamente o DrillDown é habilitado, a dimensão solicitada é automaticamente incorporada ao item do dashboard, enriquecendo a análise.
Neste ícone do dashboard, é possível incluir novas dimensões e métricas, ou solicitar a exclusão de elementos existentes, conforme necessário. Também é possível adicionar novos itens em formato de grid e solicitar a alteração da visualização para gráfico. Abaixo, segue um exemplo:
Como foi solicitado o complemento com a dimensão "Portador", o gráfico respeita essa configuração e apresenta a informação diretamente no DrillDown.
Filtros
Filtros em dashboards permitem refinar os dados exibidos, mostrando apenas informações relevantes conforme critérios definidos pelo usuário de acordo com o prompt criado. Eles são essenciais para análises mais precisas e personalizadas, e podem ser aplicados em dimensões.
Exemplos de filtros aplicado no Dashboard de acordo com o prompt criado:
- Mês Ano [GF - Data Vencimento]: permite filtrar os dados por mês e ano de vencimento dos registros financeiros. Por exemplo, se quiser ver apenas os dados referentes a junho de 2025, seleciona esse mês/ano aqui.
- Empresa [GE - Empresa]: filtra os dados para uma ou mais empresas específicas.Isso é útil em dashboards multiempresa, permitindo análise por unidade ou grupo.
- Faixa [GF - Faixa Vencimentos]: normalmente agrupa registros financeiros por faixa de vencimento, como “até 30 dias”, “31 a 60 dias”, “mais de 60 dias”.Isso ajuda a visualizar situações de pagamentos pendentes e atrasados.
- Estado [GE - Empresa]: permite filtrar por estado geográfico onde a empresa atua ou onde o registro financeiro está vinculado. Isso é útil para análises regionais.
- Ano: filtro genérico para escolher o ano dos registros que deseja visualizar.Ele pode servir para análises históricas ou comparativas.
- Tipo Lançamento Financeiro Desc.: filtra pelo tipo de lançamento financeiro, como “receita”, “despesa”, “pagamento”, “recebimento”, etc. O “Desc.”.Indica que provavelmente haverá uma descrição ou classificação para cada tipo.
- Observação importante sobre o uso de filtros:É essencial especificar corretamente os valores desejados ao aplicar filtros.
Por exemplo, ao digitar “Representante João”, estamos nos referindo a um valor de atributo e não a uma dimensão. Essa distinção é fundamental para que o sistema interprete corretamente o que deve ser filtrado, evitando confusões na aplicação dos critérios.
Este prompt está incorreto porque não deixa claro se “João” é um cliente, um representante ou outro atributo.
Além disso, mistura o assunto (vendas) com o filtro sem especificar corretamente o campo. Isso pode fazer o sistema interpretar de forma equivocada e trazer resultados errados ou incompletos.
Para datas e períodos, o funcionamento é mais flexível, pois a ferramenta já entende comandos como “filtrar o ano atual”, sem necessidade de detalhar campos técnicos.
Conforme a ferramenta evolui e o uso se intensifica, estamos aprimorando os prompts para que se tornem cada vez mais inteligentes. Esse processo é contínuo e contará sempre com novas informações e exemplos práticos, que serão adicionados ao documento de apoio.
Configurações do Item
Configurações do item:Essa tela serve para estruturar a tabela DrillThought, escolhendo o que analisar (métricas) e como analisar (dimensões e ordenações). É que define o formato final do grid que será exibido ao usuário.
Propriedades do Grid:O que você está vendo é o painel de Propriedades do Grid, que serve para configurar em detalhe a forma como o grid DrillThought será exibido no dashboard. Cada aba controla um aspecto da tabela.
- Geral: configurações básicas do grid, como identificação, número máximo de registros, entre outros parâmetros gerais.
- Aparência: ajustes visuais, como cores, bordas, estilos e formatação do layout.
- Comportamento: define como o grid reage a interações do usuário, por exemplo, se permite ordenação por coluna, drill down ou expansões.
- Linha: configurações específicas da aparência e estilo das linhas (ex.: altura, cor de fundo, formatação de valores).
- Linha Ímpar: permite diferenciar visualmente linhas pares e ímpares, facilitando a leitura (ex.: usar cor alternada).
- Títulos: personalização dos cabeçalhos das colunas, como fonte, alinhamento, tamanho do texto.
- Paginação Web: define se e como o grid será dividido em páginas na visualização online, útil para grandes volumes de dados.
- Mobile: configurações de responsividade e exibição para dispositivos móveis, garantindo que o grid se adapte a telas menores.
Configurações essenciais disponíveis nos itens do dashboard.
- DrillThought:
O grid DrillThought no BI funciona como uma tabela dinâmica interativa que permite navegar pelos dados em diferentes níveis de detalhe.
Na prática, ele mostra os registros em formato de grid (tabela), mas com a possibilidade de realizar o drill (abrir, expandir e detalhar informações). Isso significa que você pode começar olhando dados de forma consolidada.
Está ligado ao conceito de interpretação inteligente dos prompts, ou seja, o grid não é só uma tabela estática: ele é gerado a partir da pergunta feita à CIA do BI e já traz as dimensões e métricas mais adequadas para responder ao que foi solicitado.
Dentro do DrillTrought é possível aplicar filtros específicos e visualizar as informações necessárias de forma segmentada e personalizada:
A tela apresentada na tela é um termo de consentimento para o uso da inteligência artificial dentro do BI da CIA.
Ao clicar em “Sim”, você concorda com esse envio de dados para análise; ao clicar em “Não”, a funcionalidade de IA provavelmente não será executada, limitando o uso a consultas tradicionais sem inteligência artificial.
Após confirmar para gerar o relatório a combinação entre o prompt do usuário, a interpretação da CIA e a aplicação automática de dimensões, métricas e gráficos resulta em uma análise completa, além de apresentar insights textuais que não estavam explicitamente na solicitação, mas foram calculados pela IA para dar contexto (ex.: risco de inadimplência, liquidez no curto prazo, valor total analisado).
- Modelo de Prompt para Análise de Estoques:“Me traga Informações de custo por produto”
Mensagem: Assunto não encontrado. Selecione um assunto na lista para fornecer o contexto desejado.
Essa mensagem significa que o BI CIGAM não conseguiu identificar automaticamente um assunto no seu comando. No BI CIGAM, o assunto é fundamental porque ele orienta a inteligência do sistema sobre quais métricas, dimensões e filtros devem ser considerados para processar a solicitação.
No caso foi digitado"Me traga informações de custo por produto", mas não selecionou ou especificou um assunto (por exemplo: Estoque, Produção,Vendas etc.). Sem esse contexto, o sistema não sabe qual conjunto de dados usar e retorna a mensagem.
Por isso, é fundamental manter consistência no prompt criado ,mesmo que seja curto e objetivo,para garantir que a IA compreenda corretamente o que se espera e traga os dados certos no dashboard.
Agora, complementamos com o campo “Assunto”, que gostaria de saber os custos dos produtos das movimentações de estoque de entrada:
Após a inclusão do Assunto Foi possível trazer informação no painel:
Solicitado à CIA a alteração do item de gráfico utilizando o seguinte prompt:
Editado o Item dos materiais complementando com duas métricas quantidade e preço unitário:
Por enquanto, gostaríamos de desconsiderar o campo "Total Custo".
No momento para análise vamos precisar somente de uma analise do preço unitário e a quantidade dos produtos:
Customização de Assuntos, Métricas e Dimensões
Flexibilidade na Interpretação e Geração de Dashboards pela CIA BI CIGAM
Considerando que cada empresa pode ter definições específicas, com campos de dimensões e métricas exclusivas diretamente em seu ambiente, como a CIA do BI CIGAM interpreta esses elementos em um prompt, diferenciando-os do que já vem previamente definido no produto?
A CIA do BI CIGAM interpreta elementos específicos de cada cliente por meio de um processo de customização de assuntos, que ocorre diretamente no ambiente desktop. Nesse ambiente, através do Menu Integração com CIA, onde está disponível a opção para fazer o download conforme a fonte Específicas por Cliente, ou a fonte padrão que o cliente utiliza da aplicação mas que nela consta dimensão ou métricas criadas. Ou ainda podendo trocar o nome do campo.
Esse processo permite:
- Cadastrar assuntos customizados, com tópicos, métricas e dimensões específicas, incluindo descritivos e métricas criadas sob demanda.
- Integrar esses assuntos aos prompts e dashboards, possibilitando que a IA reconheça e interprete corretamente os termos específicos do cliente.
- Adaptar o sistema ao contexto de cada negócio, oferecendo flexibilidade para testes e uso de funcionalidades personalizadas.
Dessa forma, a CIA diferencia os elementos personalizados dos que já vêm definidos no produto, priorizando o que foi configurado para o cliente no ambiente de customização.
No ambiente Desktop no Integração com CIA:
Temos a opção de fazer o download e é feito a instalação ou a atualização do Assunto:
- Exemplo Assunto/Fonte Vendas com campos customizados:
A métrica "Preço Médio" foi criada diretamente no ambiente do cliente, como uma expressão personalizada na tabela de Fatos do GDI.
Ao realizar o download da fonte por meio da integração da CIA no ambiente desktop, os dados são disponibilizados localmente para análise e validação:
A partir deste momento, é possível acessar os elementos da fonte e incluir métricas customizadas derivadas dela diretamente no dashboard.
Além disso, o usuário pode personalizar a métrica, alterando seu nome e adicionando uma descrição conforme necessário. Essa flexibilidade permite renomear a métrica e incluir uma descrição explicativa, facilitando a compreensão no contexto do dashboard.
É possível definir campos personalizados utilizando os campos já pré-definidos do CIGAM. Caso o cliente utilize uma nomenclatura diferente, o usuário pode ajustar essa definição diretamente nas propriedades da coluna. Isso garante que, ao criar o prompt, a dimensão ou métrica seja interpretada corretamente pela CIA, respeitando o vocabulário e o contexto do segmento da empresa.
De forma prática, os Assuntos na CIA do BI CIGAM, são originados a partir do menu GDI da aplicação do BI CIGAM representadas pela Tabelas Fato, vinculadas a métricas e dimensões que o usuário seleciona no momento da criação do prompt.
Sendo assim, a instalação de um Assunto customizado via integração com a CIA nada mais é do que a definição da própria Fonte de Dados que é utilizada no BI.
No momento em que a fonte é instalada no menu da CIA do BI, é possível estruturá-la de acordo com as customizações existentes no ambiente do cliente, além de configurar as propriedades dos atributos. Isso garante que o prompt interprete corretamente as solicitações específicas de cada cliente.
- Exemplo de criação de Prompt com Campos Customizados e Títulos Ajustados nas Propriedades Personalizadas:
🛠️ Boas Práticas para Criar Prompts na CIA do BI CIGAM
A CIA do BI CIGAM precisa entender com precisão o que você quer ver e como quer ver. Quanto mais claro e completo for o seu prompt, melhor será a entrega dos dados no dashboard. Mesmo que não contenha todos os elementos recomendados, a estrutura ideal ajuda a IA a interpretar corretamente sua intenção.
🧠 Pergunte-se: “Está claro o suficiente para que a CIA do BI CIGAM traga os dados que eu realmente preciso no dashboard?”
💡 Dicas para Construção de Prompt na CIA do BI CIGAM
- Assunto: Qual área você quer analisar? (ex.: Financeiro, Vendas, Produção...)
- Métrica: O que deseja medir? (ex.: valor, quantidade, margem)
- Dimensões: Como os dados devem ser agrupados? (ex.: por cliente, por região)
- Filtros: Há algum recorte específico? (ex.: últimos 6 meses, qual segmento?)
- Granularidade: Deseja ver os dados por dia, mês ou ano?
🤖 Pensando como a CIA do BI CIGAM
Ao criar seu prompt, considere os principais pontos que a CIA do BI CIGAM precisa compreender para entregar os dados corretamente.
- Qual é o assunto principal?
- Quais métricas devem ser analisadas?
- Quais dimensões e filtros são relevantes?
- Qual a hierarquia dos dados?
- O resultado deve ser gráfico, tabela ou KPI/Indicadores?
- Há regras de negócio específicas?
- Existe ambiguidade na solicitação?
- Você quer um resumo ou uma análise detalhada?
Adotar essa perspectiva inversa,pensar como a CIA do BI CIGAM,ajuda a refinar seus prompts com mais precisão e eficiência. Com o tempo, você vai aprimorando a criação de prompts na aplicação, que passa a responder cada vez melhor às demandas do seu negócio, à medida que se adapta as necessidades da empresa.
Assistente Virtual CIGAM | Chatbot WIKI | Dúvidas Integração CIA do BI CIGAM
- 💡 DICA: Temos a documentação completa conforme apresentado, mas caso tenha ficado alguma dúvida, você pode também utilizar o chatbot da WIKI, perguntando conforme o contexto desejado, em: Chatbot da Wiki
- Ao fazer o questionamento neste chat, além de apresentar uma resposta, irá referenciar materiais relacionados a este assunto,com materiais complementares.
Exemplo Prático:
Pergunta:Eu posso compartilhar o dashboard que criei através da Integração com a CIA do BI CIGAM?
Resposta chatbot WIKI CIGAM:"A criação de dashboards através da CIA do BI CIGAM deve ser realizada exclusivamente pela aplicação do BI WEB. Para gerar um link de Dashboard no BI CIGAM, é necessário que a criação seja feita na aplicação web, pois é preciso ter uma URL."
Referências que o chatbot trouxe na resposta: Link desta documentação e FAQ sobre compartilhamento de dashboard:














