CIGAM WIKI - Contribuições do usuário [pt-br]

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-10-30T14:51:48Z

Roger.schneider: /* Recurso Analisar com a Cia */

{{VoltarPagina}}
 
[[categoria:Como_Fazer_Utilidades/Diversos]]
[[categoria:Como_Fazer_Utilidades/Diversos_6]]
[[MediaWiki:Como_Fazer_sidebar|Como Fazer]] > [[Como_Fazer_Utilidades/Diversos|Utilidades/Diversos]] > [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer - Uso da Cia - IA do CIGAM]]

=Recursos, configurações e segurança=
A Cia - IA do CIGAM oferece diversas funcionalidades e atua como um hub centralizador para os recursos de inteligência artificial utilizados nas soluções CIGAM. Para garantir o correto funcionamento desses recursos, é necessário verificar se os pré-requisitos e as configurações foram realizados adequadamente. Para mais informações, consulte: [[GE - Como Fazer - Configuração da Cia IA do CIGAM|Como Fazer configuração da Cia IA do CIGAM]]
 
Todas as soluções de IA do CIGAM são integradas por meio dos serviços da Cia. A Cia possui integração com diferentes provedores de IA de terceiros, como OpenAI, Google, Anthropic, entre outros. Essas integrações são realizadas por meio de contas e serviços contratados, com condições de uso que asseguram que os dados trafegados não sejam utilizados para treinamento dos modelos, identificação de origem, publicidade, anúncios ou qualquer outra finalidade não prevista.
 
No caso de IAs open-source integradas à Cia, os modelos são executados dentro dos domínios da CIGAM, mantendo as mesmas premissas aplicadas às IAs contratadas: não utilização dos dados para treinamento de modelos, não identificação da origem das informações e ausência de retenção dos dados processados.
 
Além disso, sempre que houver envio explícito de dados pelo usuário por meio das funcionalidades da Cia disponíveis nas soluções CIGAM, será apresentado um diálogo de confirmação, permitindo que o usuário aceite o envio dessas informações. Os dados enviados serão tratados conforme as mesmas diretrizes de segurança, privacidade e não retenção descritas anteriormente.
 
Esta documentação apresenta o uso da Cia e está organizada conforme a forma de acesso: [[#Cia Web (SaaS)|Cia Web (SaaS)]], [[#Portais|Portais]] e [[#Desktop|Desktop]].
 
Caso tenha dúvidas sobre onde encontrar a Cia em cada uma dessas plataformas, ou sobre quais ferramentas do CIGAM possuem recursos integrados a ela, consulte a documentação específica de acesso: [[GE - Como Fazer - Cia - Como acessar|Como Fazer - Cia - Como acessar]]
{{VoltarInicio}}

=Cia Web (SaaS)=
A Cia Web é a aplicação web que centraliza todas as funcionalidades da Cia. Ela pode ser acessada diretamente pelo navegador do seu computador ou dispositivo móvel, ou ainda a partir do Desktop e dos Portais, sem a necessidade de novo login.
 

<center><youtube>https://youtu.be/DFGtRtPF75A</youtube></center>
 

==Primeiro acesso==
A Cia Web pode ser acessada diretamente pelo navegador, utilizando o seguinte endereço: https://services.cigam.cloud/cia/index.html
 
'''Importante:''' o usuário que for realizar o login precisa ter a autenticação em duas etapas habilitada. Para saber como configurá-la, consulte: [[GE - Como Fazer - Configuração da Cia IA do CIGAM#Autenticação em duas etapas e configurações de envio de e-mail|Autenticação em duas etapas e configurações de envio de e-mail]]
 
Ao acessar pelo endereço, será necessário preencher algumas informações para que a Cia consiga validar seu acesso e consultar seus dados: 
* Informar a API do seu CIGAM Server, para garantir o direcionamento correto da base de dados. 

[[Imagem:CiaAPI.png|semmoldura|center|700px]] 

* Informar usuário e senha de login e seu código de verificação: 

[[Imagem:CiaLogin.png|semmoldura|center|700px]]
 
[[Imagem:CiaCodVerif.png|semmoldura|center|700px]] 

* Caso não queira aguardar ou informar o código de verificação, você pode optar por responder à pergunta secreta, clicando no botão “Pergunta Secreta” exibido na imagem acima. 

[[Imagem:CiaLoginA2F.png|semmoldura|center|700px]]
 

==Conhecendo a tela da Cia==
Após realizar o login, a Cia carregará automaticamente as informações e dados necessários do ambiente e será iniciada no assunto '''#Geral''', identificado pelo botão localizado à esquerda da caixa de texto.

[[Imagem:CiaGeral.png|semmoldura|center|700px]]
 
Ao clicar nesse botão, será exibida uma lista com todos os assuntos disponíveis, permitindo que você selecione aquele com o qual deseja interagir. 
Além disso, você pode digitar diretamente na caixa de texto o '''#Assunto''' que deseja utilizar, e a Cia entenderá automaticamente o tema da sua mensagem. 
Também é possível '''formular uma pergunta seguida de um #Assunto''' para interagir com qualquer assunto, mesmo que ele não esteja selecionado no momento.

[[Imagem:CiaAberta.png|semmoldura|center|700px]]
 
Ao selecionar um assunto, serão exibidas automaticamente dicas e sugestões sobre o tema escolhido, além de exemplos clicáveis que, ao serem selecionados, são processados de forma imediata. 
Além disso, ao digitar um ponto de interrogação (?) na caixa de texto, será exibida uma lista com todas as interações disponíveis para o assunto selecionado, facilitando a descoberta de comandos e possibilidades de uso.

[[Imagem:CiaDicas.png|semmoldura|center|700px]]
 
Outra funcionalidade prática é a possibilidade de reenviar perguntas já feitas no chat. Para isso, basta posicionar o mouse sobre a pergunta desejada e clicar no ícone de “Reenviar”. Ao passar o mouse sobre a mensagem, também será exibido o horário de envio.
 
[[Imagem:CiaReenviar.png|semmoldura|center|400px]]
 
Além disso, você pode utilizar as setas do teclado (⬆️ para cima e ⬇️ para baixo) na caixa de texto para navegar pelas últimas perguntas enviadas para o #Assunto selecionado, facilitando o reuso de interações anteriores.

===Ícones da caixa de texto===
Na caixa de texto, você encontrará alguns ícones com as seguintes funções:

<center>
{| class="wikitable"
|-
! !! Ação
|-
|center|[[Imagem:CiaUltPerg.png]] || '''Histórico de Perguntas''' – Ao clicar, é exibido o histórico das perguntas já realizadas para o assunto selecionado.
|-
|center|[[Imagem:CiaEnviar.png]] || '''Enviar''' – Envia o conteúdo digitado na caixa de texto.
|-
|center|[[Imagem:CiaFala.png]] || '''Falar''' – Permite falar ao invés de digitar, usando o recurso de voz.
|-
|center|[[Imagem:CiaExpandir.png]] || '''Expandir''' – Aumenta a altura da caixa de texto para facilitar a digitação de mensagens longas.
|-
|center|[[Imagem:CiaRecolher.png]] || '''Recolher''' – Reduz a caixa de texto ao tamanho padrão.
|}
</center>
{{VoltarInicio}}

==Assuntos disponíveis==

===Geral===
Nesse assunto, é possível conversar livremente com a Cia sobre qualquer um dos assuntos disponíveis. Se encontrar dificuldades para obter a resposta desejada, experimente selecionar um assunto específico, o que pode gerar resultados mais precisos. 
Se houver muitas respostas correspondentes, a Cia não executará nenhuma automaticamente. Em vez disso, exibirá uma opção com os valores possíveis, permitindo que você selecione manualmente a melhor alternativa.

[[Imagem:CiaGeralOpcoes.png|semmoldura|center|700px]]
 
Caso a Cia encontre uma resposta com confiança significativamente maior que as demais, ela será executada automaticamente.
 
No entanto, se você selecionar a opção “Não era bem isso o que eu queria”, a Cia exibirá outras opções relacionadas ao que foi solicitado, apresentando também um indicador de semáforo com a porcentagem de confiança de cada alternativa.

[[Imagem:CiaGeralOpcaoCerta.png|semmoldura|center|600px]]

===Ajuda, Vídeos e Auditor===
Conheça melhor o ERP com a ajuda da Wiki e Cia, assista vídeos sobre o CIGAM e audite seu ambiente.

====Ajuda====
Nesse assunto, você pode acessar o Chatbot da assistente virtual, onde você pode tirar dúvidas e consultar conteúdos da CIGAM Wiki enviando perguntas diretamente nela. 
 
'''Importante:''' neste assunto, a Cia atua dedicada à Wiki, focada exclusivamente nos conteúdos da documentação. As demais funcionalidades e atalhos da Cia não estarão disponíveis nesse contexto.

====Vídeos====
Nesse assunto, é possível procurar por vídeos relacionados ao tema desejado. O resultado será apresentado em forma de lista, contendo os vídeos encontrados e os tempos exatos em que o assunto começa a ser abordado, de acordo com o termo ou palavra pesquisada.

====Auditor====
Neste assunto, é possível verificar o status do sistema e identificar possíveis problemas ou inconsistências. O resultado será exibido em forma de tabela, contendo os dados retornados para facilitar a análise.

===Painéis BI, Portais e Relatórios===
Explore dashboards do BI, interaja com Portais intuitivos e execute relatórios personalizados.

====Painéis BI====
Nesse assunto, é possível abrir dashboards do BI já configurados para o usuário, permitindo sua visualização diretamente na tela.
Ao abrir um dashboard, você também pode interagir com ele, solicitando inserção de filtros, dimensões, métricas, transformações e outros ajustes. 
Cada dashboard aberto exibirá uma guia com as “Interações” disponíveis para aquele painel específico.
 
Além disso, ao selecionar o assunto '''#Painéis do BI''', é possível solicitar que a Cia crie um dashboard do zero.
Por exemplo: "Crie um dashboard para ver meu fluxo de caixa". Você pode ainda solicitar que métricas, dimensões e filtros sejam adicionados durante a criação, ou pedir dashboards separados por áreas.
 
'''Importante:''' caso o usuário não possua acesso ao BI ou este não esteja implementado na base de dados, será exibida uma mensagem informativa no momento do login na Cia.

====Portais====
Quando este assunto é utilizado, o resultado será sempre a abertura de uma tela dos Portais, permitindo ao usuário acessar diretamente os conteúdos e funcionalidades disponíveis nesse ambiente.
 
Essa abertura é feita de forma integrada, garantindo uma navegação contínua entre a Cia e os Portais, sem necessidade de realizar novo login ou sair da plataforma.

====Relatórios====
Ao utilizar esse assunto, será exibida uma tela para preenchimento de filtros, permitindo a emissão de relatórios web.
 
Para que essa funcionalidade opere corretamente, é necessário garantir que a instalação da CDN e da Pesquisa Dinâmica no servidor de aplicação esteja configurada de forma adequada.
 
Os relatórios exibidos aqui são os mesmos disponíveis nos Portais CIGAM, portanto é essencial que esses componentes também estejam funcionando corretamente nesses Portais.

===Qual, Faça, Consultar, Listar, Analisar e Insights===
Crie registros, analise informações ou liste dados cadastrados no CIGAM.

====Qual====
Nesse assunto, a Cia vai consultar e processar informações diretamente no ERP, usando os dados e relacionamentos disponíveis no CIGAM, e retornar os resultados em forma de texto para você visualizar.
 
'''Importante:''' nem todas as opções estão liberadas. Para ver quais você pode usar, digite ? na caixa de texto. A Cia vai mostrar uma lista com todos os comandos e funções disponíveis.

====Faça====
Nesse assunto, a Cia sempre fará um processamento no CIGAM e retornará o status do resultado. Por exemplo, você pode solicitar que a Cia crie um alerta ou até mesmo crie uma nova empresa no sistema.
 
'''Dica:''' para saber quais treinamentos ou comandos estão disponíveis, digite ? na caixa de texto. A Cia mostrará uma lista com todas as opções implementadas para você usar.

====Consultar====
Nesse assunto, você poderá fazer consultas de dados para obter listagens de registros, conforme os treinamentos de tabelas disponíveis. O resultado será apresentado em forma de tabela, exibindo os dados retornados. Já existem diversas Views prontas, para que você possa listar informações de forma mais completa e rápida.
 
'''Dica:''' para ver exemplos de consultas já implementadas, digite ? na caixa de texto.

====Listar====
Nesse assunto, você pode montar sua própria consulta de dados, escolhendo os filtros e parâmetros para gerar uma listagem personalizada. Diferente do assunto #Consultar, aqui é possível utilizar qualquer tabela do CIGAM para montar sua consulta, escrevendo em linguagem natural o que deseja buscar.
 
'''Dica:''' para ver todas as tabelas disponíveis, digite ? na caixa de texto.

====Analisar====
Analise o arquivo selecionado para gerar gráficos interativos e informativos, apresentando insights relevantes que ajudam a identificar tendências, padrões e oportunidades de melhoria.
 
Esse recurso oferece uma visualização clara e intuitiva dos dados, facilitando a interpretação das informações e apoiando a tomada de decisões estratégicas.
 
'''Aviso:''' para utilizar esta funcionalidade, é necessário concordar que os dados enviados serão processados por modelos de IA de terceiros integrados à Cia.

[[Imagem:AnalisarCia.png|semmoldura|center|600px]]

====Insights====
Gere insights inteligentes a partir dos dados de uma consulta, com análises automáticas realizadas pela Cia, que identificam padrões, tendências e possíveis pontos de atenção. Esse recurso ajuda a transformar dados brutos em informações acionáveis, facilitando a tomada de decisões estratégicas e otimizando processos.
 
'''Aviso:''' ao utilizar o assunto “Insights”, você concorda que os dados e informações analisados poderão ser enviados para modelos de IA de terceiros integrados à Cia, exclusivamente para processamento e geração dos resultados apresentados.

===IA Generativa e Pesquisa na Internet===
Converse com a IA sobre assuntos diversos, crie conteúdos e pesquise na internet sobre qualquer coisa.

====IA Generativa====
Nesse assunto, ao interagir com a IA Generativa, você poderá fazer qualquer tipo de pergunta ou solicitação, de forma livre e criativa.
O resultado exibido será exatamente a resposta gerada pela IA, sem complementos da Cia. Você pode, por exemplo, solicitar que a IA melhore ou reformule um texto, crie conteúdos ou resuma informações.
 
'''Importante:''' nesse assunto, a Cia não estará integrada aos serviços e sistemas do CIGAM — a interação é exclusivamente com a IA Generativa.

====Pesquisa na Internet====
Use esse assunto para fazer pesquisas na internet e visualizar os resultados diretamente integrados na Cia, sem precisar sair da plataforma. Você pode pesquisar qualquer tema de interesse e abrir os links retornados para acessar conteúdos, notícias e informações de forma rápida e prática.
{{VoltarInicio}}

===Compartilhamento de Análises da Cia===

 
<div align="justify">
Na Cia Web (SaaS), é possível gerar análises detalhadas de determinadas informações e compartilhá-las. Essa funcionalidade está disponível nos seguintes assuntos: [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Auditor|Auditor]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Analisar|Analisar]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Insights|Insights]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Listar|Listar]] e [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Consultar|Consultar]].
</div>
 

[[Image: opcoesAnalisarCia.png|semmoldura|center|800px]]

 
<div align="justify">
Essa opção está disponível por meio do botão '''Analisar''', exibido junto à resposta apresentada após a solicitação de um desses assuntos.
</div>
 

[[Image: exemploBotaoAnalisar.png|semmoldura|center|800px]]

 
<div align="justify">
Particularmente para o assunto '''Analisar''', a análise já é exibida diretamente, pois essa é a finalidade desse assunto:
</div>
 

[[Image: analiseAnalisar.png|semmoldura|center|800px]]

 
<div align="justify">
Ao gerar uma análise , a página de resultado passa a disponibilizar opções para compartilhar e utilizar o conteúdo gerado. São disponibilizadas três opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.
</div>
 

[[Image: CiaWebAnalise.png|semmoldura|center|800px]]

=====Compartilhamento por e-mail=====

<div align="justify">
Ao selecionar a opção '''E-mail''', é apresentada uma janela para preenchimento das informações necessárias ao envio da análise.
</div>
 

[[Image: CiaWebModalEmail.png|semmoldura|center|800px]]

 
<div align="justify">
Após informar os destinatários e os demais dados da mensagem, basta selecionar '''Enviar'''. A análise gerada será encaminhada como um arquivo em anexo.

Para utilizar esse recurso, o ambiente deve possuir as configurações necessárias para envio de e-mails pelo CIGAM devidamente parametrizadas. Para mais informações, consulte [[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]].
</div>

==Configurações==
O ícone de engrenagem, localizado no canto superior direito da página, reúne recursos de informação e gerenciamento. As opções disponíveis são:
* '''Respostas com áudio:''' quando ativado, as respostas da Cia são narradas em voz alta.
* '''Ambiente atual do CIGAM:''' exibe na tela o usuário logado e o ambiente em uso.
* '''Ver consumo:''' mostra a quantidade de tokens já utilizados e os usuários que geraram consumo.
* '''Limpar dados de navegação:''' exibe uma mensagem explicando como limpar os dados de navegação do navegador.
* '''Limpar cookies:''' apaga os dados armazenados localmente, permitindo informar novamente a API e realizar um novo login.
* '''Instalar aplicativo:''' instala a Cia como aplicativo no dispositivo, criando um atalho na tela inicial.
* '''Documentação na wiki:''' direciona para a documentação da Cia na CIGAM Wiki.
* '''Sair:''' encerra a sessão do usuário, permitindo realizar login com outro usuário.
 
[[Imagem:ConfiguracoesCia.png|semmoldura|center|500px]]
{{VoltarInicio}}

=Portais=
Nos Portais CIGAM, além do acesso à Cia Web pelo menu de mosaico, estão disponíveis recursos de IA que atuam diretamente nas telas em que você está trabalhando. Esses recursos não exigem parametrização e são apresentados de acordo com o contexto da tela. 

==Acesso à Cia Web (SaaS) pelo menu mosaico==
O acesso à Cia Web a partir dos Portais é feito pelo ícone de mosaico, onde está disponível o ícone da Cia - IA do CIGAM. 
 
[[Imagem:mosaicoCia.png|semmoldura|center|800px]]
 
A Cia será aberta de forma integrada, sem a necessidade de novo login, e todas as funcionalidades descritas na seção [[#Cia Web (SaaS)|Cia Web (SaaS)]] estarão disponíveis normalmente. 

==Geração de conteúdo==
Na barra superior dos Portais está disponível um ícone com um menu de contexto que permite interagir com os '''campos de texto''' de qualquer parte dos Portais. As opções disponíveis permitem melhorar textos, criar conteúdos, revisar a gramática, entre outras ações. 
 
[[Imagem:comandosCia.png|semmoldura|center|650px]]
 
A partir da versão '''Beta 260601''', essas opções passaram a ser exibidas em uma seção separada, chamada '''Geração de conteúdo''', apresentada no mesmo menu em que ficam os agentes. 
 
[[Imagem:MenuGeracaoConteudoAgentes.png|semmoldura|center|800px]]
 
O campo processado é sempre o '''último campo em que o cursor esteve posicionado''' antes de abrir o menu da Cia. Por isso, basta clicar no campo desejado e, em seguida, acionar o menu e escolher o comando. 
 
Para que o comando seja executado, o campo precisa ser um '''campo de texto válido''' e conter, no mínimo, '''três palavras'''. Caso contrário, será apresentada uma mensagem informando que o conteúdo não atende aos requisitos. 
 
Após o processamento, o conteúdo gerado é aplicado automaticamente no campo, substituindo o texto anterior, sem necessidade de confirmação. 
 
Essa funcionalidade também está disponível em telas modais, ou seja, janelas sobrepostas com interações: 
 
[[Imagem:comandosModalCia.png|semmoldura|center|800px]]
 

==Agentes==
A partir da versão '''Beta 260601''', o menu da Cia nos Portais passou a disponibilizar também o acesso aos agentes, tanto nos Portais MVC quanto nos Portais React. 
 
Ao abrir o menu da Cia, os agentes disponíveis são detectados automaticamente de acordo com a tela que está sendo acessada, ou seja, as opções apresentadas variam conforme a página aberta. 
 
[[Imagem:MenuAgentesCia.png|semmoldura|center|800px]]
 

===Como os agentes são disponibilizados===
A disponibilização de cada agente pode ocorrer de quatro formas: 
 
* '''Por contexto:''' o agente é apresentado quando a Cia identifica que a tela acessada corresponde ao assunto tratado por ele. Por exemplo, um agente sobre Ordem de Produção será disponibilizado ao acessar uma página cujo contexto seja identificado como Ordem de Produção.
 
* '''Por parâmetro:''' o agente é apresentado quando a Cia identifica, na tela, um parâmetro com o valor esperado por ele. Por exemplo, um agente de Pedidos será disponibilizado quando existir na tela um parâmetro que contenha o código do pedido.
 
* '''Por contexto e parâmetro:''' o agente é apresentado somente quando as duas condições forem atendidas ao mesmo tempo.
 
* '''Sempre disponível:''' o agente é apresentado em qualquer tela, independentemente do contexto ou dos parâmetros.
 

===Resultado do processamento===
Após o processamento, o retorno do agente pode ser apresentado de duas formas, conforme o que foi executado: 
 
* Em uma '''nova guia''' do navegador, quando o agente gera algum conteúdo ou relatório como resultado.
 
[[Imagem:AgentesRetornoGuia.png|semmoldura|center|800px]]
 
* Em uma '''janela modal''', dentro da própria página em que o usuário está, quando o retorno é uma mensagem.
 
[[Imagem:AgentesRetornoModal.png|semmoldura|center|800px]]
 
<div align="justify>
A partir da versão '''Beta 261005''', quando o resultado do agente é apresentado em uma nova guia, a página passa a disponibilizar também opções para utilização e compartilhamento da análise.
</div>
 
[[Imagem:resultadoAnalise.png|semmoldura|center|800px]]
 
<div align="justify">
No cabeçalho são apresentados o nome do agente executado e as opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.
</div>
<div align="justify">
=====Compartilhamento por e-mail=====
A janela abaixo é exibida quando selecionada a opção '''E-mail''':
</div>
 
[[Imagem:modalEmail.png|semmoldura|center|800px]]
 
<div align="justify">

Para utilizar esse recurso, o ambiente deve possuir as configurações necessárias para envio de e-mails pelo CIGAM devidamente parametrizadas. Para mais informações, consulte [[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]].
</div>

==Editor de Agentes==
<div align="justify">
A partir da versão '''Beta 261005''', o menu passou a disponibilizar o acesso à ferramenta '''Editor de Agentes''', que permite criar seus próprios agentes.

 
[[Imagem:EditorAgentesCia.png|semmoldura|center|750px]]
 

Ao clicar na opção, será aberta uma página web e ocorrerá a validação do ambiente e autenticação.

 
[[Imagem:EditorAgentesCiaValidandoAuth.png|semmoldura|center|750px]]
 

Quando não forem identificados uma API e um token válidos, ocorrerá a mensagem de bloqueio à ferramenta.

 
[[Imagem:EditorAgentesCiaBloqueio.png|semmoldura|center|750px]]
 

A página utiliza o formato de assistente (wizard), com cada etapa explicada de forma detalhada. Basta preencher as informações do agente conforme a sua necessidade e avançar pelos passos até a conclusão. Temos a opção de "Abrir" um agente já criado para podermos editar suas informações ou criar um agente do zero.

 
[[Imagem:EditorAgentesCia_logado.png|semmoldura|center|750px]]
 

Na última etapa teremos a opção de "Criar Agente" onde será realizado o download do arquivo.

 
[[Imagem:EditorAgentesWizardBaixar.png|semmoldura|center|750px]]
 

Ao final do processo, será gerado um arquivo com a extensão '''.cgagt''', que contém a definição do agente criado.

{{VoltarInicio}}
</div>
===Disponibilizando o agente criado===
<div align="justify">
Para que o agente passe a ser exibido nos Portais, o arquivo '''.cgagt''' precisa ser colocado na aplicação da API, dentro da pasta raiz da aplicação. 
 
É necessário que existam as pastas '''Exclusivo''' e, dentro dela, '''Agentes'''. Caso não existam, elas devem ser criadas manualmente. O arquivo deve ser colocado dentro dessa estrutura, ficando da seguinte forma: 
 
/api/exclusivo/agentes/
 
Assim que o arquivo é adicionado nesse local, a Cia passa a reconhecer o agente automaticamente, sem necessidade de qualquer outra configuração. Os agentes customizados são exibidos no menu da Cia nos Portais, em uma seção separada dos agentes padrão. 
 
[[Imagem:MenuAgentesCustomizados.png|semmoldura|center|800px]]
 
{{VoltarInicio}}
</div>

==Conversar com documentos==
<div align="justify">
A ferramenta de '''Conversar com documentos''' permite analisar, resumir e cruzar informações contidas em arquivos e relatórios através de modelos avançados de Inteligência Artificial integrados ao ERP CIGAM.

O acesso pode ser realizado a partir da tela principal da Cia Web (SaaS), clicando na opção correspondente ou digitando o assunto <code>#Documentos</code>, momento em que a aplicação é aberta em uma nova guia do navegador assim que digitada a primeira mensagem.

Além disto, podemos acessar a aplicação através dos Portais CIGAM, conforme descrito em [[GE_-_Como_Fazer_-_Cia_-_Como_acessar#Conversar_com_documentos|Como acessar]].

Para a utilização da aplicação, é necessário estar autenticado com um token de autorização CIGAM e com o endereço da API CIGAM devidamente parametrizado. Logo ao abrir, o sistema avalia o ambiente e valida a sessão do usuário.

Estando os parâmetros validados, será gerado automaticamente um ID de conversação (''Conversation ID'') exclusivo para a sessão. Esta identificação é armazenada em cookies do navegador com validade de 24 horas, permitindo que a Cia armazene e mantenha o contexto contínuo de todas as mensagens e documentos anexados. Caso a página seja atualizada ou fechada dentro deste período, a sessão conectada e os arquivos são recuperados automaticamente.

 
<center>[[Arquivo:cia_conv_docs_01.png|nenhum|750px]]</center>
 

No primeiro acesso, é obrigatório marcar a opção '''Termo de consentimento''' para indicar ciência de que os dados e documentos selecionados para análise serão enviados aos modelos de IA de terceiros integrados com a Cia. Por segurança e conformidade, os campos de envio e a área de anexos permanecem bloqueados até que o consentimento seja confirmado. Uma vez aceito, uma mensagem de registro é inserida no histórico da conversa e a preferência é memorizada para a sessão.

Após confirmar o termo, a área de upload no painel lateral esquerdo é habilitada, permitindo anexar múltiplos arquivos simultaneamente, seja arrastando e soltando os documentos sobre a área de dropzone, seja clicando sobre ela para abrir a janela de seleção de arquivos.

A ferramenta suporta uma ampla variedade de formatos corporativos:
*'''Documentos de Texto e Portáteis:''' PDF (<code>.pdf</code>), Texto Simples (<code>.txt</code>), Word (<code>.doc</code>, <code>.docx</code>).
*'''Planilhas e Dados Tabulares:''' Planilhas Excel (<code>.xlsx</code>, <code>.xls</code>), Valores Separados por Vírgula (<code>.csv</code>).
*'''Arquivos de Estrutura de Dados:''' Arquivos <code>.json</code> e <code>.xml</code>.

No painel lateral, é possível visualizar o contador total de documentos anexados, o ícone específico do formato, o nome, o tamanho do arquivo formatado e a indicação de que o documento encontra-se ativo no contexto da conversa. Em dispositivos móveis ou telas menores, o painel lateral pode ser recolhido ou expandido através do botão retrátil no topo da barra.

Uma vez enviados para análise, os documentos permanecem registrados no contexto da conversa no servidor, não sendo necessário reenviá-los a cada nova pergunta. Caso deseje remover os arquivos analisados, deve-se reiniciar o contexto através da opção de limpeza da conversa.

*'''Limpar conversa:''' Permite reiniciar o contexto da conversa. Ao acionar esta opção, um balão interativo de confirmação é apresentado no histórico do chat (com as opções ''Limpar Conversa'' ou ''Cancelar''). Ao confirmar, o sistema solicita a exclusão da conversa no serviço da OpenAI para evitar registros órfãos, remove os documentos e cookies locais e gera um novo ID de conversação limpo.

 
<center>[[Arquivo:cia_conv_docs_02.png|nenhum|750px]]</center>
 

Clicando no ícone da engrenagem localizado no canto superior direito da tela, temos acesso ao menu de opções e configurações da ferramenta:

*'''Provedor de IA:''' Permite selecionar o provedor de Inteligência Artificial. Atualmente está fixa a opção da OpenAI.
*'''Modelo de IA:''' Permite selecionar o modelo de Inteligência Artificial desejado para o processamento documental (ex.: GPT-5.4, GPT-5.4 Mini, GPT-5.2, GPT-5.1). A lista de modelos é atualizada dinamicamente a partir dos serviços disponíveis na Cia.
*'''Usuário Conectado:''' Exibe os dados do usuário autenticado no ERP CIGAM, incluindo nome, empresa (razão social / fantasia) e código de usuário.
*'''Ambiente & Sessão CIGAM:''' Apresenta o tipo de ambiente (produção ou depuração) e a URL da API CIGAM conectada, acompanhado de um botão de cópia rápida para facilitar diagnósticos e solicitações de suporte técnico.
*'''ID da Conversa Ativa:''' Exibe o identificador único da sessão com indicador visual de status em tempo real e botão para copiar o código do ID diretamente para a área de transferência.

*'''Documentação na wiki:''' Atalho que direciona diretamente aos manuais e guias de uso na CIGAM Wiki.

 
<center>[[Arquivo:cia_conv_docs_03.png|nenhum|750px]]</center>
 

Com os documentos anexados, podemos enviar perguntas e comandos no campo inferior para obter resumos executivos, explicações pontuais, cruzamento de dados entre arquivos distintos, localização de inconsistências ou extração de indicadores. Caso enviemos os arquivos sem digitar nenhuma mensagem complementar, a Cia aplicará o prompt de sistema padrão para realizar uma leitura analítica e retornar um resumo estruturado dos documentos.

O sistema dispõe de diretrizes de sistema corporativas (''System Prompt'') integradas ao ecossistema do ERP CIGAM, orientando o modelo a analisar com fidelidade os dados fornecidos, sem inventar informações ausentes.

Também é disponibilizado o recurso de '''Reconhecimento de Voz''' através do ícone de microfone (habilitado em conexões seguras HTTPS). O recurso conta com reconhecimento inteligente de pontuação falada: ao ditar expressões como ''"vírgula"'', ''"ponto"'', ''"ponto e vírgula"'', ''"dois pontos"'', ''"interrogação"'', ''"exclamação"'', ''"hífen"'', ''"abre parênteses"'', ''"fecha parênteses"'' ou ''"nova linha"'', os termos são automaticamente substituídos pelos respectivos sinais gráficos e as frases são capitalizadas de forma automática.

 
<center>[[Arquivo:cia_conv_docs_04.png|nenhum|750px]]</center>
 

As respostas retornadas pela Cia contam com formatação Markdown avançada, estruturando o conteúdo em títulos hierárquicos, listas ordenadas ou em tópicos, citações em bloco e tabelas responsivas estilizadas.

Além disso, sempre que a análise envolver dados numéricos comparativos, demonstrativos contábeis/financeiros (como DRE, receitas e despesas), séries temporais ou valores tabulares, a Cia gera automaticamente gráficos visuais e interativos integrados diretamente na resposta:
*'''Tipos de Gráficos Gerados:''' Barras verticais, linhas de tendência, gráficos de pizza e rosca, estilizados na paleta de cores oficial da Cia e com valores numéricos formatados no padrão brasileiro (pt-BR).
*'''Exportação do Gráfico:''' Cada card de gráfico possui um botão de download no canto superior direito, permitindo baixar a imagem em formato PNG em alta resolução para inclusão imediata em relatórios, apresentações ou envio por e-mail.

 
<center>[[Arquivo:cia_conv_docs_05.png|nenhum|750px]]</center>
 

Podemos manter uma conversa contínua com diversos documentos e mensagens em múltiplos turnos de diálogo. A Cia preserva o histórico de perguntas e respostas anteriores, permitindo aprofundar análises, solicitar detalhamentos de itens específicos ou anexar novos arquivos complementares ao longo da conversa.

</div>
{{VoltarInicio}}

=Desktop=
Na aplicação Desktop, além do acesso rápido à Cia Web, algumas ferramentas do sistema disponibilizam o recurso "Analisar com a Cia". 

==Acesso rápido à Cia Web (SaaS)==
O botão de acesso rápido (Cia - IA do CIGAM), disponível no menu lateral do Desktop, abre a Cia Web de forma integrada ao sistema, em uma janela do próprio CIGAM. 
 
Desde que as configurações necessárias tenham sido aplicadas, conforme [[GE - Como Fazer - Configuração da Cia IA do CIGAM#Acesso rápido à Cia Web (SaaS)|Acesso rápido à Cia Web (SaaS)]], '''todas as funcionalidades da Cia Web estarão disponíveis normalmente''', da mesma forma que no acesso pelo navegador. Para conhecê-las, consulte a seção [[#Cia Web (SaaS)|Cia Web (SaaS)]] desta documentação. 
 
[[Imagem:CiaAbertaDesktop.png|semmoldura|center|800px]]
 

==Recurso Analisar com a Cia==
O recurso '''"Analisar com a Cia"''' está disponível em ferramentas como CGEditor, CGReport, Pesquisa Dinâmica e Dispositivo de Saída. Em todas elas, o comportamento é o mesmo: a Cia analisa o conteúdo que está em uso na tela e gera um relatório com o resultado da análise, apresentado em uma nova página. 
 
'''Importante:''' se o usuário for novo e nunca tiver executado nenhum relatório no CIGAM, é necessário gerar um relatório merge antes de utilizar o recurso pelo '''CGEditor''', pelo '''Visualizador de PDF''' ou pelo '''Dispositivo de Saída'''. Isso grava os arquivos de preferências com as informações necessárias ao funcionamento do recurso. Essa etapa não é necessária para as demais ferramentas, nem para usuários que já executaram relatórios no sistema. 
 
Ao acionar a opção, o fluxo é o seguinte: 
 
'''1. Confirmação dos termos de uso''' 
Antes de qualquer envio, será exibida uma mensagem solicitando que o usuário concorde com o envio das informações para análise. Os dados enviados seguem as diretrizes de segurança, privacidade e não retenção descritas em [[#Recursos, configurações e segurança|Recursos, configurações e segurança]]. 
 
[[Imagem:AnalisarCiaTermos.png|semmoldura|center|500px]]
 
'''2. Complemento do prompt (opcional)''' 
Disponível a partir da patch '''RC 250505.i''' ou da versão '''Beta 251103'''. 
 
Em seguida, será apresentada uma caixa de texto para que o usuário complemente a solicitação, orientando a análise para algum ponto específico. O preenchimento é opcional e pode ser deixado em branco. 
 
Essa caixa de texto serve apenas para complementar o prompt base que a Cia monta automaticamente, e não altera o conteúdo que está sendo enviado. O recurso considera que o usuário já filtrou os dados na própria tela do CIGAM antes de acionar a análise. O prompt base é mantido oculto por ser extenso e técnico, evitando que o usuário precise conferi-lo a cada utilização. 
 
[[Imagem:AnalisarCiaPrompt.png|semmoldura|center|700px]]
 
'''3. Geração do relatório''' 
Após a confirmação, a Cia processa o conteúdo e apresenta o relatório em uma nova página flutuante, com a análise dos dados enviados. 
 
O próprio relatório informa a quantidade de dados que foi analisada, permitindo que o usuário veja o volume aproximado considerado e identifique se o conteúdo enviado corresponde ao que esperava. 
 
[[Imagem:AnalisarCiaRelatorio.png|semmoldura|center|700px]]
 

A partir da versão '''Beta 261005''', o resultado da análise passa a ser apresentado em uma nova janela flutuante, que disponibiliza opções para utilização e compartilhamento do conteúdo gerado. Nessa versão, o recurso está disponível apenas para a '''Pesquisa Dinâmica/Pesquisa Paginada''' e para o '''FastReport'''. A partir da '''RC 270519''', ele também passa a estar disponível para o '''CGEditor''' e o '''Dispositivo de Saída'''. 
 
No cabeçalho dessa janela, são apresentados o título da análise e três opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.

 
[[Imagem:AnalisarCiaDesktopCompartilhar.png|semmoldura|center|800px]]
 

====Compartilhamento por e-mail====
<div align="justify">
Ao selecionar a opção '''E-mail''', é apresentada uma janela para preenchimento das informações necessárias ao envio da análise.

 
[[Imagem:AnalisarCiaDesktopEmail.png|semmoldura|center|700px]]
 

Após informar os destinatários e os demais dados da mensagem, basta selecionar '''Enviar'''. A análise gerada será encaminhada como um arquivo em anexo.

</div>

===Limite de conteúdo enviado===
<div align="justify">
Existe um limite para o volume de conteúdo enviado em cada análise, que varia conforme a versão do ambiente:

* '''150 KB''' — desde a disponibilização do recurso, na versão '''250505.a'''.
* '''3 MB''' — a partir das patches '''250505.i''' e '''251103.a''', e da versão '''RC 260504'''.

Quando o conteúdo selecionado ultrapassa esse limite, a Cia exibe uma mensagem informando o tamanho excedido e a análise não é processada, ou seja, nenhum relatório será gerado.

[[Imagem:AnalisarCiaLimite.png|semmoldura|center|600px]]

'''Esse limite não é parametrizável e não se trata de uma restrição imposta pela CIGAM.''' Ele decorre da própria capacidade dos modelos de IA integrados à Cia, que possuem um limite técnico de volume de dados que conseguem processar em uma única análise. Quando esse volume é ultrapassado, os modelos passam a analisar as informações por amostragem — ou seja, mesmo que fosse permitido enviar uma quantidade maior de dados, o modelo não analisaria todo o conteúdo, e o resultado seria menos preciso. O limite adotado pela Cia acompanha essa característica dos modelos e assegura que a análise seja feita sobre os dados completos.

Além da qualidade da análise, há também a questão do tempo de processamento: quanto maior o volume enviado, maior o tempo de resposta do modelo, tornando a espera inviável para o uso no dia a dia.

Por isso, o recurso foi feito para ser simples e direto: analisar, com um clique, os dados que o usuário já está visualizando pelos meios tradicionais do CIGAM, como grids filtrados e relatórios. Em ambientes com grande volume de dados, a prática recomendada é '''filtrar e consolidar as informações na própria tela antes de acionar a análise''', reduzindo o período ou o escopo consultado. Para análises de períodos maiores, recomenda-se utilizar dados já consolidados, como totalizadores e relatórios sintéticos, em vez de listagens analíticas completas.

A CIGAM está trabalhando em outras ferramentas que, por processarem os dados de forma diferente, permitirão trabalhar com volumes maiores de informação.

Para saber como acessar o recurso em cada ferramenta, consulte: [[GE - Como Fazer - Cia - Como acessar]]

{{VoltarInicio}}
</div>

=Documentos Relacionados=
[[GE - Como Fazer - Cia - Como acessar]] 
[[GE - Como Fazer - Configuração da Cia IA do CIGAM]]

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-10-30T14:48:06Z

Roger.schneider: /* Recurso Analisar com a Cia */

{{VoltarPagina}}
 
[[categoria:Como_Fazer_Utilidades/Diversos]]
[[categoria:Como_Fazer_Utilidades/Diversos_6]]
[[MediaWiki:Como_Fazer_sidebar|Como Fazer]] > [[Como_Fazer_Utilidades/Diversos|Utilidades/Diversos]] > [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer - Uso da Cia - IA do CIGAM]]

=Recursos, configurações e segurança=
A Cia - IA do CIGAM oferece diversas funcionalidades e atua como um hub centralizador para os recursos de inteligência artificial utilizados nas soluções CIGAM. Para garantir o correto funcionamento desses recursos, é necessário verificar se os pré-requisitos e as configurações foram realizados adequadamente. Para mais informações, consulte: [[GE - Como Fazer - Configuração da Cia IA do CIGAM|Como Fazer configuração da Cia IA do CIGAM]]
 
Todas as soluções de IA do CIGAM são integradas por meio dos serviços da Cia. A Cia possui integração com diferentes provedores de IA de terceiros, como OpenAI, Google, Anthropic, entre outros. Essas integrações são realizadas por meio de contas e serviços contratados, com condições de uso que asseguram que os dados trafegados não sejam utilizados para treinamento dos modelos, identificação de origem, publicidade, anúncios ou qualquer outra finalidade não prevista.
 
No caso de IAs open-source integradas à Cia, os modelos são executados dentro dos domínios da CIGAM, mantendo as mesmas premissas aplicadas às IAs contratadas: não utilização dos dados para treinamento de modelos, não identificação da origem das informações e ausência de retenção dos dados processados.
 
Além disso, sempre que houver envio explícito de dados pelo usuário por meio das funcionalidades da Cia disponíveis nas soluções CIGAM, será apresentado um diálogo de confirmação, permitindo que o usuário aceite o envio dessas informações. Os dados enviados serão tratados conforme as mesmas diretrizes de segurança, privacidade e não retenção descritas anteriormente.
 
Esta documentação apresenta o uso da Cia e está organizada conforme a forma de acesso: [[#Cia Web (SaaS)|Cia Web (SaaS)]], [[#Portais|Portais]] e [[#Desktop|Desktop]].
 
Caso tenha dúvidas sobre onde encontrar a Cia em cada uma dessas plataformas, ou sobre quais ferramentas do CIGAM possuem recursos integrados a ela, consulte a documentação específica de acesso: [[GE - Como Fazer - Cia - Como acessar|Como Fazer - Cia - Como acessar]]
{{VoltarInicio}}

=Cia Web (SaaS)=
A Cia Web é a aplicação web que centraliza todas as funcionalidades da Cia. Ela pode ser acessada diretamente pelo navegador do seu computador ou dispositivo móvel, ou ainda a partir do Desktop e dos Portais, sem a necessidade de novo login.
 

<center><youtube>https://youtu.be/DFGtRtPF75A</youtube></center>
 

==Primeiro acesso==
A Cia Web pode ser acessada diretamente pelo navegador, utilizando o seguinte endereço: https://services.cigam.cloud/cia/index.html
 
'''Importante:''' o usuário que for realizar o login precisa ter a autenticação em duas etapas habilitada. Para saber como configurá-la, consulte: [[GE - Como Fazer - Configuração da Cia IA do CIGAM#Autenticação em duas etapas e configurações de envio de e-mail|Autenticação em duas etapas e configurações de envio de e-mail]]
 
Ao acessar pelo endereço, será necessário preencher algumas informações para que a Cia consiga validar seu acesso e consultar seus dados: 
* Informar a API do seu CIGAM Server, para garantir o direcionamento correto da base de dados. 

[[Imagem:CiaAPI.png|semmoldura|center|700px]] 

* Informar usuário e senha de login e seu código de verificação: 

[[Imagem:CiaLogin.png|semmoldura|center|700px]]
 
[[Imagem:CiaCodVerif.png|semmoldura|center|700px]] 

* Caso não queira aguardar ou informar o código de verificação, você pode optar por responder à pergunta secreta, clicando no botão “Pergunta Secreta” exibido na imagem acima. 

[[Imagem:CiaLoginA2F.png|semmoldura|center|700px]]
 

==Conhecendo a tela da Cia==
Após realizar o login, a Cia carregará automaticamente as informações e dados necessários do ambiente e será iniciada no assunto '''#Geral''', identificado pelo botão localizado à esquerda da caixa de texto.

[[Imagem:CiaGeral.png|semmoldura|center|700px]]
 
Ao clicar nesse botão, será exibida uma lista com todos os assuntos disponíveis, permitindo que você selecione aquele com o qual deseja interagir. 
Além disso, você pode digitar diretamente na caixa de texto o '''#Assunto''' que deseja utilizar, e a Cia entenderá automaticamente o tema da sua mensagem. 
Também é possível '''formular uma pergunta seguida de um #Assunto''' para interagir com qualquer assunto, mesmo que ele não esteja selecionado no momento.

[[Imagem:CiaAberta.png|semmoldura|center|700px]]
 
Ao selecionar um assunto, serão exibidas automaticamente dicas e sugestões sobre o tema escolhido, além de exemplos clicáveis que, ao serem selecionados, são processados de forma imediata. 
Além disso, ao digitar um ponto de interrogação (?) na caixa de texto, será exibida uma lista com todas as interações disponíveis para o assunto selecionado, facilitando a descoberta de comandos e possibilidades de uso.

[[Imagem:CiaDicas.png|semmoldura|center|700px]]
 
Outra funcionalidade prática é a possibilidade de reenviar perguntas já feitas no chat. Para isso, basta posicionar o mouse sobre a pergunta desejada e clicar no ícone de “Reenviar”. Ao passar o mouse sobre a mensagem, também será exibido o horário de envio.
 
[[Imagem:CiaReenviar.png|semmoldura|center|400px]]
 
Além disso, você pode utilizar as setas do teclado (⬆️ para cima e ⬇️ para baixo) na caixa de texto para navegar pelas últimas perguntas enviadas para o #Assunto selecionado, facilitando o reuso de interações anteriores.

===Ícones da caixa de texto===
Na caixa de texto, você encontrará alguns ícones com as seguintes funções:

<center>
{| class="wikitable"
|-
! !! Ação
|-
|center|[[Imagem:CiaUltPerg.png]] || '''Histórico de Perguntas''' – Ao clicar, é exibido o histórico das perguntas já realizadas para o assunto selecionado.
|-
|center|[[Imagem:CiaEnviar.png]] || '''Enviar''' – Envia o conteúdo digitado na caixa de texto.
|-
|center|[[Imagem:CiaFala.png]] || '''Falar''' – Permite falar ao invés de digitar, usando o recurso de voz.
|-
|center|[[Imagem:CiaExpandir.png]] || '''Expandir''' – Aumenta a altura da caixa de texto para facilitar a digitação de mensagens longas.
|-
|center|[[Imagem:CiaRecolher.png]] || '''Recolher''' – Reduz a caixa de texto ao tamanho padrão.
|}
</center>
{{VoltarInicio}}

==Assuntos disponíveis==

===Geral===
Nesse assunto, é possível conversar livremente com a Cia sobre qualquer um dos assuntos disponíveis. Se encontrar dificuldades para obter a resposta desejada, experimente selecionar um assunto específico, o que pode gerar resultados mais precisos. 
Se houver muitas respostas correspondentes, a Cia não executará nenhuma automaticamente. Em vez disso, exibirá uma opção com os valores possíveis, permitindo que você selecione manualmente a melhor alternativa.

[[Imagem:CiaGeralOpcoes.png|semmoldura|center|700px]]
 
Caso a Cia encontre uma resposta com confiança significativamente maior que as demais, ela será executada automaticamente.
 
No entanto, se você selecionar a opção “Não era bem isso o que eu queria”, a Cia exibirá outras opções relacionadas ao que foi solicitado, apresentando também um indicador de semáforo com a porcentagem de confiança de cada alternativa.

[[Imagem:CiaGeralOpcaoCerta.png|semmoldura|center|600px]]

===Ajuda, Vídeos e Auditor===
Conheça melhor o ERP com a ajuda da Wiki e Cia, assista vídeos sobre o CIGAM e audite seu ambiente.

====Ajuda====
Nesse assunto, você pode acessar o Chatbot da assistente virtual, onde você pode tirar dúvidas e consultar conteúdos da CIGAM Wiki enviando perguntas diretamente nela. 
 
'''Importante:''' neste assunto, a Cia atua dedicada à Wiki, focada exclusivamente nos conteúdos da documentação. As demais funcionalidades e atalhos da Cia não estarão disponíveis nesse contexto.

====Vídeos====
Nesse assunto, é possível procurar por vídeos relacionados ao tema desejado. O resultado será apresentado em forma de lista, contendo os vídeos encontrados e os tempos exatos em que o assunto começa a ser abordado, de acordo com o termo ou palavra pesquisada.

====Auditor====
Neste assunto, é possível verificar o status do sistema e identificar possíveis problemas ou inconsistências. O resultado será exibido em forma de tabela, contendo os dados retornados para facilitar a análise.

===Painéis BI, Portais e Relatórios===
Explore dashboards do BI, interaja com Portais intuitivos e execute relatórios personalizados.

====Painéis BI====
Nesse assunto, é possível abrir dashboards do BI já configurados para o usuário, permitindo sua visualização diretamente na tela.
Ao abrir um dashboard, você também pode interagir com ele, solicitando inserção de filtros, dimensões, métricas, transformações e outros ajustes. 
Cada dashboard aberto exibirá uma guia com as “Interações” disponíveis para aquele painel específico.
 
Além disso, ao selecionar o assunto '''#Painéis do BI''', é possível solicitar que a Cia crie um dashboard do zero.
Por exemplo: "Crie um dashboard para ver meu fluxo de caixa". Você pode ainda solicitar que métricas, dimensões e filtros sejam adicionados durante a criação, ou pedir dashboards separados por áreas.
 
'''Importante:''' caso o usuário não possua acesso ao BI ou este não esteja implementado na base de dados, será exibida uma mensagem informativa no momento do login na Cia.

====Portais====
Quando este assunto é utilizado, o resultado será sempre a abertura de uma tela dos Portais, permitindo ao usuário acessar diretamente os conteúdos e funcionalidades disponíveis nesse ambiente.
 
Essa abertura é feita de forma integrada, garantindo uma navegação contínua entre a Cia e os Portais, sem necessidade de realizar novo login ou sair da plataforma.

====Relatórios====
Ao utilizar esse assunto, será exibida uma tela para preenchimento de filtros, permitindo a emissão de relatórios web.
 
Para que essa funcionalidade opere corretamente, é necessário garantir que a instalação da CDN e da Pesquisa Dinâmica no servidor de aplicação esteja configurada de forma adequada.
 
Os relatórios exibidos aqui são os mesmos disponíveis nos Portais CIGAM, portanto é essencial que esses componentes também estejam funcionando corretamente nesses Portais.

===Qual, Faça, Consultar, Listar, Analisar e Insights===
Crie registros, analise informações ou liste dados cadastrados no CIGAM.

====Qual====
Nesse assunto, a Cia vai consultar e processar informações diretamente no ERP, usando os dados e relacionamentos disponíveis no CIGAM, e retornar os resultados em forma de texto para você visualizar.
 
'''Importante:''' nem todas as opções estão liberadas. Para ver quais você pode usar, digite ? na caixa de texto. A Cia vai mostrar uma lista com todos os comandos e funções disponíveis.

====Faça====
Nesse assunto, a Cia sempre fará um processamento no CIGAM e retornará o status do resultado. Por exemplo, você pode solicitar que a Cia crie um alerta ou até mesmo crie uma nova empresa no sistema.
 
'''Dica:''' para saber quais treinamentos ou comandos estão disponíveis, digite ? na caixa de texto. A Cia mostrará uma lista com todas as opções implementadas para você usar.

====Consultar====
Nesse assunto, você poderá fazer consultas de dados para obter listagens de registros, conforme os treinamentos de tabelas disponíveis. O resultado será apresentado em forma de tabela, exibindo os dados retornados. Já existem diversas Views prontas, para que você possa listar informações de forma mais completa e rápida.
 
'''Dica:''' para ver exemplos de consultas já implementadas, digite ? na caixa de texto.

====Listar====
Nesse assunto, você pode montar sua própria consulta de dados, escolhendo os filtros e parâmetros para gerar uma listagem personalizada. Diferente do assunto #Consultar, aqui é possível utilizar qualquer tabela do CIGAM para montar sua consulta, escrevendo em linguagem natural o que deseja buscar.
 
'''Dica:''' para ver todas as tabelas disponíveis, digite ? na caixa de texto.

====Analisar====
Analise o arquivo selecionado para gerar gráficos interativos e informativos, apresentando insights relevantes que ajudam a identificar tendências, padrões e oportunidades de melhoria.
 
Esse recurso oferece uma visualização clara e intuitiva dos dados, facilitando a interpretação das informações e apoiando a tomada de decisões estratégicas.
 
'''Aviso:''' para utilizar esta funcionalidade, é necessário concordar que os dados enviados serão processados por modelos de IA de terceiros integrados à Cia.

[[Imagem:AnalisarCia.png|semmoldura|center|600px]]

====Insights====
Gere insights inteligentes a partir dos dados de uma consulta, com análises automáticas realizadas pela Cia, que identificam padrões, tendências e possíveis pontos de atenção. Esse recurso ajuda a transformar dados brutos em informações acionáveis, facilitando a tomada de decisões estratégicas e otimizando processos.
 
'''Aviso:''' ao utilizar o assunto “Insights”, você concorda que os dados e informações analisados poderão ser enviados para modelos de IA de terceiros integrados à Cia, exclusivamente para processamento e geração dos resultados apresentados.

===IA Generativa e Pesquisa na Internet===
Converse com a IA sobre assuntos diversos, crie conteúdos e pesquise na internet sobre qualquer coisa.

====IA Generativa====
Nesse assunto, ao interagir com a IA Generativa, você poderá fazer qualquer tipo de pergunta ou solicitação, de forma livre e criativa.
O resultado exibido será exatamente a resposta gerada pela IA, sem complementos da Cia. Você pode, por exemplo, solicitar que a IA melhore ou reformule um texto, crie conteúdos ou resuma informações.
 
'''Importante:''' nesse assunto, a Cia não estará integrada aos serviços e sistemas do CIGAM — a interação é exclusivamente com a IA Generativa.

====Pesquisa na Internet====
Use esse assunto para fazer pesquisas na internet e visualizar os resultados diretamente integrados na Cia, sem precisar sair da plataforma. Você pode pesquisar qualquer tema de interesse e abrir os links retornados para acessar conteúdos, notícias e informações de forma rápida e prática.
{{VoltarInicio}}

===Compartilhamento de Análises da Cia===

 
<div align="justify">
Na Cia Web (SaaS), é possível gerar análises detalhadas de determinadas informações e compartilhá-las. Essa funcionalidade está disponível nos seguintes assuntos: [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Auditor|Auditor]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Analisar|Analisar]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Insights|Insights]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Listar|Listar]] e [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Consultar|Consultar]].
</div>
 

[[Image: opcoesAnalisarCia.png|semmoldura|center|800px]]

 
<div align="justify">
Essa opção está disponível por meio do botão '''Analisar''', exibido junto à resposta apresentada após a solicitação de um desses assuntos.
</div>
 

[[Image: exemploBotaoAnalisar.png|semmoldura|center|800px]]

 
<div align="justify">
Particularmente para o assunto '''Analisar''', a análise já é exibida diretamente, pois essa é a finalidade desse assunto:
</div>
 

[[Image: analiseAnalisar.png|semmoldura|center|800px]]

 
<div align="justify">
Ao gerar uma análise , a página de resultado passa a disponibilizar opções para compartilhar e utilizar o conteúdo gerado. São disponibilizadas três opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.
</div>
 

[[Image: CiaWebAnalise.png|semmoldura|center|800px]]

=====Compartilhamento por e-mail=====

<div align="justify">
Ao selecionar a opção '''E-mail''', é apresentada uma janela para preenchimento das informações necessárias ao envio da análise.
</div>
 

[[Image: CiaWebModalEmail.png|semmoldura|center|800px]]

 
<div align="justify">
Após informar os destinatários e os demais dados da mensagem, basta selecionar '''Enviar'''. A análise gerada será encaminhada como um arquivo em anexo.

Para utilizar esse recurso, o ambiente deve possuir as configurações necessárias para envio de e-mails pelo CIGAM devidamente parametrizadas. Para mais informações, consulte [[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]].
</div>

==Configurações==
O ícone de engrenagem, localizado no canto superior direito da página, reúne recursos de informação e gerenciamento. As opções disponíveis são:
* '''Respostas com áudio:''' quando ativado, as respostas da Cia são narradas em voz alta.
* '''Ambiente atual do CIGAM:''' exibe na tela o usuário logado e o ambiente em uso.
* '''Ver consumo:''' mostra a quantidade de tokens já utilizados e os usuários que geraram consumo.
* '''Limpar dados de navegação:''' exibe uma mensagem explicando como limpar os dados de navegação do navegador.
* '''Limpar cookies:''' apaga os dados armazenados localmente, permitindo informar novamente a API e realizar um novo login.
* '''Instalar aplicativo:''' instala a Cia como aplicativo no dispositivo, criando um atalho na tela inicial.
* '''Documentação na wiki:''' direciona para a documentação da Cia na CIGAM Wiki.
* '''Sair:''' encerra a sessão do usuário, permitindo realizar login com outro usuário.
 
[[Imagem:ConfiguracoesCia.png|semmoldura|center|500px]]
{{VoltarInicio}}

=Portais=
Nos Portais CIGAM, além do acesso à Cia Web pelo menu de mosaico, estão disponíveis recursos de IA que atuam diretamente nas telas em que você está trabalhando. Esses recursos não exigem parametrização e são apresentados de acordo com o contexto da tela. 

==Acesso à Cia Web (SaaS) pelo menu mosaico==
O acesso à Cia Web a partir dos Portais é feito pelo ícone de mosaico, onde está disponível o ícone da Cia - IA do CIGAM. 
 
[[Imagem:mosaicoCia.png|semmoldura|center|800px]]
 
A Cia será aberta de forma integrada, sem a necessidade de novo login, e todas as funcionalidades descritas na seção [[#Cia Web (SaaS)|Cia Web (SaaS)]] estarão disponíveis normalmente. 

==Geração de conteúdo==
Na barra superior dos Portais está disponível um ícone com um menu de contexto que permite interagir com os '''campos de texto''' de qualquer parte dos Portais. As opções disponíveis permitem melhorar textos, criar conteúdos, revisar a gramática, entre outras ações. 
 
[[Imagem:comandosCia.png|semmoldura|center|650px]]
 
A partir da versão '''Beta 260601''', essas opções passaram a ser exibidas em uma seção separada, chamada '''Geração de conteúdo''', apresentada no mesmo menu em que ficam os agentes. 
 
[[Imagem:MenuGeracaoConteudoAgentes.png|semmoldura|center|800px]]
 
O campo processado é sempre o '''último campo em que o cursor esteve posicionado''' antes de abrir o menu da Cia. Por isso, basta clicar no campo desejado e, em seguida, acionar o menu e escolher o comando. 
 
Para que o comando seja executado, o campo precisa ser um '''campo de texto válido''' e conter, no mínimo, '''três palavras'''. Caso contrário, será apresentada uma mensagem informando que o conteúdo não atende aos requisitos. 
 
Após o processamento, o conteúdo gerado é aplicado automaticamente no campo, substituindo o texto anterior, sem necessidade de confirmação. 
 
Essa funcionalidade também está disponível em telas modais, ou seja, janelas sobrepostas com interações: 
 
[[Imagem:comandosModalCia.png|semmoldura|center|800px]]
 

==Agentes==
A partir da versão '''Beta 260601''', o menu da Cia nos Portais passou a disponibilizar também o acesso aos agentes, tanto nos Portais MVC quanto nos Portais React. 
 
Ao abrir o menu da Cia, os agentes disponíveis são detectados automaticamente de acordo com a tela que está sendo acessada, ou seja, as opções apresentadas variam conforme a página aberta. 
 
[[Imagem:MenuAgentesCia.png|semmoldura|center|800px]]
 

===Como os agentes são disponibilizados===
A disponibilização de cada agente pode ocorrer de quatro formas: 
 
* '''Por contexto:''' o agente é apresentado quando a Cia identifica que a tela acessada corresponde ao assunto tratado por ele. Por exemplo, um agente sobre Ordem de Produção será disponibilizado ao acessar uma página cujo contexto seja identificado como Ordem de Produção.
 
* '''Por parâmetro:''' o agente é apresentado quando a Cia identifica, na tela, um parâmetro com o valor esperado por ele. Por exemplo, um agente de Pedidos será disponibilizado quando existir na tela um parâmetro que contenha o código do pedido.
 
* '''Por contexto e parâmetro:''' o agente é apresentado somente quando as duas condições forem atendidas ao mesmo tempo.
 
* '''Sempre disponível:''' o agente é apresentado em qualquer tela, independentemente do contexto ou dos parâmetros.
 

===Resultado do processamento===
Após o processamento, o retorno do agente pode ser apresentado de duas formas, conforme o que foi executado: 
 
* Em uma '''nova guia''' do navegador, quando o agente gera algum conteúdo ou relatório como resultado.
 
[[Imagem:AgentesRetornoGuia.png|semmoldura|center|800px]]
 
* Em uma '''janela modal''', dentro da própria página em que o usuário está, quando o retorno é uma mensagem.
 
[[Imagem:AgentesRetornoModal.png|semmoldura|center|800px]]
 
<div align="justify>
A partir da versão '''Beta 261005''', quando o resultado do agente é apresentado em uma nova guia, a página passa a disponibilizar também opções para utilização e compartilhamento da análise.
</div>
 
[[Imagem:resultadoAnalise.png|semmoldura|center|800px]]
 
<div align="justify">
No cabeçalho são apresentados o nome do agente executado e as opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.
</div>
<div align="justify">
=====Compartilhamento por e-mail=====
A janela abaixo é exibida quando selecionada a opção '''E-mail''':
</div>
 
[[Imagem:modalEmail.png|semmoldura|center|800px]]
 
<div align="justify">

Para utilizar esse recurso, o ambiente deve possuir as configurações necessárias para envio de e-mails pelo CIGAM devidamente parametrizadas. Para mais informações, consulte [[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]].
</div>

==Editor de Agentes==
<div align="justify">
A partir da versão '''Beta 261005''', o menu passou a disponibilizar o acesso à ferramenta '''Editor de Agentes''', que permite criar seus próprios agentes.

 
[[Imagem:EditorAgentesCia.png|semmoldura|center|750px]]
 

Ao clicar na opção, será aberta uma página web e ocorrerá a validação do ambiente e autenticação.

 
[[Imagem:EditorAgentesCiaValidandoAuth.png|semmoldura|center|750px]]
 

Quando não forem identificados uma API e um token válidos, ocorrerá a mensagem de bloqueio à ferramenta.

 
[[Imagem:EditorAgentesCiaBloqueio.png|semmoldura|center|750px]]
 

A página utiliza o formato de assistente (wizard), com cada etapa explicada de forma detalhada. Basta preencher as informações do agente conforme a sua necessidade e avançar pelos passos até a conclusão. Temos a opção de "Abrir" um agente já criado para podermos editar suas informações ou criar um agente do zero.

 
[[Imagem:EditorAgentesCia_logado.png|semmoldura|center|750px]]
 

Na última etapa teremos a opção de "Criar Agente" onde será realizado o download do arquivo.

 
[[Imagem:EditorAgentesWizardBaixar.png|semmoldura|center|750px]]
 

Ao final do processo, será gerado um arquivo com a extensão '''.cgagt''', que contém a definição do agente criado.

{{VoltarInicio}}
</div>
===Disponibilizando o agente criado===
<div align="justify">
Para que o agente passe a ser exibido nos Portais, o arquivo '''.cgagt''' precisa ser colocado na aplicação da API, dentro da pasta raiz da aplicação. 
 
É necessário que existam as pastas '''Exclusivo''' e, dentro dela, '''Agentes'''. Caso não existam, elas devem ser criadas manualmente. O arquivo deve ser colocado dentro dessa estrutura, ficando da seguinte forma: 
 
/api/exclusivo/agentes/
 
Assim que o arquivo é adicionado nesse local, a Cia passa a reconhecer o agente automaticamente, sem necessidade de qualquer outra configuração. Os agentes customizados são exibidos no menu da Cia nos Portais, em uma seção separada dos agentes padrão. 
 
[[Imagem:MenuAgentesCustomizados.png|semmoldura|center|800px]]
 
{{VoltarInicio}}
</div>

==Conversar com documentos==
<div align="justify">
A ferramenta de '''Conversar com documentos''' permite analisar, resumir e cruzar informações contidas em arquivos e relatórios através de modelos avançados de Inteligência Artificial integrados ao ERP CIGAM.

O acesso pode ser realizado a partir da tela principal da Cia Web (SaaS), clicando na opção correspondente ou digitando o assunto <code>#Documentos</code>, momento em que a aplicação é aberta em uma nova guia do navegador assim que digitada a primeira mensagem.

Além disto, podemos acessar a aplicação através dos Portais CIGAM, conforme descrito em [[GE_-_Como_Fazer_-_Cia_-_Como_acessar#Conversar_com_documentos|Como acessar]].

Para a utilização da aplicação, é necessário estar autenticado com um token de autorização CIGAM e com o endereço da API CIGAM devidamente parametrizado. Logo ao abrir, o sistema avalia o ambiente e valida a sessão do usuário.

Estando os parâmetros validados, será gerado automaticamente um ID de conversação (''Conversation ID'') exclusivo para a sessão. Esta identificação é armazenada em cookies do navegador com validade de 24 horas, permitindo que a Cia armazene e mantenha o contexto contínuo de todas as mensagens e documentos anexados. Caso a página seja atualizada ou fechada dentro deste período, a sessão conectada e os arquivos são recuperados automaticamente.

 
<center>[[Arquivo:cia_conv_docs_01.png|nenhum|750px]]</center>
 

No primeiro acesso, é obrigatório marcar a opção '''Termo de consentimento''' para indicar ciência de que os dados e documentos selecionados para análise serão enviados aos modelos de IA de terceiros integrados com a Cia. Por segurança e conformidade, os campos de envio e a área de anexos permanecem bloqueados até que o consentimento seja confirmado. Uma vez aceito, uma mensagem de registro é inserida no histórico da conversa e a preferência é memorizada para a sessão.

Após confirmar o termo, a área de upload no painel lateral esquerdo é habilitada, permitindo anexar múltiplos arquivos simultaneamente, seja arrastando e soltando os documentos sobre a área de dropzone, seja clicando sobre ela para abrir a janela de seleção de arquivos.

A ferramenta suporta uma ampla variedade de formatos corporativos:
*'''Documentos de Texto e Portáteis:''' PDF (<code>.pdf</code>), Texto Simples (<code>.txt</code>), Word (<code>.doc</code>, <code>.docx</code>).
*'''Planilhas e Dados Tabulares:''' Planilhas Excel (<code>.xlsx</code>, <code>.xls</code>), Valores Separados por Vírgula (<code>.csv</code>).
*'''Arquivos de Estrutura de Dados:''' Arquivos <code>.json</code> e <code>.xml</code>.

No painel lateral, é possível visualizar o contador total de documentos anexados, o ícone específico do formato, o nome, o tamanho do arquivo formatado e a indicação de que o documento encontra-se ativo no contexto da conversa. Em dispositivos móveis ou telas menores, o painel lateral pode ser recolhido ou expandido através do botão retrátil no topo da barra.

Uma vez enviados para análise, os documentos permanecem registrados no contexto da conversa no servidor, não sendo necessário reenviá-los a cada nova pergunta. Caso deseje remover os arquivos analisados, deve-se reiniciar o contexto através da opção de limpeza da conversa.

*'''Limpar conversa:''' Permite reiniciar o contexto da conversa. Ao acionar esta opção, um balão interativo de confirmação é apresentado no histórico do chat (com as opções ''Limpar Conversa'' ou ''Cancelar''). Ao confirmar, o sistema solicita a exclusão da conversa no serviço da OpenAI para evitar registros órfãos, remove os documentos e cookies locais e gera um novo ID de conversação limpo.

 
<center>[[Arquivo:cia_conv_docs_02.png|nenhum|750px]]</center>
 

Clicando no ícone da engrenagem localizado no canto superior direito da tela, temos acesso ao menu de opções e configurações da ferramenta:

*'''Provedor de IA:''' Permite selecionar o provedor de Inteligência Artificial. Atualmente está fixa a opção da OpenAI.
*'''Modelo de IA:''' Permite selecionar o modelo de Inteligência Artificial desejado para o processamento documental (ex.: GPT-5.4, GPT-5.4 Mini, GPT-5.2, GPT-5.1). A lista de modelos é atualizada dinamicamente a partir dos serviços disponíveis na Cia.
*'''Usuário Conectado:''' Exibe os dados do usuário autenticado no ERP CIGAM, incluindo nome, empresa (razão social / fantasia) e código de usuário.
*'''Ambiente & Sessão CIGAM:''' Apresenta o tipo de ambiente (produção ou depuração) e a URL da API CIGAM conectada, acompanhado de um botão de cópia rápida para facilitar diagnósticos e solicitações de suporte técnico.
*'''ID da Conversa Ativa:''' Exibe o identificador único da sessão com indicador visual de status em tempo real e botão para copiar o código do ID diretamente para a área de transferência.

*'''Documentação na wiki:''' Atalho que direciona diretamente aos manuais e guias de uso na CIGAM Wiki.

 
<center>[[Arquivo:cia_conv_docs_03.png|nenhum|750px]]</center>
 

Com os documentos anexados, podemos enviar perguntas e comandos no campo inferior para obter resumos executivos, explicações pontuais, cruzamento de dados entre arquivos distintos, localização de inconsistências ou extração de indicadores. Caso enviemos os arquivos sem digitar nenhuma mensagem complementar, a Cia aplicará o prompt de sistema padrão para realizar uma leitura analítica e retornar um resumo estruturado dos documentos.

O sistema dispõe de diretrizes de sistema corporativas (''System Prompt'') integradas ao ecossistema do ERP CIGAM, orientando o modelo a analisar com fidelidade os dados fornecidos, sem inventar informações ausentes.

Também é disponibilizado o recurso de '''Reconhecimento de Voz''' através do ícone de microfone (habilitado em conexões seguras HTTPS). O recurso conta com reconhecimento inteligente de pontuação falada: ao ditar expressões como ''"vírgula"'', ''"ponto"'', ''"ponto e vírgula"'', ''"dois pontos"'', ''"interrogação"'', ''"exclamação"'', ''"hífen"'', ''"abre parênteses"'', ''"fecha parênteses"'' ou ''"nova linha"'', os termos são automaticamente substituídos pelos respectivos sinais gráficos e as frases são capitalizadas de forma automática.

 
<center>[[Arquivo:cia_conv_docs_04.png|nenhum|750px]]</center>
 

As respostas retornadas pela Cia contam com formatação Markdown avançada, estruturando o conteúdo em títulos hierárquicos, listas ordenadas ou em tópicos, citações em bloco e tabelas responsivas estilizadas.

Além disso, sempre que a análise envolver dados numéricos comparativos, demonstrativos contábeis/financeiros (como DRE, receitas e despesas), séries temporais ou valores tabulares, a Cia gera automaticamente gráficos visuais e interativos integrados diretamente na resposta:
*'''Tipos de Gráficos Gerados:''' Barras verticais, linhas de tendência, gráficos de pizza e rosca, estilizados na paleta de cores oficial da Cia e com valores numéricos formatados no padrão brasileiro (pt-BR).
*'''Exportação do Gráfico:''' Cada card de gráfico possui um botão de download no canto superior direito, permitindo baixar a imagem em formato PNG em alta resolução para inclusão imediata em relatórios, apresentações ou envio por e-mail.

 
<center>[[Arquivo:cia_conv_docs_05.png|nenhum|750px]]</center>
 

Podemos manter uma conversa contínua com diversos documentos e mensagens em múltiplos turnos de diálogo. A Cia preserva o histórico de perguntas e respostas anteriores, permitindo aprofundar análises, solicitar detalhamentos de itens específicos ou anexar novos arquivos complementares ao longo da conversa.

</div>
{{VoltarInicio}}

=Desktop=
Na aplicação Desktop, além do acesso rápido à Cia Web, algumas ferramentas do sistema disponibilizam o recurso "Analisar com a Cia". 

==Acesso rápido à Cia Web (SaaS)==
O botão de acesso rápido (Cia - IA do CIGAM), disponível no menu lateral do Desktop, abre a Cia Web de forma integrada ao sistema, em uma janela do próprio CIGAM. 
 
Desde que as configurações necessárias tenham sido aplicadas, conforme [[GE - Como Fazer - Configuração da Cia IA do CIGAM#Acesso rápido à Cia Web (SaaS)|Acesso rápido à Cia Web (SaaS)]], '''todas as funcionalidades da Cia Web estarão disponíveis normalmente''', da mesma forma que no acesso pelo navegador. Para conhecê-las, consulte a seção [[#Cia Web (SaaS)|Cia Web (SaaS)]] desta documentação. 
 
[[Imagem:CiaAbertaDesktop.png|semmoldura|center|800px]]
 

==Recurso Analisar com a Cia==
O recurso '''"Analisar com a Cia"''' está disponível em ferramentas como CGEditor, CGReport, Pesquisa Dinâmica e Dispositivo de Saída. Em todas elas, o comportamento é o mesmo: a Cia analisa o conteúdo que está em uso na tela e gera um relatório com o resultado da análise, apresentado em uma nova página. 
 
'''Importante:''' se o usuário for novo e nunca tiver executado nenhum relatório no CIGAM, é necessário gerar um relatório merge antes de utilizar o recurso pelo '''CGEditor''', pelo '''Visualizador de PDF''' ou pelo '''Dispositivo de Saída'''. Isso grava os arquivos de preferências com as informações necessárias ao funcionamento do recurso. Essa etapa não é necessária para as demais ferramentas, nem para usuários que já executaram relatórios no sistema. 
 
Ao acionar a opção, o fluxo é o seguinte: 
 
'''1. Confirmação dos termos de uso''' 
Antes de qualquer envio, será exibida uma mensagem solicitando que o usuário concorde com o envio das informações para análise. Os dados enviados seguem as diretrizes de segurança, privacidade e não retenção descritas em [[#Recursos, configurações e segurança|Recursos, configurações e segurança]]. 
 
[[Imagem:AnalisarCiaTermos.png|semmoldura|center|500px]]
 
'''2. Complemento do prompt (opcional)''' 
Disponível a partir do patch '''RC 250505.i''' ou da versão '''Beta 251103'''. 
 
Em seguida, será apresentada uma caixa de texto para que o usuário complemente a solicitação, orientando a análise para algum ponto específico. O preenchimento é opcional e pode ser deixado em branco. 
 
Essa caixa de texto serve apenas para complementar o prompt base que a Cia monta automaticamente, e não altera o conteúdo que está sendo enviado. O recurso considera que o usuário já filtrou os dados na própria tela do CIGAM antes de acionar a análise. O prompt base é mantido oculto por ser extenso e técnico, evitando que o usuário precise conferi-lo a cada utilização. 
 
[[Imagem:AnalisarCiaPrompt.png|semmoldura|center|700px]]
 
'''3. Geração do relatório''' 
Após a confirmação, a Cia processa o conteúdo e apresenta o relatório em uma nova página flutuante, com a análise dos dados enviados. 
 
O próprio relatório informa a quantidade de dados que foi analisada, permitindo que o usuário veja o volume aproximado considerado e identifique se o conteúdo enviado corresponde ao que esperava. 
 
[[Imagem:AnalisarCiaRelatorio.png|semmoldura|center|700px]]
 

A partir da versão '''Beta 261005''', o resultado da análise passa a ser apresentado em uma nova janela flutuante, que disponibiliza opções para utilização e compartilhamento do conteúdo gerado. Nessa versão, o recurso está disponível apenas para a '''Pesquisa Dinâmica/Pesquisa Paginada''' e para o '''FastReport'''. A partir da '''RC 270519''', ele também passa a estar disponível para o '''CGEditor''' e o '''Dispositivo de Saída'''. 
 
No cabeçalho dessa janela, são apresentados o título da análise e três opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.

 
[[Imagem:AnalisarCiaDesktopCompartilhar.png|semmoldura|center|800px]]
 

====Compartilhamento por e-mail====
<div align="justify">
Ao selecionar a opção '''E-mail''', é apresentada uma janela para preenchimento das informações necessárias ao envio da análise.

 
[[Imagem:AnalisarCiaDesktopEmail.png|semmoldura|center|700px]]
 

Após informar os destinatários e os demais dados da mensagem, basta selecionar '''Enviar'''. A análise gerada será encaminhada como um arquivo em anexo.

</div>

===Limite de conteúdo enviado===
<div align="justify">
Existe um limite para o volume de conteúdo enviado em cada análise, que varia conforme a versão do ambiente:

* '''150 KB''' — desde a disponibilização do recurso, na versão '''250505.a'''.
* '''3 MB''' — a partir das patches '''250505.i''' e '''251103.a''', e da versão '''RC 260504'''.

Quando o conteúdo selecionado ultrapassa esse limite, a Cia exibe uma mensagem informando o tamanho excedido e a análise não é processada, ou seja, nenhum relatório será gerado.

[[Imagem:AnalisarCiaLimite.png|semmoldura|center|600px]]

'''Esse limite não é parametrizável e não se trata de uma restrição imposta pela CIGAM.''' Ele decorre da própria capacidade dos modelos de IA integrados à Cia, que possuem um limite técnico de volume de dados que conseguem processar em uma única análise. Quando esse volume é ultrapassado, os modelos passam a analisar as informações por amostragem — ou seja, mesmo que fosse permitido enviar uma quantidade maior de dados, o modelo não analisaria todo o conteúdo, e o resultado seria menos preciso. O limite adotado pela Cia acompanha essa característica dos modelos e assegura que a análise seja feita sobre os dados completos.

Além da qualidade da análise, há também a questão do tempo de processamento: quanto maior o volume enviado, maior o tempo de resposta do modelo, tornando a espera inviável para o uso no dia a dia.

Por isso, o recurso foi feito para ser simples e direto: analisar, com um clique, os dados que o usuário já está visualizando pelos meios tradicionais do CIGAM, como grids filtrados e relatórios. Em ambientes com grande volume de dados, a prática recomendada é '''filtrar e consolidar as informações na própria tela antes de acionar a análise''', reduzindo o período ou o escopo consultado. Para análises de períodos maiores, recomenda-se utilizar dados já consolidados, como totalizadores e relatórios sintéticos, em vez de listagens analíticas completas.

A CIGAM está trabalhando em outras ferramentas que, por processarem os dados de forma diferente, permitirão trabalhar com volumes maiores de informação.

Para saber como acessar o recurso em cada ferramenta, consulte: [[GE - Como Fazer - Cia - Como acessar]]

{{VoltarInicio}}
</div>

=Documentos Relacionados=
[[GE - Como Fazer - Cia - Como acessar]] 
[[GE - Como Fazer - Configuração da Cia IA do CIGAM]]

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-10-30T14:45:43Z

Roger.schneider: /* Recurso Analisar com a Cia */

{{VoltarPagina}}
 
[[categoria:Como_Fazer_Utilidades/Diversos]]
[[categoria:Como_Fazer_Utilidades/Diversos_6]]
[[MediaWiki:Como_Fazer_sidebar|Como Fazer]] > [[Como_Fazer_Utilidades/Diversos|Utilidades/Diversos]] > [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer - Uso da Cia - IA do CIGAM]]

=Recursos, configurações e segurança=
A Cia - IA do CIGAM oferece diversas funcionalidades e atua como um hub centralizador para os recursos de inteligência artificial utilizados nas soluções CIGAM. Para garantir o correto funcionamento desses recursos, é necessário verificar se os pré-requisitos e as configurações foram realizados adequadamente. Para mais informações, consulte: [[GE - Como Fazer - Configuração da Cia IA do CIGAM|Como Fazer configuração da Cia IA do CIGAM]]
 
Todas as soluções de IA do CIGAM são integradas por meio dos serviços da Cia. A Cia possui integração com diferentes provedores de IA de terceiros, como OpenAI, Google, Anthropic, entre outros. Essas integrações são realizadas por meio de contas e serviços contratados, com condições de uso que asseguram que os dados trafegados não sejam utilizados para treinamento dos modelos, identificação de origem, publicidade, anúncios ou qualquer outra finalidade não prevista.
 
No caso de IAs open-source integradas à Cia, os modelos são executados dentro dos domínios da CIGAM, mantendo as mesmas premissas aplicadas às IAs contratadas: não utilização dos dados para treinamento de modelos, não identificação da origem das informações e ausência de retenção dos dados processados.
 
Além disso, sempre que houver envio explícito de dados pelo usuário por meio das funcionalidades da Cia disponíveis nas soluções CIGAM, será apresentado um diálogo de confirmação, permitindo que o usuário aceite o envio dessas informações. Os dados enviados serão tratados conforme as mesmas diretrizes de segurança, privacidade e não retenção descritas anteriormente.
 
Esta documentação apresenta o uso da Cia e está organizada conforme a forma de acesso: [[#Cia Web (SaaS)|Cia Web (SaaS)]], [[#Portais|Portais]] e [[#Desktop|Desktop]].
 
Caso tenha dúvidas sobre onde encontrar a Cia em cada uma dessas plataformas, ou sobre quais ferramentas do CIGAM possuem recursos integrados a ela, consulte a documentação específica de acesso: [[GE - Como Fazer - Cia - Como acessar|Como Fazer - Cia - Como acessar]]
{{VoltarInicio}}

=Cia Web (SaaS)=
A Cia Web é a aplicação web que centraliza todas as funcionalidades da Cia. Ela pode ser acessada diretamente pelo navegador do seu computador ou dispositivo móvel, ou ainda a partir do Desktop e dos Portais, sem a necessidade de novo login.
 

<center><youtube>https://youtu.be/DFGtRtPF75A</youtube></center>
 

==Primeiro acesso==
A Cia Web pode ser acessada diretamente pelo navegador, utilizando o seguinte endereço: https://services.cigam.cloud/cia/index.html
 
'''Importante:''' o usuário que for realizar o login precisa ter a autenticação em duas etapas habilitada. Para saber como configurá-la, consulte: [[GE - Como Fazer - Configuração da Cia IA do CIGAM#Autenticação em duas etapas e configurações de envio de e-mail|Autenticação em duas etapas e configurações de envio de e-mail]]
 
Ao acessar pelo endereço, será necessário preencher algumas informações para que a Cia consiga validar seu acesso e consultar seus dados: 
* Informar a API do seu CIGAM Server, para garantir o direcionamento correto da base de dados. 

[[Imagem:CiaAPI.png|semmoldura|center|700px]] 

* Informar usuário e senha de login e seu código de verificação: 

[[Imagem:CiaLogin.png|semmoldura|center|700px]]
 
[[Imagem:CiaCodVerif.png|semmoldura|center|700px]] 

* Caso não queira aguardar ou informar o código de verificação, você pode optar por responder à pergunta secreta, clicando no botão “Pergunta Secreta” exibido na imagem acima. 

[[Imagem:CiaLoginA2F.png|semmoldura|center|700px]]
 

==Conhecendo a tela da Cia==
Após realizar o login, a Cia carregará automaticamente as informações e dados necessários do ambiente e será iniciada no assunto '''#Geral''', identificado pelo botão localizado à esquerda da caixa de texto.

[[Imagem:CiaGeral.png|semmoldura|center|700px]]
 
Ao clicar nesse botão, será exibida uma lista com todos os assuntos disponíveis, permitindo que você selecione aquele com o qual deseja interagir. 
Além disso, você pode digitar diretamente na caixa de texto o '''#Assunto''' que deseja utilizar, e a Cia entenderá automaticamente o tema da sua mensagem. 
Também é possível '''formular uma pergunta seguida de um #Assunto''' para interagir com qualquer assunto, mesmo que ele não esteja selecionado no momento.

[[Imagem:CiaAberta.png|semmoldura|center|700px]]
 
Ao selecionar um assunto, serão exibidas automaticamente dicas e sugestões sobre o tema escolhido, além de exemplos clicáveis que, ao serem selecionados, são processados de forma imediata. 
Além disso, ao digitar um ponto de interrogação (?) na caixa de texto, será exibida uma lista com todas as interações disponíveis para o assunto selecionado, facilitando a descoberta de comandos e possibilidades de uso.

[[Imagem:CiaDicas.png|semmoldura|center|700px]]
 
Outra funcionalidade prática é a possibilidade de reenviar perguntas já feitas no chat. Para isso, basta posicionar o mouse sobre a pergunta desejada e clicar no ícone de “Reenviar”. Ao passar o mouse sobre a mensagem, também será exibido o horário de envio.
 
[[Imagem:CiaReenviar.png|semmoldura|center|400px]]
 
Além disso, você pode utilizar as setas do teclado (⬆️ para cima e ⬇️ para baixo) na caixa de texto para navegar pelas últimas perguntas enviadas para o #Assunto selecionado, facilitando o reuso de interações anteriores.

===Ícones da caixa de texto===
Na caixa de texto, você encontrará alguns ícones com as seguintes funções:

<center>
{| class="wikitable"
|-
! !! Ação
|-
|center|[[Imagem:CiaUltPerg.png]] || '''Histórico de Perguntas''' – Ao clicar, é exibido o histórico das perguntas já realizadas para o assunto selecionado.
|-
|center|[[Imagem:CiaEnviar.png]] || '''Enviar''' – Envia o conteúdo digitado na caixa de texto.
|-
|center|[[Imagem:CiaFala.png]] || '''Falar''' – Permite falar ao invés de digitar, usando o recurso de voz.
|-
|center|[[Imagem:CiaExpandir.png]] || '''Expandir''' – Aumenta a altura da caixa de texto para facilitar a digitação de mensagens longas.
|-
|center|[[Imagem:CiaRecolher.png]] || '''Recolher''' – Reduz a caixa de texto ao tamanho padrão.
|}
</center>
{{VoltarInicio}}

==Assuntos disponíveis==

===Geral===
Nesse assunto, é possível conversar livremente com a Cia sobre qualquer um dos assuntos disponíveis. Se encontrar dificuldades para obter a resposta desejada, experimente selecionar um assunto específico, o que pode gerar resultados mais precisos. 
Se houver muitas respostas correspondentes, a Cia não executará nenhuma automaticamente. Em vez disso, exibirá uma opção com os valores possíveis, permitindo que você selecione manualmente a melhor alternativa.

[[Imagem:CiaGeralOpcoes.png|semmoldura|center|700px]]
 
Caso a Cia encontre uma resposta com confiança significativamente maior que as demais, ela será executada automaticamente.
 
No entanto, se você selecionar a opção “Não era bem isso o que eu queria”, a Cia exibirá outras opções relacionadas ao que foi solicitado, apresentando também um indicador de semáforo com a porcentagem de confiança de cada alternativa.

[[Imagem:CiaGeralOpcaoCerta.png|semmoldura|center|600px]]

===Ajuda, Vídeos e Auditor===
Conheça melhor o ERP com a ajuda da Wiki e Cia, assista vídeos sobre o CIGAM e audite seu ambiente.

====Ajuda====
Nesse assunto, você pode acessar o Chatbot da assistente virtual, onde você pode tirar dúvidas e consultar conteúdos da CIGAM Wiki enviando perguntas diretamente nela. 
 
'''Importante:''' neste assunto, a Cia atua dedicada à Wiki, focada exclusivamente nos conteúdos da documentação. As demais funcionalidades e atalhos da Cia não estarão disponíveis nesse contexto.

====Vídeos====
Nesse assunto, é possível procurar por vídeos relacionados ao tema desejado. O resultado será apresentado em forma de lista, contendo os vídeos encontrados e os tempos exatos em que o assunto começa a ser abordado, de acordo com o termo ou palavra pesquisada.

====Auditor====
Neste assunto, é possível verificar o status do sistema e identificar possíveis problemas ou inconsistências. O resultado será exibido em forma de tabela, contendo os dados retornados para facilitar a análise.

===Painéis BI, Portais e Relatórios===
Explore dashboards do BI, interaja com Portais intuitivos e execute relatórios personalizados.

====Painéis BI====
Nesse assunto, é possível abrir dashboards do BI já configurados para o usuário, permitindo sua visualização diretamente na tela.
Ao abrir um dashboard, você também pode interagir com ele, solicitando inserção de filtros, dimensões, métricas, transformações e outros ajustes. 
Cada dashboard aberto exibirá uma guia com as “Interações” disponíveis para aquele painel específico.
 
Além disso, ao selecionar o assunto '''#Painéis do BI''', é possível solicitar que a Cia crie um dashboard do zero.
Por exemplo: "Crie um dashboard para ver meu fluxo de caixa". Você pode ainda solicitar que métricas, dimensões e filtros sejam adicionados durante a criação, ou pedir dashboards separados por áreas.
 
'''Importante:''' caso o usuário não possua acesso ao BI ou este não esteja implementado na base de dados, será exibida uma mensagem informativa no momento do login na Cia.

====Portais====
Quando este assunto é utilizado, o resultado será sempre a abertura de uma tela dos Portais, permitindo ao usuário acessar diretamente os conteúdos e funcionalidades disponíveis nesse ambiente.
 
Essa abertura é feita de forma integrada, garantindo uma navegação contínua entre a Cia e os Portais, sem necessidade de realizar novo login ou sair da plataforma.

====Relatórios====
Ao utilizar esse assunto, será exibida uma tela para preenchimento de filtros, permitindo a emissão de relatórios web.
 
Para que essa funcionalidade opere corretamente, é necessário garantir que a instalação da CDN e da Pesquisa Dinâmica no servidor de aplicação esteja configurada de forma adequada.
 
Os relatórios exibidos aqui são os mesmos disponíveis nos Portais CIGAM, portanto é essencial que esses componentes também estejam funcionando corretamente nesses Portais.

===Qual, Faça, Consultar, Listar, Analisar e Insights===
Crie registros, analise informações ou liste dados cadastrados no CIGAM.

====Qual====
Nesse assunto, a Cia vai consultar e processar informações diretamente no ERP, usando os dados e relacionamentos disponíveis no CIGAM, e retornar os resultados em forma de texto para você visualizar.
 
'''Importante:''' nem todas as opções estão liberadas. Para ver quais você pode usar, digite ? na caixa de texto. A Cia vai mostrar uma lista com todos os comandos e funções disponíveis.

====Faça====
Nesse assunto, a Cia sempre fará um processamento no CIGAM e retornará o status do resultado. Por exemplo, você pode solicitar que a Cia crie um alerta ou até mesmo crie uma nova empresa no sistema.
 
'''Dica:''' para saber quais treinamentos ou comandos estão disponíveis, digite ? na caixa de texto. A Cia mostrará uma lista com todas as opções implementadas para você usar.

====Consultar====
Nesse assunto, você poderá fazer consultas de dados para obter listagens de registros, conforme os treinamentos de tabelas disponíveis. O resultado será apresentado em forma de tabela, exibindo os dados retornados. Já existem diversas Views prontas, para que você possa listar informações de forma mais completa e rápida.
 
'''Dica:''' para ver exemplos de consultas já implementadas, digite ? na caixa de texto.

====Listar====
Nesse assunto, você pode montar sua própria consulta de dados, escolhendo os filtros e parâmetros para gerar uma listagem personalizada. Diferente do assunto #Consultar, aqui é possível utilizar qualquer tabela do CIGAM para montar sua consulta, escrevendo em linguagem natural o que deseja buscar.
 
'''Dica:''' para ver todas as tabelas disponíveis, digite ? na caixa de texto.

====Analisar====
Analise o arquivo selecionado para gerar gráficos interativos e informativos, apresentando insights relevantes que ajudam a identificar tendências, padrões e oportunidades de melhoria.
 
Esse recurso oferece uma visualização clara e intuitiva dos dados, facilitando a interpretação das informações e apoiando a tomada de decisões estratégicas.
 
'''Aviso:''' para utilizar esta funcionalidade, é necessário concordar que os dados enviados serão processados por modelos de IA de terceiros integrados à Cia.

[[Imagem:AnalisarCia.png|semmoldura|center|600px]]

====Insights====
Gere insights inteligentes a partir dos dados de uma consulta, com análises automáticas realizadas pela Cia, que identificam padrões, tendências e possíveis pontos de atenção. Esse recurso ajuda a transformar dados brutos em informações acionáveis, facilitando a tomada de decisões estratégicas e otimizando processos.
 
'''Aviso:''' ao utilizar o assunto “Insights”, você concorda que os dados e informações analisados poderão ser enviados para modelos de IA de terceiros integrados à Cia, exclusivamente para processamento e geração dos resultados apresentados.

===IA Generativa e Pesquisa na Internet===
Converse com a IA sobre assuntos diversos, crie conteúdos e pesquise na internet sobre qualquer coisa.

====IA Generativa====
Nesse assunto, ao interagir com a IA Generativa, você poderá fazer qualquer tipo de pergunta ou solicitação, de forma livre e criativa.
O resultado exibido será exatamente a resposta gerada pela IA, sem complementos da Cia. Você pode, por exemplo, solicitar que a IA melhore ou reformule um texto, crie conteúdos ou resuma informações.
 
'''Importante:''' nesse assunto, a Cia não estará integrada aos serviços e sistemas do CIGAM — a interação é exclusivamente com a IA Generativa.

====Pesquisa na Internet====
Use esse assunto para fazer pesquisas na internet e visualizar os resultados diretamente integrados na Cia, sem precisar sair da plataforma. Você pode pesquisar qualquer tema de interesse e abrir os links retornados para acessar conteúdos, notícias e informações de forma rápida e prática.
{{VoltarInicio}}

===Compartilhamento de Análises da Cia===

 
<div align="justify">
Na Cia Web (SaaS), é possível gerar análises detalhadas de determinadas informações e compartilhá-las. Essa funcionalidade está disponível nos seguintes assuntos: [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Auditor|Auditor]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Analisar|Analisar]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Insights|Insights]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Listar|Listar]] e [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Consultar|Consultar]].
</div>
 

[[Image: opcoesAnalisarCia.png|semmoldura|center|800px]]

 
<div align="justify">
Essa opção está disponível por meio do botão '''Analisar''', exibido junto à resposta apresentada após a solicitação de um desses assuntos.
</div>
 

[[Image: exemploBotaoAnalisar.png|semmoldura|center|800px]]

 
<div align="justify">
Particularmente para o assunto '''Analisar''', a análise já é exibida diretamente, pois essa é a finalidade desse assunto:
</div>
 

[[Image: analiseAnalisar.png|semmoldura|center|800px]]

 
<div align="justify">
Ao gerar uma análise , a página de resultado passa a disponibilizar opções para compartilhar e utilizar o conteúdo gerado. São disponibilizadas três opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.
</div>
 

[[Image: CiaWebAnalise.png|semmoldura|center|800px]]

=====Compartilhamento por e-mail=====

<div align="justify">
Ao selecionar a opção '''E-mail''', é apresentada uma janela para preenchimento das informações necessárias ao envio da análise.
</div>
 

[[Image: CiaWebModalEmail.png|semmoldura|center|800px]]

 
<div align="justify">
Após informar os destinatários e os demais dados da mensagem, basta selecionar '''Enviar'''. A análise gerada será encaminhada como um arquivo em anexo.

Para utilizar esse recurso, o ambiente deve possuir as configurações necessárias para envio de e-mails pelo CIGAM devidamente parametrizadas. Para mais informações, consulte [[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]].
</div>

==Configurações==
O ícone de engrenagem, localizado no canto superior direito da página, reúne recursos de informação e gerenciamento. As opções disponíveis são:
* '''Respostas com áudio:''' quando ativado, as respostas da Cia são narradas em voz alta.
* '''Ambiente atual do CIGAM:''' exibe na tela o usuário logado e o ambiente em uso.
* '''Ver consumo:''' mostra a quantidade de tokens já utilizados e os usuários que geraram consumo.
* '''Limpar dados de navegação:''' exibe uma mensagem explicando como limpar os dados de navegação do navegador.
* '''Limpar cookies:''' apaga os dados armazenados localmente, permitindo informar novamente a API e realizar um novo login.
* '''Instalar aplicativo:''' instala a Cia como aplicativo no dispositivo, criando um atalho na tela inicial.
* '''Documentação na wiki:''' direciona para a documentação da Cia na CIGAM Wiki.
* '''Sair:''' encerra a sessão do usuário, permitindo realizar login com outro usuário.
 
[[Imagem:ConfiguracoesCia.png|semmoldura|center|500px]]
{{VoltarInicio}}

=Portais=
Nos Portais CIGAM, além do acesso à Cia Web pelo menu de mosaico, estão disponíveis recursos de IA que atuam diretamente nas telas em que você está trabalhando. Esses recursos não exigem parametrização e são apresentados de acordo com o contexto da tela. 

==Acesso à Cia Web (SaaS) pelo menu mosaico==
O acesso à Cia Web a partir dos Portais é feito pelo ícone de mosaico, onde está disponível o ícone da Cia - IA do CIGAM. 
 
[[Imagem:mosaicoCia.png|semmoldura|center|800px]]
 
A Cia será aberta de forma integrada, sem a necessidade de novo login, e todas as funcionalidades descritas na seção [[#Cia Web (SaaS)|Cia Web (SaaS)]] estarão disponíveis normalmente. 

==Geração de conteúdo==
Na barra superior dos Portais está disponível um ícone com um menu de contexto que permite interagir com os '''campos de texto''' de qualquer parte dos Portais. As opções disponíveis permitem melhorar textos, criar conteúdos, revisar a gramática, entre outras ações. 
 
[[Imagem:comandosCia.png|semmoldura|center|650px]]
 
A partir da versão '''Beta 260601''', essas opções passaram a ser exibidas em uma seção separada, chamada '''Geração de conteúdo''', apresentada no mesmo menu em que ficam os agentes. 
 
[[Imagem:MenuGeracaoConteudoAgentes.png|semmoldura|center|800px]]
 
O campo processado é sempre o '''último campo em que o cursor esteve posicionado''' antes de abrir o menu da Cia. Por isso, basta clicar no campo desejado e, em seguida, acionar o menu e escolher o comando. 
 
Para que o comando seja executado, o campo precisa ser um '''campo de texto válido''' e conter, no mínimo, '''três palavras'''. Caso contrário, será apresentada uma mensagem informando que o conteúdo não atende aos requisitos. 
 
Após o processamento, o conteúdo gerado é aplicado automaticamente no campo, substituindo o texto anterior, sem necessidade de confirmação. 
 
Essa funcionalidade também está disponível em telas modais, ou seja, janelas sobrepostas com interações: 
 
[[Imagem:comandosModalCia.png|semmoldura|center|800px]]
 

==Agentes==
A partir da versão '''Beta 260601''', o menu da Cia nos Portais passou a disponibilizar também o acesso aos agentes, tanto nos Portais MVC quanto nos Portais React. 
 
Ao abrir o menu da Cia, os agentes disponíveis são detectados automaticamente de acordo com a tela que está sendo acessada, ou seja, as opções apresentadas variam conforme a página aberta. 
 
[[Imagem:MenuAgentesCia.png|semmoldura|center|800px]]
 

===Como os agentes são disponibilizados===
A disponibilização de cada agente pode ocorrer de quatro formas: 
 
* '''Por contexto:''' o agente é apresentado quando a Cia identifica que a tela acessada corresponde ao assunto tratado por ele. Por exemplo, um agente sobre Ordem de Produção será disponibilizado ao acessar uma página cujo contexto seja identificado como Ordem de Produção.
 
* '''Por parâmetro:''' o agente é apresentado quando a Cia identifica, na tela, um parâmetro com o valor esperado por ele. Por exemplo, um agente de Pedidos será disponibilizado quando existir na tela um parâmetro que contenha o código do pedido.
 
* '''Por contexto e parâmetro:''' o agente é apresentado somente quando as duas condições forem atendidas ao mesmo tempo.
 
* '''Sempre disponível:''' o agente é apresentado em qualquer tela, independentemente do contexto ou dos parâmetros.
 

===Resultado do processamento===
Após o processamento, o retorno do agente pode ser apresentado de duas formas, conforme o que foi executado: 
 
* Em uma '''nova guia''' do navegador, quando o agente gera algum conteúdo ou relatório como resultado.
 
[[Imagem:AgentesRetornoGuia.png|semmoldura|center|800px]]
 
* Em uma '''janela modal''', dentro da própria página em que o usuário está, quando o retorno é uma mensagem.
 
[[Imagem:AgentesRetornoModal.png|semmoldura|center|800px]]
 
<div align="justify>
A partir da versão '''Beta 261005''', quando o resultado do agente é apresentado em uma nova guia, a página passa a disponibilizar também opções para utilização e compartilhamento da análise.
</div>
 
[[Imagem:resultadoAnalise.png|semmoldura|center|800px]]
 
<div align="justify">
No cabeçalho são apresentados o nome do agente executado e as opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.
</div>
<div align="justify">
=====Compartilhamento por e-mail=====
A janela abaixo é exibida quando selecionada a opção '''E-mail''':
</div>
 
[[Imagem:modalEmail.png|semmoldura|center|800px]]
 
<div align="justify">

Para utilizar esse recurso, o ambiente deve possuir as configurações necessárias para envio de e-mails pelo CIGAM devidamente parametrizadas. Para mais informações, consulte [[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]].
</div>

==Editor de Agentes==
<div align="justify">
A partir da versão '''Beta 261005''', o menu passou a disponibilizar o acesso à ferramenta '''Editor de Agentes''', que permite criar seus próprios agentes.

 
[[Imagem:EditorAgentesCia.png|semmoldura|center|750px]]
 

Ao clicar na opção, será aberta uma página web e ocorrerá a validação do ambiente e autenticação.

 
[[Imagem:EditorAgentesCiaValidandoAuth.png|semmoldura|center|750px]]
 

Quando não forem identificados uma API e um token válidos, ocorrerá a mensagem de bloqueio à ferramenta.

 
[[Imagem:EditorAgentesCiaBloqueio.png|semmoldura|center|750px]]
 

A página utiliza o formato de assistente (wizard), com cada etapa explicada de forma detalhada. Basta preencher as informações do agente conforme a sua necessidade e avançar pelos passos até a conclusão. Temos a opção de "Abrir" um agente já criado para podermos editar suas informações ou criar um agente do zero.

 
[[Imagem:EditorAgentesCia_logado.png|semmoldura|center|750px]]
 

Na última etapa teremos a opção de "Criar Agente" onde será realizado o download do arquivo.

 
[[Imagem:EditorAgentesWizardBaixar.png|semmoldura|center|750px]]
 

Ao final do processo, será gerado um arquivo com a extensão '''.cgagt''', que contém a definição do agente criado.

{{VoltarInicio}}
</div>
===Disponibilizando o agente criado===
<div align="justify">
Para que o agente passe a ser exibido nos Portais, o arquivo '''.cgagt''' precisa ser colocado na aplicação da API, dentro da pasta raiz da aplicação. 
 
É necessário que existam as pastas '''Exclusivo''' e, dentro dela, '''Agentes'''. Caso não existam, elas devem ser criadas manualmente. O arquivo deve ser colocado dentro dessa estrutura, ficando da seguinte forma: 
 
/api/exclusivo/agentes/
 
Assim que o arquivo é adicionado nesse local, a Cia passa a reconhecer o agente automaticamente, sem necessidade de qualquer outra configuração. Os agentes customizados são exibidos no menu da Cia nos Portais, em uma seção separada dos agentes padrão. 
 
[[Imagem:MenuAgentesCustomizados.png|semmoldura|center|800px]]
 
{{VoltarInicio}}
</div>

==Conversar com documentos==
<div align="justify">
A ferramenta de '''Conversar com documentos''' permite analisar, resumir e cruzar informações contidas em arquivos e relatórios através de modelos avançados de Inteligência Artificial integrados ao ERP CIGAM.

O acesso pode ser realizado a partir da tela principal da Cia Web (SaaS), clicando na opção correspondente ou digitando o assunto <code>#Documentos</code>, momento em que a aplicação é aberta em uma nova guia do navegador assim que digitada a primeira mensagem.

Além disto, podemos acessar a aplicação através dos Portais CIGAM, conforme descrito em [[GE_-_Como_Fazer_-_Cia_-_Como_acessar#Conversar_com_documentos|Como acessar]].

Para a utilização da aplicação, é necessário estar autenticado com um token de autorização CIGAM e com o endereço da API CIGAM devidamente parametrizado. Logo ao abrir, o sistema avalia o ambiente e valida a sessão do usuário.

Estando os parâmetros validados, será gerado automaticamente um ID de conversação (''Conversation ID'') exclusivo para a sessão. Esta identificação é armazenada em cookies do navegador com validade de 24 horas, permitindo que a Cia armazene e mantenha o contexto contínuo de todas as mensagens e documentos anexados. Caso a página seja atualizada ou fechada dentro deste período, a sessão conectada e os arquivos são recuperados automaticamente.

 
<center>[[Arquivo:cia_conv_docs_01.png|nenhum|750px]]</center>
 

No primeiro acesso, é obrigatório marcar a opção '''Termo de consentimento''' para indicar ciência de que os dados e documentos selecionados para análise serão enviados aos modelos de IA de terceiros integrados com a Cia. Por segurança e conformidade, os campos de envio e a área de anexos permanecem bloqueados até que o consentimento seja confirmado. Uma vez aceito, uma mensagem de registro é inserida no histórico da conversa e a preferência é memorizada para a sessão.

Após confirmar o termo, a área de upload no painel lateral esquerdo é habilitada, permitindo anexar múltiplos arquivos simultaneamente, seja arrastando e soltando os documentos sobre a área de dropzone, seja clicando sobre ela para abrir a janela de seleção de arquivos.

A ferramenta suporta uma ampla variedade de formatos corporativos:
*'''Documentos de Texto e Portáteis:''' PDF (<code>.pdf</code>), Texto Simples (<code>.txt</code>), Word (<code>.doc</code>, <code>.docx</code>).
*'''Planilhas e Dados Tabulares:''' Planilhas Excel (<code>.xlsx</code>, <code>.xls</code>), Valores Separados por Vírgula (<code>.csv</code>).
*'''Arquivos de Estrutura de Dados:''' Arquivos <code>.json</code> e <code>.xml</code>.

No painel lateral, é possível visualizar o contador total de documentos anexados, o ícone específico do formato, o nome, o tamanho do arquivo formatado e a indicação de que o documento encontra-se ativo no contexto da conversa. Em dispositivos móveis ou telas menores, o painel lateral pode ser recolhido ou expandido através do botão retrátil no topo da barra.

Uma vez enviados para análise, os documentos permanecem registrados no contexto da conversa no servidor, não sendo necessário reenviá-los a cada nova pergunta. Caso deseje remover os arquivos analisados, deve-se reiniciar o contexto através da opção de limpeza da conversa.

*'''Limpar conversa:''' Permite reiniciar o contexto da conversa. Ao acionar esta opção, um balão interativo de confirmação é apresentado no histórico do chat (com as opções ''Limpar Conversa'' ou ''Cancelar''). Ao confirmar, o sistema solicita a exclusão da conversa no serviço da OpenAI para evitar registros órfãos, remove os documentos e cookies locais e gera um novo ID de conversação limpo.

 
<center>[[Arquivo:cia_conv_docs_02.png|nenhum|750px]]</center>
 

Clicando no ícone da engrenagem localizado no canto superior direito da tela, temos acesso ao menu de opções e configurações da ferramenta:

*'''Provedor de IA:''' Permite selecionar o provedor de Inteligência Artificial. Atualmente está fixa a opção da OpenAI.
*'''Modelo de IA:''' Permite selecionar o modelo de Inteligência Artificial desejado para o processamento documental (ex.: GPT-5.4, GPT-5.4 Mini, GPT-5.2, GPT-5.1). A lista de modelos é atualizada dinamicamente a partir dos serviços disponíveis na Cia.
*'''Usuário Conectado:''' Exibe os dados do usuário autenticado no ERP CIGAM, incluindo nome, empresa (razão social / fantasia) e código de usuário.
*'''Ambiente & Sessão CIGAM:''' Apresenta o tipo de ambiente (produção ou depuração) e a URL da API CIGAM conectada, acompanhado de um botão de cópia rápida para facilitar diagnósticos e solicitações de suporte técnico.
*'''ID da Conversa Ativa:''' Exibe o identificador único da sessão com indicador visual de status em tempo real e botão para copiar o código do ID diretamente para a área de transferência.

*'''Documentação na wiki:''' Atalho que direciona diretamente aos manuais e guias de uso na CIGAM Wiki.

 
<center>[[Arquivo:cia_conv_docs_03.png|nenhum|750px]]</center>
 

Com os documentos anexados, podemos enviar perguntas e comandos no campo inferior para obter resumos executivos, explicações pontuais, cruzamento de dados entre arquivos distintos, localização de inconsistências ou extração de indicadores. Caso enviemos os arquivos sem digitar nenhuma mensagem complementar, a Cia aplicará o prompt de sistema padrão para realizar uma leitura analítica e retornar um resumo estruturado dos documentos.

O sistema dispõe de diretrizes de sistema corporativas (''System Prompt'') integradas ao ecossistema do ERP CIGAM, orientando o modelo a analisar com fidelidade os dados fornecidos, sem inventar informações ausentes.

Também é disponibilizado o recurso de '''Reconhecimento de Voz''' através do ícone de microfone (habilitado em conexões seguras HTTPS). O recurso conta com reconhecimento inteligente de pontuação falada: ao ditar expressões como ''"vírgula"'', ''"ponto"'', ''"ponto e vírgula"'', ''"dois pontos"'', ''"interrogação"'', ''"exclamação"'', ''"hífen"'', ''"abre parênteses"'', ''"fecha parênteses"'' ou ''"nova linha"'', os termos são automaticamente substituídos pelos respectivos sinais gráficos e as frases são capitalizadas de forma automática.

 
<center>[[Arquivo:cia_conv_docs_04.png|nenhum|750px]]</center>
 

As respostas retornadas pela Cia contam com formatação Markdown avançada, estruturando o conteúdo em títulos hierárquicos, listas ordenadas ou em tópicos, citações em bloco e tabelas responsivas estilizadas.

Além disso, sempre que a análise envolver dados numéricos comparativos, demonstrativos contábeis/financeiros (como DRE, receitas e despesas), séries temporais ou valores tabulares, a Cia gera automaticamente gráficos visuais e interativos integrados diretamente na resposta:
*'''Tipos de Gráficos Gerados:''' Barras verticais, linhas de tendência, gráficos de pizza e rosca, estilizados na paleta de cores oficial da Cia e com valores numéricos formatados no padrão brasileiro (pt-BR).
*'''Exportação do Gráfico:''' Cada card de gráfico possui um botão de download no canto superior direito, permitindo baixar a imagem em formato PNG em alta resolução para inclusão imediata em relatórios, apresentações ou envio por e-mail.

 
<center>[[Arquivo:cia_conv_docs_05.png|nenhum|750px]]</center>
 

Podemos manter uma conversa contínua com diversos documentos e mensagens em múltiplos turnos de diálogo. A Cia preserva o histórico de perguntas e respostas anteriores, permitindo aprofundar análises, solicitar detalhamentos de itens específicos ou anexar novos arquivos complementares ao longo da conversa.

</div>
{{VoltarInicio}}

=Desktop=
Na aplicação Desktop, além do acesso rápido à Cia Web, algumas ferramentas do sistema disponibilizam o recurso "Analisar com a Cia". 

==Acesso rápido à Cia Web (SaaS)==
O botão de acesso rápido (Cia - IA do CIGAM), disponível no menu lateral do Desktop, abre a Cia Web de forma integrada ao sistema, em uma janela do próprio CIGAM. 
 
Desde que as configurações necessárias tenham sido aplicadas, conforme [[GE - Como Fazer - Configuração da Cia IA do CIGAM#Acesso rápido à Cia Web (SaaS)|Acesso rápido à Cia Web (SaaS)]], '''todas as funcionalidades da Cia Web estarão disponíveis normalmente''', da mesma forma que no acesso pelo navegador. Para conhecê-las, consulte a seção [[#Cia Web (SaaS)|Cia Web (SaaS)]] desta documentação. 
 
[[Imagem:CiaAbertaDesktop.png|semmoldura|center|800px]]
 

==Recurso Analisar com a Cia==
O recurso '''"Analisar com a Cia"''' está disponível em ferramentas como CGEditor, CGReport, Pesquisa Dinâmica e Dispositivo de Saída. Em todas elas, o comportamento é o mesmo: a Cia analisa o conteúdo que está em uso na tela e gera um relatório com o resultado da análise, apresentado em uma nova página. 
 
'''Importante:''' na primeira vez que o usuário for utilizar o recurso pelo '''CGEditor''', pelo '''Visualizador de PDF''' ou pelo '''Dispositivo de Saída''', é necessário gerar um relatório merge pelo CIGAM, para que os arquivos de preferências sejam gravados com as informações necessárias ao funcionamento do recurso. Essa etapa não é necessária para as demais ferramentas. 
Ao acionar a opção, o fluxo é o seguinte: 
 
'''1. Confirmação dos termos de uso''' 
Antes de qualquer envio, será exibida uma mensagem solicitando que o usuário concorde com o envio das informações para análise. Os dados enviados seguem as diretrizes de segurança, privacidade e não retenção descritas em [[#Recursos, configurações e segurança|Recursos, configurações e segurança]]. 
 
[[Imagem:AnalisarCiaTermos.png|semmoldura|center|500px]]
 
'''2. Complemento do prompt (opcional)''' 
Disponível a partir do patch '''RC 250505.i''' ou da versão '''Beta 251103'''. 
 
Em seguida, será apresentada uma caixa de texto para que o usuário complemente a solicitação, orientando a análise para algum ponto específico. O preenchimento é opcional e pode ser deixado em branco. 
 
Essa caixa de texto serve apenas para complementar o prompt base que a Cia monta automaticamente, e não altera o conteúdo que está sendo enviado. O recurso considera que o usuário já filtrou os dados na própria tela do CIGAM antes de acionar a análise. O prompt base é mantido oculto por ser extenso e técnico, evitando que o usuário precise conferi-lo a cada utilização. 
 
[[Imagem:AnalisarCiaPrompt.png|semmoldura|center|700px]]
 
'''3. Geração do relatório''' 
Após a confirmação, a Cia processa o conteúdo e apresenta o relatório em uma nova página flutuante, com a análise dos dados enviados. 
 
O próprio relatório informa a quantidade de dados que foi analisada, permitindo que o usuário veja o volume aproximado considerado e identifique se o conteúdo enviado corresponde ao que esperava. 
 
[[Imagem:AnalisarCiaRelatorio.png|semmoldura|center|700px]]
 

A partir da versão '''Beta 261005''', o resultado da análise passa a ser apresentado em uma nova janela flutuante, que disponibiliza opções para utilização e compartilhamento do conteúdo gerado. Nessa versão, o recurso está disponível apenas para a '''Pesquisa Dinâmica/Pesquisa Paginada''' e para o '''FastReport'''. A partir da '''RC 270519''', ele também passa a estar disponível para o '''CGEditor''' e o '''Dispositivo de Saída'''. 
 
No cabeçalho dessa janela, são apresentados o título da análise e três opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.

 
[[Imagem:AnalisarCiaDesktopCompartilhar.png|semmoldura|center|800px]]
 

====Compartilhamento por e-mail====
<div align="justify">
Ao selecionar a opção '''E-mail''', é apresentada uma janela para preenchimento das informações necessárias ao envio da análise.

 
[[Imagem:AnalisarCiaDesktopEmail.png|semmoldura|center|700px]]
 

Após informar os destinatários e os demais dados da mensagem, basta selecionar '''Enviar'''. A análise gerada será encaminhada como um arquivo em anexo.

</div>

===Limite de conteúdo enviado===
<div align="justify">
Existe um limite para o volume de conteúdo enviado em cada análise, que varia conforme a versão do ambiente:

* '''150 KB''' — desde a disponibilização do recurso, na versão '''250505.a'''.
* '''3 MB''' — a partir das patches '''250505.i''' e '''251103.a''', e da versão '''RC 260504'''.

Quando o conteúdo selecionado ultrapassa esse limite, a Cia exibe uma mensagem informando o tamanho excedido e a análise não é processada, ou seja, nenhum relatório será gerado.

[[Imagem:AnalisarCiaLimite.png|semmoldura|center|600px]]

'''Esse limite não é parametrizável e não se trata de uma restrição imposta pela CIGAM.''' Ele decorre da própria capacidade dos modelos de IA integrados à Cia, que possuem um limite técnico de volume de dados que conseguem processar em uma única análise. Quando esse volume é ultrapassado, os modelos passam a analisar as informações por amostragem — ou seja, mesmo que fosse permitido enviar uma quantidade maior de dados, o modelo não analisaria todo o conteúdo, e o resultado seria menos preciso. O limite adotado pela Cia acompanha essa característica dos modelos e assegura que a análise seja feita sobre os dados completos.

Além da qualidade da análise, há também a questão do tempo de processamento: quanto maior o volume enviado, maior o tempo de resposta do modelo, tornando a espera inviável para o uso no dia a dia.

Por isso, o recurso foi feito para ser simples e direto: analisar, com um clique, os dados que o usuário já está visualizando pelos meios tradicionais do CIGAM, como grids filtrados e relatórios. Em ambientes com grande volume de dados, a prática recomendada é '''filtrar e consolidar as informações na própria tela antes de acionar a análise''', reduzindo o período ou o escopo consultado. Para análises de períodos maiores, recomenda-se utilizar dados já consolidados, como totalizadores e relatórios sintéticos, em vez de listagens analíticas completas.

A CIGAM está trabalhando em outras ferramentas que, por processarem os dados de forma diferente, permitirão trabalhar com volumes maiores de informação.

Para saber como acessar o recurso em cada ferramenta, consulte: [[GE - Como Fazer - Cia - Como acessar]]

{{VoltarInicio}}
</div>

=Documentos Relacionados=
[[GE - Como Fazer - Cia - Como acessar]] 
[[GE - Como Fazer - Configuração da Cia IA do CIGAM]]

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-10-30T14:45:00Z

Roger.schneider: /* Recurso Analisar com a Cia */

{{VoltarPagina}}
 
[[categoria:Como_Fazer_Utilidades/Diversos]]
[[categoria:Como_Fazer_Utilidades/Diversos_6]]
[[MediaWiki:Como_Fazer_sidebar|Como Fazer]] > [[Como_Fazer_Utilidades/Diversos|Utilidades/Diversos]] > [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer - Uso da Cia - IA do CIGAM]]

=Recursos, configurações e segurança=
A Cia - IA do CIGAM oferece diversas funcionalidades e atua como um hub centralizador para os recursos de inteligência artificial utilizados nas soluções CIGAM. Para garantir o correto funcionamento desses recursos, é necessário verificar se os pré-requisitos e as configurações foram realizados adequadamente. Para mais informações, consulte: [[GE - Como Fazer - Configuração da Cia IA do CIGAM|Como Fazer configuração da Cia IA do CIGAM]]
 
Todas as soluções de IA do CIGAM são integradas por meio dos serviços da Cia. A Cia possui integração com diferentes provedores de IA de terceiros, como OpenAI, Google, Anthropic, entre outros. Essas integrações são realizadas por meio de contas e serviços contratados, com condições de uso que asseguram que os dados trafegados não sejam utilizados para treinamento dos modelos, identificação de origem, publicidade, anúncios ou qualquer outra finalidade não prevista.
 
No caso de IAs open-source integradas à Cia, os modelos são executados dentro dos domínios da CIGAM, mantendo as mesmas premissas aplicadas às IAs contratadas: não utilização dos dados para treinamento de modelos, não identificação da origem das informações e ausência de retenção dos dados processados.
 
Além disso, sempre que houver envio explícito de dados pelo usuário por meio das funcionalidades da Cia disponíveis nas soluções CIGAM, será apresentado um diálogo de confirmação, permitindo que o usuário aceite o envio dessas informações. Os dados enviados serão tratados conforme as mesmas diretrizes de segurança, privacidade e não retenção descritas anteriormente.
 
Esta documentação apresenta o uso da Cia e está organizada conforme a forma de acesso: [[#Cia Web (SaaS)|Cia Web (SaaS)]], [[#Portais|Portais]] e [[#Desktop|Desktop]].
 
Caso tenha dúvidas sobre onde encontrar a Cia em cada uma dessas plataformas, ou sobre quais ferramentas do CIGAM possuem recursos integrados a ela, consulte a documentação específica de acesso: [[GE - Como Fazer - Cia - Como acessar|Como Fazer - Cia - Como acessar]]
{{VoltarInicio}}

=Cia Web (SaaS)=
A Cia Web é a aplicação web que centraliza todas as funcionalidades da Cia. Ela pode ser acessada diretamente pelo navegador do seu computador ou dispositivo móvel, ou ainda a partir do Desktop e dos Portais, sem a necessidade de novo login.
 

<center><youtube>https://youtu.be/DFGtRtPF75A</youtube></center>
 

==Primeiro acesso==
A Cia Web pode ser acessada diretamente pelo navegador, utilizando o seguinte endereço: https://services.cigam.cloud/cia/index.html
 
'''Importante:''' o usuário que for realizar o login precisa ter a autenticação em duas etapas habilitada. Para saber como configurá-la, consulte: [[GE - Como Fazer - Configuração da Cia IA do CIGAM#Autenticação em duas etapas e configurações de envio de e-mail|Autenticação em duas etapas e configurações de envio de e-mail]]
 
Ao acessar pelo endereço, será necessário preencher algumas informações para que a Cia consiga validar seu acesso e consultar seus dados: 
* Informar a API do seu CIGAM Server, para garantir o direcionamento correto da base de dados. 

[[Imagem:CiaAPI.png|semmoldura|center|700px]] 

* Informar usuário e senha de login e seu código de verificação: 

[[Imagem:CiaLogin.png|semmoldura|center|700px]]
 
[[Imagem:CiaCodVerif.png|semmoldura|center|700px]] 

* Caso não queira aguardar ou informar o código de verificação, você pode optar por responder à pergunta secreta, clicando no botão “Pergunta Secreta” exibido na imagem acima. 

[[Imagem:CiaLoginA2F.png|semmoldura|center|700px]]
 

==Conhecendo a tela da Cia==
Após realizar o login, a Cia carregará automaticamente as informações e dados necessários do ambiente e será iniciada no assunto '''#Geral''', identificado pelo botão localizado à esquerda da caixa de texto.

[[Imagem:CiaGeral.png|semmoldura|center|700px]]
 
Ao clicar nesse botão, será exibida uma lista com todos os assuntos disponíveis, permitindo que você selecione aquele com o qual deseja interagir. 
Além disso, você pode digitar diretamente na caixa de texto o '''#Assunto''' que deseja utilizar, e a Cia entenderá automaticamente o tema da sua mensagem. 
Também é possível '''formular uma pergunta seguida de um #Assunto''' para interagir com qualquer assunto, mesmo que ele não esteja selecionado no momento.

[[Imagem:CiaAberta.png|semmoldura|center|700px]]
 
Ao selecionar um assunto, serão exibidas automaticamente dicas e sugestões sobre o tema escolhido, além de exemplos clicáveis que, ao serem selecionados, são processados de forma imediata. 
Além disso, ao digitar um ponto de interrogação (?) na caixa de texto, será exibida uma lista com todas as interações disponíveis para o assunto selecionado, facilitando a descoberta de comandos e possibilidades de uso.

[[Imagem:CiaDicas.png|semmoldura|center|700px]]
 
Outra funcionalidade prática é a possibilidade de reenviar perguntas já feitas no chat. Para isso, basta posicionar o mouse sobre a pergunta desejada e clicar no ícone de “Reenviar”. Ao passar o mouse sobre a mensagem, também será exibido o horário de envio.
 
[[Imagem:CiaReenviar.png|semmoldura|center|400px]]
 
Além disso, você pode utilizar as setas do teclado (⬆️ para cima e ⬇️ para baixo) na caixa de texto para navegar pelas últimas perguntas enviadas para o #Assunto selecionado, facilitando o reuso de interações anteriores.

===Ícones da caixa de texto===
Na caixa de texto, você encontrará alguns ícones com as seguintes funções:

<center>
{| class="wikitable"
|-
! !! Ação
|-
|center|[[Imagem:CiaUltPerg.png]] || '''Histórico de Perguntas''' – Ao clicar, é exibido o histórico das perguntas já realizadas para o assunto selecionado.
|-
|center|[[Imagem:CiaEnviar.png]] || '''Enviar''' – Envia o conteúdo digitado na caixa de texto.
|-
|center|[[Imagem:CiaFala.png]] || '''Falar''' – Permite falar ao invés de digitar, usando o recurso de voz.
|-
|center|[[Imagem:CiaExpandir.png]] || '''Expandir''' – Aumenta a altura da caixa de texto para facilitar a digitação de mensagens longas.
|-
|center|[[Imagem:CiaRecolher.png]] || '''Recolher''' – Reduz a caixa de texto ao tamanho padrão.
|}
</center>
{{VoltarInicio}}

==Assuntos disponíveis==

===Geral===
Nesse assunto, é possível conversar livremente com a Cia sobre qualquer um dos assuntos disponíveis. Se encontrar dificuldades para obter a resposta desejada, experimente selecionar um assunto específico, o que pode gerar resultados mais precisos. 
Se houver muitas respostas correspondentes, a Cia não executará nenhuma automaticamente. Em vez disso, exibirá uma opção com os valores possíveis, permitindo que você selecione manualmente a melhor alternativa.

[[Imagem:CiaGeralOpcoes.png|semmoldura|center|700px]]
 
Caso a Cia encontre uma resposta com confiança significativamente maior que as demais, ela será executada automaticamente.
 
No entanto, se você selecionar a opção “Não era bem isso o que eu queria”, a Cia exibirá outras opções relacionadas ao que foi solicitado, apresentando também um indicador de semáforo com a porcentagem de confiança de cada alternativa.

[[Imagem:CiaGeralOpcaoCerta.png|semmoldura|center|600px]]

===Ajuda, Vídeos e Auditor===
Conheça melhor o ERP com a ajuda da Wiki e Cia, assista vídeos sobre o CIGAM e audite seu ambiente.

====Ajuda====
Nesse assunto, você pode acessar o Chatbot da assistente virtual, onde você pode tirar dúvidas e consultar conteúdos da CIGAM Wiki enviando perguntas diretamente nela. 
 
'''Importante:''' neste assunto, a Cia atua dedicada à Wiki, focada exclusivamente nos conteúdos da documentação. As demais funcionalidades e atalhos da Cia não estarão disponíveis nesse contexto.

====Vídeos====
Nesse assunto, é possível procurar por vídeos relacionados ao tema desejado. O resultado será apresentado em forma de lista, contendo os vídeos encontrados e os tempos exatos em que o assunto começa a ser abordado, de acordo com o termo ou palavra pesquisada.

====Auditor====
Neste assunto, é possível verificar o status do sistema e identificar possíveis problemas ou inconsistências. O resultado será exibido em forma de tabela, contendo os dados retornados para facilitar a análise.

===Painéis BI, Portais e Relatórios===
Explore dashboards do BI, interaja com Portais intuitivos e execute relatórios personalizados.

====Painéis BI====
Nesse assunto, é possível abrir dashboards do BI já configurados para o usuário, permitindo sua visualização diretamente na tela.
Ao abrir um dashboard, você também pode interagir com ele, solicitando inserção de filtros, dimensões, métricas, transformações e outros ajustes. 
Cada dashboard aberto exibirá uma guia com as “Interações” disponíveis para aquele painel específico.
 
Além disso, ao selecionar o assunto '''#Painéis do BI''', é possível solicitar que a Cia crie um dashboard do zero.
Por exemplo: "Crie um dashboard para ver meu fluxo de caixa". Você pode ainda solicitar que métricas, dimensões e filtros sejam adicionados durante a criação, ou pedir dashboards separados por áreas.
 
'''Importante:''' caso o usuário não possua acesso ao BI ou este não esteja implementado na base de dados, será exibida uma mensagem informativa no momento do login na Cia.

====Portais====
Quando este assunto é utilizado, o resultado será sempre a abertura de uma tela dos Portais, permitindo ao usuário acessar diretamente os conteúdos e funcionalidades disponíveis nesse ambiente.
 
Essa abertura é feita de forma integrada, garantindo uma navegação contínua entre a Cia e os Portais, sem necessidade de realizar novo login ou sair da plataforma.

====Relatórios====
Ao utilizar esse assunto, será exibida uma tela para preenchimento de filtros, permitindo a emissão de relatórios web.
 
Para que essa funcionalidade opere corretamente, é necessário garantir que a instalação da CDN e da Pesquisa Dinâmica no servidor de aplicação esteja configurada de forma adequada.
 
Os relatórios exibidos aqui são os mesmos disponíveis nos Portais CIGAM, portanto é essencial que esses componentes também estejam funcionando corretamente nesses Portais.

===Qual, Faça, Consultar, Listar, Analisar e Insights===
Crie registros, analise informações ou liste dados cadastrados no CIGAM.

====Qual====
Nesse assunto, a Cia vai consultar e processar informações diretamente no ERP, usando os dados e relacionamentos disponíveis no CIGAM, e retornar os resultados em forma de texto para você visualizar.
 
'''Importante:''' nem todas as opções estão liberadas. Para ver quais você pode usar, digite ? na caixa de texto. A Cia vai mostrar uma lista com todos os comandos e funções disponíveis.

====Faça====
Nesse assunto, a Cia sempre fará um processamento no CIGAM e retornará o status do resultado. Por exemplo, você pode solicitar que a Cia crie um alerta ou até mesmo crie uma nova empresa no sistema.
 
'''Dica:''' para saber quais treinamentos ou comandos estão disponíveis, digite ? na caixa de texto. A Cia mostrará uma lista com todas as opções implementadas para você usar.

====Consultar====
Nesse assunto, você poderá fazer consultas de dados para obter listagens de registros, conforme os treinamentos de tabelas disponíveis. O resultado será apresentado em forma de tabela, exibindo os dados retornados. Já existem diversas Views prontas, para que você possa listar informações de forma mais completa e rápida.
 
'''Dica:''' para ver exemplos de consultas já implementadas, digite ? na caixa de texto.

====Listar====
Nesse assunto, você pode montar sua própria consulta de dados, escolhendo os filtros e parâmetros para gerar uma listagem personalizada. Diferente do assunto #Consultar, aqui é possível utilizar qualquer tabela do CIGAM para montar sua consulta, escrevendo em linguagem natural o que deseja buscar.
 
'''Dica:''' para ver todas as tabelas disponíveis, digite ? na caixa de texto.

====Analisar====
Analise o arquivo selecionado para gerar gráficos interativos e informativos, apresentando insights relevantes que ajudam a identificar tendências, padrões e oportunidades de melhoria.
 
Esse recurso oferece uma visualização clara e intuitiva dos dados, facilitando a interpretação das informações e apoiando a tomada de decisões estratégicas.
 
'''Aviso:''' para utilizar esta funcionalidade, é necessário concordar que os dados enviados serão processados por modelos de IA de terceiros integrados à Cia.

[[Imagem:AnalisarCia.png|semmoldura|center|600px]]

====Insights====
Gere insights inteligentes a partir dos dados de uma consulta, com análises automáticas realizadas pela Cia, que identificam padrões, tendências e possíveis pontos de atenção. Esse recurso ajuda a transformar dados brutos em informações acionáveis, facilitando a tomada de decisões estratégicas e otimizando processos.
 
'''Aviso:''' ao utilizar o assunto “Insights”, você concorda que os dados e informações analisados poderão ser enviados para modelos de IA de terceiros integrados à Cia, exclusivamente para processamento e geração dos resultados apresentados.

===IA Generativa e Pesquisa na Internet===
Converse com a IA sobre assuntos diversos, crie conteúdos e pesquise na internet sobre qualquer coisa.

====IA Generativa====
Nesse assunto, ao interagir com a IA Generativa, você poderá fazer qualquer tipo de pergunta ou solicitação, de forma livre e criativa.
O resultado exibido será exatamente a resposta gerada pela IA, sem complementos da Cia. Você pode, por exemplo, solicitar que a IA melhore ou reformule um texto, crie conteúdos ou resuma informações.
 
'''Importante:''' nesse assunto, a Cia não estará integrada aos serviços e sistemas do CIGAM — a interação é exclusivamente com a IA Generativa.

====Pesquisa na Internet====
Use esse assunto para fazer pesquisas na internet e visualizar os resultados diretamente integrados na Cia, sem precisar sair da plataforma. Você pode pesquisar qualquer tema de interesse e abrir os links retornados para acessar conteúdos, notícias e informações de forma rápida e prática.
{{VoltarInicio}}

===Compartilhamento de Análises da Cia===

 
<div align="justify">
Na Cia Web (SaaS), é possível gerar análises detalhadas de determinadas informações e compartilhá-las. Essa funcionalidade está disponível nos seguintes assuntos: [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Auditor|Auditor]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Analisar|Analisar]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Insights|Insights]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Listar|Listar]] e [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Consultar|Consultar]].
</div>
 

[[Image: opcoesAnalisarCia.png|semmoldura|center|800px]]

 
<div align="justify">
Essa opção está disponível por meio do botão '''Analisar''', exibido junto à resposta apresentada após a solicitação de um desses assuntos.
</div>
 

[[Image: exemploBotaoAnalisar.png|semmoldura|center|800px]]

 
<div align="justify">
Particularmente para o assunto '''Analisar''', a análise já é exibida diretamente, pois essa é a finalidade desse assunto:
</div>
 

[[Image: analiseAnalisar.png|semmoldura|center|800px]]

 
<div align="justify">
Ao gerar uma análise , a página de resultado passa a disponibilizar opções para compartilhar e utilizar o conteúdo gerado. São disponibilizadas três opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.
</div>
 

[[Image: CiaWebAnalise.png|semmoldura|center|800px]]

=====Compartilhamento por e-mail=====

<div align="justify">
Ao selecionar a opção '''E-mail''', é apresentada uma janela para preenchimento das informações necessárias ao envio da análise.
</div>
 

[[Image: CiaWebModalEmail.png|semmoldura|center|800px]]

 
<div align="justify">
Após informar os destinatários e os demais dados da mensagem, basta selecionar '''Enviar'''. A análise gerada será encaminhada como um arquivo em anexo.

Para utilizar esse recurso, o ambiente deve possuir as configurações necessárias para envio de e-mails pelo CIGAM devidamente parametrizadas. Para mais informações, consulte [[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]].
</div>

==Configurações==
O ícone de engrenagem, localizado no canto superior direito da página, reúne recursos de informação e gerenciamento. As opções disponíveis são:
* '''Respostas com áudio:''' quando ativado, as respostas da Cia são narradas em voz alta.
* '''Ambiente atual do CIGAM:''' exibe na tela o usuário logado e o ambiente em uso.
* '''Ver consumo:''' mostra a quantidade de tokens já utilizados e os usuários que geraram consumo.
* '''Limpar dados de navegação:''' exibe uma mensagem explicando como limpar os dados de navegação do navegador.
* '''Limpar cookies:''' apaga os dados armazenados localmente, permitindo informar novamente a API e realizar um novo login.
* '''Instalar aplicativo:''' instala a Cia como aplicativo no dispositivo, criando um atalho na tela inicial.
* '''Documentação na wiki:''' direciona para a documentação da Cia na CIGAM Wiki.
* '''Sair:''' encerra a sessão do usuário, permitindo realizar login com outro usuário.
 
[[Imagem:ConfiguracoesCia.png|semmoldura|center|500px]]
{{VoltarInicio}}

=Portais=
Nos Portais CIGAM, além do acesso à Cia Web pelo menu de mosaico, estão disponíveis recursos de IA que atuam diretamente nas telas em que você está trabalhando. Esses recursos não exigem parametrização e são apresentados de acordo com o contexto da tela. 

==Acesso à Cia Web (SaaS) pelo menu mosaico==
O acesso à Cia Web a partir dos Portais é feito pelo ícone de mosaico, onde está disponível o ícone da Cia - IA do CIGAM. 
 
[[Imagem:mosaicoCia.png|semmoldura|center|800px]]
 
A Cia será aberta de forma integrada, sem a necessidade de novo login, e todas as funcionalidades descritas na seção [[#Cia Web (SaaS)|Cia Web (SaaS)]] estarão disponíveis normalmente. 

==Geração de conteúdo==
Na barra superior dos Portais está disponível um ícone com um menu de contexto que permite interagir com os '''campos de texto''' de qualquer parte dos Portais. As opções disponíveis permitem melhorar textos, criar conteúdos, revisar a gramática, entre outras ações. 
 
[[Imagem:comandosCia.png|semmoldura|center|650px]]
 
A partir da versão '''Beta 260601''', essas opções passaram a ser exibidas em uma seção separada, chamada '''Geração de conteúdo''', apresentada no mesmo menu em que ficam os agentes. 
 
[[Imagem:MenuGeracaoConteudoAgentes.png|semmoldura|center|800px]]
 
O campo processado é sempre o '''último campo em que o cursor esteve posicionado''' antes de abrir o menu da Cia. Por isso, basta clicar no campo desejado e, em seguida, acionar o menu e escolher o comando. 
 
Para que o comando seja executado, o campo precisa ser um '''campo de texto válido''' e conter, no mínimo, '''três palavras'''. Caso contrário, será apresentada uma mensagem informando que o conteúdo não atende aos requisitos. 
 
Após o processamento, o conteúdo gerado é aplicado automaticamente no campo, substituindo o texto anterior, sem necessidade de confirmação. 
 
Essa funcionalidade também está disponível em telas modais, ou seja, janelas sobrepostas com interações: 
 
[[Imagem:comandosModalCia.png|semmoldura|center|800px]]
 

==Agentes==
A partir da versão '''Beta 260601''', o menu da Cia nos Portais passou a disponibilizar também o acesso aos agentes, tanto nos Portais MVC quanto nos Portais React. 
 
Ao abrir o menu da Cia, os agentes disponíveis são detectados automaticamente de acordo com a tela que está sendo acessada, ou seja, as opções apresentadas variam conforme a página aberta. 
 
[[Imagem:MenuAgentesCia.png|semmoldura|center|800px]]
 

===Como os agentes são disponibilizados===
A disponibilização de cada agente pode ocorrer de quatro formas: 
 
* '''Por contexto:''' o agente é apresentado quando a Cia identifica que a tela acessada corresponde ao assunto tratado por ele. Por exemplo, um agente sobre Ordem de Produção será disponibilizado ao acessar uma página cujo contexto seja identificado como Ordem de Produção.
 
* '''Por parâmetro:''' o agente é apresentado quando a Cia identifica, na tela, um parâmetro com o valor esperado por ele. Por exemplo, um agente de Pedidos será disponibilizado quando existir na tela um parâmetro que contenha o código do pedido.
 
* '''Por contexto e parâmetro:''' o agente é apresentado somente quando as duas condições forem atendidas ao mesmo tempo.
 
* '''Sempre disponível:''' o agente é apresentado em qualquer tela, independentemente do contexto ou dos parâmetros.
 

===Resultado do processamento===
Após o processamento, o retorno do agente pode ser apresentado de duas formas, conforme o que foi executado: 
 
* Em uma '''nova guia''' do navegador, quando o agente gera algum conteúdo ou relatório como resultado.
 
[[Imagem:AgentesRetornoGuia.png|semmoldura|center|800px]]
 
* Em uma '''janela modal''', dentro da própria página em que o usuário está, quando o retorno é uma mensagem.
 
[[Imagem:AgentesRetornoModal.png|semmoldura|center|800px]]
 
<div align="justify>
A partir da versão '''Beta 261005''', quando o resultado do agente é apresentado em uma nova guia, a página passa a disponibilizar também opções para utilização e compartilhamento da análise.
</div>
 
[[Imagem:resultadoAnalise.png|semmoldura|center|800px]]
 
<div align="justify">
No cabeçalho são apresentados o nome do agente executado e as opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.
</div>
<div align="justify">
=====Compartilhamento por e-mail=====
A janela abaixo é exibida quando selecionada a opção '''E-mail''':
</div>
 
[[Imagem:modalEmail.png|semmoldura|center|800px]]
 
<div align="justify">

Para utilizar esse recurso, o ambiente deve possuir as configurações necessárias para envio de e-mails pelo CIGAM devidamente parametrizadas. Para mais informações, consulte [[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]].
</div>

==Editor de Agentes==
<div align="justify">
A partir da versão '''Beta 261005''', o menu passou a disponibilizar o acesso à ferramenta '''Editor de Agentes''', que permite criar seus próprios agentes.

 
[[Imagem:EditorAgentesCia.png|semmoldura|center|750px]]
 

Ao clicar na opção, será aberta uma página web e ocorrerá a validação do ambiente e autenticação.

 
[[Imagem:EditorAgentesCiaValidandoAuth.png|semmoldura|center|750px]]
 

Quando não forem identificados uma API e um token válidos, ocorrerá a mensagem de bloqueio à ferramenta.

 
[[Imagem:EditorAgentesCiaBloqueio.png|semmoldura|center|750px]]
 

A página utiliza o formato de assistente (wizard), com cada etapa explicada de forma detalhada. Basta preencher as informações do agente conforme a sua necessidade e avançar pelos passos até a conclusão. Temos a opção de "Abrir" um agente já criado para podermos editar suas informações ou criar um agente do zero.

 
[[Imagem:EditorAgentesCia_logado.png|semmoldura|center|750px]]
 

Na última etapa teremos a opção de "Criar Agente" onde será realizado o download do arquivo.

 
[[Imagem:EditorAgentesWizardBaixar.png|semmoldura|center|750px]]
 

Ao final do processo, será gerado um arquivo com a extensão '''.cgagt''', que contém a definição do agente criado.

{{VoltarInicio}}
</div>
===Disponibilizando o agente criado===
<div align="justify">
Para que o agente passe a ser exibido nos Portais, o arquivo '''.cgagt''' precisa ser colocado na aplicação da API, dentro da pasta raiz da aplicação. 
 
É necessário que existam as pastas '''Exclusivo''' e, dentro dela, '''Agentes'''. Caso não existam, elas devem ser criadas manualmente. O arquivo deve ser colocado dentro dessa estrutura, ficando da seguinte forma: 
 
/api/exclusivo/agentes/
 
Assim que o arquivo é adicionado nesse local, a Cia passa a reconhecer o agente automaticamente, sem necessidade de qualquer outra configuração. Os agentes customizados são exibidos no menu da Cia nos Portais, em uma seção separada dos agentes padrão. 
 
[[Imagem:MenuAgentesCustomizados.png|semmoldura|center|800px]]
 
{{VoltarInicio}}
</div>

==Conversar com documentos==
<div align="justify">
A ferramenta de '''Conversar com documentos''' permite analisar, resumir e cruzar informações contidas em arquivos e relatórios através de modelos avançados de Inteligência Artificial integrados ao ERP CIGAM.

O acesso pode ser realizado a partir da tela principal da Cia Web (SaaS), clicando na opção correspondente ou digitando o assunto <code>#Documentos</code>, momento em que a aplicação é aberta em uma nova guia do navegador assim que digitada a primeira mensagem.

Além disto, podemos acessar a aplicação através dos Portais CIGAM, conforme descrito em [[GE_-_Como_Fazer_-_Cia_-_Como_acessar#Conversar_com_documentos|Como acessar]].

Para a utilização da aplicação, é necessário estar autenticado com um token de autorização CIGAM e com o endereço da API CIGAM devidamente parametrizado. Logo ao abrir, o sistema avalia o ambiente e valida a sessão do usuário.

Estando os parâmetros validados, será gerado automaticamente um ID de conversação (''Conversation ID'') exclusivo para a sessão. Esta identificação é armazenada em cookies do navegador com validade de 24 horas, permitindo que a Cia armazene e mantenha o contexto contínuo de todas as mensagens e documentos anexados. Caso a página seja atualizada ou fechada dentro deste período, a sessão conectada e os arquivos são recuperados automaticamente.

 
<center>[[Arquivo:cia_conv_docs_01.png|nenhum|750px]]</center>
 

No primeiro acesso, é obrigatório marcar a opção '''Termo de consentimento''' para indicar ciência de que os dados e documentos selecionados para análise serão enviados aos modelos de IA de terceiros integrados com a Cia. Por segurança e conformidade, os campos de envio e a área de anexos permanecem bloqueados até que o consentimento seja confirmado. Uma vez aceito, uma mensagem de registro é inserida no histórico da conversa e a preferência é memorizada para a sessão.

Após confirmar o termo, a área de upload no painel lateral esquerdo é habilitada, permitindo anexar múltiplos arquivos simultaneamente, seja arrastando e soltando os documentos sobre a área de dropzone, seja clicando sobre ela para abrir a janela de seleção de arquivos.

A ferramenta suporta uma ampla variedade de formatos corporativos:
*'''Documentos de Texto e Portáteis:''' PDF (<code>.pdf</code>), Texto Simples (<code>.txt</code>), Word (<code>.doc</code>, <code>.docx</code>).
*'''Planilhas e Dados Tabulares:''' Planilhas Excel (<code>.xlsx</code>, <code>.xls</code>), Valores Separados por Vírgula (<code>.csv</code>).
*'''Arquivos de Estrutura de Dados:''' Arquivos <code>.json</code> e <code>.xml</code>.

No painel lateral, é possível visualizar o contador total de documentos anexados, o ícone específico do formato, o nome, o tamanho do arquivo formatado e a indicação de que o documento encontra-se ativo no contexto da conversa. Em dispositivos móveis ou telas menores, o painel lateral pode ser recolhido ou expandido através do botão retrátil no topo da barra.

Uma vez enviados para análise, os documentos permanecem registrados no contexto da conversa no servidor, não sendo necessário reenviá-los a cada nova pergunta. Caso deseje remover os arquivos analisados, deve-se reiniciar o contexto através da opção de limpeza da conversa.

*'''Limpar conversa:''' Permite reiniciar o contexto da conversa. Ao acionar esta opção, um balão interativo de confirmação é apresentado no histórico do chat (com as opções ''Limpar Conversa'' ou ''Cancelar''). Ao confirmar, o sistema solicita a exclusão da conversa no serviço da OpenAI para evitar registros órfãos, remove os documentos e cookies locais e gera um novo ID de conversação limpo.

 
<center>[[Arquivo:cia_conv_docs_02.png|nenhum|750px]]</center>
 

Clicando no ícone da engrenagem localizado no canto superior direito da tela, temos acesso ao menu de opções e configurações da ferramenta:

*'''Provedor de IA:''' Permite selecionar o provedor de Inteligência Artificial. Atualmente está fixa a opção da OpenAI.
*'''Modelo de IA:''' Permite selecionar o modelo de Inteligência Artificial desejado para o processamento documental (ex.: GPT-5.4, GPT-5.4 Mini, GPT-5.2, GPT-5.1). A lista de modelos é atualizada dinamicamente a partir dos serviços disponíveis na Cia.
*'''Usuário Conectado:''' Exibe os dados do usuário autenticado no ERP CIGAM, incluindo nome, empresa (razão social / fantasia) e código de usuário.
*'''Ambiente & Sessão CIGAM:''' Apresenta o tipo de ambiente (produção ou depuração) e a URL da API CIGAM conectada, acompanhado de um botão de cópia rápida para facilitar diagnósticos e solicitações de suporte técnico.
*'''ID da Conversa Ativa:''' Exibe o identificador único da sessão com indicador visual de status em tempo real e botão para copiar o código do ID diretamente para a área de transferência.

*'''Documentação na wiki:''' Atalho que direciona diretamente aos manuais e guias de uso na CIGAM Wiki.

 
<center>[[Arquivo:cia_conv_docs_03.png|nenhum|750px]]</center>
 

Com os documentos anexados, podemos enviar perguntas e comandos no campo inferior para obter resumos executivos, explicações pontuais, cruzamento de dados entre arquivos distintos, localização de inconsistências ou extração de indicadores. Caso enviemos os arquivos sem digitar nenhuma mensagem complementar, a Cia aplicará o prompt de sistema padrão para realizar uma leitura analítica e retornar um resumo estruturado dos documentos.

O sistema dispõe de diretrizes de sistema corporativas (''System Prompt'') integradas ao ecossistema do ERP CIGAM, orientando o modelo a analisar com fidelidade os dados fornecidos, sem inventar informações ausentes.

Também é disponibilizado o recurso de '''Reconhecimento de Voz''' através do ícone de microfone (habilitado em conexões seguras HTTPS). O recurso conta com reconhecimento inteligente de pontuação falada: ao ditar expressões como ''"vírgula"'', ''"ponto"'', ''"ponto e vírgula"'', ''"dois pontos"'', ''"interrogação"'', ''"exclamação"'', ''"hífen"'', ''"abre parênteses"'', ''"fecha parênteses"'' ou ''"nova linha"'', os termos são automaticamente substituídos pelos respectivos sinais gráficos e as frases são capitalizadas de forma automática.

 
<center>[[Arquivo:cia_conv_docs_04.png|nenhum|750px]]</center>
 

As respostas retornadas pela Cia contam com formatação Markdown avançada, estruturando o conteúdo em títulos hierárquicos, listas ordenadas ou em tópicos, citações em bloco e tabelas responsivas estilizadas.

Além disso, sempre que a análise envolver dados numéricos comparativos, demonstrativos contábeis/financeiros (como DRE, receitas e despesas), séries temporais ou valores tabulares, a Cia gera automaticamente gráficos visuais e interativos integrados diretamente na resposta:
*'''Tipos de Gráficos Gerados:''' Barras verticais, linhas de tendência, gráficos de pizza e rosca, estilizados na paleta de cores oficial da Cia e com valores numéricos formatados no padrão brasileiro (pt-BR).
*'''Exportação do Gráfico:''' Cada card de gráfico possui um botão de download no canto superior direito, permitindo baixar a imagem em formato PNG em alta resolução para inclusão imediata em relatórios, apresentações ou envio por e-mail.

 
<center>[[Arquivo:cia_conv_docs_05.png|nenhum|750px]]</center>
 

Podemos manter uma conversa contínua com diversos documentos e mensagens em múltiplos turnos de diálogo. A Cia preserva o histórico de perguntas e respostas anteriores, permitindo aprofundar análises, solicitar detalhamentos de itens específicos ou anexar novos arquivos complementares ao longo da conversa.

</div>
{{VoltarInicio}}

=Desktop=
Na aplicação Desktop, além do acesso rápido à Cia Web, algumas ferramentas do sistema disponibilizam o recurso "Analisar com a Cia". 

==Acesso rápido à Cia Web (SaaS)==
O botão de acesso rápido (Cia - IA do CIGAM), disponível no menu lateral do Desktop, abre a Cia Web de forma integrada ao sistema, em uma janela do próprio CIGAM. 
 
Desde que as configurações necessárias tenham sido aplicadas, conforme [[GE - Como Fazer - Configuração da Cia IA do CIGAM#Acesso rápido à Cia Web (SaaS)|Acesso rápido à Cia Web (SaaS)]], '''todas as funcionalidades da Cia Web estarão disponíveis normalmente''', da mesma forma que no acesso pelo navegador. Para conhecê-las, consulte a seção [[#Cia Web (SaaS)|Cia Web (SaaS)]] desta documentação. 
 
[[Imagem:CiaAbertaDesktop.png|semmoldura|center|800px]]
 

==Recurso Analisar com a Cia==
O recurso '''"Analisar com a Cia"''' está disponível em ferramentas como CGEditor, CGReport, Pesquisa Dinâmica e Dispositivo de Saída. Em todas elas, o comportamento é o mesmo: a Cia analisa o conteúdo que está em uso na tela e gera um relatório com o resultado da análise, apresentado em uma nova página. 
 
'''Importante:''' na primeira vez que o usuário for utilizar o recurso pelo '''CGEditor''', pelo '''Visualizador de PDF''' ou pelo '''Dispositivo de Saída''', é necessário gerar um relatório merge pelo CIGAM, para que os arquivos de preferências sejam gravados com as informações necessárias ao funcionamento do recurso. Essa etapa não é necessária para as demais ferramentas. 
Ao acionar a opção, o fluxo é o seguinte: 
 
'''1. Confirmação dos termos de uso''' 
Antes de qualquer envio, será exibida uma mensagem solicitando que o usuário concorde com o envio das informações para análise. Os dados enviados seguem as diretrizes de segurança, privacidade e não retenção descritas em [[#Recursos, configurações e segurança|Recursos, configurações e segurança]]. 
 
[[Imagem:AnalisarCiaTermos.png|semmoldura|center|500px]]
 
'''2. Complemento do prompt (opcional)''' 
Disponível a partir do patch '''RC 250505.i''' ou da versão '''Beta 251103'''. 
 
Em seguida, será apresentada uma caixa de texto para que o usuário complemente a solicitação, orientando a análise para algum ponto específico. O preenchimento é opcional e pode ser deixado em branco. 
 
Essa caixa de texto serve apenas para complementar o prompt base que a Cia monta automaticamente, e não altera o conteúdo que está sendo enviado. O recurso considera que o usuário já filtrou os dados na própria tela do CIGAM antes de acionar a análise. O prompt base é mantido oculto por ser extenso e técnico, evitando que o usuário precise conferi-lo a cada utilização. 
 
[[Imagem:AnalisarCiaPrompt.png|semmoldura|center|700px]]
 
'''3. Geração do relatório''' 
Após a confirmação, a Cia processa o conteúdo e apresenta o relatório em uma nova página flutuante, com a análise dos dados enviados. 
 
O próprio relatório informa a quantidade de dados que foi analisada, permitindo que o usuário veja o volume aproximado considerado e identifique se o conteúdo enviado corresponde ao que esperava. 
 
[[Imagem:AnalisarCiaRelatorio.png|semmoldura|center|700px]]
 

A partir da versão '''Beta 261005''', o resultado da análise passa a ser apresentado em uma nova janela flutuante, que disponibiliza opções para utilização e compartilhamento do conteúdo gerado. Nessa versão, o recurso está disponível apenas para a '''Pesquisa Dinâmica/Pesquisa Paginada''' e para o '''FastReport'''. A partir da '''RC 270519''', ele também passa a estar disponível para o '''CGEditor''' e o '''Dispositivo de Saída'''. 
 
No cabeçalho dessa janela, são apresentados o título da análise e três opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.

 
[[Imagem:AnalisarCiaDesktopCompartilhar.png|semmoldura|center|800px]]
 

====Compartilhamento por e-mail====
<div align="justify">
Ao selecionar a opção '''E-mail''', é apresentada uma janela para preenchimento das informações necessárias ao envio da análise.

 
[[Imagem:AnalisarCiaDesktopEmail.png|semmoldura|center|700px]]
 

Após informar os destinatários e os demais dados da mensagem, basta selecionar '''Enviar'''. A análise gerada será encaminhada como um arquivo em anexo.

</div>

===Limite de conteúdo enviado===
<div align="justify">
Existe um limite para o volume de conteúdo enviado em cada análise, que varia conforme a versão do ambiente:

* '''150 KB''' — desde a disponibilização do recurso, na versão '''250505.a'''.
* '''3 MB''' — a partir das patches '''250505.i''' e '''251103.a''', e da versão '''RC 260504'''.

Quando o conteúdo selecionado ultrapassa esse limite, a Cia exibe uma mensagem informando o tamanho excedido e a análise não é processada, ou seja, nenhum relatório será gerado.

[[Imagem:AnalisarCiaLimite.png|semmoldura|center|600px]]

'''Esse limite não é parametrizável e não se trata de uma restrição imposta pela CIGAM.''' Ele decorre da própria capacidade dos modelos de IA integrados à Cia, que possuem um limite técnico de volume de dados que conseguem processar em uma única análise. Quando esse volume é ultrapassado, os modelos passam a analisar as informações por amostragem — ou seja, mesmo que fosse permitido enviar uma quantidade maior de dados, o modelo não analisaria todo o conteúdo, e o resultado seria menos preciso. O limite adotado pela Cia acompanha essa característica dos modelos e assegura que a análise seja feita sobre os dados completos.

Além da qualidade da análise, há também a questão do tempo de processamento: quanto maior o volume enviado, maior o tempo de resposta do modelo, tornando a espera inviável para o uso no dia a dia.

Por isso, o recurso foi feito para ser simples e direto: analisar, com um clique, os dados que o usuário já está visualizando pelos meios tradicionais do CIGAM, como grids filtrados e relatórios. Em ambientes com grande volume de dados, a prática recomendada é '''filtrar e consolidar as informações na própria tela antes de acionar a análise''', reduzindo o período ou o escopo consultado. Para análises de períodos maiores, recomenda-se utilizar dados já consolidados, como totalizadores e relatórios sintéticos, em vez de listagens analíticas completas.

A CIGAM está trabalhando em outras ferramentas que, por processarem os dados de forma diferente, permitirão trabalhar com volumes maiores de informação.

Para saber como acessar o recurso em cada ferramenta, consulte: [[GE - Como Fazer - Cia - Como acessar]]

{{VoltarInicio}}
</div>

=Documentos Relacionados=
[[GE - Como Fazer - Cia - Como acessar]] 
[[GE - Como Fazer - Configuração da Cia IA do CIGAM]]

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-10-30T14:15:46Z

Roger.schneider: /* Recurso Analisar com a Cia */

{{VoltarPagina}}
 
[[categoria:Como_Fazer_Utilidades/Diversos]]
[[categoria:Como_Fazer_Utilidades/Diversos_6]]
[[MediaWiki:Como_Fazer_sidebar|Como Fazer]] > [[Como_Fazer_Utilidades/Diversos|Utilidades/Diversos]] > [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer - Uso da Cia - IA do CIGAM]]

=Recursos, configurações e segurança=
A Cia - IA do CIGAM oferece diversas funcionalidades e atua como um hub centralizador para os recursos de inteligência artificial utilizados nas soluções CIGAM. Para garantir o correto funcionamento desses recursos, é necessário verificar se os pré-requisitos e as configurações foram realizados adequadamente. Para mais informações, consulte: [[GE - Como Fazer - Configuração da Cia IA do CIGAM|Como Fazer configuração da Cia IA do CIGAM]]
 
Todas as soluções de IA do CIGAM são integradas por meio dos serviços da Cia. A Cia possui integração com diferentes provedores de IA de terceiros, como OpenAI, Google, Anthropic, entre outros. Essas integrações são realizadas por meio de contas e serviços contratados, com condições de uso que asseguram que os dados trafegados não sejam utilizados para treinamento dos modelos, identificação de origem, publicidade, anúncios ou qualquer outra finalidade não prevista.
 
No caso de IAs open-source integradas à Cia, os modelos são executados dentro dos domínios da CIGAM, mantendo as mesmas premissas aplicadas às IAs contratadas: não utilização dos dados para treinamento de modelos, não identificação da origem das informações e ausência de retenção dos dados processados.
 
Além disso, sempre que houver envio explícito de dados pelo usuário por meio das funcionalidades da Cia disponíveis nas soluções CIGAM, será apresentado um diálogo de confirmação, permitindo que o usuário aceite o envio dessas informações. Os dados enviados serão tratados conforme as mesmas diretrizes de segurança, privacidade e não retenção descritas anteriormente.
 
Esta documentação apresenta o uso da Cia e está organizada conforme a forma de acesso: [[#Cia Web (SaaS)|Cia Web (SaaS)]], [[#Portais|Portais]] e [[#Desktop|Desktop]].
 
Caso tenha dúvidas sobre onde encontrar a Cia em cada uma dessas plataformas, ou sobre quais ferramentas do CIGAM possuem recursos integrados a ela, consulte a documentação específica de acesso: [[GE - Como Fazer - Cia - Como acessar|Como Fazer - Cia - Como acessar]]
{{VoltarInicio}}

=Cia Web (SaaS)=
A Cia Web é a aplicação web que centraliza todas as funcionalidades da Cia. Ela pode ser acessada diretamente pelo navegador do seu computador ou dispositivo móvel, ou ainda a partir do Desktop e dos Portais, sem a necessidade de novo login.
 

<center><youtube>https://youtu.be/DFGtRtPF75A</youtube></center>
 

==Primeiro acesso==
A Cia Web pode ser acessada diretamente pelo navegador, utilizando o seguinte endereço: https://services.cigam.cloud/cia/index.html
 
'''Importante:''' o usuário que for realizar o login precisa ter a autenticação em duas etapas habilitada. Para saber como configurá-la, consulte: [[GE - Como Fazer - Configuração da Cia IA do CIGAM#Autenticação em duas etapas e configurações de envio de e-mail|Autenticação em duas etapas e configurações de envio de e-mail]]
 
Ao acessar pelo endereço, será necessário preencher algumas informações para que a Cia consiga validar seu acesso e consultar seus dados: 
* Informar a API do seu CIGAM Server, para garantir o direcionamento correto da base de dados. 

[[Imagem:CiaAPI.png|semmoldura|center|700px]] 

* Informar usuário e senha de login e seu código de verificação: 

[[Imagem:CiaLogin.png|semmoldura|center|700px]]
 
[[Imagem:CiaCodVerif.png|semmoldura|center|700px]] 

* Caso não queira aguardar ou informar o código de verificação, você pode optar por responder à pergunta secreta, clicando no botão “Pergunta Secreta” exibido na imagem acima. 

[[Imagem:CiaLoginA2F.png|semmoldura|center|700px]]
 

==Conhecendo a tela da Cia==
Após realizar o login, a Cia carregará automaticamente as informações e dados necessários do ambiente e será iniciada no assunto '''#Geral''', identificado pelo botão localizado à esquerda da caixa de texto.

[[Imagem:CiaGeral.png|semmoldura|center|700px]]
 
Ao clicar nesse botão, será exibida uma lista com todos os assuntos disponíveis, permitindo que você selecione aquele com o qual deseja interagir. 
Além disso, você pode digitar diretamente na caixa de texto o '''#Assunto''' que deseja utilizar, e a Cia entenderá automaticamente o tema da sua mensagem. 
Também é possível '''formular uma pergunta seguida de um #Assunto''' para interagir com qualquer assunto, mesmo que ele não esteja selecionado no momento.

[[Imagem:CiaAberta.png|semmoldura|center|700px]]
 
Ao selecionar um assunto, serão exibidas automaticamente dicas e sugestões sobre o tema escolhido, além de exemplos clicáveis que, ao serem selecionados, são processados de forma imediata. 
Além disso, ao digitar um ponto de interrogação (?) na caixa de texto, será exibida uma lista com todas as interações disponíveis para o assunto selecionado, facilitando a descoberta de comandos e possibilidades de uso.

[[Imagem:CiaDicas.png|semmoldura|center|700px]]
 
Outra funcionalidade prática é a possibilidade de reenviar perguntas já feitas no chat. Para isso, basta posicionar o mouse sobre a pergunta desejada e clicar no ícone de “Reenviar”. Ao passar o mouse sobre a mensagem, também será exibido o horário de envio.
 
[[Imagem:CiaReenviar.png|semmoldura|center|400px]]
 
Além disso, você pode utilizar as setas do teclado (⬆️ para cima e ⬇️ para baixo) na caixa de texto para navegar pelas últimas perguntas enviadas para o #Assunto selecionado, facilitando o reuso de interações anteriores.

===Ícones da caixa de texto===
Na caixa de texto, você encontrará alguns ícones com as seguintes funções:

<center>
{| class="wikitable"
|-
! !! Ação
|-
|center|[[Imagem:CiaUltPerg.png]] || '''Histórico de Perguntas''' – Ao clicar, é exibido o histórico das perguntas já realizadas para o assunto selecionado.
|-
|center|[[Imagem:CiaEnviar.png]] || '''Enviar''' – Envia o conteúdo digitado na caixa de texto.
|-
|center|[[Imagem:CiaFala.png]] || '''Falar''' – Permite falar ao invés de digitar, usando o recurso de voz.
|-
|center|[[Imagem:CiaExpandir.png]] || '''Expandir''' – Aumenta a altura da caixa de texto para facilitar a digitação de mensagens longas.
|-
|center|[[Imagem:CiaRecolher.png]] || '''Recolher''' – Reduz a caixa de texto ao tamanho padrão.
|}
</center>
{{VoltarInicio}}

==Assuntos disponíveis==

===Geral===
Nesse assunto, é possível conversar livremente com a Cia sobre qualquer um dos assuntos disponíveis. Se encontrar dificuldades para obter a resposta desejada, experimente selecionar um assunto específico, o que pode gerar resultados mais precisos. 
Se houver muitas respostas correspondentes, a Cia não executará nenhuma automaticamente. Em vez disso, exibirá uma opção com os valores possíveis, permitindo que você selecione manualmente a melhor alternativa.

[[Imagem:CiaGeralOpcoes.png|semmoldura|center|700px]]
 
Caso a Cia encontre uma resposta com confiança significativamente maior que as demais, ela será executada automaticamente.
 
No entanto, se você selecionar a opção “Não era bem isso o que eu queria”, a Cia exibirá outras opções relacionadas ao que foi solicitado, apresentando também um indicador de semáforo com a porcentagem de confiança de cada alternativa.

[[Imagem:CiaGeralOpcaoCerta.png|semmoldura|center|600px]]

===Ajuda, Vídeos e Auditor===
Conheça melhor o ERP com a ajuda da Wiki e Cia, assista vídeos sobre o CIGAM e audite seu ambiente.

====Ajuda====
Nesse assunto, você pode acessar o Chatbot da assistente virtual, onde você pode tirar dúvidas e consultar conteúdos da CIGAM Wiki enviando perguntas diretamente nela. 
 
'''Importante:''' neste assunto, a Cia atua dedicada à Wiki, focada exclusivamente nos conteúdos da documentação. As demais funcionalidades e atalhos da Cia não estarão disponíveis nesse contexto.

====Vídeos====
Nesse assunto, é possível procurar por vídeos relacionados ao tema desejado. O resultado será apresentado em forma de lista, contendo os vídeos encontrados e os tempos exatos em que o assunto começa a ser abordado, de acordo com o termo ou palavra pesquisada.

====Auditor====
Neste assunto, é possível verificar o status do sistema e identificar possíveis problemas ou inconsistências. O resultado será exibido em forma de tabela, contendo os dados retornados para facilitar a análise.

===Painéis BI, Portais e Relatórios===
Explore dashboards do BI, interaja com Portais intuitivos e execute relatórios personalizados.

====Painéis BI====
Nesse assunto, é possível abrir dashboards do BI já configurados para o usuário, permitindo sua visualização diretamente na tela.
Ao abrir um dashboard, você também pode interagir com ele, solicitando inserção de filtros, dimensões, métricas, transformações e outros ajustes. 
Cada dashboard aberto exibirá uma guia com as “Interações” disponíveis para aquele painel específico.
 
Além disso, ao selecionar o assunto '''#Painéis do BI''', é possível solicitar que a Cia crie um dashboard do zero.
Por exemplo: "Crie um dashboard para ver meu fluxo de caixa". Você pode ainda solicitar que métricas, dimensões e filtros sejam adicionados durante a criação, ou pedir dashboards separados por áreas.
 
'''Importante:''' caso o usuário não possua acesso ao BI ou este não esteja implementado na base de dados, será exibida uma mensagem informativa no momento do login na Cia.

====Portais====
Quando este assunto é utilizado, o resultado será sempre a abertura de uma tela dos Portais, permitindo ao usuário acessar diretamente os conteúdos e funcionalidades disponíveis nesse ambiente.
 
Essa abertura é feita de forma integrada, garantindo uma navegação contínua entre a Cia e os Portais, sem necessidade de realizar novo login ou sair da plataforma.

====Relatórios====
Ao utilizar esse assunto, será exibida uma tela para preenchimento de filtros, permitindo a emissão de relatórios web.
 
Para que essa funcionalidade opere corretamente, é necessário garantir que a instalação da CDN e da Pesquisa Dinâmica no servidor de aplicação esteja configurada de forma adequada.
 
Os relatórios exibidos aqui são os mesmos disponíveis nos Portais CIGAM, portanto é essencial que esses componentes também estejam funcionando corretamente nesses Portais.

===Qual, Faça, Consultar, Listar, Analisar e Insights===
Crie registros, analise informações ou liste dados cadastrados no CIGAM.

====Qual====
Nesse assunto, a Cia vai consultar e processar informações diretamente no ERP, usando os dados e relacionamentos disponíveis no CIGAM, e retornar os resultados em forma de texto para você visualizar.
 
'''Importante:''' nem todas as opções estão liberadas. Para ver quais você pode usar, digite ? na caixa de texto. A Cia vai mostrar uma lista com todos os comandos e funções disponíveis.

====Faça====
Nesse assunto, a Cia sempre fará um processamento no CIGAM e retornará o status do resultado. Por exemplo, você pode solicitar que a Cia crie um alerta ou até mesmo crie uma nova empresa no sistema.
 
'''Dica:''' para saber quais treinamentos ou comandos estão disponíveis, digite ? na caixa de texto. A Cia mostrará uma lista com todas as opções implementadas para você usar.

====Consultar====
Nesse assunto, você poderá fazer consultas de dados para obter listagens de registros, conforme os treinamentos de tabelas disponíveis. O resultado será apresentado em forma de tabela, exibindo os dados retornados. Já existem diversas Views prontas, para que você possa listar informações de forma mais completa e rápida.
 
'''Dica:''' para ver exemplos de consultas já implementadas, digite ? na caixa de texto.

====Listar====
Nesse assunto, você pode montar sua própria consulta de dados, escolhendo os filtros e parâmetros para gerar uma listagem personalizada. Diferente do assunto #Consultar, aqui é possível utilizar qualquer tabela do CIGAM para montar sua consulta, escrevendo em linguagem natural o que deseja buscar.
 
'''Dica:''' para ver todas as tabelas disponíveis, digite ? na caixa de texto.

====Analisar====
Analise o arquivo selecionado para gerar gráficos interativos e informativos, apresentando insights relevantes que ajudam a identificar tendências, padrões e oportunidades de melhoria.
 
Esse recurso oferece uma visualização clara e intuitiva dos dados, facilitando a interpretação das informações e apoiando a tomada de decisões estratégicas.
 
'''Aviso:''' para utilizar esta funcionalidade, é necessário concordar que os dados enviados serão processados por modelos de IA de terceiros integrados à Cia.

[[Imagem:AnalisarCia.png|semmoldura|center|600px]]

====Insights====
Gere insights inteligentes a partir dos dados de uma consulta, com análises automáticas realizadas pela Cia, que identificam padrões, tendências e possíveis pontos de atenção. Esse recurso ajuda a transformar dados brutos em informações acionáveis, facilitando a tomada de decisões estratégicas e otimizando processos.
 
'''Aviso:''' ao utilizar o assunto “Insights”, você concorda que os dados e informações analisados poderão ser enviados para modelos de IA de terceiros integrados à Cia, exclusivamente para processamento e geração dos resultados apresentados.

===IA Generativa e Pesquisa na Internet===
Converse com a IA sobre assuntos diversos, crie conteúdos e pesquise na internet sobre qualquer coisa.

====IA Generativa====
Nesse assunto, ao interagir com a IA Generativa, você poderá fazer qualquer tipo de pergunta ou solicitação, de forma livre e criativa.
O resultado exibido será exatamente a resposta gerada pela IA, sem complementos da Cia. Você pode, por exemplo, solicitar que a IA melhore ou reformule um texto, crie conteúdos ou resuma informações.
 
'''Importante:''' nesse assunto, a Cia não estará integrada aos serviços e sistemas do CIGAM — a interação é exclusivamente com a IA Generativa.

====Pesquisa na Internet====
Use esse assunto para fazer pesquisas na internet e visualizar os resultados diretamente integrados na Cia, sem precisar sair da plataforma. Você pode pesquisar qualquer tema de interesse e abrir os links retornados para acessar conteúdos, notícias e informações de forma rápida e prática.
{{VoltarInicio}}

===Compartilhamento de Análises da Cia===

 
<div align="justify">
Na Cia Web (SaaS), é possível gerar análises detalhadas de determinadas informações e compartilhá-las. Essa funcionalidade está disponível nos seguintes assuntos: [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Auditor|Auditor]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Analisar|Analisar]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Insights|Insights]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Listar|Listar]] e [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Consultar|Consultar]].
</div>
 

[[Image: opcoesAnalisarCia.png|semmoldura|center|800px]]

 
<div align="justify">
Essa opção está disponível por meio do botão '''Analisar''', exibido junto à resposta apresentada após a solicitação de um desses assuntos.
</div>
 

[[Image: exemploBotaoAnalisar.png|semmoldura|center|800px]]

 
<div align="justify">
Particularmente para o assunto '''Analisar''', a análise já é exibida diretamente, pois essa é a finalidade desse assunto:
</div>
 

[[Image: analiseAnalisar.png|semmoldura|center|800px]]

 
<div align="justify">
Ao gerar uma análise , a página de resultado passa a disponibilizar opções para compartilhar e utilizar o conteúdo gerado. São disponibilizadas três opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.
</div>
 

[[Image: CiaWebAnalise.png|semmoldura|center|800px]]

=====Compartilhamento por e-mail=====

<div align="justify">
Ao selecionar a opção '''E-mail''', é apresentada uma janela para preenchimento das informações necessárias ao envio da análise.
</div>
 

[[Image: CiaWebModalEmail.png|semmoldura|center|800px]]

 
<div align="justify">
Após informar os destinatários e os demais dados da mensagem, basta selecionar '''Enviar'''. A análise gerada será encaminhada como um arquivo em anexo.

Para utilizar esse recurso, o ambiente deve possuir as configurações necessárias para envio de e-mails pelo CIGAM devidamente parametrizadas. Para mais informações, consulte [[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]].
</div>

==Configurações==
O ícone de engrenagem, localizado no canto superior direito da página, reúne recursos de informação e gerenciamento. As opções disponíveis são:
* '''Respostas com áudio:''' quando ativado, as respostas da Cia são narradas em voz alta.
* '''Ambiente atual do CIGAM:''' exibe na tela o usuário logado e o ambiente em uso.
* '''Ver consumo:''' mostra a quantidade de tokens já utilizados e os usuários que geraram consumo.
* '''Limpar dados de navegação:''' exibe uma mensagem explicando como limpar os dados de navegação do navegador.
* '''Limpar cookies:''' apaga os dados armazenados localmente, permitindo informar novamente a API e realizar um novo login.
* '''Instalar aplicativo:''' instala a Cia como aplicativo no dispositivo, criando um atalho na tela inicial.
* '''Documentação na wiki:''' direciona para a documentação da Cia na CIGAM Wiki.
* '''Sair:''' encerra a sessão do usuário, permitindo realizar login com outro usuário.
 
[[Imagem:ConfiguracoesCia.png|semmoldura|center|500px]]
{{VoltarInicio}}

=Portais=
Nos Portais CIGAM, além do acesso à Cia Web pelo menu de mosaico, estão disponíveis recursos de IA que atuam diretamente nas telas em que você está trabalhando. Esses recursos não exigem parametrização e são apresentados de acordo com o contexto da tela. 

==Acesso à Cia Web (SaaS) pelo menu mosaico==
O acesso à Cia Web a partir dos Portais é feito pelo ícone de mosaico, onde está disponível o ícone da Cia - IA do CIGAM. 
 
[[Imagem:mosaicoCia.png|semmoldura|center|800px]]
 
A Cia será aberta de forma integrada, sem a necessidade de novo login, e todas as funcionalidades descritas na seção [[#Cia Web (SaaS)|Cia Web (SaaS)]] estarão disponíveis normalmente. 

==Geração de conteúdo==
Na barra superior dos Portais está disponível um ícone com um menu de contexto que permite interagir com os '''campos de texto''' de qualquer parte dos Portais. As opções disponíveis permitem melhorar textos, criar conteúdos, revisar a gramática, entre outras ações. 
 
[[Imagem:comandosCia.png|semmoldura|center|650px]]
 
A partir da versão '''Beta 260601''', essas opções passaram a ser exibidas em uma seção separada, chamada '''Geração de conteúdo''', apresentada no mesmo menu em que ficam os agentes. 
 
[[Imagem:MenuGeracaoConteudoAgentes.png|semmoldura|center|800px]]
 
O campo processado é sempre o '''último campo em que o cursor esteve posicionado''' antes de abrir o menu da Cia. Por isso, basta clicar no campo desejado e, em seguida, acionar o menu e escolher o comando. 
 
Para que o comando seja executado, o campo precisa ser um '''campo de texto válido''' e conter, no mínimo, '''três palavras'''. Caso contrário, será apresentada uma mensagem informando que o conteúdo não atende aos requisitos. 
 
Após o processamento, o conteúdo gerado é aplicado automaticamente no campo, substituindo o texto anterior, sem necessidade de confirmação. 
 
Essa funcionalidade também está disponível em telas modais, ou seja, janelas sobrepostas com interações: 
 
[[Imagem:comandosModalCia.png|semmoldura|center|800px]]
 

==Agentes==
A partir da versão '''Beta 260601''', o menu da Cia nos Portais passou a disponibilizar também o acesso aos agentes, tanto nos Portais MVC quanto nos Portais React. 
 
Ao abrir o menu da Cia, os agentes disponíveis são detectados automaticamente de acordo com a tela que está sendo acessada, ou seja, as opções apresentadas variam conforme a página aberta. 
 
[[Imagem:MenuAgentesCia.png|semmoldura|center|800px]]
 

===Como os agentes são disponibilizados===
A disponibilização de cada agente pode ocorrer de quatro formas: 
 
* '''Por contexto:''' o agente é apresentado quando a Cia identifica que a tela acessada corresponde ao assunto tratado por ele. Por exemplo, um agente sobre Ordem de Produção será disponibilizado ao acessar uma página cujo contexto seja identificado como Ordem de Produção.
 
* '''Por parâmetro:''' o agente é apresentado quando a Cia identifica, na tela, um parâmetro com o valor esperado por ele. Por exemplo, um agente de Pedidos será disponibilizado quando existir na tela um parâmetro que contenha o código do pedido.
 
* '''Por contexto e parâmetro:''' o agente é apresentado somente quando as duas condições forem atendidas ao mesmo tempo.
 
* '''Sempre disponível:''' o agente é apresentado em qualquer tela, independentemente do contexto ou dos parâmetros.
 

===Resultado do processamento===
Após o processamento, o retorno do agente pode ser apresentado de duas formas, conforme o que foi executado: 
 
* Em uma '''nova guia''' do navegador, quando o agente gera algum conteúdo ou relatório como resultado.
 
[[Imagem:AgentesRetornoGuia.png|semmoldura|center|800px]]
 
* Em uma '''janela modal''', dentro da própria página em que o usuário está, quando o retorno é uma mensagem.
 
[[Imagem:AgentesRetornoModal.png|semmoldura|center|800px]]
 
<div align="justify>
A partir da versão '''Beta 261005''', quando o resultado do agente é apresentado em uma nova guia, a página passa a disponibilizar também opções para utilização e compartilhamento da análise.
</div>
 
[[Imagem:resultadoAnalise.png|semmoldura|center|800px]]
 
<div align="justify">
No cabeçalho são apresentados o nome do agente executado e as opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.
</div>
<div align="justify">
=====Compartilhamento por e-mail=====
A janela abaixo é exibida quando selecionada a opção '''E-mail''':
</div>
 
[[Imagem:modalEmail.png|semmoldura|center|800px]]
 
<div align="justify">

Para utilizar esse recurso, o ambiente deve possuir as configurações necessárias para envio de e-mails pelo CIGAM devidamente parametrizadas. Para mais informações, consulte [[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]].
</div>

==Editor de Agentes==
<div align="justify">
A partir da versão '''Beta 261005''', o menu passou a disponibilizar o acesso à ferramenta '''Editor de Agentes''', que permite criar seus próprios agentes.

 
[[Imagem:EditorAgentesCia.png|semmoldura|center|750px]]
 

Ao clicar na opção, será aberta uma página web e ocorrerá a validação do ambiente e autenticação.

 
[[Imagem:EditorAgentesCiaValidandoAuth.png|semmoldura|center|750px]]
 

Quando não forem identificados uma API e um token válidos, ocorrerá a mensagem de bloqueio à ferramenta.

 
[[Imagem:EditorAgentesCiaBloqueio.png|semmoldura|center|750px]]
 

A página utiliza o formato de assistente (wizard), com cada etapa explicada de forma detalhada. Basta preencher as informações do agente conforme a sua necessidade e avançar pelos passos até a conclusão. Temos a opção de "Abrir" um agente já criado para podermos editar suas informações ou criar um agente do zero.

 
[[Imagem:EditorAgentesCia_logado.png|semmoldura|center|750px]]
 

Na última etapa teremos a opção de "Criar Agente" onde será realizado o download do arquivo.

 
[[Imagem:EditorAgentesWizardBaixar.png|semmoldura|center|750px]]
 

Ao final do processo, será gerado um arquivo com a extensão '''.cgagt''', que contém a definição do agente criado.

{{VoltarInicio}}
</div>
===Disponibilizando o agente criado===
<div align="justify">
Para que o agente passe a ser exibido nos Portais, o arquivo '''.cgagt''' precisa ser colocado na aplicação da API, dentro da pasta raiz da aplicação. 
 
É necessário que existam as pastas '''Exclusivo''' e, dentro dela, '''Agentes'''. Caso não existam, elas devem ser criadas manualmente. O arquivo deve ser colocado dentro dessa estrutura, ficando da seguinte forma: 
 
/api/exclusivo/agentes/
 
Assim que o arquivo é adicionado nesse local, a Cia passa a reconhecer o agente automaticamente, sem necessidade de qualquer outra configuração. Os agentes customizados são exibidos no menu da Cia nos Portais, em uma seção separada dos agentes padrão. 
 
[[Imagem:MenuAgentesCustomizados.png|semmoldura|center|800px]]
 
{{VoltarInicio}}
</div>

==Conversar com documentos==
<div align="justify">
A ferramenta de '''Conversar com documentos''' permite analisar, resumir e cruzar informações contidas em arquivos e relatórios através de modelos avançados de Inteligência Artificial integrados ao ERP CIGAM.

O acesso pode ser realizado a partir da tela principal da Cia Web (SaaS), clicando na opção correspondente ou digitando o assunto <code>#Documentos</code>, momento em que a aplicação é aberta em uma nova guia do navegador assim que digitada a primeira mensagem.

Além disto, podemos acessar a aplicação através dos Portais CIGAM, conforme descrito em [[GE_-_Como_Fazer_-_Cia_-_Como_acessar#Conversar_com_documentos|Como acessar]].

Para a utilização da aplicação, é necessário estar autenticado com um token de autorização CIGAM e com o endereço da API CIGAM devidamente parametrizado. Logo ao abrir, o sistema avalia o ambiente e valida a sessão do usuário.

Estando os parâmetros validados, será gerado automaticamente um ID de conversação (''Conversation ID'') exclusivo para a sessão. Esta identificação é armazenada em cookies do navegador com validade de 24 horas, permitindo que a Cia armazene e mantenha o contexto contínuo de todas as mensagens e documentos anexados. Caso a página seja atualizada ou fechada dentro deste período, a sessão conectada e os arquivos são recuperados automaticamente.

 
<center>[[Arquivo:cia_conv_docs_01.png|nenhum|750px]]</center>
 

No primeiro acesso, é obrigatório marcar a opção '''Termo de consentimento''' para indicar ciência de que os dados e documentos selecionados para análise serão enviados aos modelos de IA de terceiros integrados com a Cia. Por segurança e conformidade, os campos de envio e a área de anexos permanecem bloqueados até que o consentimento seja confirmado. Uma vez aceito, uma mensagem de registro é inserida no histórico da conversa e a preferência é memorizada para a sessão.

Após confirmar o termo, a área de upload no painel lateral esquerdo é habilitada, permitindo anexar múltiplos arquivos simultaneamente, seja arrastando e soltando os documentos sobre a área de dropzone, seja clicando sobre ela para abrir a janela de seleção de arquivos.

A ferramenta suporta uma ampla variedade de formatos corporativos:
*'''Documentos de Texto e Portáteis:''' PDF (<code>.pdf</code>), Texto Simples (<code>.txt</code>), Word (<code>.doc</code>, <code>.docx</code>).
*'''Planilhas e Dados Tabulares:''' Planilhas Excel (<code>.xlsx</code>, <code>.xls</code>), Valores Separados por Vírgula (<code>.csv</code>).
*'''Arquivos de Estrutura de Dados:''' Arquivos <code>.json</code> e <code>.xml</code>.

No painel lateral, é possível visualizar o contador total de documentos anexados, o ícone específico do formato, o nome, o tamanho do arquivo formatado e a indicação de que o documento encontra-se ativo no contexto da conversa. Em dispositivos móveis ou telas menores, o painel lateral pode ser recolhido ou expandido através do botão retrátil no topo da barra.

Uma vez enviados para análise, os documentos permanecem registrados no contexto da conversa no servidor, não sendo necessário reenviá-los a cada nova pergunta. Caso deseje remover os arquivos analisados, deve-se reiniciar o contexto através da opção de limpeza da conversa.

*'''Limpar conversa:''' Permite reiniciar o contexto da conversa. Ao acionar esta opção, um balão interativo de confirmação é apresentado no histórico do chat (com as opções ''Limpar Conversa'' ou ''Cancelar''). Ao confirmar, o sistema solicita a exclusão da conversa no serviço da OpenAI para evitar registros órfãos, remove os documentos e cookies locais e gera um novo ID de conversação limpo.

 
<center>[[Arquivo:cia_conv_docs_02.png|nenhum|750px]]</center>
 

Clicando no ícone da engrenagem localizado no canto superior direito da tela, temos acesso ao menu de opções e configurações da ferramenta:

*'''Provedor de IA:''' Permite selecionar o provedor de Inteligência Artificial. Atualmente está fixa a opção da OpenAI.
*'''Modelo de IA:''' Permite selecionar o modelo de Inteligência Artificial desejado para o processamento documental (ex.: GPT-5.4, GPT-5.4 Mini, GPT-5.2, GPT-5.1). A lista de modelos é atualizada dinamicamente a partir dos serviços disponíveis na Cia.
*'''Usuário Conectado:''' Exibe os dados do usuário autenticado no ERP CIGAM, incluindo nome, empresa (razão social / fantasia) e código de usuário.
*'''Ambiente & Sessão CIGAM:''' Apresenta o tipo de ambiente (produção ou depuração) e a URL da API CIGAM conectada, acompanhado de um botão de cópia rápida para facilitar diagnósticos e solicitações de suporte técnico.
*'''ID da Conversa Ativa:''' Exibe o identificador único da sessão com indicador visual de status em tempo real e botão para copiar o código do ID diretamente para a área de transferência.

*'''Documentação na wiki:''' Atalho que direciona diretamente aos manuais e guias de uso na CIGAM Wiki.

 
<center>[[Arquivo:cia_conv_docs_03.png|nenhum|750px]]</center>
 

Com os documentos anexados, podemos enviar perguntas e comandos no campo inferior para obter resumos executivos, explicações pontuais, cruzamento de dados entre arquivos distintos, localização de inconsistências ou extração de indicadores. Caso enviemos os arquivos sem digitar nenhuma mensagem complementar, a Cia aplicará o prompt de sistema padrão para realizar uma leitura analítica e retornar um resumo estruturado dos documentos.

O sistema dispõe de diretrizes de sistema corporativas (''System Prompt'') integradas ao ecossistema do ERP CIGAM, orientando o modelo a analisar com fidelidade os dados fornecidos, sem inventar informações ausentes.

Também é disponibilizado o recurso de '''Reconhecimento de Voz''' através do ícone de microfone (habilitado em conexões seguras HTTPS). O recurso conta com reconhecimento inteligente de pontuação falada: ao ditar expressões como ''"vírgula"'', ''"ponto"'', ''"ponto e vírgula"'', ''"dois pontos"'', ''"interrogação"'', ''"exclamação"'', ''"hífen"'', ''"abre parênteses"'', ''"fecha parênteses"'' ou ''"nova linha"'', os termos são automaticamente substituídos pelos respectivos sinais gráficos e as frases são capitalizadas de forma automática.

 
<center>[[Arquivo:cia_conv_docs_04.png|nenhum|750px]]</center>
 

As respostas retornadas pela Cia contam com formatação Markdown avançada, estruturando o conteúdo em títulos hierárquicos, listas ordenadas ou em tópicos, citações em bloco e tabelas responsivas estilizadas.

Além disso, sempre que a análise envolver dados numéricos comparativos, demonstrativos contábeis/financeiros (como DRE, receitas e despesas), séries temporais ou valores tabulares, a Cia gera automaticamente gráficos visuais e interativos integrados diretamente na resposta:
*'''Tipos de Gráficos Gerados:''' Barras verticais, linhas de tendência, gráficos de pizza e rosca, estilizados na paleta de cores oficial da Cia e com valores numéricos formatados no padrão brasileiro (pt-BR).
*'''Exportação do Gráfico:''' Cada card de gráfico possui um botão de download no canto superior direito, permitindo baixar a imagem em formato PNG em alta resolução para inclusão imediata em relatórios, apresentações ou envio por e-mail.

 
<center>[[Arquivo:cia_conv_docs_05.png|nenhum|750px]]</center>
 

Podemos manter uma conversa contínua com diversos documentos e mensagens em múltiplos turnos de diálogo. A Cia preserva o histórico de perguntas e respostas anteriores, permitindo aprofundar análises, solicitar detalhamentos de itens específicos ou anexar novos arquivos complementares ao longo da conversa.

</div>
{{VoltarInicio}}

=Desktop=
Na aplicação Desktop, além do acesso rápido à Cia Web, algumas ferramentas do sistema disponibilizam o recurso "Analisar com a Cia". 

==Acesso rápido à Cia Web (SaaS)==
O botão de acesso rápido (Cia - IA do CIGAM), disponível no menu lateral do Desktop, abre a Cia Web de forma integrada ao sistema, em uma janela do próprio CIGAM. 
 
Desde que as configurações necessárias tenham sido aplicadas, conforme [[GE - Como Fazer - Configuração da Cia IA do CIGAM#Acesso rápido à Cia Web (SaaS)|Acesso rápido à Cia Web (SaaS)]], '''todas as funcionalidades da Cia Web estarão disponíveis normalmente''', da mesma forma que no acesso pelo navegador. Para conhecê-las, consulte a seção [[#Cia Web (SaaS)|Cia Web (SaaS)]] desta documentação. 
 
[[Imagem:CiaAbertaDesktop.png|semmoldura|center|800px]]
 

==Recurso Analisar com a Cia==
O recurso '''"Analisar com a Cia"''' está disponível em ferramentas como CGEditor, CGReport, Pesquisa Dinâmica e Dispositivo de Saída. Em todas elas, o comportamento é o mesmo: a Cia analisa o conteúdo que está em uso na tela e gera um relatório com o resultado da análise, apresentado em uma nova página. 
 
Ao acionar a opção, o fluxo é o seguinte: 
 
'''1. Confirmação dos termos de uso''' 
Antes de qualquer envio, será exibida uma mensagem solicitando que o usuário concorde com o envio das informações para análise. Os dados enviados seguem as diretrizes de segurança, privacidade e não retenção descritas em [[#Recursos, configurações e segurança|Recursos, configurações e segurança]]. 
 
[[Imagem:AnalisarCiaTermos.png|semmoldura|center|500px]]
 
'''2. Complemento do prompt (opcional)''' 
Em seguida, será apresentada uma caixa de texto para que o usuário complemente a solicitação, orientando a análise para algum ponto específico. O preenchimento é opcional e pode ser deixado em branco. 
 
Essa caixa de texto serve apenas para complementar o prompt base que a Cia monta automaticamente, e não altera o conteúdo que está sendo enviado. O recurso considera que o usuário já filtrou os dados na própria tela do CIGAM antes de acionar a análise. O prompt base é mantido oculto por ser extenso e técnico, evitando que o usuário precise conferi-lo a cada utilização. 
 
[[Imagem:AnalisarCiaPrompt.png|semmoldura|center|700px]]
 
'''3. Geração do relatório''' 
Após a confirmação, a Cia processa o conteúdo e apresenta o relatório em uma nova página flutuante, com a análise dos dados enviados. 
 
O próprio relatório informa a quantidade de dados que foi analisada, permitindo que o usuário veja o volume aproximado considerado e identifique se o conteúdo enviado corresponde ao que esperava. 
 
[[Imagem:AnalisarCiaRelatorio.png|semmoldura|center|700px]]
 

A partir da versão '''Beta 261005''', o resultado da análise passa a ser apresentado em uma nova janela flutuante, que disponibiliza opções para utilização e compartilhamento do conteúdo gerado. Nessa versão, o recurso está disponível apenas para a '''Pesquisa Dinâmica/Pesquisa Paginada''' e para o '''FastReport'''. A partir da '''RC 270519''', ele também passa a estar disponível para o '''CGEditor''' e o '''Dispositivo de Saída'''. 
 
No cabeçalho dessa janela, são apresentados o título da análise e três opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.

 
[[Imagem:AnalisarCiaDesktopCompartilhar.png|semmoldura|center|800px]]
 

====Compartilhamento por e-mail====
<div align="justify">
Ao selecionar a opção '''E-mail''', é apresentada uma janela para preenchimento das informações necessárias ao envio da análise.

 
[[Imagem:AnalisarCiaDesktopEmail.png|semmoldura|center|700px]]
 

Após informar os destinatários e os demais dados da mensagem, basta selecionar '''Enviar'''. A análise gerada será encaminhada como um arquivo em anexo.

</div>

===Limite de conteúdo enviado===
<div align="justify">
Existe um limite para o volume de conteúdo enviado em cada análise, que varia conforme a versão do ambiente:

* '''150 KB''' — desde a disponibilização do recurso, na versão '''250505.a'''.
* '''3 MB''' — a partir das patches '''250505.i''' e '''251103.a''', e da versão '''RC 260504'''.

Quando o conteúdo selecionado ultrapassa esse limite, a Cia exibe uma mensagem informando o tamanho excedido e a análise não é processada, ou seja, nenhum relatório será gerado.

[[Imagem:AnalisarCiaLimite.png|semmoldura|center|600px]]

'''Esse limite não é parametrizável e não se trata de uma restrição imposta pela CIGAM.''' Ele decorre da própria capacidade dos modelos de IA integrados à Cia, que possuem um limite técnico de volume de dados que conseguem processar em uma única análise. Quando esse volume é ultrapassado, os modelos passam a analisar as informações por amostragem — ou seja, mesmo que fosse permitido enviar uma quantidade maior de dados, o modelo não analisaria todo o conteúdo, e o resultado seria menos preciso. O limite adotado pela Cia acompanha essa característica dos modelos e assegura que a análise seja feita sobre os dados completos.

Além da qualidade da análise, há também a questão do tempo de processamento: quanto maior o volume enviado, maior o tempo de resposta do modelo, tornando a espera inviável para o uso no dia a dia.

Por isso, o recurso foi feito para ser simples e direto: analisar, com um clique, os dados que o usuário já está visualizando pelos meios tradicionais do CIGAM, como grids filtrados e relatórios. Em ambientes com grande volume de dados, a prática recomendada é '''filtrar e consolidar as informações na própria tela antes de acionar a análise''', reduzindo o período ou o escopo consultado. Para análises de períodos maiores, recomenda-se utilizar dados já consolidados, como totalizadores e relatórios sintéticos, em vez de listagens analíticas completas.

A CIGAM está trabalhando em outras ferramentas que, por processarem os dados de forma diferente, permitirão trabalhar com volumes maiores de informação.

Para saber como acessar o recurso em cada ferramenta, consulte: [[GE - Como Fazer - Cia - Como acessar]]

{{VoltarInicio}}
</div>

=Documentos Relacionados=
[[GE - Como Fazer - Cia - Como acessar]] 
[[GE - Como Fazer - Configuração da Cia IA do CIGAM]]

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-10-30T14:14:54Z

Roger.schneider: /* Recurso Analisar com a Cia */

{{VoltarPagina}}
 
[[categoria:Como_Fazer_Utilidades/Diversos]]
[[categoria:Como_Fazer_Utilidades/Diversos_6]]
[[MediaWiki:Como_Fazer_sidebar|Como Fazer]] > [[Como_Fazer_Utilidades/Diversos|Utilidades/Diversos]] > [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer - Uso da Cia - IA do CIGAM]]

=Recursos, configurações e segurança=
A Cia - IA do CIGAM oferece diversas funcionalidades e atua como um hub centralizador para os recursos de inteligência artificial utilizados nas soluções CIGAM. Para garantir o correto funcionamento desses recursos, é necessário verificar se os pré-requisitos e as configurações foram realizados adequadamente. Para mais informações, consulte: [[GE - Como Fazer - Configuração da Cia IA do CIGAM|Como Fazer configuração da Cia IA do CIGAM]]
 
Todas as soluções de IA do CIGAM são integradas por meio dos serviços da Cia. A Cia possui integração com diferentes provedores de IA de terceiros, como OpenAI, Google, Anthropic, entre outros. Essas integrações são realizadas por meio de contas e serviços contratados, com condições de uso que asseguram que os dados trafegados não sejam utilizados para treinamento dos modelos, identificação de origem, publicidade, anúncios ou qualquer outra finalidade não prevista.
 
No caso de IAs open-source integradas à Cia, os modelos são executados dentro dos domínios da CIGAM, mantendo as mesmas premissas aplicadas às IAs contratadas: não utilização dos dados para treinamento de modelos, não identificação da origem das informações e ausência de retenção dos dados processados.
 
Além disso, sempre que houver envio explícito de dados pelo usuário por meio das funcionalidades da Cia disponíveis nas soluções CIGAM, será apresentado um diálogo de confirmação, permitindo que o usuário aceite o envio dessas informações. Os dados enviados serão tratados conforme as mesmas diretrizes de segurança, privacidade e não retenção descritas anteriormente.
 
Esta documentação apresenta o uso da Cia e está organizada conforme a forma de acesso: [[#Cia Web (SaaS)|Cia Web (SaaS)]], [[#Portais|Portais]] e [[#Desktop|Desktop]].
 
Caso tenha dúvidas sobre onde encontrar a Cia em cada uma dessas plataformas, ou sobre quais ferramentas do CIGAM possuem recursos integrados a ela, consulte a documentação específica de acesso: [[GE - Como Fazer - Cia - Como acessar|Como Fazer - Cia - Como acessar]]
{{VoltarInicio}}

=Cia Web (SaaS)=
A Cia Web é a aplicação web que centraliza todas as funcionalidades da Cia. Ela pode ser acessada diretamente pelo navegador do seu computador ou dispositivo móvel, ou ainda a partir do Desktop e dos Portais, sem a necessidade de novo login.
 

<center><youtube>https://youtu.be/DFGtRtPF75A</youtube></center>
 

==Primeiro acesso==
A Cia Web pode ser acessada diretamente pelo navegador, utilizando o seguinte endereço: https://services.cigam.cloud/cia/index.html
 
'''Importante:''' o usuário que for realizar o login precisa ter a autenticação em duas etapas habilitada. Para saber como configurá-la, consulte: [[GE - Como Fazer - Configuração da Cia IA do CIGAM#Autenticação em duas etapas e configurações de envio de e-mail|Autenticação em duas etapas e configurações de envio de e-mail]]
 
Ao acessar pelo endereço, será necessário preencher algumas informações para que a Cia consiga validar seu acesso e consultar seus dados: 
* Informar a API do seu CIGAM Server, para garantir o direcionamento correto da base de dados. 

[[Imagem:CiaAPI.png|semmoldura|center|700px]] 

* Informar usuário e senha de login e seu código de verificação: 

[[Imagem:CiaLogin.png|semmoldura|center|700px]]
 
[[Imagem:CiaCodVerif.png|semmoldura|center|700px]] 

* Caso não queira aguardar ou informar o código de verificação, você pode optar por responder à pergunta secreta, clicando no botão “Pergunta Secreta” exibido na imagem acima. 

[[Imagem:CiaLoginA2F.png|semmoldura|center|700px]]
 

==Conhecendo a tela da Cia==
Após realizar o login, a Cia carregará automaticamente as informações e dados necessários do ambiente e será iniciada no assunto '''#Geral''', identificado pelo botão localizado à esquerda da caixa de texto.

[[Imagem:CiaGeral.png|semmoldura|center|700px]]
 
Ao clicar nesse botão, será exibida uma lista com todos os assuntos disponíveis, permitindo que você selecione aquele com o qual deseja interagir. 
Além disso, você pode digitar diretamente na caixa de texto o '''#Assunto''' que deseja utilizar, e a Cia entenderá automaticamente o tema da sua mensagem. 
Também é possível '''formular uma pergunta seguida de um #Assunto''' para interagir com qualquer assunto, mesmo que ele não esteja selecionado no momento.

[[Imagem:CiaAberta.png|semmoldura|center|700px]]
 
Ao selecionar um assunto, serão exibidas automaticamente dicas e sugestões sobre o tema escolhido, além de exemplos clicáveis que, ao serem selecionados, são processados de forma imediata. 
Além disso, ao digitar um ponto de interrogação (?) na caixa de texto, será exibida uma lista com todas as interações disponíveis para o assunto selecionado, facilitando a descoberta de comandos e possibilidades de uso.

[[Imagem:CiaDicas.png|semmoldura|center|700px]]
 
Outra funcionalidade prática é a possibilidade de reenviar perguntas já feitas no chat. Para isso, basta posicionar o mouse sobre a pergunta desejada e clicar no ícone de “Reenviar”. Ao passar o mouse sobre a mensagem, também será exibido o horário de envio.
 
[[Imagem:CiaReenviar.png|semmoldura|center|400px]]
 
Além disso, você pode utilizar as setas do teclado (⬆️ para cima e ⬇️ para baixo) na caixa de texto para navegar pelas últimas perguntas enviadas para o #Assunto selecionado, facilitando o reuso de interações anteriores.

===Ícones da caixa de texto===
Na caixa de texto, você encontrará alguns ícones com as seguintes funções:

<center>
{| class="wikitable"
|-
! !! Ação
|-
|center|[[Imagem:CiaUltPerg.png]] || '''Histórico de Perguntas''' – Ao clicar, é exibido o histórico das perguntas já realizadas para o assunto selecionado.
|-
|center|[[Imagem:CiaEnviar.png]] || '''Enviar''' – Envia o conteúdo digitado na caixa de texto.
|-
|center|[[Imagem:CiaFala.png]] || '''Falar''' – Permite falar ao invés de digitar, usando o recurso de voz.
|-
|center|[[Imagem:CiaExpandir.png]] || '''Expandir''' – Aumenta a altura da caixa de texto para facilitar a digitação de mensagens longas.
|-
|center|[[Imagem:CiaRecolher.png]] || '''Recolher''' – Reduz a caixa de texto ao tamanho padrão.
|}
</center>
{{VoltarInicio}}

==Assuntos disponíveis==

===Geral===
Nesse assunto, é possível conversar livremente com a Cia sobre qualquer um dos assuntos disponíveis. Se encontrar dificuldades para obter a resposta desejada, experimente selecionar um assunto específico, o que pode gerar resultados mais precisos. 
Se houver muitas respostas correspondentes, a Cia não executará nenhuma automaticamente. Em vez disso, exibirá uma opção com os valores possíveis, permitindo que você selecione manualmente a melhor alternativa.

[[Imagem:CiaGeralOpcoes.png|semmoldura|center|700px]]
 
Caso a Cia encontre uma resposta com confiança significativamente maior que as demais, ela será executada automaticamente.
 
No entanto, se você selecionar a opção “Não era bem isso o que eu queria”, a Cia exibirá outras opções relacionadas ao que foi solicitado, apresentando também um indicador de semáforo com a porcentagem de confiança de cada alternativa.

[[Imagem:CiaGeralOpcaoCerta.png|semmoldura|center|600px]]

===Ajuda, Vídeos e Auditor===
Conheça melhor o ERP com a ajuda da Wiki e Cia, assista vídeos sobre o CIGAM e audite seu ambiente.

====Ajuda====
Nesse assunto, você pode acessar o Chatbot da assistente virtual, onde você pode tirar dúvidas e consultar conteúdos da CIGAM Wiki enviando perguntas diretamente nela. 
 
'''Importante:''' neste assunto, a Cia atua dedicada à Wiki, focada exclusivamente nos conteúdos da documentação. As demais funcionalidades e atalhos da Cia não estarão disponíveis nesse contexto.

====Vídeos====
Nesse assunto, é possível procurar por vídeos relacionados ao tema desejado. O resultado será apresentado em forma de lista, contendo os vídeos encontrados e os tempos exatos em que o assunto começa a ser abordado, de acordo com o termo ou palavra pesquisada.

====Auditor====
Neste assunto, é possível verificar o status do sistema e identificar possíveis problemas ou inconsistências. O resultado será exibido em forma de tabela, contendo os dados retornados para facilitar a análise.

===Painéis BI, Portais e Relatórios===
Explore dashboards do BI, interaja com Portais intuitivos e execute relatórios personalizados.

====Painéis BI====
Nesse assunto, é possível abrir dashboards do BI já configurados para o usuário, permitindo sua visualização diretamente na tela.
Ao abrir um dashboard, você também pode interagir com ele, solicitando inserção de filtros, dimensões, métricas, transformações e outros ajustes. 
Cada dashboard aberto exibirá uma guia com as “Interações” disponíveis para aquele painel específico.
 
Além disso, ao selecionar o assunto '''#Painéis do BI''', é possível solicitar que a Cia crie um dashboard do zero.
Por exemplo: "Crie um dashboard para ver meu fluxo de caixa". Você pode ainda solicitar que métricas, dimensões e filtros sejam adicionados durante a criação, ou pedir dashboards separados por áreas.
 
'''Importante:''' caso o usuário não possua acesso ao BI ou este não esteja implementado na base de dados, será exibida uma mensagem informativa no momento do login na Cia.

====Portais====
Quando este assunto é utilizado, o resultado será sempre a abertura de uma tela dos Portais, permitindo ao usuário acessar diretamente os conteúdos e funcionalidades disponíveis nesse ambiente.
 
Essa abertura é feita de forma integrada, garantindo uma navegação contínua entre a Cia e os Portais, sem necessidade de realizar novo login ou sair da plataforma.

====Relatórios====
Ao utilizar esse assunto, será exibida uma tela para preenchimento de filtros, permitindo a emissão de relatórios web.
 
Para que essa funcionalidade opere corretamente, é necessário garantir que a instalação da CDN e da Pesquisa Dinâmica no servidor de aplicação esteja configurada de forma adequada.
 
Os relatórios exibidos aqui são os mesmos disponíveis nos Portais CIGAM, portanto é essencial que esses componentes também estejam funcionando corretamente nesses Portais.

===Qual, Faça, Consultar, Listar, Analisar e Insights===
Crie registros, analise informações ou liste dados cadastrados no CIGAM.

====Qual====
Nesse assunto, a Cia vai consultar e processar informações diretamente no ERP, usando os dados e relacionamentos disponíveis no CIGAM, e retornar os resultados em forma de texto para você visualizar.
 
'''Importante:''' nem todas as opções estão liberadas. Para ver quais você pode usar, digite ? na caixa de texto. A Cia vai mostrar uma lista com todos os comandos e funções disponíveis.

====Faça====
Nesse assunto, a Cia sempre fará um processamento no CIGAM e retornará o status do resultado. Por exemplo, você pode solicitar que a Cia crie um alerta ou até mesmo crie uma nova empresa no sistema.
 
'''Dica:''' para saber quais treinamentos ou comandos estão disponíveis, digite ? na caixa de texto. A Cia mostrará uma lista com todas as opções implementadas para você usar.

====Consultar====
Nesse assunto, você poderá fazer consultas de dados para obter listagens de registros, conforme os treinamentos de tabelas disponíveis. O resultado será apresentado em forma de tabela, exibindo os dados retornados. Já existem diversas Views prontas, para que você possa listar informações de forma mais completa e rápida.
 
'''Dica:''' para ver exemplos de consultas já implementadas, digite ? na caixa de texto.

====Listar====
Nesse assunto, você pode montar sua própria consulta de dados, escolhendo os filtros e parâmetros para gerar uma listagem personalizada. Diferente do assunto #Consultar, aqui é possível utilizar qualquer tabela do CIGAM para montar sua consulta, escrevendo em linguagem natural o que deseja buscar.
 
'''Dica:''' para ver todas as tabelas disponíveis, digite ? na caixa de texto.

====Analisar====
Analise o arquivo selecionado para gerar gráficos interativos e informativos, apresentando insights relevantes que ajudam a identificar tendências, padrões e oportunidades de melhoria.
 
Esse recurso oferece uma visualização clara e intuitiva dos dados, facilitando a interpretação das informações e apoiando a tomada de decisões estratégicas.
 
'''Aviso:''' para utilizar esta funcionalidade, é necessário concordar que os dados enviados serão processados por modelos de IA de terceiros integrados à Cia.

[[Imagem:AnalisarCia.png|semmoldura|center|600px]]

====Insights====
Gere insights inteligentes a partir dos dados de uma consulta, com análises automáticas realizadas pela Cia, que identificam padrões, tendências e possíveis pontos de atenção. Esse recurso ajuda a transformar dados brutos em informações acionáveis, facilitando a tomada de decisões estratégicas e otimizando processos.
 
'''Aviso:''' ao utilizar o assunto “Insights”, você concorda que os dados e informações analisados poderão ser enviados para modelos de IA de terceiros integrados à Cia, exclusivamente para processamento e geração dos resultados apresentados.

===IA Generativa e Pesquisa na Internet===
Converse com a IA sobre assuntos diversos, crie conteúdos e pesquise na internet sobre qualquer coisa.

====IA Generativa====
Nesse assunto, ao interagir com a IA Generativa, você poderá fazer qualquer tipo de pergunta ou solicitação, de forma livre e criativa.
O resultado exibido será exatamente a resposta gerada pela IA, sem complementos da Cia. Você pode, por exemplo, solicitar que a IA melhore ou reformule um texto, crie conteúdos ou resuma informações.
 
'''Importante:''' nesse assunto, a Cia não estará integrada aos serviços e sistemas do CIGAM — a interação é exclusivamente com a IA Generativa.

====Pesquisa na Internet====
Use esse assunto para fazer pesquisas na internet e visualizar os resultados diretamente integrados na Cia, sem precisar sair da plataforma. Você pode pesquisar qualquer tema de interesse e abrir os links retornados para acessar conteúdos, notícias e informações de forma rápida e prática.
{{VoltarInicio}}

===Compartilhamento de Análises da Cia===

 
<div align="justify">
Na Cia Web (SaaS), é possível gerar análises detalhadas de determinadas informações e compartilhá-las. Essa funcionalidade está disponível nos seguintes assuntos: [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Auditor|Auditor]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Analisar|Analisar]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Insights|Insights]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Listar|Listar]] e [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Consultar|Consultar]].
</div>
 

[[Image: opcoesAnalisarCia.png|semmoldura|center|800px]]

 
<div align="justify">
Essa opção está disponível por meio do botão '''Analisar''', exibido junto à resposta apresentada após a solicitação de um desses assuntos.
</div>
 

[[Image: exemploBotaoAnalisar.png|semmoldura|center|800px]]

 
<div align="justify">
Particularmente para o assunto '''Analisar''', a análise já é exibida diretamente, pois essa é a finalidade desse assunto:
</div>
 

[[Image: analiseAnalisar.png|semmoldura|center|800px]]

 
<div align="justify">
Ao gerar uma análise , a página de resultado passa a disponibilizar opções para compartilhar e utilizar o conteúdo gerado. São disponibilizadas três opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.
</div>
 

[[Image: CiaWebAnalise.png|semmoldura|center|800px]]

=====Compartilhamento por e-mail=====

<div align="justify">
Ao selecionar a opção '''E-mail''', é apresentada uma janela para preenchimento das informações necessárias ao envio da análise.
</div>
 

[[Image: CiaWebModalEmail.png|semmoldura|center|800px]]

 
<div align="justify">
Após informar os destinatários e os demais dados da mensagem, basta selecionar '''Enviar'''. A análise gerada será encaminhada como um arquivo em anexo.

Para utilizar esse recurso, o ambiente deve possuir as configurações necessárias para envio de e-mails pelo CIGAM devidamente parametrizadas. Para mais informações, consulte [[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]].
</div>

==Configurações==
O ícone de engrenagem, localizado no canto superior direito da página, reúne recursos de informação e gerenciamento. As opções disponíveis são:
* '''Respostas com áudio:''' quando ativado, as respostas da Cia são narradas em voz alta.
* '''Ambiente atual do CIGAM:''' exibe na tela o usuário logado e o ambiente em uso.
* '''Ver consumo:''' mostra a quantidade de tokens já utilizados e os usuários que geraram consumo.
* '''Limpar dados de navegação:''' exibe uma mensagem explicando como limpar os dados de navegação do navegador.
* '''Limpar cookies:''' apaga os dados armazenados localmente, permitindo informar novamente a API e realizar um novo login.
* '''Instalar aplicativo:''' instala a Cia como aplicativo no dispositivo, criando um atalho na tela inicial.
* '''Documentação na wiki:''' direciona para a documentação da Cia na CIGAM Wiki.
* '''Sair:''' encerra a sessão do usuário, permitindo realizar login com outro usuário.
 
[[Imagem:ConfiguracoesCia.png|semmoldura|center|500px]]
{{VoltarInicio}}

=Portais=
Nos Portais CIGAM, além do acesso à Cia Web pelo menu de mosaico, estão disponíveis recursos de IA que atuam diretamente nas telas em que você está trabalhando. Esses recursos não exigem parametrização e são apresentados de acordo com o contexto da tela. 

==Acesso à Cia Web (SaaS) pelo menu mosaico==
O acesso à Cia Web a partir dos Portais é feito pelo ícone de mosaico, onde está disponível o ícone da Cia - IA do CIGAM. 
 
[[Imagem:mosaicoCia.png|semmoldura|center|800px]]
 
A Cia será aberta de forma integrada, sem a necessidade de novo login, e todas as funcionalidades descritas na seção [[#Cia Web (SaaS)|Cia Web (SaaS)]] estarão disponíveis normalmente. 

==Geração de conteúdo==
Na barra superior dos Portais está disponível um ícone com um menu de contexto que permite interagir com os '''campos de texto''' de qualquer parte dos Portais. As opções disponíveis permitem melhorar textos, criar conteúdos, revisar a gramática, entre outras ações. 
 
[[Imagem:comandosCia.png|semmoldura|center|650px]]
 
A partir da versão '''Beta 260601''', essas opções passaram a ser exibidas em uma seção separada, chamada '''Geração de conteúdo''', apresentada no mesmo menu em que ficam os agentes. 
 
[[Imagem:MenuGeracaoConteudoAgentes.png|semmoldura|center|800px]]
 
O campo processado é sempre o '''último campo em que o cursor esteve posicionado''' antes de abrir o menu da Cia. Por isso, basta clicar no campo desejado e, em seguida, acionar o menu e escolher o comando. 
 
Para que o comando seja executado, o campo precisa ser um '''campo de texto válido''' e conter, no mínimo, '''três palavras'''. Caso contrário, será apresentada uma mensagem informando que o conteúdo não atende aos requisitos. 
 
Após o processamento, o conteúdo gerado é aplicado automaticamente no campo, substituindo o texto anterior, sem necessidade de confirmação. 
 
Essa funcionalidade também está disponível em telas modais, ou seja, janelas sobrepostas com interações: 
 
[[Imagem:comandosModalCia.png|semmoldura|center|800px]]
 

==Agentes==
A partir da versão '''Beta 260601''', o menu da Cia nos Portais passou a disponibilizar também o acesso aos agentes, tanto nos Portais MVC quanto nos Portais React. 
 
Ao abrir o menu da Cia, os agentes disponíveis são detectados automaticamente de acordo com a tela que está sendo acessada, ou seja, as opções apresentadas variam conforme a página aberta. 
 
[[Imagem:MenuAgentesCia.png|semmoldura|center|800px]]
 

===Como os agentes são disponibilizados===
A disponibilização de cada agente pode ocorrer de quatro formas: 
 
* '''Por contexto:''' o agente é apresentado quando a Cia identifica que a tela acessada corresponde ao assunto tratado por ele. Por exemplo, um agente sobre Ordem de Produção será disponibilizado ao acessar uma página cujo contexto seja identificado como Ordem de Produção.
 
* '''Por parâmetro:''' o agente é apresentado quando a Cia identifica, na tela, um parâmetro com o valor esperado por ele. Por exemplo, um agente de Pedidos será disponibilizado quando existir na tela um parâmetro que contenha o código do pedido.
 
* '''Por contexto e parâmetro:''' o agente é apresentado somente quando as duas condições forem atendidas ao mesmo tempo.
 
* '''Sempre disponível:''' o agente é apresentado em qualquer tela, independentemente do contexto ou dos parâmetros.
 

===Resultado do processamento===
Após o processamento, o retorno do agente pode ser apresentado de duas formas, conforme o que foi executado: 
 
* Em uma '''nova guia''' do navegador, quando o agente gera algum conteúdo ou relatório como resultado.
 
[[Imagem:AgentesRetornoGuia.png|semmoldura|center|800px]]
 
* Em uma '''janela modal''', dentro da própria página em que o usuário está, quando o retorno é uma mensagem.
 
[[Imagem:AgentesRetornoModal.png|semmoldura|center|800px]]
 
<div align="justify>
A partir da versão '''Beta 261005''', quando o resultado do agente é apresentado em uma nova guia, a página passa a disponibilizar também opções para utilização e compartilhamento da análise.
</div>
 
[[Imagem:resultadoAnalise.png|semmoldura|center|800px]]
 
<div align="justify">
No cabeçalho são apresentados o nome do agente executado e as opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.
</div>
<div align="justify">
=====Compartilhamento por e-mail=====
A janela abaixo é exibida quando selecionada a opção '''E-mail''':
</div>
 
[[Imagem:modalEmail.png|semmoldura|center|800px]]
 
<div align="justify">

Para utilizar esse recurso, o ambiente deve possuir as configurações necessárias para envio de e-mails pelo CIGAM devidamente parametrizadas. Para mais informações, consulte [[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]].
</div>

==Editor de Agentes==
<div align="justify">
A partir da versão '''Beta 261005''', o menu passou a disponibilizar o acesso à ferramenta '''Editor de Agentes''', que permite criar seus próprios agentes.

 
[[Imagem:EditorAgentesCia.png|semmoldura|center|750px]]
 

Ao clicar na opção, será aberta uma página web e ocorrerá a validação do ambiente e autenticação.

 
[[Imagem:EditorAgentesCiaValidandoAuth.png|semmoldura|center|750px]]
 

Quando não forem identificados uma API e um token válidos, ocorrerá a mensagem de bloqueio à ferramenta.

 
[[Imagem:EditorAgentesCiaBloqueio.png|semmoldura|center|750px]]
 

A página utiliza o formato de assistente (wizard), com cada etapa explicada de forma detalhada. Basta preencher as informações do agente conforme a sua necessidade e avançar pelos passos até a conclusão. Temos a opção de "Abrir" um agente já criado para podermos editar suas informações ou criar um agente do zero.

 
[[Imagem:EditorAgentesCia_logado.png|semmoldura|center|750px]]
 

Na última etapa teremos a opção de "Criar Agente" onde será realizado o download do arquivo.

 
[[Imagem:EditorAgentesWizardBaixar.png|semmoldura|center|750px]]
 

Ao final do processo, será gerado um arquivo com a extensão '''.cgagt''', que contém a definição do agente criado.

{{VoltarInicio}}
</div>
===Disponibilizando o agente criado===
<div align="justify">
Para que o agente passe a ser exibido nos Portais, o arquivo '''.cgagt''' precisa ser colocado na aplicação da API, dentro da pasta raiz da aplicação. 
 
É necessário que existam as pastas '''Exclusivo''' e, dentro dela, '''Agentes'''. Caso não existam, elas devem ser criadas manualmente. O arquivo deve ser colocado dentro dessa estrutura, ficando da seguinte forma: 
 
/api/exclusivo/agentes/
 
Assim que o arquivo é adicionado nesse local, a Cia passa a reconhecer o agente automaticamente, sem necessidade de qualquer outra configuração. Os agentes customizados são exibidos no menu da Cia nos Portais, em uma seção separada dos agentes padrão. 
 
[[Imagem:MenuAgentesCustomizados.png|semmoldura|center|800px]]
 
{{VoltarInicio}}
</div>

==Conversar com documentos==
<div align="justify">
A ferramenta de '''Conversar com documentos''' permite analisar, resumir e cruzar informações contidas em arquivos e relatórios através de modelos avançados de Inteligência Artificial integrados ao ERP CIGAM.

O acesso pode ser realizado a partir da tela principal da Cia Web (SaaS), clicando na opção correspondente ou digitando o assunto <code>#Documentos</code>, momento em que a aplicação é aberta em uma nova guia do navegador assim que digitada a primeira mensagem.

Além disto, podemos acessar a aplicação através dos Portais CIGAM, conforme descrito em [[GE_-_Como_Fazer_-_Cia_-_Como_acessar#Conversar_com_documentos|Como acessar]].

Para a utilização da aplicação, é necessário estar autenticado com um token de autorização CIGAM e com o endereço da API CIGAM devidamente parametrizado. Logo ao abrir, o sistema avalia o ambiente e valida a sessão do usuário.

Estando os parâmetros validados, será gerado automaticamente um ID de conversação (''Conversation ID'') exclusivo para a sessão. Esta identificação é armazenada em cookies do navegador com validade de 24 horas, permitindo que a Cia armazene e mantenha o contexto contínuo de todas as mensagens e documentos anexados. Caso a página seja atualizada ou fechada dentro deste período, a sessão conectada e os arquivos são recuperados automaticamente.

 
<center>[[Arquivo:cia_conv_docs_01.png|nenhum|750px]]</center>
 

No primeiro acesso, é obrigatório marcar a opção '''Termo de consentimento''' para indicar ciência de que os dados e documentos selecionados para análise serão enviados aos modelos de IA de terceiros integrados com a Cia. Por segurança e conformidade, os campos de envio e a área de anexos permanecem bloqueados até que o consentimento seja confirmado. Uma vez aceito, uma mensagem de registro é inserida no histórico da conversa e a preferência é memorizada para a sessão.

Após confirmar o termo, a área de upload no painel lateral esquerdo é habilitada, permitindo anexar múltiplos arquivos simultaneamente, seja arrastando e soltando os documentos sobre a área de dropzone, seja clicando sobre ela para abrir a janela de seleção de arquivos.

A ferramenta suporta uma ampla variedade de formatos corporativos:
*'''Documentos de Texto e Portáteis:''' PDF (<code>.pdf</code>), Texto Simples (<code>.txt</code>), Word (<code>.doc</code>, <code>.docx</code>).
*'''Planilhas e Dados Tabulares:''' Planilhas Excel (<code>.xlsx</code>, <code>.xls</code>), Valores Separados por Vírgula (<code>.csv</code>).
*'''Arquivos de Estrutura de Dados:''' Arquivos <code>.json</code> e <code>.xml</code>.

No painel lateral, é possível visualizar o contador total de documentos anexados, o ícone específico do formato, o nome, o tamanho do arquivo formatado e a indicação de que o documento encontra-se ativo no contexto da conversa. Em dispositivos móveis ou telas menores, o painel lateral pode ser recolhido ou expandido através do botão retrátil no topo da barra.

Uma vez enviados para análise, os documentos permanecem registrados no contexto da conversa no servidor, não sendo necessário reenviá-los a cada nova pergunta. Caso deseje remover os arquivos analisados, deve-se reiniciar o contexto através da opção de limpeza da conversa.

*'''Limpar conversa:''' Permite reiniciar o contexto da conversa. Ao acionar esta opção, um balão interativo de confirmação é apresentado no histórico do chat (com as opções ''Limpar Conversa'' ou ''Cancelar''). Ao confirmar, o sistema solicita a exclusão da conversa no serviço da OpenAI para evitar registros órfãos, remove os documentos e cookies locais e gera um novo ID de conversação limpo.

 
<center>[[Arquivo:cia_conv_docs_02.png|nenhum|750px]]</center>
 

Clicando no ícone da engrenagem localizado no canto superior direito da tela, temos acesso ao menu de opções e configurações da ferramenta:

*'''Provedor de IA:''' Permite selecionar o provedor de Inteligência Artificial. Atualmente está fixa a opção da OpenAI.
*'''Modelo de IA:''' Permite selecionar o modelo de Inteligência Artificial desejado para o processamento documental (ex.: GPT-5.4, GPT-5.4 Mini, GPT-5.2, GPT-5.1). A lista de modelos é atualizada dinamicamente a partir dos serviços disponíveis na Cia.
*'''Usuário Conectado:''' Exibe os dados do usuário autenticado no ERP CIGAM, incluindo nome, empresa (razão social / fantasia) e código de usuário.
*'''Ambiente & Sessão CIGAM:''' Apresenta o tipo de ambiente (produção ou depuração) e a URL da API CIGAM conectada, acompanhado de um botão de cópia rápida para facilitar diagnósticos e solicitações de suporte técnico.
*'''ID da Conversa Ativa:''' Exibe o identificador único da sessão com indicador visual de status em tempo real e botão para copiar o código do ID diretamente para a área de transferência.

*'''Documentação na wiki:''' Atalho que direciona diretamente aos manuais e guias de uso na CIGAM Wiki.

 
<center>[[Arquivo:cia_conv_docs_03.png|nenhum|750px]]</center>
 

Com os documentos anexados, podemos enviar perguntas e comandos no campo inferior para obter resumos executivos, explicações pontuais, cruzamento de dados entre arquivos distintos, localização de inconsistências ou extração de indicadores. Caso enviemos os arquivos sem digitar nenhuma mensagem complementar, a Cia aplicará o prompt de sistema padrão para realizar uma leitura analítica e retornar um resumo estruturado dos documentos.

O sistema dispõe de diretrizes de sistema corporativas (''System Prompt'') integradas ao ecossistema do ERP CIGAM, orientando o modelo a analisar com fidelidade os dados fornecidos, sem inventar informações ausentes.

Também é disponibilizado o recurso de '''Reconhecimento de Voz''' através do ícone de microfone (habilitado em conexões seguras HTTPS). O recurso conta com reconhecimento inteligente de pontuação falada: ao ditar expressões como ''"vírgula"'', ''"ponto"'', ''"ponto e vírgula"'', ''"dois pontos"'', ''"interrogação"'', ''"exclamação"'', ''"hífen"'', ''"abre parênteses"'', ''"fecha parênteses"'' ou ''"nova linha"'', os termos são automaticamente substituídos pelos respectivos sinais gráficos e as frases são capitalizadas de forma automática.

 
<center>[[Arquivo:cia_conv_docs_04.png|nenhum|750px]]</center>
 

As respostas retornadas pela Cia contam com formatação Markdown avançada, estruturando o conteúdo em títulos hierárquicos, listas ordenadas ou em tópicos, citações em bloco e tabelas responsivas estilizadas.

Além disso, sempre que a análise envolver dados numéricos comparativos, demonstrativos contábeis/financeiros (como DRE, receitas e despesas), séries temporais ou valores tabulares, a Cia gera automaticamente gráficos visuais e interativos integrados diretamente na resposta:
*'''Tipos de Gráficos Gerados:''' Barras verticais, linhas de tendência, gráficos de pizza e rosca, estilizados na paleta de cores oficial da Cia e com valores numéricos formatados no padrão brasileiro (pt-BR).
*'''Exportação do Gráfico:''' Cada card de gráfico possui um botão de download no canto superior direito, permitindo baixar a imagem em formato PNG em alta resolução para inclusão imediata em relatórios, apresentações ou envio por e-mail.

 
<center>[[Arquivo:cia_conv_docs_05.png|nenhum|750px]]</center>
 

Podemos manter uma conversa contínua com diversos documentos e mensagens em múltiplos turnos de diálogo. A Cia preserva o histórico de perguntas e respostas anteriores, permitindo aprofundar análises, solicitar detalhamentos de itens específicos ou anexar novos arquivos complementares ao longo da conversa.

</div>
{{VoltarInicio}}

=Desktop=
Na aplicação Desktop, além do acesso rápido à Cia Web, algumas ferramentas do sistema disponibilizam o recurso "Analisar com a Cia". 

==Acesso rápido à Cia Web (SaaS)==
O botão de acesso rápido (Cia - IA do CIGAM), disponível no menu lateral do Desktop, abre a Cia Web de forma integrada ao sistema, em uma janela do próprio CIGAM. 
 
Desde que as configurações necessárias tenham sido aplicadas, conforme [[GE - Como Fazer - Configuração da Cia IA do CIGAM#Acesso rápido à Cia Web (SaaS)|Acesso rápido à Cia Web (SaaS)]], '''todas as funcionalidades da Cia Web estarão disponíveis normalmente''', da mesma forma que no acesso pelo navegador. Para conhecê-las, consulte a seção [[#Cia Web (SaaS)|Cia Web (SaaS)]] desta documentação. 
 
[[Imagem:CiaAbertaDesktop.png|semmoldura|center|800px]]
 

==Recurso Analisar com a Cia==
O recurso '''"Analisar com a Cia"''' está disponível em ferramentas como CGEditor, CGReport, Pesquisa Dinâmica e Dispositivo de Saída. Em todas elas, o comportamento é o mesmo: a Cia analisa o conteúdo que está em uso na tela e gera um relatório com o resultado da análise, apresentado em uma nova página.. 
 
Ao acionar a opção, o fluxo é o seguinte: 
 
'''1. Confirmação dos termos de uso''' 
Antes de qualquer envio, será exibida uma mensagem solicitando que o usuário concorde com o envio das informações para análise. Os dados enviados seguem as diretrizes de segurança, privacidade e não retenção descritas em [[#Recursos, configurações e segurança|Recursos, configurações e segurança]]. 
 
[[Imagem:AnalisarCiaTermos.png|semmoldura|center|500px]]
 
'''2. Complemento do prompt (opcional)''' 
Em seguida, será apresentada uma caixa de texto para que o usuário complemente a solicitação, orientando a análise para algum ponto específico. O preenchimento é opcional e pode ser deixado em branco. 
 
Essa caixa de texto serve apenas para complementar o prompt base que a Cia monta automaticamente, e não altera o conteúdo que está sendo enviado. O recurso considera que o usuário já filtrou os dados na própria tela do CIGAM antes de acionar a análise. O prompt base é mantido oculto por ser extenso e técnico, evitando que o usuário precise conferi-lo a cada utilização. 
 
[[Imagem:AnalisarCiaPrompt.png|semmoldura|center|700px]]
 
'''3. Geração do relatório''' 
Após a confirmação, a Cia processa o conteúdo e apresenta o relatório em uma nova página flutuante, com a análise dos dados enviados. 
 
O próprio relatório informa a quantidade de dados que foi analisada, permitindo que o usuário veja o volume aproximado considerado e identifique se o conteúdo enviado corresponde ao que esperava. 
 
[[Imagem:AnalisarCiaRelatorio.png|semmoldura|center|700px]]
 

A partir da versão '''Beta 261005''', o resultado da análise passa a ser apresentado em uma nova janela flutuante, que disponibiliza opções para utilização e compartilhamento do conteúdo gerado. Nessa versão, o recurso está disponível apenas para a '''Pesquisa Dinâmica/Pesquisa Paginada''' e para o '''FastReport'''. A partir da '''RC 270519''', ele também passa a estar disponível para o '''CGEditor''' e o '''Dispositivo de Saída'''. 
 
No cabeçalho dessa janela, são apresentados o título da análise e três opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.

 
[[Imagem:AnalisarCiaDesktopCompartilhar.png|semmoldura|center|800px]]
 

====Compartilhamento por e-mail====
<div align="justify">
Ao selecionar a opção '''E-mail''', é apresentada uma janela para preenchimento das informações necessárias ao envio da análise.

 
[[Imagem:AnalisarCiaDesktopEmail.png|semmoldura|center|700px]]
 

Após informar os destinatários e os demais dados da mensagem, basta selecionar '''Enviar'''. A análise gerada será encaminhada como um arquivo em anexo.

</div>

===Limite de conteúdo enviado===
<div align="justify">
Existe um limite para o volume de conteúdo enviado em cada análise, que varia conforme a versão do ambiente:

* '''150 KB''' — desde a disponibilização do recurso, na versão '''250505.a'''.
* '''3 MB''' — a partir das patches '''250505.i''' e '''251103.a''', e da versão '''RC 260504'''.

Quando o conteúdo selecionado ultrapassa esse limite, a Cia exibe uma mensagem informando o tamanho excedido e a análise não é processada, ou seja, nenhum relatório será gerado.

[[Imagem:AnalisarCiaLimite.png|semmoldura|center|600px]]

'''Esse limite não é parametrizável e não se trata de uma restrição imposta pela CIGAM.''' Ele decorre da própria capacidade dos modelos de IA integrados à Cia, que possuem um limite técnico de volume de dados que conseguem processar em uma única análise. Quando esse volume é ultrapassado, os modelos passam a analisar as informações por amostragem — ou seja, mesmo que fosse permitido enviar uma quantidade maior de dados, o modelo não analisaria todo o conteúdo, e o resultado seria menos preciso. O limite adotado pela Cia acompanha essa característica dos modelos e assegura que a análise seja feita sobre os dados completos.

Além da qualidade da análise, há também a questão do tempo de processamento: quanto maior o volume enviado, maior o tempo de resposta do modelo, tornando a espera inviável para o uso no dia a dia.

Por isso, o recurso foi feito para ser simples e direto: analisar, com um clique, os dados que o usuário já está visualizando pelos meios tradicionais do CIGAM, como grids filtrados e relatórios. Em ambientes com grande volume de dados, a prática recomendada é '''filtrar e consolidar as informações na própria tela antes de acionar a análise''', reduzindo o período ou o escopo consultado. Para análises de períodos maiores, recomenda-se utilizar dados já consolidados, como totalizadores e relatórios sintéticos, em vez de listagens analíticas completas.

A CIGAM está trabalhando em outras ferramentas que, por processarem os dados de forma diferente, permitirão trabalhar com volumes maiores de informação.

Para saber como acessar o recurso em cada ferramenta, consulte: [[GE - Como Fazer - Cia - Como acessar]]

{{VoltarInicio}}
</div>

=Documentos Relacionados=
[[GE - Como Fazer - Cia - Como acessar]] 
[[GE - Como Fazer - Configuração da Cia IA do CIGAM]]

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-10-27T14:23:43Z

Roger.schneider: /* Conversar com documentos */

{{VoltarPagina}}
 
[[categoria:Como_Fazer_Utilidades/Diversos]]
[[categoria:Como_Fazer_Utilidades/Diversos_6]]
[[MediaWiki:Como_Fazer_sidebar|Como Fazer]] > [[Como_Fazer_Utilidades/Diversos|Utilidades/Diversos]] > [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer - Uso da Cia - IA do CIGAM]]

=Recursos, configurações e segurança=
A Cia - IA do CIGAM oferece diversas funcionalidades e atua como um hub centralizador para os recursos de inteligência artificial utilizados nas soluções CIGAM. Para garantir o correto funcionamento desses recursos, é necessário verificar se os pré-requisitos e as configurações foram realizados adequadamente. Para mais informações, consulte: [[GE - Como Fazer - Configuração da Cia IA do CIGAM|Como Fazer configuração da Cia IA do CIGAM]]
 
Todas as soluções de IA do CIGAM são integradas por meio dos serviços da Cia. A Cia possui integração com diferentes provedores de IA de terceiros, como OpenAI, Google, Anthropic, entre outros. Essas integrações são realizadas por meio de contas e serviços contratados, com condições de uso que asseguram que os dados trafegados não sejam utilizados para treinamento dos modelos, identificação de origem, publicidade, anúncios ou qualquer outra finalidade não prevista.
 
No caso de IAs open-source integradas à Cia, os modelos são executados dentro dos domínios da CIGAM, mantendo as mesmas premissas aplicadas às IAs contratadas: não utilização dos dados para treinamento de modelos, não identificação da origem das informações e ausência de retenção dos dados processados.
 
Além disso, sempre que houver envio explícito de dados pelo usuário por meio das funcionalidades da Cia disponíveis nas soluções CIGAM, será apresentado um diálogo de confirmação, permitindo que o usuário aceite o envio dessas informações. Os dados enviados serão tratados conforme as mesmas diretrizes de segurança, privacidade e não retenção descritas anteriormente.
 
Esta documentação apresenta o uso da Cia e está organizada conforme a forma de acesso: [[#Cia Web (SaaS)|Cia Web (SaaS)]], [[#Portais|Portais]] e [[#Desktop|Desktop]].
 
Caso tenha dúvidas sobre onde encontrar a Cia em cada uma dessas plataformas, ou sobre quais ferramentas do CIGAM possuem recursos integrados a ela, consulte a documentação específica de acesso: [[GE - Como Fazer - Cia - Como acessar|Como Fazer - Cia - Como acessar]]
{{VoltarInicio}}

=Cia Web (SaaS)=
A Cia Web é a aplicação web que centraliza todas as funcionalidades da Cia. Ela pode ser acessada diretamente pelo navegador do seu computador ou dispositivo móvel, ou ainda a partir do Desktop e dos Portais, sem a necessidade de novo login.
 

<center><youtube>https://youtu.be/DFGtRtPF75A</youtube></center>
 

==Primeiro acesso==
A Cia Web pode ser acessada diretamente pelo navegador, utilizando o seguinte endereço: https://services.cigam.cloud/cia/index.html
 
'''Importante:''' o usuário que for realizar o login precisa ter a autenticação em duas etapas habilitada. Para saber como configurá-la, consulte: [[GE - Como Fazer - Configuração da Cia IA do CIGAM#Autenticação em duas etapas e configurações de envio de e-mail|Autenticação em duas etapas e configurações de envio de e-mail]]
 
Ao acessar pelo endereço, será necessário preencher algumas informações para que a Cia consiga validar seu acesso e consultar seus dados: 
* Informar a API do seu CIGAM Server, para garantir o direcionamento correto da base de dados. 

[[Imagem:CiaAPI.png|semmoldura|center|700px]] 

* Informar usuário e senha de login e seu código de verificação: 

[[Imagem:CiaLogin.png|semmoldura|center|700px]]
 
[[Imagem:CiaCodVerif.png|semmoldura|center|700px]] 

* Caso não queira aguardar ou informar o código de verificação, você pode optar por responder à pergunta secreta, clicando no botão “Pergunta Secreta” exibido na imagem acima. 

[[Imagem:CiaLoginA2F.png|semmoldura|center|700px]]
 

==Conhecendo a tela da Cia==
Após realizar o login, a Cia carregará automaticamente as informações e dados necessários do ambiente e será iniciada no assunto '''#Geral''', identificado pelo botão localizado à esquerda da caixa de texto.

[[Imagem:CiaGeral.png|semmoldura|center|700px]]
 
Ao clicar nesse botão, será exibida uma lista com todos os assuntos disponíveis, permitindo que você selecione aquele com o qual deseja interagir. 
Além disso, você pode digitar diretamente na caixa de texto o '''#Assunto''' que deseja utilizar, e a Cia entenderá automaticamente o tema da sua mensagem. 
Também é possível '''formular uma pergunta seguida de um #Assunto''' para interagir com qualquer assunto, mesmo que ele não esteja selecionado no momento.

[[Imagem:CiaAberta.png|semmoldura|center|700px]]
 
Ao selecionar um assunto, serão exibidas automaticamente dicas e sugestões sobre o tema escolhido, além de exemplos clicáveis que, ao serem selecionados, são processados de forma imediata. 
Além disso, ao digitar um ponto de interrogação (?) na caixa de texto, será exibida uma lista com todas as interações disponíveis para o assunto selecionado, facilitando a descoberta de comandos e possibilidades de uso.

[[Imagem:CiaDicas.png|semmoldura|center|700px]]
 
Outra funcionalidade prática é a possibilidade de reenviar perguntas já feitas no chat. Para isso, basta posicionar o mouse sobre a pergunta desejada e clicar no ícone de “Reenviar”. Ao passar o mouse sobre a mensagem, também será exibido o horário de envio.
 
[[Imagem:CiaReenviar.png|semmoldura|center|400px]]
 
Além disso, você pode utilizar as setas do teclado (⬆️ para cima e ⬇️ para baixo) na caixa de texto para navegar pelas últimas perguntas enviadas para o #Assunto selecionado, facilitando o reuso de interações anteriores.

===Ícones da caixa de texto===
Na caixa de texto, você encontrará alguns ícones com as seguintes funções:

<center>
{| class="wikitable"
|-
! !! Ação
|-
|center|[[Imagem:CiaUltPerg.png]] || '''Histórico de Perguntas''' – Ao clicar, é exibido o histórico das perguntas já realizadas para o assunto selecionado.
|-
|center|[[Imagem:CiaEnviar.png]] || '''Enviar''' – Envia o conteúdo digitado na caixa de texto.
|-
|center|[[Imagem:CiaFala.png]] || '''Falar''' – Permite falar ao invés de digitar, usando o recurso de voz.
|-
|center|[[Imagem:CiaExpandir.png]] || '''Expandir''' – Aumenta a altura da caixa de texto para facilitar a digitação de mensagens longas.
|-
|center|[[Imagem:CiaRecolher.png]] || '''Recolher''' – Reduz a caixa de texto ao tamanho padrão.
|}
</center>
{{VoltarInicio}}

==Assuntos disponíveis==

===Geral===
Nesse assunto, é possível conversar livremente com a Cia sobre qualquer um dos assuntos disponíveis. Se encontrar dificuldades para obter a resposta desejada, experimente selecionar um assunto específico, o que pode gerar resultados mais precisos. 
Se houver muitas respostas correspondentes, a Cia não executará nenhuma automaticamente. Em vez disso, exibirá uma opção com os valores possíveis, permitindo que você selecione manualmente a melhor alternativa.

[[Imagem:CiaGeralOpcoes.png|semmoldura|center|700px]]
 
Caso a Cia encontre uma resposta com confiança significativamente maior que as demais, ela será executada automaticamente.
 
No entanto, se você selecionar a opção “Não era bem isso o que eu queria”, a Cia exibirá outras opções relacionadas ao que foi solicitado, apresentando também um indicador de semáforo com a porcentagem de confiança de cada alternativa.

[[Imagem:CiaGeralOpcaoCerta.png|semmoldura|center|600px]]

===Ajuda, Vídeos e Auditor===
Conheça melhor o ERP com a ajuda da Wiki e Cia, assista vídeos sobre o CIGAM e audite seu ambiente.

====Ajuda====
Nesse assunto, você pode acessar o Chatbot da assistente virtual, onde você pode tirar dúvidas e consultar conteúdos da CIGAM Wiki enviando perguntas diretamente nela. 
 
'''Importante:''' neste assunto, a Cia atua dedicada à Wiki, focada exclusivamente nos conteúdos da documentação. As demais funcionalidades e atalhos da Cia não estarão disponíveis nesse contexto.

====Vídeos====
Nesse assunto, é possível procurar por vídeos relacionados ao tema desejado. O resultado será apresentado em forma de lista, contendo os vídeos encontrados e os tempos exatos em que o assunto começa a ser abordado, de acordo com o termo ou palavra pesquisada.

====Auditor====
Neste assunto, é possível verificar o status do sistema e identificar possíveis problemas ou inconsistências. O resultado será exibido em forma de tabela, contendo os dados retornados para facilitar a análise.

===Painéis BI, Portais e Relatórios===
Explore dashboards do BI, interaja com Portais intuitivos e execute relatórios personalizados.

====Painéis BI====
Nesse assunto, é possível abrir dashboards do BI já configurados para o usuário, permitindo sua visualização diretamente na tela.
Ao abrir um dashboard, você também pode interagir com ele, solicitando inserção de filtros, dimensões, métricas, transformações e outros ajustes. 
Cada dashboard aberto exibirá uma guia com as “Interações” disponíveis para aquele painel específico.
 
Além disso, ao selecionar o assunto '''#Painéis do BI''', é possível solicitar que a Cia crie um dashboard do zero.
Por exemplo: "Crie um dashboard para ver meu fluxo de caixa". Você pode ainda solicitar que métricas, dimensões e filtros sejam adicionados durante a criação, ou pedir dashboards separados por áreas.
 
'''Importante:''' caso o usuário não possua acesso ao BI ou este não esteja implementado na base de dados, será exibida uma mensagem informativa no momento do login na Cia.

====Portais====
Quando este assunto é utilizado, o resultado será sempre a abertura de uma tela dos Portais, permitindo ao usuário acessar diretamente os conteúdos e funcionalidades disponíveis nesse ambiente.
 
Essa abertura é feita de forma integrada, garantindo uma navegação contínua entre a Cia e os Portais, sem necessidade de realizar novo login ou sair da plataforma.

====Relatórios====
Ao utilizar esse assunto, será exibida uma tela para preenchimento de filtros, permitindo a emissão de relatórios web.
 
Para que essa funcionalidade opere corretamente, é necessário garantir que a instalação da CDN e da Pesquisa Dinâmica no servidor de aplicação esteja configurada de forma adequada.
 
Os relatórios exibidos aqui são os mesmos disponíveis nos Portais CIGAM, portanto é essencial que esses componentes também estejam funcionando corretamente nesses Portais.

===Qual, Faça, Consultar, Listar, Analisar e Insights===
Crie registros, analise informações ou liste dados cadastrados no CIGAM.

====Qual====
Nesse assunto, a Cia vai consultar e processar informações diretamente no ERP, usando os dados e relacionamentos disponíveis no CIGAM, e retornar os resultados em forma de texto para você visualizar.
 
'''Importante:''' nem todas as opções estão liberadas. Para ver quais você pode usar, digite ? na caixa de texto. A Cia vai mostrar uma lista com todos os comandos e funções disponíveis.

====Faça====
Nesse assunto, a Cia sempre fará um processamento no CIGAM e retornará o status do resultado. Por exemplo, você pode solicitar que a Cia crie um alerta ou até mesmo crie uma nova empresa no sistema.
 
'''Dica:''' para saber quais treinamentos ou comandos estão disponíveis, digite ? na caixa de texto. A Cia mostrará uma lista com todas as opções implementadas para você usar.

====Consultar====
Nesse assunto, você poderá fazer consultas de dados para obter listagens de registros, conforme os treinamentos de tabelas disponíveis. O resultado será apresentado em forma de tabela, exibindo os dados retornados. Já existem diversas Views prontas, para que você possa listar informações de forma mais completa e rápida.
 
'''Dica:''' para ver exemplos de consultas já implementadas, digite ? na caixa de texto.

====Listar====
Nesse assunto, você pode montar sua própria consulta de dados, escolhendo os filtros e parâmetros para gerar uma listagem personalizada. Diferente do assunto #Consultar, aqui é possível utilizar qualquer tabela do CIGAM para montar sua consulta, escrevendo em linguagem natural o que deseja buscar.
 
'''Dica:''' para ver todas as tabelas disponíveis, digite ? na caixa de texto.

====Analisar====
Analise o arquivo selecionado para gerar gráficos interativos e informativos, apresentando insights relevantes que ajudam a identificar tendências, padrões e oportunidades de melhoria.
 
Esse recurso oferece uma visualização clara e intuitiva dos dados, facilitando a interpretação das informações e apoiando a tomada de decisões estratégicas.
 
'''Aviso:''' para utilizar esta funcionalidade, é necessário concordar que os dados enviados serão processados por modelos de IA de terceiros integrados à Cia.

[[Imagem:AnalisarCia.png|semmoldura|center|600px]]

====Insights====
Gere insights inteligentes a partir dos dados de uma consulta, com análises automáticas realizadas pela Cia, que identificam padrões, tendências e possíveis pontos de atenção. Esse recurso ajuda a transformar dados brutos em informações acionáveis, facilitando a tomada de decisões estratégicas e otimizando processos.
 
'''Aviso:''' ao utilizar o assunto “Insights”, você concorda que os dados e informações analisados poderão ser enviados para modelos de IA de terceiros integrados à Cia, exclusivamente para processamento e geração dos resultados apresentados.

===IA Generativa e Pesquisa na Internet===
Converse com a IA sobre assuntos diversos, crie conteúdos e pesquise na internet sobre qualquer coisa.

====IA Generativa====
Nesse assunto, ao interagir com a IA Generativa, você poderá fazer qualquer tipo de pergunta ou solicitação, de forma livre e criativa.
O resultado exibido será exatamente a resposta gerada pela IA, sem complementos da Cia. Você pode, por exemplo, solicitar que a IA melhore ou reformule um texto, crie conteúdos ou resuma informações.
 
'''Importante:''' nesse assunto, a Cia não estará integrada aos serviços e sistemas do CIGAM — a interação é exclusivamente com a IA Generativa.

====Pesquisa na Internet====
Use esse assunto para fazer pesquisas na internet e visualizar os resultados diretamente integrados na Cia, sem precisar sair da plataforma. Você pode pesquisar qualquer tema de interesse e abrir os links retornados para acessar conteúdos, notícias e informações de forma rápida e prática.
{{VoltarInicio}}

===Compartilhamento de Análises da Cia===

 
<div align="justify">
Na Cia Web (SaaS), é possível gerar análises detalhadas de determinadas informações e compartilhá-las. Essa funcionalidade está disponível nos seguintes assuntos: [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Auditor|Auditor]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Analisar|Analisar]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Insights|Insights]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Listar|Listar]] e [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Consultar|Consultar]].
</div>
 

[[Image: opcoesAnalisarCia.png|semmoldura|center|800px]]

 
<div align="justify">
Essa opção está disponível por meio do botão '''Analisar''', exibido junto à resposta apresentada após a solicitação de um desses assuntos.
</div>
 

[[Image: exemploBotaoAnalisar.png|semmoldura|center|800px]]

 
<div align="justify">
Particularmente para o assunto '''Analisar''', a análise já é exibida diretamente, pois essa é a finalidade desse assunto:
</div>
 

[[Image: analiseAnalisar.png|semmoldura|center|800px]]

 
<div align="justify">
Ao gerar uma análise , a página de resultado passa a disponibilizar opções para compartilhar e utilizar o conteúdo gerado. São disponibilizadas três opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.
</div>
 

[[Image: CiaWebAnalise.png|semmoldura|center|800px]]

=====Compartilhamento por e-mail=====

<div align="justify">
Ao selecionar a opção '''E-mail''', é apresentada uma janela para preenchimento das informações necessárias ao envio da análise.
</div>
 

[[Image: CiaWebModalEmail.png|semmoldura|center|800px]]

 
<div align="justify">
Após informar os destinatários e os demais dados da mensagem, basta selecionar '''Enviar'''. A análise gerada será encaminhada como um arquivo em anexo.

Para utilizar esse recurso, o ambiente deve possuir as configurações necessárias para envio de e-mails pelo CIGAM devidamente parametrizadas. Para mais informações, consulte [[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]].
</div>

==Configurações==
O ícone de engrenagem, localizado no canto superior direito da página, reúne recursos de informação e gerenciamento. As opções disponíveis são:
* '''Respostas com áudio:''' quando ativado, as respostas da Cia são narradas em voz alta.
* '''Ambiente atual do CIGAM:''' exibe na tela o usuário logado e o ambiente em uso.
* '''Ver consumo:''' mostra a quantidade de tokens já utilizados e os usuários que geraram consumo.
* '''Limpar dados de navegação:''' exibe uma mensagem explicando como limpar os dados de navegação do navegador.
* '''Limpar cookies:''' apaga os dados armazenados localmente, permitindo informar novamente a API e realizar um novo login.
* '''Instalar aplicativo:''' instala a Cia como aplicativo no dispositivo, criando um atalho na tela inicial.
* '''Documentação na wiki:''' direciona para a documentação da Cia na CIGAM Wiki.
* '''Sair:''' encerra a sessão do usuário, permitindo realizar login com outro usuário.
 
[[Imagem:ConfiguracoesCia.png|semmoldura|center|500px]]
{{VoltarInicio}}

=Portais=
Nos Portais CIGAM, além do acesso à Cia Web pelo menu de mosaico, estão disponíveis recursos de IA que atuam diretamente nas telas em que você está trabalhando. Esses recursos não exigem parametrização e são apresentados de acordo com o contexto da tela. 

==Acesso à Cia Web (SaaS) pelo menu mosaico==
O acesso à Cia Web a partir dos Portais é feito pelo ícone de mosaico, onde está disponível o ícone da Cia - IA do CIGAM. 
 
[[Imagem:mosaicoCia.png|semmoldura|center|800px]]
 
A Cia será aberta de forma integrada, sem a necessidade de novo login, e todas as funcionalidades descritas na seção [[#Cia Web (SaaS)|Cia Web (SaaS)]] estarão disponíveis normalmente. 

==Geração de conteúdo==
Na barra superior dos Portais está disponível um ícone com um menu de contexto que permite interagir com os '''campos de texto''' de qualquer parte dos Portais. As opções disponíveis permitem melhorar textos, criar conteúdos, revisar a gramática, entre outras ações. 
 
[[Imagem:comandosCia.png|semmoldura|center|650px]]
 
A partir da versão '''Beta 260601''', essas opções passaram a ser exibidas em uma seção separada, chamada '''Geração de conteúdo''', apresentada no mesmo menu em que ficam os agentes. 
 
[[Imagem:MenuGeracaoConteudoAgentes.png|semmoldura|center|800px]]
 
O campo processado é sempre o '''último campo em que o cursor esteve posicionado''' antes de abrir o menu da Cia. Por isso, basta clicar no campo desejado e, em seguida, acionar o menu e escolher o comando. 
 
Para que o comando seja executado, o campo precisa ser um '''campo de texto válido''' e conter, no mínimo, '''três palavras'''. Caso contrário, será apresentada uma mensagem informando que o conteúdo não atende aos requisitos. 
 
Após o processamento, o conteúdo gerado é aplicado automaticamente no campo, substituindo o texto anterior, sem necessidade de confirmação. 
 
Essa funcionalidade também está disponível em telas modais, ou seja, janelas sobrepostas com interações: 
 
[[Imagem:comandosModalCia.png|semmoldura|center|800px]]
 

==Agentes==
A partir da versão '''Beta 260601''', o menu da Cia nos Portais passou a disponibilizar também o acesso aos agentes, tanto nos Portais MVC quanto nos Portais React. 
 
Ao abrir o menu da Cia, os agentes disponíveis são detectados automaticamente de acordo com a tela que está sendo acessada, ou seja, as opções apresentadas variam conforme a página aberta. 
 
[[Imagem:MenuAgentesCia.png|semmoldura|center|800px]]
 

===Como os agentes são disponibilizados===
A disponibilização de cada agente pode ocorrer de quatro formas: 
 
* '''Por contexto:''' o agente é apresentado quando a Cia identifica que a tela acessada corresponde ao assunto tratado por ele. Por exemplo, um agente sobre Ordem de Produção será disponibilizado ao acessar uma página cujo contexto seja identificado como Ordem de Produção.
 
* '''Por parâmetro:''' o agente é apresentado quando a Cia identifica, na tela, um parâmetro com o valor esperado por ele. Por exemplo, um agente de Pedidos será disponibilizado quando existir na tela um parâmetro que contenha o código do pedido.
 
* '''Por contexto e parâmetro:''' o agente é apresentado somente quando as duas condições forem atendidas ao mesmo tempo.
 
* '''Sempre disponível:''' o agente é apresentado em qualquer tela, independentemente do contexto ou dos parâmetros.
 

===Resultado do processamento===
Após o processamento, o retorno do agente pode ser apresentado de duas formas, conforme o que foi executado: 
 
* Em uma '''nova guia''' do navegador, quando o agente gera algum conteúdo ou relatório como resultado.
 
[[Imagem:AgentesRetornoGuia.png|semmoldura|center|800px]]
 
* Em uma '''janela modal''', dentro da própria página em que o usuário está, quando o retorno é uma mensagem.
 
[[Imagem:AgentesRetornoModal.png|semmoldura|center|800px]]
 
<div align="justify>
A partir da versão '''Beta 261005''', quando o resultado do agente é apresentado em uma nova guia, a página passa a disponibilizar também opções para utilização e compartilhamento da análise.
</div>
 
[[Imagem:resultadoAnalise.png|semmoldura|center|800px]]
 
<div align="justify">
No cabeçalho são apresentados o nome do agente executado e as opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.
</div>
<div align="justify">
=====Compartilhamento por e-mail=====
A janela abaixo é exibida quando selecionada a opção '''E-mail''':
</div>
 
[[Imagem:modalEmail.png|semmoldura|center|800px]]
 
<div align="justify">

Para utilizar esse recurso, o ambiente deve possuir as configurações necessárias para envio de e-mails pelo CIGAM devidamente parametrizadas. Para mais informações, consulte [[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]].
</div>

==Editor de Agentes==
<div align="justify">
A partir da versão '''Beta 261005''', o menu passou a disponibilizar o acesso à ferramenta '''Editor de Agentes''', que permite criar seus próprios agentes.

 
[[Imagem:EditorAgentesCia.png|semmoldura|center|750px]]
 

Ao clicar na opção, será aberta uma página web e ocorrerá a validação do ambiente e autenticação.

 
[[Imagem:EditorAgentesCiaValidandoAuth.png|semmoldura|center|750px]]
 

Quando não forem identificados uma API e um token válidos, ocorrerá a mensagem de bloqueio à ferramenta.

 
[[Imagem:EditorAgentesCiaBloqueio.png|semmoldura|center|750px]]
 

A página utiliza o formato de assistente (wizard), com cada etapa explicada de forma detalhada. Basta preencher as informações do agente conforme a sua necessidade e avançar pelos passos até a conclusão. Temos a opção de "Abrir" um agente já criado para podermos editar suas informações ou criar um agente do zero.

 
[[Imagem:EditorAgentesCia_logado.png|semmoldura|center|750px]]
 

Na última etapa teremos a opção de "Criar Agente" onde será realizado o download do arquivo.

 
[[Imagem:EditorAgentesWizardBaixar.png|semmoldura|center|750px]]
 

Ao final do processo, será gerado um arquivo com a extensão '''.cgagt''', que contém a definição do agente criado.

{{VoltarInicio}}
</div>
===Disponibilizando o agente criado===
<div align="justify">
Para que o agente passe a ser exibido nos Portais, o arquivo '''.cgagt''' precisa ser colocado na aplicação da API, dentro da pasta raiz da aplicação. 
 
É necessário que existam as pastas '''Exclusivo''' e, dentro dela, '''Agentes'''. Caso não existam, elas devem ser criadas manualmente. O arquivo deve ser colocado dentro dessa estrutura, ficando da seguinte forma: 
 
/api/exclusivo/agentes/
 
Assim que o arquivo é adicionado nesse local, a Cia passa a reconhecer o agente automaticamente, sem necessidade de qualquer outra configuração. Os agentes customizados são exibidos no menu da Cia nos Portais, em uma seção separada dos agentes padrão. 
 
[[Imagem:MenuAgentesCustomizados.png|semmoldura|center|800px]]
 
{{VoltarInicio}}
</div>

==Conversar com documentos==
<div align="justify">
A ferramenta de '''Conversar com documentos''' permite analisar, resumir e cruzar informações contidas em arquivos e relatórios através de modelos avançados de Inteligência Artificial integrados ao ERP CIGAM.

O acesso pode ser realizado a partir da tela principal da Cia Web (SaaS), clicando na opção correspondente ou digitando o assunto <code>#Documentos</code>, momento em que a aplicação é aberta em uma nova guia do navegador assim que digitada a primeira mensagem.

Além disto, podemos acessar a aplicação através dos Portais CIGAM, conforme descrito em [[GE_-_Como_Fazer_-_Cia_-_Como_acessar#Conversar_com_documentos|Como acessar]].

Para a utilização da aplicação, é necessário estar autenticado com um token de autorização CIGAM e com o endereço da API CIGAM devidamente parametrizado. Logo ao abrir, o sistema avalia o ambiente e valida a sessão do usuário.

Estando os parâmetros validados, será gerado automaticamente um ID de conversação (''Conversation ID'') exclusivo para a sessão. Esta identificação é armazenada em cookies do navegador com validade de 24 horas, permitindo que a Cia armazene e mantenha o contexto contínuo de todas as mensagens e documentos anexados. Caso a página seja atualizada ou fechada dentro deste período, a sessão conectada e os arquivos são recuperados automaticamente.

 
<center>[[Arquivo:cia_conv_docs_01.png|nenhum|750px]]</center>
 

No primeiro acesso, é obrigatório marcar a opção '''Termo de consentimento''' para indicar ciência de que os dados e documentos selecionados para análise serão enviados aos modelos de IA de terceiros integrados com a Cia. Por segurança e conformidade, os campos de envio e a área de anexos permanecem bloqueados até que o consentimento seja confirmado. Uma vez aceito, uma mensagem de registro é inserida no histórico da conversa e a preferência é memorizada para a sessão.

Após confirmar o termo, a área de upload no painel lateral esquerdo é habilitada, permitindo anexar múltiplos arquivos simultaneamente, seja arrastando e soltando os documentos sobre a área de dropzone, seja clicando sobre ela para abrir a janela de seleção de arquivos.

A ferramenta suporta uma ampla variedade de formatos corporativos:
*'''Documentos de Texto e Portáteis:''' PDF (<code>.pdf</code>), Texto Simples (<code>.txt</code>), Word (<code>.doc</code>, <code>.docx</code>).
*'''Planilhas e Dados Tabulares:''' Planilhas Excel (<code>.xlsx</code>, <code>.xls</code>), Valores Separados por Vírgula (<code>.csv</code>).
*'''Arquivos de Estrutura de Dados:''' Arquivos <code>.json</code> e <code>.xml</code>.

No painel lateral, é possível visualizar o contador total de documentos anexados, o ícone específico do formato, o nome, o tamanho do arquivo formatado e a indicação de que o documento encontra-se ativo no contexto da conversa. Em dispositivos móveis ou telas menores, o painel lateral pode ser recolhido ou expandido através do botão retrátil no topo da barra.

Uma vez enviados para análise, os documentos permanecem registrados no contexto da conversa no servidor, não sendo necessário reenviá-los a cada nova pergunta. Caso deseje remover os arquivos analisados, deve-se reiniciar o contexto através da opção de limpeza da conversa.

*'''Limpar conversa:''' Permite reiniciar o contexto da conversa. Ao acionar esta opção, um balão interativo de confirmação é apresentado no histórico do chat (com as opções ''Limpar Conversa'' ou ''Cancelar''). Ao confirmar, o sistema solicita a exclusão da conversa no serviço da OpenAI para evitar registros órfãos, remove os documentos e cookies locais e gera um novo ID de conversação limpo.

 
<center>[[Arquivo:cia_conv_docs_02.png|nenhum|750px]]</center>
 

Clicando no ícone da engrenagem localizado no canto superior direito da tela, temos acesso ao menu de opções e configurações da ferramenta:

*'''Provedor de IA:''' Permite selecionar o provedor de Inteligência Artificial. Atualmente está fixa a opção da OpenAI.
*'''Modelo de IA:''' Permite selecionar o modelo de Inteligência Artificial desejado para o processamento documental (ex.: GPT-5.4, GPT-5.4 Mini, GPT-5.2, GPT-5.1). A lista de modelos é atualizada dinamicamente a partir dos serviços disponíveis na Cia.
*'''Usuário Conectado:''' Exibe os dados do usuário autenticado no ERP CIGAM, incluindo nome, empresa (razão social / fantasia) e código de usuário.
*'''Ambiente & Sessão CIGAM:''' Apresenta o tipo de ambiente (produção ou depuração) e a URL da API CIGAM conectada, acompanhado de um botão de cópia rápida para facilitar diagnósticos e solicitações de suporte técnico.
*'''ID da Conversa Ativa:''' Exibe o identificador único da sessão com indicador visual de status em tempo real e botão para copiar o código do ID diretamente para a área de transferência.

*'''Documentação na wiki:''' Atalho que direciona diretamente aos manuais e guias de uso na CIGAM Wiki.

 
<center>[[Arquivo:cia_conv_docs_03.png|nenhum|750px]]</center>
 

Com os documentos anexados, podemos enviar perguntas e comandos no campo inferior para obter resumos executivos, explicações pontuais, cruzamento de dados entre arquivos distintos, localização de inconsistências ou extração de indicadores. Caso enviemos os arquivos sem digitar nenhuma mensagem complementar, a Cia aplicará o prompt de sistema padrão para realizar uma leitura analítica e retornar um resumo estruturado dos documentos.

O sistema dispõe de diretrizes de sistema corporativas (''System Prompt'') integradas ao ecossistema do ERP CIGAM, orientando o modelo a analisar com fidelidade os dados fornecidos, sem inventar informações ausentes.

Também é disponibilizado o recurso de '''Reconhecimento de Voz''' através do ícone de microfone (habilitado em conexões seguras HTTPS). O recurso conta com reconhecimento inteligente de pontuação falada: ao ditar expressões como ''"vírgula"'', ''"ponto"'', ''"ponto e vírgula"'', ''"dois pontos"'', ''"interrogação"'', ''"exclamação"'', ''"hífen"'', ''"abre parênteses"'', ''"fecha parênteses"'' ou ''"nova linha"'', os termos são automaticamente substituídos pelos respectivos sinais gráficos e as frases são capitalizadas de forma automática.

 
<center>[[Arquivo:cia_conv_docs_04.png|nenhum|750px]]</center>
 

As respostas retornadas pela Cia contam com formatação Markdown avançada, estruturando o conteúdo em títulos hierárquicos, listas ordenadas ou em tópicos, citações em bloco e tabelas responsivas estilizadas.

Além disso, sempre que a análise envolver dados numéricos comparativos, demonstrativos contábeis/financeiros (como DRE, receitas e despesas), séries temporais ou valores tabulares, a Cia gera automaticamente gráficos visuais e interativos integrados diretamente na resposta:
*'''Tipos de Gráficos Gerados:''' Barras verticais, linhas de tendência, gráficos de pizza e rosca, estilizados na paleta de cores oficial da Cia e com valores numéricos formatados no padrão brasileiro (pt-BR).
*'''Exportação do Gráfico:''' Cada card de gráfico possui um botão de download no canto superior direito, permitindo baixar a imagem em formato PNG em alta resolução para inclusão imediata em relatórios, apresentações ou envio por e-mail.

 
<center>[[Arquivo:cia_conv_docs_05.png|nenhum|750px]]</center>
 

Podemos manter uma conversa contínua com diversos documentos e mensagens em múltiplos turnos de diálogo. A Cia preserva o histórico de perguntas e respostas anteriores, permitindo aprofundar análises, solicitar detalhamentos de itens específicos ou anexar novos arquivos complementares ao longo da conversa.

</div>
{{VoltarInicio}}

=Desktop=
Na aplicação Desktop, além do acesso rápido à Cia Web, algumas ferramentas do sistema disponibilizam o recurso "Analisar com a Cia". 

==Acesso rápido à Cia Web (SaaS)==
O botão de acesso rápido (Cia - IA do CIGAM), disponível no menu lateral do Desktop, abre a Cia Web de forma integrada ao sistema, em uma janela do próprio CIGAM. 
 
Desde que as configurações necessárias tenham sido aplicadas, conforme [[GE - Como Fazer - Configuração da Cia IA do CIGAM#Acesso rápido à Cia Web (SaaS)|Acesso rápido à Cia Web (SaaS)]], '''todas as funcionalidades da Cia Web estarão disponíveis normalmente''', da mesma forma que no acesso pelo navegador. Para conhecê-las, consulte a seção [[#Cia Web (SaaS)|Cia Web (SaaS)]] desta documentação. 
 
[[Imagem:CiaAbertaDesktop.png|semmoldura|center|800px]]
 

==Recurso Analisar com a Cia==
O recurso '''"Analisar com a Cia"''' está disponível em ferramentas como CGEditor, CGReport, Pesquisa Dinâmica e Dispositivo de Saída. Em todas elas, o comportamento é o mesmo: a Cia analisa o conteúdo que está em uso na tela e gera um relatório com o resultado da análise, apresentado em uma nova página. 
 
Ao acionar a opção, o fluxo é o seguinte: 
 
'''1. Confirmação dos termos de uso''' 
Antes de qualquer envio, será exibida uma mensagem solicitando que o usuário concorde com o envio das informações para análise. Os dados enviados seguem as diretrizes de segurança, privacidade e não retenção descritas em [[#Recursos, configurações e segurança|Recursos, configurações e segurança]]. 
 
[[Imagem:AnalisarCiaTermos.png|semmoldura|center|500px]]
 
'''2. Complemento do prompt (opcional)''' 
Em seguida, será apresentada uma caixa de texto para que o usuário complemente a solicitação, orientando a análise para algum ponto específico. O preenchimento é opcional e pode ser deixado em branco. 
 
Essa caixa de texto serve apenas para complementar o prompt base que a Cia monta automaticamente, e não altera o conteúdo que está sendo enviado. O recurso considera que o usuário já filtrou os dados na própria tela do CIGAM antes de acionar a análise. O prompt base é mantido oculto por ser extenso e técnico, evitando que o usuário precise conferi-lo a cada utilização. 
 
[[Imagem:AnalisarCiaPrompt.png|semmoldura|center|700px]]
 
'''3. Geração do relatório''' 
Após a confirmação, a Cia processa o conteúdo e apresenta o relatório em uma nova página flutuante, com a análise dos dados enviados. 
 
O próprio relatório informa a quantidade de dados que foi analisada, permitindo que o usuário veja o volume aproximado considerado e identifique se o conteúdo enviado corresponde ao que esperava. 
 
[[Imagem:AnalisarCiaRelatorio.png|semmoldura|center|700px]]
 

A partir da versão '''Beta 261005''', o resultado da análise passa a ser apresentado em uma nova janela flutuante, que disponibiliza opções para utilização e compartilhamento do conteúdo gerado. Nessa versão, o recurso está disponível apenas para a '''Pesquisa Dinâmica/Pesquisa Paginada''' e para o '''FastReport'''. A partir da '''RC 270519''', ele também passa a estar disponível para o '''CGEditor''' e o '''Dispositivo de Saída'''. 
 
No cabeçalho dessa janela, são apresentados o título da análise e três opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.

 
[[Imagem:AnalisarCiaDesktopCompartilhar.png|semmoldura|center|800px]]
 

====Compartilhamento por e-mail====
<div align="justify">
Ao selecionar a opção '''E-mail''', é apresentada uma janela para preenchimento das informações necessárias ao envio da análise.

 
[[Imagem:AnalisarCiaDesktopEmail.png|semmoldura|center|700px]]
 

Após informar os destinatários e os demais dados da mensagem, basta selecionar '''Enviar'''. A análise gerada será encaminhada como um arquivo em anexo.

</div>

===Limite de conteúdo enviado===
<div align="justify">
Existe um limite para o volume de conteúdo enviado em cada análise, que varia conforme a versão do ambiente:

* '''150 KB''' — desde a disponibilização do recurso, na versão '''250505.a'''.
* '''3 MB''' — a partir das patches '''250505.i''' e '''251103.a''', e da versão '''RC 260504'''.

Quando o conteúdo selecionado ultrapassa esse limite, a Cia exibe uma mensagem informando o tamanho excedido e a análise não é processada, ou seja, nenhum relatório será gerado.

[[Imagem:AnalisarCiaLimite.png|semmoldura|center|600px]]

'''Esse limite não é parametrizável e não se trata de uma restrição imposta pela CIGAM.''' Ele decorre da própria capacidade dos modelos de IA integrados à Cia, que possuem um limite técnico de volume de dados que conseguem processar em uma única análise. Quando esse volume é ultrapassado, os modelos passam a analisar as informações por amostragem — ou seja, mesmo que fosse permitido enviar uma quantidade maior de dados, o modelo não analisaria todo o conteúdo, e o resultado seria menos preciso. O limite adotado pela Cia acompanha essa característica dos modelos e assegura que a análise seja feita sobre os dados completos.

Além da qualidade da análise, há também a questão do tempo de processamento: quanto maior o volume enviado, maior o tempo de resposta do modelo, tornando a espera inviável para o uso no dia a dia.

Por isso, o recurso foi feito para ser simples e direto: analisar, com um clique, os dados que o usuário já está visualizando pelos meios tradicionais do CIGAM, como grids filtrados e relatórios. Em ambientes com grande volume de dados, a prática recomendada é '''filtrar e consolidar as informações na própria tela antes de acionar a análise''', reduzindo o período ou o escopo consultado. Para análises de períodos maiores, recomenda-se utilizar dados já consolidados, como totalizadores e relatórios sintéticos, em vez de listagens analíticas completas.

A CIGAM está trabalhando em outras ferramentas que, por processarem os dados de forma diferente, permitirão trabalhar com volumes maiores de informação.

Para saber como acessar o recurso em cada ferramenta, consulte: [[GE - Como Fazer - Cia - Como acessar]]

{{VoltarInicio}}
</div>

=Documentos Relacionados=
[[GE - Como Fazer - Cia - Como acessar]] 
[[GE - Como Fazer - Configuração da Cia IA do CIGAM]]

GE - Como Fazer - Configuração da Cia IA do CIGAM

2026-10-19T13:19:18Z

Roger.schneider: /* Configurações para compartilhamento de análises por e-mail */

{{VoltarPagina}}
 
[[categoria:Como_Fazer_Utilidades/Diversos]]
[[categoria:Como Fazer Utilidades/Diversos_2]]
[[MediaWiki:Como_Fazer_sidebar|Como Fazer]] > [[Como_Fazer_Utilidades/Diversos|Utilidades/Diversos]] > [[GE - Como_Fazer - Configuração da Cia IA do CIGAM|Configuração da Cia IA do CIGAM]]

=Como a Cia - IA do CIGAM funciona?=

A Cia, a IA do CIGAM, é composta por uma aplicação e um serviço, ambos hospedados na Nuvem CIGAM e executados como um SaaS (Software como Serviço). O SaaS é um modelo de aplicação acessada diretamente pelos usuários finais através do navegador de internet.
 
A execução através do modelo SaaS garante que toda a infraestrutura necessária permaneça sob responsabilidade da CIGAM na Nuvem CIGAM, oferecendo:
 
* Atualizações em tempo real, sem necessidade de intervenção do cliente. 
* Treinamento de forma compartilhada, adicionando novas funcionalidades, otimizando performance e resultados. 

Todas as configurações necessárias estão descritas em [[#Cia Web (SaaS)|Cia Web (SaaS)]]. As seções [[#Portais|Portais]] e [[#Desktop|Desktop]] indicam quais dessas configurações se aplicam a cada forma de acesso. 

=Cia Web (SaaS)=
A Cia será executada como uma página web no navegador de internet, acessando todo o ecossistema do CIGAM através das credenciais do usuário logado, da mesma forma que o usuário acessaria se estivesse logado diretamente no CIGAM.
 
As configurações desta seção garantem o funcionamento da Cia Web, que é a aplicação onde todos os recursos da Cia são disponibilizados.
 
Como os Portais e a aplicação Desktop abrem a mesma Cia Web, essas configurações também se aplicam a eles, conforme indicado nas respectivas seções. 

==Versões de navegadores==

Para garantir o pleno funcionamento da Cia, é aconselhável utilizar os navegadores Google Chrome ou Microsoft Edge, sempre atualizados para a última versão disponível, pois são os navegadores homologados pela CIGAM.
 
Além disso, recomenda-se que a extensão associada ao arquivo .html esteja configurada, por padrão, para abrir em um desses navegadores. Essa configuração assegura que relatórios, portais e páginas sejam carregados corretamente, proporcionando maior compatibilidade, segurança e desempenho.
 
Para mais informações, acesse: [[Requisitos_de_Software#Versões_de_Navegadores|Versões de navegadores]]


==Importância do uso do HTTPS==

A Cia sempre notificará o usuário caso ele esteja utilizando o protocolo HTTP, recomendando o uso do protocolo HTTPS. Isso ocorre por dois motivos principais:
 
1. Segurança: O HTTPS criptografa os dados transmitidos, garantindo maior proteção contra interceptações e ataques. 
2. Funcionalidades: O HTTPS permite que a Cia utilize recursos adicionais, como o microfone para reconhecimento de voz, aplicativo para dispositivos móveis, etc. Caso o usuário esteja em HTTP, a Cia automaticamente desativa essas funcionalidades por questões de segurança. 
 
Para mais informações sobre a importância do uso do HTTPS, acesse: [[GE - Importância do uso do HTTPS|Importância do uso do HTTPS]]


==Autenticação em duas etapas e configurações de envio de e-mail==

Para acessar a Cia Web, é obrigatório que o usuário tenha habilitado a autenticação em duas etapas para realizar o login, independentemente do ambiente. Se precisar de ajuda para configurar, consulte a documentação: [[GE Autenticação em duas etapas]]
 
Caso o envio de e-mails ainda não esteja configurado, será necessário configurá-lo, pois a autenticação em duas etapas depende dessa configuração. Se precisar de ajuda, consulte: [[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]]


==Configurações para Cia no CIGAM==
Algumas configurações e parametrizações no CIGAM são necessárias para garantir o funcionamento adequado da Cia, conforme o seu ambiente. Verifique se todas as aplicações estão em um único site ou distribuídas em mais de um e configure-as conforme a necessidade. 

===Ambiente padrão com único site===
Normalmente, os Portais, API, BI, entre outras aplicações são instalados no mesmo local, ou seja, com mesmo site, domínio e porta. Esse é o ambiente mais fácil de configurar, exigindo apenas os seguintes ajustes:
 
* Para acessar os Portais MVC:
** Acesse a configuração [[GE - AM - 3159 - Local de Instalação dos Portais Base]] e informe o local onde seus Portais MVC estão instalados.
*** Exemplo: http://servidor:porta/
 
* Para acessar os Portais React:
** Acesse a configuração [[GE - AM - 3160 - Local de Instalação dos Portais Complementares]] e informe onde seus Portais React estão instalados.
*** Exemplo: http://servidor:porta/
 
* Para acessar os dashboards do BI:
** Acesse a configuração [[GE - GE - 100325 - URL Base BI Portal]] e informe o endereço onde seu BI está instalado.
*** Exemplo: http://servidor:porta/bi 
 
'''Observação:''' mesmo em ambientes com um único site, é possível configurar as aplicações apenas por meio de '''nomes lógicos''' no arquivo '''Magic.ini'''. Nesse caso, as configurações acima não são necessárias. Para mais informações sobre como configurar nomes lógicos, consulte a documentação: [[GE - Como Fazer - Configuração do menu mosaico nos Portais Web]] 

===Ambiente com mais de um site===
Em alguns casos, as aplicações podem estar instaladas em locais diferentes, ou seja, em sites, domínios ou portas distintas. Nesses cenários, é necessário realizar configurações específicas para que a Cia consiga se comunicar corretamente com cada um deles.
 
* Quando o ambiente possui aplicações distribuídas em sites separados, podemos utilizar a configuração [[GE - AM - 3159 - Local de Instalação dos Portais Base]] para definir o endereço onde a API está hospedada. Para os demais Portais e aplicações, é possível utilizar nomes lógicos no arquivo '''Magic.ini''', informando cada um dos endereços. Alternativamente, todas as aplicações podem ser configuradas apenas por meio de nomes lógicos, sem a necessidade de utilizar essa configuração. Para mais informações sobre como configurar nomes lógicos, consulte a documentação: [[GE - Como Fazer - Configuração do menu mosaico nos Portais Web]]
 
* Para acessar os Portais React:
** Acesse a configuração [[GE - AM - 3160 - Local de Instalação dos Portais Complementares]] e informe onde seus Portais React estão instalados.
*** Exemplo: http://servidor:porta/
 
* Para acessar os dashboards do BI:
** Acesse a configuração [[GE - GE - 100325 - URL Base BI Portal]] e informe o endereço onde seu BI está instalado.
*** Exemplo: http://servidor:porta/bi 

===Configuração do BI para integração com a Cia===
Se o ambiente possuir um BI instalado e for utilizado pela Cia, é necessário garantir que a URL da API CIGAM esteja devidamente configurada. Caso ainda não esteja informada, adicione a URL nas configurações:
 
[[Imagem:apiCigamBI.png|semmoldura|centro|600px]]

===Configurações para compartilhamento de análises por e-mail===
A partir da versão '''Beta 261005''', o recurso [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Recurso_"Analisar_com_a_Cia"|Analisar com a Cia]] no Desktop passa a disponibilizar opções para utilização e compartilhamento das análises geradas, incluindo o envio por e-mail. 
 
A disponibilização ocorre por ferramenta, conforme a versão: 
* '''Beta 261005''' — Pesquisa Dinâmica/Pesquisa Paginada e FastReport.
* '''RC 270519''' — CGEditor e Dispositivo de Saída.

Embora a geração das análises não exija parametrizações adicionais no CIGAM, o compartilhamento por e-mail depende de algumas configurações no ambiente.

Para utilizar essa funcionalidade, é necessário:

* Possuir a '''API CIGAM''' instalada no ambiente utilizado.
* Possuir o '''Broker''' do ambiente devidamente configurado e em execução.
* Informar os nomes lógicos '''CDN''' e '''CDN_KEYTOKEN''' no arquivo '''Magic.ini'''.
* Possuir as configurações de envio de e-mails pelo CIGAM devidamente parametrizadas.
 

====Configuração da API====

Para realizar o envio de análises por e-mail, é necessário que a '''API CIGAM''' esteja instalada e acessível no ambiente utilizado.

A configuração [[GE - AM - 3159 - Local de Instalação dos Portais Base|3159 - Local de Instalação dos Portais Base]] deve estar devidamente parametrizada, permitindo que o CIGAM localize a API responsável pelo processamento da solicitação.

Caso a API não esteja instalada ou não possa ser acessada, será apresentada uma mensagem de erro ao tentar realizar o envio.

 
[[Imagem:CiaDesktopErroAPI.png|semmoldura|center|700px]]
 

====Configuração do Broker====

Para realizar o compartilhamento das análises por e-mail, também é necessário que o '''Broker''' do ambiente esteja devidamente configurado e em execução.
Caso o Broker não esteja em execução ou apresente alguma configuração incorreta, será exibida uma mensagem de erro ao tentar enviar a análise por e-mail.
 
[[Imagem:CiaDesktopErroBroker.png|semmoldura|center|700px]]
 

====Configuração dos nomes lógicos====
Além da API e do Broker, é necessário configurar os nomes lógicos '''CDN''' e '''CDN_KEYTOKEN''' no arquivo '''Magic.ini''' do ambiente.
Esses nomes lógicos são utilizados para identificar o endereço e a chave de acesso à CDN, necessária para disponibilizar o arquivo da análise que será enviado como anexo.

* '''CDN:''' deve conter o endereço da CDN utilizada pelo ambiente.
* '''CDN_KEYTOKEN:''' deve conter a chave de acesso utilizada para a comunicação com a CDN.

Caso o nome lógico '''CDN''' não esteja configurado corretamente, será apresentada uma mensagem de erro relacionada ao endereço da CDN.
 
[[Imagem:CiaDesktopErroCaminhoCDN.png|semmoldura|center|700px]]
 

Da mesma forma, caso o nome lógico '''CDN_KEYTOKEN''' não esteja informado corretamente, será apresentada uma mensagem de erro relacionada à chave de acesso.
 
[[Imagem:CiaDesktopErroCDNKey.png|semmoldura|center|700px]]
 

====Configurações de envio de e-mail====

Também é necessário que o ambiente possua as configurações necessárias para realizar o envio de e-mails pelo CIGAM devidamente parametrizadas.
Caso essas configurações estejam ausentes ou incorretas, poderão ocorrer falhas durante o envio da análise.
Para mais informações, consulte [[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]].
 

'''Importante:''' o botão '''E-mail''' permanece disponível mesmo quando alguma das configurações necessárias não está correta. Nesses casos, a mensagem de erro correspondente será apresentada durante a tentativa de envio, e não haverá o compartilhamento da análise.
{{VoltarInicio}}

==Configurações de CORS==

A forma como a Cia é executada, operando como um SaaS, pode causar restrições relacionadas ao CORS (Compartilhamento de Recursos entre Origens Diferentes). O CORS é um mecanismo de segurança implementado pelos navegadores para proteger os usuários, restringindo solicitações de recursos entre diferentes domínios não permitidos. Essas restrições podem causar erros ao tentar acessar cookies e outras informações. 
Cookies são pequenos arquivos armazenados no computador ou dispositivo do usuário que contêm informações sobre a atividade do usuário em sites para melhorar a experiência de navegação. 
Para o navegador, domínios diferentes são tratados de forma separada por questões de segurança. A Cia estará hospedada em um domínio (da CIGAM Corp. na Nuvem CIGAM). E o CIGAM Web do usuário estará em outro domínio, que pode ser em um servidor on-premise (local) ou em qualquer Nuvem, inclusive na Nuvem CIGAM.


==Ambientes com acesso externo às aplicações==

Esse seria o ambiente ideal para utilizar a Cia, o qual possui acesso externo às aplicações do CIGAM, como Portais, APIs, etc. Esse ambiente é acessível via internet e deve possuir HTTPS configurado com um domínio público.


===Como configurar o web server (Microsoft IIS)?===

Para permitir que a Cia acesse as aplicações do ambiente com acesso externo, é necessário configurar o Web Server no Microsoft IIS. O principal ajuste será a inclusão do cabeçalho de resposta denominado CSP (Content-Security-Policy).
 
O CSP define diretrizes que instruem o navegador sobre as fontes permitidas para diferentes tipos de conteúdo em uma página da web. Essa configuração pode ser realizada das seguintes formas:


====Configuração via arquivo web.config====

A maneira mais simples e rápida de realizar essa configuração é por meio da criação ou edição do arquivo Web.config, que funciona como um "manual de instruções" para o sistema. Sempre que você ajusta configurações no Microsoft IIS, esse arquivo pode ser criado ou modificado automaticamente. 
 
No entanto, é importante destacar que o arquivo Web.config pode não existir em alguns ambientes. Isso ocorre porque, até então, não utilizávamos esse tipo de configuração como padrão em todos os portais. Portanto, caso o arquivo não esteja presente, será necessário criá-lo manualmente. 
 
Esse arquivo deve ser criado (ou editado) na pasta raiz do site que engloba todas as aplicações, permitindo que a Cia tenha acesso a todos os domínios e aplicações de forma unificada. Por ser um arquivo geral, o Web.config afeta todas as aplicações vinculadas à raiz do site. Portanto, a configuração nesse local garante abrangência e evita a necessidade de repetir ajustes em cada aplicação individualmente. 
 
Se o Web.config já existir, não é necessário substituí-lo. Basta adicionar ou ajustar as permissões necessárias, tomando cuidado para não alterar outras configurações já existentes, a fim de evitar impactos indesejados no ambiente.
 
'''Se estiver trabalhando com sites separados, além das URLs da Cia, é necessário incluir os endereços de todas as demais aplicações. Caso contrário, elas não poderão ser carregadas corretamente nos demais Portais e aplicações, pois a configuração padrão permite apenas 'self', ou seja, restringe o acesso a aplicações do mesmo site e da Cia.'''
 
'''Lembre-se de que, mesmo que a maioria dos Portais e aplicações estejam todos no mesmo site, se você tiver um Portal em React, ele provavelmente estará hospedado em um site separado. Por isso, é fundamental incluir a URL desse Portal nas configurações. Caso contrário, ele poderá enfrentar restrições ao carregar outras aplicações, causando falhas na exibição dos conteúdos integrados.'''
 
'''Importante: Essas configurações devem ser feitas apenas para os ambientes que tiverem HTTPS configurados.'''
 
Exemplo com as pastas das aplicações do CIGAM Web em C:\inetpub\wwwroot\cigam no Web Server IIS:


[[Imagem:pastaWebConfig.png|semmoldura|centro|770px|Web Config]]
 

Também é possível copiar e utilizar o código abaixo para facilitar a configuração:

''<?xml version="1.0" encoding="UTF-8"?> <configuration>''
''<system.web>''
''<httpCookies requireSSL="true" sameSite="None" />''
''<sessionState cookieSameSite="None"/>''
''</system.web>''
''<system.webServer>''
''<httpProtocol>''
''<customHeaders>''
''<add name="Content-Security-Policy" value="frame-ancestors 'self' https://services.cigam.cloud http://services.cigam.cloud;" />''
''</customHeaders>''
''</httpProtocol>''
''</system.webServer> </configuration>''

====Como dar acesso através do IIS?====

Para configurar o CSP diretamente no IIS, siga os passos abaixo: 
1. Acesse o '''Gerenciador de Serviços de Informações da Internet (IIS)''' e localize o site que deseja liberar o acesso. 
2. Abra a opção '''Cabeçalhos de Resposta HTTP''' no painel do IIS, selecione o site desejado e clique em '''Cabeçalhos de Resposta HTTP'''.


[[Imagem:CabecalhoResp.png|semmoldura|centro|800px]]
 

3. Adicione o cabeçalho '''Content-Security-Policy''' na seção '''Ações''', localizada à direita, clique em '''Adicionar'''.


[[Imagem:CabecalhoResp2.png|semmoldura|centro|800px]]
 

4. Na caixa de diálogo que será exibida, preencha os seguintes campos:
* Nome: Content-Security-Policy.
* Valor: frame-ancestors 'self' https://services.cigam.cloud http://services.cigam.cloud;

 
'''Lembre-se de que, caso esteja com um ambiente com sites separados, além dessas URLs da Cia, é necessário incluir os endereços dos demais sites.'''

====Como configurar o acesso aos cookies no IIS?====

Para permitir que a Cia acesse os Cookies das aplicações, será necessário ajustar algumas permissões. Siga os passos abaixo:
* Acesse o '''Editor de Configurações''' no painel do IIS, localize a opção '''Editor de Configurações''' dentro da seção '''Gerenciamento'''.


[[Imagem:Gerenciamento.png|semmoldura|centro|800px]]
 
 

* Ajuste as configurações em '''httpCookies''':
** Navegue até a seção '''system.web''' e localize a configuração '''httpCookies'''.
** Defina os seguintes valores:
** requireSSL: True
** sameSite: None


[[Imagem:httpCookies.png|semmoldura|centro|800px]]
 


* Configuração de '''sessionState''':
** Ainda em '''system.web''', localize a configuração '''sessionState'''. 
** Altere o valor da propriedade '''cookieSameSite''' para '''None'''.


[[Imagem:sessionStage.png|semmoldura|centro|850px]]
 
Essas configurações garantem que os cookies sejam transmitidos com segurança e permitam o uso adequado em aplicações externas, atendendo aos requisitos da Cia.
{{VoltarInicio}}

==Ambientes internos sem acesso externo às aplicações==

Este ambiente possui acesso restrito à rede interna da empresa e utiliza o protocolo HTTP. Por esse motivo, algumas funcionalidades da Cia serão desabilitadas automaticamente — como recursos que exigem permissões avançadas do navegador, como o uso do microfone, ou o acesso dinâmico a iframes (componentes que permitem exibir conteúdos de outros sistemas dentro da mesma tela, como Portais).
 
'''Importante:''' Você não precisa se preocupar. A Cia detecta automaticamente essas limitações e desativa ou oculta as funcionalidades afetadas, garantindo que a experiência continue fluida e segura. Sempre que necessário, você será notificado com orientações claras sobre o que fazer.
 
Para mais informações sobre a importância do uso do HTTPS, acesse: [[GE - Importância do uso do HTTPS|Importância do uso do HTTPS]]


==Garantindo permissão de acesso aos cookies de terceiros no navegador==

Por padrão, os navegadores geralmente têm a permissão para Cookies de terceiros habilitada. No entanto, é importante verificar e assegurar essa configuração. Abaixo estão os passos para os navegadores '''Microsoft Edge''' e '''Google Chrome''': 
 
* Microsoft Edge
** Em Português:
*** Acesse Configurações → Cookies e permissões de sites → Gerenciar e excluir cookies e dados do site.
*** Desabilite a opção "Bloquear cookies de terceiros".
** Em Inglês:
*** Acesse Settings → Cookies and Site Permissions → Manage and delete cookies and site data.
*** Desabilite a opção "Block third-party cookies".


[[Imagem:settingsEdge.png|semmoldura|centro|800px]]
 
 

* Google Chrome:
** Em Português:
*** Vá para Configurações → Privacidade e segurança → Cookies de terceiros.
*** Habilite a opção "Permitir cookies de terceiros".
** Em Inglês:
*** Vá para Settings → Privacy and security → Third-party cookies.
*** Habilite a opção "Allow third-party cookies".


[[Imagem:settingsChrome.png|semmoldura|centro|800px]]

==Dispositivos móveis==

A Cia também oferece suporte para dispositivos móveis, proporcionando acesso prático e otimizado. Para utilizar a Cia em um dispositivo móvel, basta acessar o endereço normalmente pelo seu navegador. Ao entrar, será exibida uma mensagem convidando o usuário a instalar o aplicativo. A instalação também pode ser realizada diretamente através do ícone de engrenagem, no menu de configurações.


[[Imagem:CiaInstalarAppMobile.png|semmoldura|centro|700px]]


É importante destacar que a instalação do aplicativo no dispositivo móvel só será possível se o ambiente estiver configurado para utilizar HTTPS. Caso contrário, o usuário só poderá acessar a Cia diretamente pelo próprio navegador móvel, porém com algumas restrições de funcionalidades.

{{VoltarInicio}}

=Portais=
Nos Portais CIGAM, os recursos da Cia possuem exigências diferentes de configuração. Os itens abaixo indicam o que é necessário em cada caso. 

==Acesso à Cia Web (SaaS) pelo menu mosaico==
O acesso à Cia a partir do menu de mosaico (Cia - IA do CIGAM) abre a Cia Web (SaaS). Por esse motivo, depende das configurações descritas na seção [[#Cia Web (SaaS)|Cia Web (SaaS)]], em especial: 
* [[#Configurações para Cia no CIGAM|Configurações para Cia no CIGAM]], conforme o ambiente possua um único site ou mais de um.
* [[#Autenticação em duas etapas e configurações de envio de e-mail|Autenticação em duas etapas e configurações de envio de e-mail]].
* As configurações de ambiente, como CSP, cookies e permissões do navegador.
 
[[Imagem:mosaicoCia.png|semmoldura|centro|650px]]
 
Para mais informações sobre como configurar nomes lógicos e o menu mosaico, consulte: [[GE - Como Fazer - Configuração do menu mosaico nos Portais Web]] 

==Agentes e opções generativas==
Não é necessária nenhuma parametrização para utilizar os '''agentes''' e as '''opções generativas''' disponíveis no menu da Cia nos Portais, como melhoria de texto e revisão gramatical. Esses recursos são disponibilizados automaticamente, de acordo com o contexto da tela, e não dependem das configurações de local de instalação nem da autenticação em duas etapas. 
 
Os agentes estão disponíveis a partir da versão '''Beta 260601''', e o '''Editor de Agentes''' a partir da versão '''Beta 261005''', tanto para os Portais MVC quanto para os Portais React. 
 
[[Imagem:MenuCiaPortais.png|semmoldura|centro|600px]]
 
Para saber como utilizar esses recursos, consulte: [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer uso da Cia IA do CIGAM]]
{{VoltarInicio}}

=Desktop=
Na aplicação Desktop, os recursos da Cia possuem exigências distintas de configuração: 
 
{| class="wikitable"
|-
| '''Recurso''' || '''Configuração necessária'''
|-
| '''Acesso rápido à Cia - IA do CIGAM''' || Exige API e Portais instalados, além das configurações da Cia Web (SaaS).
|-
| '''Analisar com a Cia''' || Não exige parametrização no CIGAM. Requer a versão 250505 patch A ou superior e o navegador padrão e a extensão .html configurados no Windows.
|-
| '''Compartilhamento de análises por e-mail''' || Exige API instalada, configuração 3159, nomes lógicos CDN e CDN_KEYTOKEN e configurações de envio de e-mail.
|}

==Acesso rápido à Cia Web (SaaS)==
O botão de acesso rápido (Cia - IA do CIGAM) disponível no menu lateral do Desktop abre a Cia Web (SaaS) em uma janela integrada ao sistema. Por esse motivo, depende de: 
* A API e os Portais instalados, pois são eles que conectam o sistema aos dados do ERP. '''Sem a API, a funcionalidade não funcionará'''.
* As configurações descritas na seção [[#Cia Web (SaaS)|Cia Web (SaaS)]], em especial [[#Configurações para Cia no CIGAM|Configurações para Cia no CIGAM]] e [[#Autenticação em duas etapas e configurações de envio de e-mail|Autenticação em duas etapas e configurações de envio de e-mail]].
 
[[Imagem:CiaIA.png|semmoldura|centro|800px]]
 

==Recurso "Analisar com a Cia"==
O recurso '''"Analisar com a Cia"''', disponível em ferramentas como CGEditor, CGReport, Pesquisa Dinâmica e Dispositivo de Saída, não exige nenhuma parametrização adicional no CIGAM para a geração das análises. Ele também não depende da autenticação em duas etapas nem das configurações de local de instalação dos Portais. 
 
Entretanto, a funcionalidade de '''compartilhamento por e-mail''', disponível a partir da versão '''Beta 261005''', exige configurações adicionais no ambiente, conforme descrito em: [[#Configurações para compartilhamento de análises por e-mail|Configurações para compartilhamento de análises por e-mail]] 
 
Exemplo do recurso disponível na Pesquisa Dinâmica: 
 
[[Imagem:PesquisaDinamicaComCia.png|semmoldura|centro|800px]]
 
Os requisitos para utilização são: 
* Estar na versão '''250505.a''' ou superior.
* Ter um '''navegador padrão configurado no Windows''', preferencialmente o '''Google Chrome''' ou o '''Microsoft Edge''', por serem os navegadores homologados pela CIGAM.
* Ter a '''extensão .html''' associada a um desses navegadores, para que o conteúdo enviado à Cia seja aberto corretamente.
 
[[Imagem:NavegadorPadraoWindows.png|semmoldura|centro|800px]]
 
Para mais informações sobre os navegadores homologados, acesse: [[Requisitos_de_Software#Versões_de_Navegadores|Versões de navegadores]] 
 
Para saber como utilizar o recurso, consulte: [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer uso da Cia IA do CIGAM]]

=Documentos Relacionados=
[[GE - Como Fazer - Cia - Como acessar]] 
[[GE - Como Fazer - Uso da Cia - IA do CIGAM]] 
[[GE - Importância do uso do HTTPS]] 
[[GE Autenticação em duas etapas]] 
[[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]] 
[[GE - Como Fazer - Configuração do menu mosaico nos Portais Web]]
{{VoltarInicio}}

GE - Como Fazer - Configuração da Cia IA do CIGAM

2026-10-19T13:18:41Z

Roger.schneider: /* Configurações para compartilhamento de análises por e-mail */

{{VoltarPagina}}
 
[[categoria:Como_Fazer_Utilidades/Diversos]]
[[categoria:Como Fazer Utilidades/Diversos_2]]
[[MediaWiki:Como_Fazer_sidebar|Como Fazer]] > [[Como_Fazer_Utilidades/Diversos|Utilidades/Diversos]] > [[GE - Como_Fazer - Configuração da Cia IA do CIGAM|Configuração da Cia IA do CIGAM]]

=Como a Cia - IA do CIGAM funciona?=

A Cia, a IA do CIGAM, é composta por uma aplicação e um serviço, ambos hospedados na Nuvem CIGAM e executados como um SaaS (Software como Serviço). O SaaS é um modelo de aplicação acessada diretamente pelos usuários finais através do navegador de internet.
 
A execução através do modelo SaaS garante que toda a infraestrutura necessária permaneça sob responsabilidade da CIGAM na Nuvem CIGAM, oferecendo:
 
* Atualizações em tempo real, sem necessidade de intervenção do cliente. 
* Treinamento de forma compartilhada, adicionando novas funcionalidades, otimizando performance e resultados. 

Todas as configurações necessárias estão descritas em [[#Cia Web (SaaS)|Cia Web (SaaS)]]. As seções [[#Portais|Portais]] e [[#Desktop|Desktop]] indicam quais dessas configurações se aplicam a cada forma de acesso. 

=Cia Web (SaaS)=
A Cia será executada como uma página web no navegador de internet, acessando todo o ecossistema do CIGAM através das credenciais do usuário logado, da mesma forma que o usuário acessaria se estivesse logado diretamente no CIGAM.
 
As configurações desta seção garantem o funcionamento da Cia Web, que é a aplicação onde todos os recursos da Cia são disponibilizados.
 
Como os Portais e a aplicação Desktop abrem a mesma Cia Web, essas configurações também se aplicam a eles, conforme indicado nas respectivas seções. 

==Versões de navegadores==

Para garantir o pleno funcionamento da Cia, é aconselhável utilizar os navegadores Google Chrome ou Microsoft Edge, sempre atualizados para a última versão disponível, pois são os navegadores homologados pela CIGAM.
 
Além disso, recomenda-se que a extensão associada ao arquivo .html esteja configurada, por padrão, para abrir em um desses navegadores. Essa configuração assegura que relatórios, portais e páginas sejam carregados corretamente, proporcionando maior compatibilidade, segurança e desempenho.
 
Para mais informações, acesse: [[Requisitos_de_Software#Versões_de_Navegadores|Versões de navegadores]]


==Importância do uso do HTTPS==

A Cia sempre notificará o usuário caso ele esteja utilizando o protocolo HTTP, recomendando o uso do protocolo HTTPS. Isso ocorre por dois motivos principais:
 
1. Segurança: O HTTPS criptografa os dados transmitidos, garantindo maior proteção contra interceptações e ataques. 
2. Funcionalidades: O HTTPS permite que a Cia utilize recursos adicionais, como o microfone para reconhecimento de voz, aplicativo para dispositivos móveis, etc. Caso o usuário esteja em HTTP, a Cia automaticamente desativa essas funcionalidades por questões de segurança. 
 
Para mais informações sobre a importância do uso do HTTPS, acesse: [[GE - Importância do uso do HTTPS|Importância do uso do HTTPS]]


==Autenticação em duas etapas e configurações de envio de e-mail==

Para acessar a Cia Web, é obrigatório que o usuário tenha habilitado a autenticação em duas etapas para realizar o login, independentemente do ambiente. Se precisar de ajuda para configurar, consulte a documentação: [[GE Autenticação em duas etapas]]
 
Caso o envio de e-mails ainda não esteja configurado, será necessário configurá-lo, pois a autenticação em duas etapas depende dessa configuração. Se precisar de ajuda, consulte: [[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]]


==Configurações para Cia no CIGAM==
Algumas configurações e parametrizações no CIGAM são necessárias para garantir o funcionamento adequado da Cia, conforme o seu ambiente. Verifique se todas as aplicações estão em um único site ou distribuídas em mais de um e configure-as conforme a necessidade. 

===Ambiente padrão com único site===
Normalmente, os Portais, API, BI, entre outras aplicações são instalados no mesmo local, ou seja, com mesmo site, domínio e porta. Esse é o ambiente mais fácil de configurar, exigindo apenas os seguintes ajustes:
 
* Para acessar os Portais MVC:
** Acesse a configuração [[GE - AM - 3159 - Local de Instalação dos Portais Base]] e informe o local onde seus Portais MVC estão instalados.
*** Exemplo: http://servidor:porta/
 
* Para acessar os Portais React:
** Acesse a configuração [[GE - AM - 3160 - Local de Instalação dos Portais Complementares]] e informe onde seus Portais React estão instalados.
*** Exemplo: http://servidor:porta/
 
* Para acessar os dashboards do BI:
** Acesse a configuração [[GE - GE - 100325 - URL Base BI Portal]] e informe o endereço onde seu BI está instalado.
*** Exemplo: http://servidor:porta/bi 
 
'''Observação:''' mesmo em ambientes com um único site, é possível configurar as aplicações apenas por meio de '''nomes lógicos''' no arquivo '''Magic.ini'''. Nesse caso, as configurações acima não são necessárias. Para mais informações sobre como configurar nomes lógicos, consulte a documentação: [[GE - Como Fazer - Configuração do menu mosaico nos Portais Web]] 

===Ambiente com mais de um site===
Em alguns casos, as aplicações podem estar instaladas em locais diferentes, ou seja, em sites, domínios ou portas distintas. Nesses cenários, é necessário realizar configurações específicas para que a Cia consiga se comunicar corretamente com cada um deles.
 
* Quando o ambiente possui aplicações distribuídas em sites separados, podemos utilizar a configuração [[GE - AM - 3159 - Local de Instalação dos Portais Base]] para definir o endereço onde a API está hospedada. Para os demais Portais e aplicações, é possível utilizar nomes lógicos no arquivo '''Magic.ini''', informando cada um dos endereços. Alternativamente, todas as aplicações podem ser configuradas apenas por meio de nomes lógicos, sem a necessidade de utilizar essa configuração. Para mais informações sobre como configurar nomes lógicos, consulte a documentação: [[GE - Como Fazer - Configuração do menu mosaico nos Portais Web]]
 
* Para acessar os Portais React:
** Acesse a configuração [[GE - AM - 3160 - Local de Instalação dos Portais Complementares]] e informe onde seus Portais React estão instalados.
*** Exemplo: http://servidor:porta/
 
* Para acessar os dashboards do BI:
** Acesse a configuração [[GE - GE - 100325 - URL Base BI Portal]] e informe o endereço onde seu BI está instalado.
*** Exemplo: http://servidor:porta/bi 

===Configuração do BI para integração com a Cia===
Se o ambiente possuir um BI instalado e for utilizado pela Cia, é necessário garantir que a URL da API CIGAM esteja devidamente configurada. Caso ainda não esteja informada, adicione a URL nas configurações:
 
[[Imagem:apiCigamBI.png|semmoldura|centro|600px]]

===Configurações para compartilhamento de análises por e-mail===
A partir da versão '''Beta 261005''', o recurso [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Recurso_"Analisar_com_a_Cia"|Analisar com a Cia]] no Desktop passa a disponibilizar opções para utilização e compartilhamento das análises geradas, incluindo o envio por e-mail. 
 
A disponibilização ocorre por ferramenta, conforme a versão: 
* '''Beta 261005''' — Pesquisa Dinâmica/Pesquisa Paginada e FastReport.
* '''RC 270519''' — CGEditor e Dispositivo de Saída.
 

Embora a geração das análises não exija parametrizações adicionais no CIGAM, o compartilhamento por e-mail depende de algumas configurações no ambiente.

Para utilizar essa funcionalidade, é necessário:

* Possuir a '''API CIGAM''' instalada no ambiente utilizado.
* Possuir o '''Broker''' do ambiente devidamente configurado e em execução.
* Informar os nomes lógicos '''CDN''' e '''CDN_KEYTOKEN''' no arquivo '''Magic.ini'''.
* Possuir as configurações de envio de e-mails pelo CIGAM devidamente parametrizadas.
 

====Configuração da API====

Para realizar o envio de análises por e-mail, é necessário que a '''API CIGAM''' esteja instalada e acessível no ambiente utilizado.

A configuração [[GE - AM - 3159 - Local de Instalação dos Portais Base|3159 - Local de Instalação dos Portais Base]] deve estar devidamente parametrizada, permitindo que o CIGAM localize a API responsável pelo processamento da solicitação.

Caso a API não esteja instalada ou não possa ser acessada, será apresentada uma mensagem de erro ao tentar realizar o envio.

 
[[Imagem:CiaDesktopErroAPI.png|semmoldura|center|700px]]
 

====Configuração do Broker====

Para realizar o compartilhamento das análises por e-mail, também é necessário que o '''Broker''' do ambiente esteja devidamente configurado e em execução.
Caso o Broker não esteja em execução ou apresente alguma configuração incorreta, será exibida uma mensagem de erro ao tentar enviar a análise por e-mail.
 
[[Imagem:CiaDesktopErroBroker.png|semmoldura|center|700px]]
 

====Configuração dos nomes lógicos====
Além da API e do Broker, é necessário configurar os nomes lógicos '''CDN''' e '''CDN_KEYTOKEN''' no arquivo '''Magic.ini''' do ambiente.
Esses nomes lógicos são utilizados para identificar o endereço e a chave de acesso à CDN, necessária para disponibilizar o arquivo da análise que será enviado como anexo.

* '''CDN:''' deve conter o endereço da CDN utilizada pelo ambiente.
* '''CDN_KEYTOKEN:''' deve conter a chave de acesso utilizada para a comunicação com a CDN.

Caso o nome lógico '''CDN''' não esteja configurado corretamente, será apresentada uma mensagem de erro relacionada ao endereço da CDN.
 
[[Imagem:CiaDesktopErroCaminhoCDN.png|semmoldura|center|700px]]
 

Da mesma forma, caso o nome lógico '''CDN_KEYTOKEN''' não esteja informado corretamente, será apresentada uma mensagem de erro relacionada à chave de acesso.
 
[[Imagem:CiaDesktopErroCDNKey.png|semmoldura|center|700px]]
 

====Configurações de envio de e-mail====

Também é necessário que o ambiente possua as configurações necessárias para realizar o envio de e-mails pelo CIGAM devidamente parametrizadas.
Caso essas configurações estejam ausentes ou incorretas, poderão ocorrer falhas durante o envio da análise.
Para mais informações, consulte [[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]].
 

'''Importante:''' o botão '''E-mail''' permanece disponível mesmo quando alguma das configurações necessárias não está correta. Nesses casos, a mensagem de erro correspondente será apresentada durante a tentativa de envio, e não haverá o compartilhamento da análise.
{{VoltarInicio}}

==Configurações de CORS==

A forma como a Cia é executada, operando como um SaaS, pode causar restrições relacionadas ao CORS (Compartilhamento de Recursos entre Origens Diferentes). O CORS é um mecanismo de segurança implementado pelos navegadores para proteger os usuários, restringindo solicitações de recursos entre diferentes domínios não permitidos. Essas restrições podem causar erros ao tentar acessar cookies e outras informações. 
Cookies são pequenos arquivos armazenados no computador ou dispositivo do usuário que contêm informações sobre a atividade do usuário em sites para melhorar a experiência de navegação. 
Para o navegador, domínios diferentes são tratados de forma separada por questões de segurança. A Cia estará hospedada em um domínio (da CIGAM Corp. na Nuvem CIGAM). E o CIGAM Web do usuário estará em outro domínio, que pode ser em um servidor on-premise (local) ou em qualquer Nuvem, inclusive na Nuvem CIGAM.


==Ambientes com acesso externo às aplicações==

Esse seria o ambiente ideal para utilizar a Cia, o qual possui acesso externo às aplicações do CIGAM, como Portais, APIs, etc. Esse ambiente é acessível via internet e deve possuir HTTPS configurado com um domínio público.


===Como configurar o web server (Microsoft IIS)?===

Para permitir que a Cia acesse as aplicações do ambiente com acesso externo, é necessário configurar o Web Server no Microsoft IIS. O principal ajuste será a inclusão do cabeçalho de resposta denominado CSP (Content-Security-Policy).
 
O CSP define diretrizes que instruem o navegador sobre as fontes permitidas para diferentes tipos de conteúdo em uma página da web. Essa configuração pode ser realizada das seguintes formas:


====Configuração via arquivo web.config====

A maneira mais simples e rápida de realizar essa configuração é por meio da criação ou edição do arquivo Web.config, que funciona como um "manual de instruções" para o sistema. Sempre que você ajusta configurações no Microsoft IIS, esse arquivo pode ser criado ou modificado automaticamente. 
 
No entanto, é importante destacar que o arquivo Web.config pode não existir em alguns ambientes. Isso ocorre porque, até então, não utilizávamos esse tipo de configuração como padrão em todos os portais. Portanto, caso o arquivo não esteja presente, será necessário criá-lo manualmente. 
 
Esse arquivo deve ser criado (ou editado) na pasta raiz do site que engloba todas as aplicações, permitindo que a Cia tenha acesso a todos os domínios e aplicações de forma unificada. Por ser um arquivo geral, o Web.config afeta todas as aplicações vinculadas à raiz do site. Portanto, a configuração nesse local garante abrangência e evita a necessidade de repetir ajustes em cada aplicação individualmente. 
 
Se o Web.config já existir, não é necessário substituí-lo. Basta adicionar ou ajustar as permissões necessárias, tomando cuidado para não alterar outras configurações já existentes, a fim de evitar impactos indesejados no ambiente.
 
'''Se estiver trabalhando com sites separados, além das URLs da Cia, é necessário incluir os endereços de todas as demais aplicações. Caso contrário, elas não poderão ser carregadas corretamente nos demais Portais e aplicações, pois a configuração padrão permite apenas 'self', ou seja, restringe o acesso a aplicações do mesmo site e da Cia.'''
 
'''Lembre-se de que, mesmo que a maioria dos Portais e aplicações estejam todos no mesmo site, se você tiver um Portal em React, ele provavelmente estará hospedado em um site separado. Por isso, é fundamental incluir a URL desse Portal nas configurações. Caso contrário, ele poderá enfrentar restrições ao carregar outras aplicações, causando falhas na exibição dos conteúdos integrados.'''
 
'''Importante: Essas configurações devem ser feitas apenas para os ambientes que tiverem HTTPS configurados.'''
 
Exemplo com as pastas das aplicações do CIGAM Web em C:\inetpub\wwwroot\cigam no Web Server IIS:


[[Imagem:pastaWebConfig.png|semmoldura|centro|770px|Web Config]]
 

Também é possível copiar e utilizar o código abaixo para facilitar a configuração:

''<?xml version="1.0" encoding="UTF-8"?> <configuration>''
''<system.web>''
''<httpCookies requireSSL="true" sameSite="None" />''
''<sessionState cookieSameSite="None"/>''
''</system.web>''
''<system.webServer>''
''<httpProtocol>''
''<customHeaders>''
''<add name="Content-Security-Policy" value="frame-ancestors 'self' https://services.cigam.cloud http://services.cigam.cloud;" />''
''</customHeaders>''
''</httpProtocol>''
''</system.webServer> </configuration>''

====Como dar acesso através do IIS?====

Para configurar o CSP diretamente no IIS, siga os passos abaixo: 
1. Acesse o '''Gerenciador de Serviços de Informações da Internet (IIS)''' e localize o site que deseja liberar o acesso. 
2. Abra a opção '''Cabeçalhos de Resposta HTTP''' no painel do IIS, selecione o site desejado e clique em '''Cabeçalhos de Resposta HTTP'''.


[[Imagem:CabecalhoResp.png|semmoldura|centro|800px]]
 

3. Adicione o cabeçalho '''Content-Security-Policy''' na seção '''Ações''', localizada à direita, clique em '''Adicionar'''.


[[Imagem:CabecalhoResp2.png|semmoldura|centro|800px]]
 

4. Na caixa de diálogo que será exibida, preencha os seguintes campos:
* Nome: Content-Security-Policy.
* Valor: frame-ancestors 'self' https://services.cigam.cloud http://services.cigam.cloud;

 
'''Lembre-se de que, caso esteja com um ambiente com sites separados, além dessas URLs da Cia, é necessário incluir os endereços dos demais sites.'''

====Como configurar o acesso aos cookies no IIS?====

Para permitir que a Cia acesse os Cookies das aplicações, será necessário ajustar algumas permissões. Siga os passos abaixo:
* Acesse o '''Editor de Configurações''' no painel do IIS, localize a opção '''Editor de Configurações''' dentro da seção '''Gerenciamento'''.


[[Imagem:Gerenciamento.png|semmoldura|centro|800px]]
 
 

* Ajuste as configurações em '''httpCookies''':
** Navegue até a seção '''system.web''' e localize a configuração '''httpCookies'''.
** Defina os seguintes valores:
** requireSSL: True
** sameSite: None


[[Imagem:httpCookies.png|semmoldura|centro|800px]]
 


* Configuração de '''sessionState''':
** Ainda em '''system.web''', localize a configuração '''sessionState'''. 
** Altere o valor da propriedade '''cookieSameSite''' para '''None'''.


[[Imagem:sessionStage.png|semmoldura|centro|850px]]
 
Essas configurações garantem que os cookies sejam transmitidos com segurança e permitam o uso adequado em aplicações externas, atendendo aos requisitos da Cia.
{{VoltarInicio}}

==Ambientes internos sem acesso externo às aplicações==

Este ambiente possui acesso restrito à rede interna da empresa e utiliza o protocolo HTTP. Por esse motivo, algumas funcionalidades da Cia serão desabilitadas automaticamente — como recursos que exigem permissões avançadas do navegador, como o uso do microfone, ou o acesso dinâmico a iframes (componentes que permitem exibir conteúdos de outros sistemas dentro da mesma tela, como Portais).
 
'''Importante:''' Você não precisa se preocupar. A Cia detecta automaticamente essas limitações e desativa ou oculta as funcionalidades afetadas, garantindo que a experiência continue fluida e segura. Sempre que necessário, você será notificado com orientações claras sobre o que fazer.
 
Para mais informações sobre a importância do uso do HTTPS, acesse: [[GE - Importância do uso do HTTPS|Importância do uso do HTTPS]]


==Garantindo permissão de acesso aos cookies de terceiros no navegador==

Por padrão, os navegadores geralmente têm a permissão para Cookies de terceiros habilitada. No entanto, é importante verificar e assegurar essa configuração. Abaixo estão os passos para os navegadores '''Microsoft Edge''' e '''Google Chrome''': 
 
* Microsoft Edge
** Em Português:
*** Acesse Configurações → Cookies e permissões de sites → Gerenciar e excluir cookies e dados do site.
*** Desabilite a opção "Bloquear cookies de terceiros".
** Em Inglês:
*** Acesse Settings → Cookies and Site Permissions → Manage and delete cookies and site data.
*** Desabilite a opção "Block third-party cookies".


[[Imagem:settingsEdge.png|semmoldura|centro|800px]]
 
 

* Google Chrome:
** Em Português:
*** Vá para Configurações → Privacidade e segurança → Cookies de terceiros.
*** Habilite a opção "Permitir cookies de terceiros".
** Em Inglês:
*** Vá para Settings → Privacy and security → Third-party cookies.
*** Habilite a opção "Allow third-party cookies".


[[Imagem:settingsChrome.png|semmoldura|centro|800px]]

==Dispositivos móveis==

A Cia também oferece suporte para dispositivos móveis, proporcionando acesso prático e otimizado. Para utilizar a Cia em um dispositivo móvel, basta acessar o endereço normalmente pelo seu navegador. Ao entrar, será exibida uma mensagem convidando o usuário a instalar o aplicativo. A instalação também pode ser realizada diretamente através do ícone de engrenagem, no menu de configurações.


[[Imagem:CiaInstalarAppMobile.png|semmoldura|centro|700px]]


É importante destacar que a instalação do aplicativo no dispositivo móvel só será possível se o ambiente estiver configurado para utilizar HTTPS. Caso contrário, o usuário só poderá acessar a Cia diretamente pelo próprio navegador móvel, porém com algumas restrições de funcionalidades.

{{VoltarInicio}}

=Portais=
Nos Portais CIGAM, os recursos da Cia possuem exigências diferentes de configuração. Os itens abaixo indicam o que é necessário em cada caso. 

==Acesso à Cia Web (SaaS) pelo menu mosaico==
O acesso à Cia a partir do menu de mosaico (Cia - IA do CIGAM) abre a Cia Web (SaaS). Por esse motivo, depende das configurações descritas na seção [[#Cia Web (SaaS)|Cia Web (SaaS)]], em especial: 
* [[#Configurações para Cia no CIGAM|Configurações para Cia no CIGAM]], conforme o ambiente possua um único site ou mais de um.
* [[#Autenticação em duas etapas e configurações de envio de e-mail|Autenticação em duas etapas e configurações de envio de e-mail]].
* As configurações de ambiente, como CSP, cookies e permissões do navegador.
 
[[Imagem:mosaicoCia.png|semmoldura|centro|650px]]
 
Para mais informações sobre como configurar nomes lógicos e o menu mosaico, consulte: [[GE - Como Fazer - Configuração do menu mosaico nos Portais Web]] 

==Agentes e opções generativas==
Não é necessária nenhuma parametrização para utilizar os '''agentes''' e as '''opções generativas''' disponíveis no menu da Cia nos Portais, como melhoria de texto e revisão gramatical. Esses recursos são disponibilizados automaticamente, de acordo com o contexto da tela, e não dependem das configurações de local de instalação nem da autenticação em duas etapas. 
 
Os agentes estão disponíveis a partir da versão '''Beta 260601''', e o '''Editor de Agentes''' a partir da versão '''Beta 261005''', tanto para os Portais MVC quanto para os Portais React. 
 
[[Imagem:MenuCiaPortais.png|semmoldura|centro|600px]]
 
Para saber como utilizar esses recursos, consulte: [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer uso da Cia IA do CIGAM]]
{{VoltarInicio}}

=Desktop=
Na aplicação Desktop, os recursos da Cia possuem exigências distintas de configuração: 
 
{| class="wikitable"
|-
| '''Recurso''' || '''Configuração necessária'''
|-
| '''Acesso rápido à Cia - IA do CIGAM''' || Exige API e Portais instalados, além das configurações da Cia Web (SaaS).
|-
| '''Analisar com a Cia''' || Não exige parametrização no CIGAM. Requer a versão 250505 patch A ou superior e o navegador padrão e a extensão .html configurados no Windows.
|-
| '''Compartilhamento de análises por e-mail''' || Exige API instalada, configuração 3159, nomes lógicos CDN e CDN_KEYTOKEN e configurações de envio de e-mail.
|}

==Acesso rápido à Cia Web (SaaS)==
O botão de acesso rápido (Cia - IA do CIGAM) disponível no menu lateral do Desktop abre a Cia Web (SaaS) em uma janela integrada ao sistema. Por esse motivo, depende de: 
* A API e os Portais instalados, pois são eles que conectam o sistema aos dados do ERP. '''Sem a API, a funcionalidade não funcionará'''.
* As configurações descritas na seção [[#Cia Web (SaaS)|Cia Web (SaaS)]], em especial [[#Configurações para Cia no CIGAM|Configurações para Cia no CIGAM]] e [[#Autenticação em duas etapas e configurações de envio de e-mail|Autenticação em duas etapas e configurações de envio de e-mail]].
 
[[Imagem:CiaIA.png|semmoldura|centro|800px]]
 

==Recurso "Analisar com a Cia"==
O recurso '''"Analisar com a Cia"''', disponível em ferramentas como CGEditor, CGReport, Pesquisa Dinâmica e Dispositivo de Saída, não exige nenhuma parametrização adicional no CIGAM para a geração das análises. Ele também não depende da autenticação em duas etapas nem das configurações de local de instalação dos Portais. 
 
Entretanto, a funcionalidade de '''compartilhamento por e-mail''', disponível a partir da versão '''Beta 261005''', exige configurações adicionais no ambiente, conforme descrito em: [[#Configurações para compartilhamento de análises por e-mail|Configurações para compartilhamento de análises por e-mail]] 
 
Exemplo do recurso disponível na Pesquisa Dinâmica: 
 
[[Imagem:PesquisaDinamicaComCia.png|semmoldura|centro|800px]]
 
Os requisitos para utilização são: 
* Estar na versão '''250505.a''' ou superior.
* Ter um '''navegador padrão configurado no Windows''', preferencialmente o '''Google Chrome''' ou o '''Microsoft Edge''', por serem os navegadores homologados pela CIGAM.
* Ter a '''extensão .html''' associada a um desses navegadores, para que o conteúdo enviado à Cia seja aberto corretamente.
 
[[Imagem:NavegadorPadraoWindows.png|semmoldura|centro|800px]]
 
Para mais informações sobre os navegadores homologados, acesse: [[Requisitos_de_Software#Versões_de_Navegadores|Versões de navegadores]] 
 
Para saber como utilizar o recurso, consulte: [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer uso da Cia IA do CIGAM]]

=Documentos Relacionados=
[[GE - Como Fazer - Cia - Como acessar]] 
[[GE - Como Fazer - Uso da Cia - IA do CIGAM]] 
[[GE - Importância do uso do HTTPS]] 
[[GE Autenticação em duas etapas]] 
[[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]] 
[[GE - Como Fazer - Configuração do menu mosaico nos Portais Web]]
{{VoltarInicio}}

GE - Como Fazer - Configuração da Cia IA do CIGAM

2026-10-19T13:15:19Z

Roger.schneider: /* Recurso "Analisar com a Cia" */

{{VoltarPagina}}
 
[[categoria:Como_Fazer_Utilidades/Diversos]]
[[categoria:Como Fazer Utilidades/Diversos_2]]
[[MediaWiki:Como_Fazer_sidebar|Como Fazer]] > [[Como_Fazer_Utilidades/Diversos|Utilidades/Diversos]] > [[GE - Como_Fazer - Configuração da Cia IA do CIGAM|Configuração da Cia IA do CIGAM]]

=Como a Cia - IA do CIGAM funciona?=

A Cia, a IA do CIGAM, é composta por uma aplicação e um serviço, ambos hospedados na Nuvem CIGAM e executados como um SaaS (Software como Serviço). O SaaS é um modelo de aplicação acessada diretamente pelos usuários finais através do navegador de internet.
 
A execução através do modelo SaaS garante que toda a infraestrutura necessária permaneça sob responsabilidade da CIGAM na Nuvem CIGAM, oferecendo:
 
* Atualizações em tempo real, sem necessidade de intervenção do cliente. 
* Treinamento de forma compartilhada, adicionando novas funcionalidades, otimizando performance e resultados. 

Todas as configurações necessárias estão descritas em [[#Cia Web (SaaS)|Cia Web (SaaS)]]. As seções [[#Portais|Portais]] e [[#Desktop|Desktop]] indicam quais dessas configurações se aplicam a cada forma de acesso. 

=Cia Web (SaaS)=
A Cia será executada como uma página web no navegador de internet, acessando todo o ecossistema do CIGAM através das credenciais do usuário logado, da mesma forma que o usuário acessaria se estivesse logado diretamente no CIGAM.
 
As configurações desta seção garantem o funcionamento da Cia Web, que é a aplicação onde todos os recursos da Cia são disponibilizados.
 
Como os Portais e a aplicação Desktop abrem a mesma Cia Web, essas configurações também se aplicam a eles, conforme indicado nas respectivas seções. 

==Versões de navegadores==

Para garantir o pleno funcionamento da Cia, é aconselhável utilizar os navegadores Google Chrome ou Microsoft Edge, sempre atualizados para a última versão disponível, pois são os navegadores homologados pela CIGAM.
 
Além disso, recomenda-se que a extensão associada ao arquivo .html esteja configurada, por padrão, para abrir em um desses navegadores. Essa configuração assegura que relatórios, portais e páginas sejam carregados corretamente, proporcionando maior compatibilidade, segurança e desempenho.
 
Para mais informações, acesse: [[Requisitos_de_Software#Versões_de_Navegadores|Versões de navegadores]]


==Importância do uso do HTTPS==

A Cia sempre notificará o usuário caso ele esteja utilizando o protocolo HTTP, recomendando o uso do protocolo HTTPS. Isso ocorre por dois motivos principais:
 
1. Segurança: O HTTPS criptografa os dados transmitidos, garantindo maior proteção contra interceptações e ataques. 
2. Funcionalidades: O HTTPS permite que a Cia utilize recursos adicionais, como o microfone para reconhecimento de voz, aplicativo para dispositivos móveis, etc. Caso o usuário esteja em HTTP, a Cia automaticamente desativa essas funcionalidades por questões de segurança. 
 
Para mais informações sobre a importância do uso do HTTPS, acesse: [[GE - Importância do uso do HTTPS|Importância do uso do HTTPS]]


==Autenticação em duas etapas e configurações de envio de e-mail==

Para acessar a Cia Web, é obrigatório que o usuário tenha habilitado a autenticação em duas etapas para realizar o login, independentemente do ambiente. Se precisar de ajuda para configurar, consulte a documentação: [[GE Autenticação em duas etapas]]
 
Caso o envio de e-mails ainda não esteja configurado, será necessário configurá-lo, pois a autenticação em duas etapas depende dessa configuração. Se precisar de ajuda, consulte: [[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]]


==Configurações para Cia no CIGAM==
Algumas configurações e parametrizações no CIGAM são necessárias para garantir o funcionamento adequado da Cia, conforme o seu ambiente. Verifique se todas as aplicações estão em um único site ou distribuídas em mais de um e configure-as conforme a necessidade. 

===Ambiente padrão com único site===
Normalmente, os Portais, API, BI, entre outras aplicações são instalados no mesmo local, ou seja, com mesmo site, domínio e porta. Esse é o ambiente mais fácil de configurar, exigindo apenas os seguintes ajustes:
 
* Para acessar os Portais MVC:
** Acesse a configuração [[GE - AM - 3159 - Local de Instalação dos Portais Base]] e informe o local onde seus Portais MVC estão instalados.
*** Exemplo: http://servidor:porta/
 
* Para acessar os Portais React:
** Acesse a configuração [[GE - AM - 3160 - Local de Instalação dos Portais Complementares]] e informe onde seus Portais React estão instalados.
*** Exemplo: http://servidor:porta/
 
* Para acessar os dashboards do BI:
** Acesse a configuração [[GE - GE - 100325 - URL Base BI Portal]] e informe o endereço onde seu BI está instalado.
*** Exemplo: http://servidor:porta/bi 
 
'''Observação:''' mesmo em ambientes com um único site, é possível configurar as aplicações apenas por meio de '''nomes lógicos''' no arquivo '''Magic.ini'''. Nesse caso, as configurações acima não são necessárias. Para mais informações sobre como configurar nomes lógicos, consulte a documentação: [[GE - Como Fazer - Configuração do menu mosaico nos Portais Web]] 

===Ambiente com mais de um site===
Em alguns casos, as aplicações podem estar instaladas em locais diferentes, ou seja, em sites, domínios ou portas distintas. Nesses cenários, é necessário realizar configurações específicas para que a Cia consiga se comunicar corretamente com cada um deles.
 
* Quando o ambiente possui aplicações distribuídas em sites separados, podemos utilizar a configuração [[GE - AM - 3159 - Local de Instalação dos Portais Base]] para definir o endereço onde a API está hospedada. Para os demais Portais e aplicações, é possível utilizar nomes lógicos no arquivo '''Magic.ini''', informando cada um dos endereços. Alternativamente, todas as aplicações podem ser configuradas apenas por meio de nomes lógicos, sem a necessidade de utilizar essa configuração. Para mais informações sobre como configurar nomes lógicos, consulte a documentação: [[GE - Como Fazer - Configuração do menu mosaico nos Portais Web]]
 
* Para acessar os Portais React:
** Acesse a configuração [[GE - AM - 3160 - Local de Instalação dos Portais Complementares]] e informe onde seus Portais React estão instalados.
*** Exemplo: http://servidor:porta/
 
* Para acessar os dashboards do BI:
** Acesse a configuração [[GE - GE - 100325 - URL Base BI Portal]] e informe o endereço onde seu BI está instalado.
*** Exemplo: http://servidor:porta/bi 

===Configuração do BI para integração com a Cia===
Se o ambiente possuir um BI instalado e for utilizado pela Cia, é necessário garantir que a URL da API CIGAM esteja devidamente configurada. Caso ainda não esteja informada, adicione a URL nas configurações:
 
[[Imagem:apiCigamBI.png|semmoldura|centro|600px]]

===Configurações para compartilhamento de análises por e-mail===

A partir da versão '''Beta 261005''', o recurso [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Recurso_"Analisar_com_a_Cia"|Analisar com a Cia]] no Desktop passa a disponibilizar opções para utilização e compartilhamento das análises geradas, incluindo o envio por e-mail.

Embora a geração das análises não exija parametrizações adicionais no CIGAM, o compartilhamento por e-mail depende de algumas configurações no ambiente.

Para utilizar essa funcionalidade, é necessário:

* Possuir a '''API CIGAM''' instalada no ambiente utilizado.
* Possuir o '''Broker''' do ambiente devidamente configurado e em execução.
* Informar os nomes lógicos '''CDN''' e '''CDN_KEYTOKEN''' no arquivo '''Magic.ini'''.
* Possuir as configurações de envio de e-mails pelo CIGAM devidamente parametrizadas.
 

====Configuração da API====

Para realizar o envio de análises por e-mail, é necessário que a '''API CIGAM''' esteja instalada e acessível no ambiente utilizado.

A configuração [[GE - AM - 3159 - Local de Instalação dos Portais Base|3159 - Local de Instalação dos Portais Base]] deve estar devidamente parametrizada, permitindo que o CIGAM localize a API responsável pelo processamento da solicitação.

Caso a API não esteja instalada ou não possa ser acessada, será apresentada uma mensagem de erro ao tentar realizar o envio.

 
[[Imagem:CiaDesktopErroAPI.png|semmoldura|center|700px]]
 

====Configuração do Broker====

Para realizar o compartilhamento das análises por e-mail, também é necessário que o '''Broker''' do ambiente esteja devidamente configurado e em execução.
Caso o Broker não esteja em execução ou apresente alguma configuração incorreta, será exibida uma mensagem de erro ao tentar enviar a análise por e-mail.
 
[[Imagem:CiaDesktopErroBroker.png|semmoldura|center|700px]]
 

====Configuração dos nomes lógicos====
Além da API e do Broker, é necessário configurar os nomes lógicos '''CDN''' e '''CDN_KEYTOKEN''' no arquivo '''Magic.ini''' do ambiente.
Esses nomes lógicos são utilizados para identificar o endereço e a chave de acesso à CDN, necessária para disponibilizar o arquivo da análise que será enviado como anexo.

* '''CDN:''' deve conter o endereço da CDN utilizada pelo ambiente.
* '''CDN_KEYTOKEN:''' deve conter a chave de acesso utilizada para a comunicação com a CDN.

Caso o nome lógico '''CDN''' não esteja configurado corretamente, será apresentada uma mensagem de erro relacionada ao endereço da CDN.
 
[[Imagem:CiaDesktopErroCaminhoCDN.png|semmoldura|center|700px]]
 

Da mesma forma, caso o nome lógico '''CDN_KEYTOKEN''' não esteja informado corretamente, será apresentada uma mensagem de erro relacionada à chave de acesso.
 
[[Imagem:CiaDesktopErroCDNKey.png|semmoldura|center|700px]]
 

====Configurações de envio de e-mail====

Também é necessário que o ambiente possua as configurações necessárias para realizar o envio de e-mails pelo CIGAM devidamente parametrizadas.
Caso essas configurações estejam ausentes ou incorretas, poderão ocorrer falhas durante o envio da análise.
Para mais informações, consulte [[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]].
 

'''Importante:''' o botão '''E-mail''' permanece disponível mesmo quando alguma das configurações necessárias não está correta. Nesses casos, a mensagem de erro correspondente será apresentada durante a tentativa de envio, e não haverá o compartilhamento da análise.
{{VoltarInicio}}

==Configurações de CORS==

A forma como a Cia é executada, operando como um SaaS, pode causar restrições relacionadas ao CORS (Compartilhamento de Recursos entre Origens Diferentes). O CORS é um mecanismo de segurança implementado pelos navegadores para proteger os usuários, restringindo solicitações de recursos entre diferentes domínios não permitidos. Essas restrições podem causar erros ao tentar acessar cookies e outras informações. 
Cookies são pequenos arquivos armazenados no computador ou dispositivo do usuário que contêm informações sobre a atividade do usuário em sites para melhorar a experiência de navegação. 
Para o navegador, domínios diferentes são tratados de forma separada por questões de segurança. A Cia estará hospedada em um domínio (da CIGAM Corp. na Nuvem CIGAM). E o CIGAM Web do usuário estará em outro domínio, que pode ser em um servidor on-premise (local) ou em qualquer Nuvem, inclusive na Nuvem CIGAM.


==Ambientes com acesso externo às aplicações==

Esse seria o ambiente ideal para utilizar a Cia, o qual possui acesso externo às aplicações do CIGAM, como Portais, APIs, etc. Esse ambiente é acessível via internet e deve possuir HTTPS configurado com um domínio público.


===Como configurar o web server (Microsoft IIS)?===

Para permitir que a Cia acesse as aplicações do ambiente com acesso externo, é necessário configurar o Web Server no Microsoft IIS. O principal ajuste será a inclusão do cabeçalho de resposta denominado CSP (Content-Security-Policy).
 
O CSP define diretrizes que instruem o navegador sobre as fontes permitidas para diferentes tipos de conteúdo em uma página da web. Essa configuração pode ser realizada das seguintes formas:


====Configuração via arquivo web.config====

A maneira mais simples e rápida de realizar essa configuração é por meio da criação ou edição do arquivo Web.config, que funciona como um "manual de instruções" para o sistema. Sempre que você ajusta configurações no Microsoft IIS, esse arquivo pode ser criado ou modificado automaticamente. 
 
No entanto, é importante destacar que o arquivo Web.config pode não existir em alguns ambientes. Isso ocorre porque, até então, não utilizávamos esse tipo de configuração como padrão em todos os portais. Portanto, caso o arquivo não esteja presente, será necessário criá-lo manualmente. 
 
Esse arquivo deve ser criado (ou editado) na pasta raiz do site que engloba todas as aplicações, permitindo que a Cia tenha acesso a todos os domínios e aplicações de forma unificada. Por ser um arquivo geral, o Web.config afeta todas as aplicações vinculadas à raiz do site. Portanto, a configuração nesse local garante abrangência e evita a necessidade de repetir ajustes em cada aplicação individualmente. 
 
Se o Web.config já existir, não é necessário substituí-lo. Basta adicionar ou ajustar as permissões necessárias, tomando cuidado para não alterar outras configurações já existentes, a fim de evitar impactos indesejados no ambiente.
 
'''Se estiver trabalhando com sites separados, além das URLs da Cia, é necessário incluir os endereços de todas as demais aplicações. Caso contrário, elas não poderão ser carregadas corretamente nos demais Portais e aplicações, pois a configuração padrão permite apenas 'self', ou seja, restringe o acesso a aplicações do mesmo site e da Cia.'''
 
'''Lembre-se de que, mesmo que a maioria dos Portais e aplicações estejam todos no mesmo site, se você tiver um Portal em React, ele provavelmente estará hospedado em um site separado. Por isso, é fundamental incluir a URL desse Portal nas configurações. Caso contrário, ele poderá enfrentar restrições ao carregar outras aplicações, causando falhas na exibição dos conteúdos integrados.'''
 
'''Importante: Essas configurações devem ser feitas apenas para os ambientes que tiverem HTTPS configurados.'''
 
Exemplo com as pastas das aplicações do CIGAM Web em C:\inetpub\wwwroot\cigam no Web Server IIS:


[[Imagem:pastaWebConfig.png|semmoldura|centro|770px|Web Config]]
 

Também é possível copiar e utilizar o código abaixo para facilitar a configuração:

''<?xml version="1.0" encoding="UTF-8"?> <configuration>''
''<system.web>''
''<httpCookies requireSSL="true" sameSite="None" />''
''<sessionState cookieSameSite="None"/>''
''</system.web>''
''<system.webServer>''
''<httpProtocol>''
''<customHeaders>''
''<add name="Content-Security-Policy" value="frame-ancestors 'self' https://services.cigam.cloud http://services.cigam.cloud;" />''
''</customHeaders>''
''</httpProtocol>''
''</system.webServer> </configuration>''

====Como dar acesso através do IIS?====

Para configurar o CSP diretamente no IIS, siga os passos abaixo: 
1. Acesse o '''Gerenciador de Serviços de Informações da Internet (IIS)''' e localize o site que deseja liberar o acesso. 
2. Abra a opção '''Cabeçalhos de Resposta HTTP''' no painel do IIS, selecione o site desejado e clique em '''Cabeçalhos de Resposta HTTP'''.


[[Imagem:CabecalhoResp.png|semmoldura|centro|800px]]
 

3. Adicione o cabeçalho '''Content-Security-Policy''' na seção '''Ações''', localizada à direita, clique em '''Adicionar'''.


[[Imagem:CabecalhoResp2.png|semmoldura|centro|800px]]
 

4. Na caixa de diálogo que será exibida, preencha os seguintes campos:
* Nome: Content-Security-Policy.
* Valor: frame-ancestors 'self' https://services.cigam.cloud http://services.cigam.cloud;

 
'''Lembre-se de que, caso esteja com um ambiente com sites separados, além dessas URLs da Cia, é necessário incluir os endereços dos demais sites.'''

====Como configurar o acesso aos cookies no IIS?====

Para permitir que a Cia acesse os Cookies das aplicações, será necessário ajustar algumas permissões. Siga os passos abaixo:
* Acesse o '''Editor de Configurações''' no painel do IIS, localize a opção '''Editor de Configurações''' dentro da seção '''Gerenciamento'''.


[[Imagem:Gerenciamento.png|semmoldura|centro|800px]]
 
 

* Ajuste as configurações em '''httpCookies''':
** Navegue até a seção '''system.web''' e localize a configuração '''httpCookies'''.
** Defina os seguintes valores:
** requireSSL: True
** sameSite: None


[[Imagem:httpCookies.png|semmoldura|centro|800px]]
 


* Configuração de '''sessionState''':
** Ainda em '''system.web''', localize a configuração '''sessionState'''. 
** Altere o valor da propriedade '''cookieSameSite''' para '''None'''.


[[Imagem:sessionStage.png|semmoldura|centro|850px]]
 
Essas configurações garantem que os cookies sejam transmitidos com segurança e permitam o uso adequado em aplicações externas, atendendo aos requisitos da Cia.
{{VoltarInicio}}

==Ambientes internos sem acesso externo às aplicações==

Este ambiente possui acesso restrito à rede interna da empresa e utiliza o protocolo HTTP. Por esse motivo, algumas funcionalidades da Cia serão desabilitadas automaticamente — como recursos que exigem permissões avançadas do navegador, como o uso do microfone, ou o acesso dinâmico a iframes (componentes que permitem exibir conteúdos de outros sistemas dentro da mesma tela, como Portais).
 
'''Importante:''' Você não precisa se preocupar. A Cia detecta automaticamente essas limitações e desativa ou oculta as funcionalidades afetadas, garantindo que a experiência continue fluida e segura. Sempre que necessário, você será notificado com orientações claras sobre o que fazer.
 
Para mais informações sobre a importância do uso do HTTPS, acesse: [[GE - Importância do uso do HTTPS|Importância do uso do HTTPS]]


==Garantindo permissão de acesso aos cookies de terceiros no navegador==

Por padrão, os navegadores geralmente têm a permissão para Cookies de terceiros habilitada. No entanto, é importante verificar e assegurar essa configuração. Abaixo estão os passos para os navegadores '''Microsoft Edge''' e '''Google Chrome''': 
 
* Microsoft Edge
** Em Português:
*** Acesse Configurações → Cookies e permissões de sites → Gerenciar e excluir cookies e dados do site.
*** Desabilite a opção "Bloquear cookies de terceiros".
** Em Inglês:
*** Acesse Settings → Cookies and Site Permissions → Manage and delete cookies and site data.
*** Desabilite a opção "Block third-party cookies".


[[Imagem:settingsEdge.png|semmoldura|centro|800px]]
 
 

* Google Chrome:
** Em Português:
*** Vá para Configurações → Privacidade e segurança → Cookies de terceiros.
*** Habilite a opção "Permitir cookies de terceiros".
** Em Inglês:
*** Vá para Settings → Privacy and security → Third-party cookies.
*** Habilite a opção "Allow third-party cookies".


[[Imagem:settingsChrome.png|semmoldura|centro|800px]]

==Dispositivos móveis==

A Cia também oferece suporte para dispositivos móveis, proporcionando acesso prático e otimizado. Para utilizar a Cia em um dispositivo móvel, basta acessar o endereço normalmente pelo seu navegador. Ao entrar, será exibida uma mensagem convidando o usuário a instalar o aplicativo. A instalação também pode ser realizada diretamente através do ícone de engrenagem, no menu de configurações.


[[Imagem:CiaInstalarAppMobile.png|semmoldura|centro|700px]]


É importante destacar que a instalação do aplicativo no dispositivo móvel só será possível se o ambiente estiver configurado para utilizar HTTPS. Caso contrário, o usuário só poderá acessar a Cia diretamente pelo próprio navegador móvel, porém com algumas restrições de funcionalidades.

{{VoltarInicio}}

=Portais=
Nos Portais CIGAM, os recursos da Cia possuem exigências diferentes de configuração. Os itens abaixo indicam o que é necessário em cada caso. 

==Acesso à Cia Web (SaaS) pelo menu mosaico==
O acesso à Cia a partir do menu de mosaico (Cia - IA do CIGAM) abre a Cia Web (SaaS). Por esse motivo, depende das configurações descritas na seção [[#Cia Web (SaaS)|Cia Web (SaaS)]], em especial: 
* [[#Configurações para Cia no CIGAM|Configurações para Cia no CIGAM]], conforme o ambiente possua um único site ou mais de um.
* [[#Autenticação em duas etapas e configurações de envio de e-mail|Autenticação em duas etapas e configurações de envio de e-mail]].
* As configurações de ambiente, como CSP, cookies e permissões do navegador.
 
[[Imagem:mosaicoCia.png|semmoldura|centro|650px]]
 
Para mais informações sobre como configurar nomes lógicos e o menu mosaico, consulte: [[GE - Como Fazer - Configuração do menu mosaico nos Portais Web]] 

==Agentes e opções generativas==
Não é necessária nenhuma parametrização para utilizar os '''agentes''' e as '''opções generativas''' disponíveis no menu da Cia nos Portais, como melhoria de texto e revisão gramatical. Esses recursos são disponibilizados automaticamente, de acordo com o contexto da tela, e não dependem das configurações de local de instalação nem da autenticação em duas etapas. 
 
Os agentes estão disponíveis a partir da versão '''Beta 260601''', e o '''Editor de Agentes''' a partir da versão '''Beta 261005''', tanto para os Portais MVC quanto para os Portais React. 
 
[[Imagem:MenuCiaPortais.png|semmoldura|centro|600px]]
 
Para saber como utilizar esses recursos, consulte: [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer uso da Cia IA do CIGAM]]
{{VoltarInicio}}

=Desktop=
Na aplicação Desktop, os recursos da Cia possuem exigências distintas de configuração: 
 
{| class="wikitable"
|-
| '''Recurso''' || '''Configuração necessária'''
|-
| '''Acesso rápido à Cia - IA do CIGAM''' || Exige API e Portais instalados, além das configurações da Cia Web (SaaS).
|-
| '''Analisar com a Cia''' || Não exige parametrização no CIGAM. Requer a versão 250505 patch A ou superior e o navegador padrão e a extensão .html configurados no Windows.
|-
| '''Compartilhamento de análises por e-mail''' || Exige API instalada, configuração 3159, nomes lógicos CDN e CDN_KEYTOKEN e configurações de envio de e-mail.
|}

==Acesso rápido à Cia Web (SaaS)==
O botão de acesso rápido (Cia - IA do CIGAM) disponível no menu lateral do Desktop abre a Cia Web (SaaS) em uma janela integrada ao sistema. Por esse motivo, depende de: 
* A API e os Portais instalados, pois são eles que conectam o sistema aos dados do ERP. '''Sem a API, a funcionalidade não funcionará'''.
* As configurações descritas na seção [[#Cia Web (SaaS)|Cia Web (SaaS)]], em especial [[#Configurações para Cia no CIGAM|Configurações para Cia no CIGAM]] e [[#Autenticação em duas etapas e configurações de envio de e-mail|Autenticação em duas etapas e configurações de envio de e-mail]].
 
[[Imagem:CiaIA.png|semmoldura|centro|800px]]
 

==Recurso "Analisar com a Cia"==
O recurso '''"Analisar com a Cia"''', disponível em ferramentas como CGEditor, CGReport, Pesquisa Dinâmica e Dispositivo de Saída, não exige nenhuma parametrização adicional no CIGAM para a geração das análises. Ele também não depende da autenticação em duas etapas nem das configurações de local de instalação dos Portais. 
 
Entretanto, a funcionalidade de '''compartilhamento por e-mail''', disponível a partir da versão '''Beta 261005''', exige configurações adicionais no ambiente, conforme descrito em: [[#Configurações para compartilhamento de análises por e-mail|Configurações para compartilhamento de análises por e-mail]] 
 
Exemplo do recurso disponível na Pesquisa Dinâmica: 
 
[[Imagem:PesquisaDinamicaComCia.png|semmoldura|centro|800px]]
 
Os requisitos para utilização são: 
* Estar na versão '''250505.a''' ou superior.
* Ter um '''navegador padrão configurado no Windows''', preferencialmente o '''Google Chrome''' ou o '''Microsoft Edge''', por serem os navegadores homologados pela CIGAM.
* Ter a '''extensão .html''' associada a um desses navegadores, para que o conteúdo enviado à Cia seja aberto corretamente.
 
[[Imagem:NavegadorPadraoWindows.png|semmoldura|centro|800px]]
 
Para mais informações sobre os navegadores homologados, acesse: [[Requisitos_de_Software#Versões_de_Navegadores|Versões de navegadores]] 
 
Para saber como utilizar o recurso, consulte: [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer uso da Cia IA do CIGAM]]

=Documentos Relacionados=
[[GE - Como Fazer - Cia - Como acessar]] 
[[GE - Como Fazer - Uso da Cia - IA do CIGAM]] 
[[GE - Importância do uso do HTTPS]] 
[[GE Autenticação em duas etapas]] 
[[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]] 
[[GE - Como Fazer - Configuração do menu mosaico nos Portais Web]]
{{VoltarInicio}}

GE - Como Fazer - Configuração da Cia IA do CIGAM

2026-10-19T13:13:46Z

Roger.schneider: /* Recurso "Analisar com a Cia" */

{{VoltarPagina}}
 
[[categoria:Como_Fazer_Utilidades/Diversos]]
[[categoria:Como Fazer Utilidades/Diversos_2]]
[[MediaWiki:Como_Fazer_sidebar|Como Fazer]] > [[Como_Fazer_Utilidades/Diversos|Utilidades/Diversos]] > [[GE - Como_Fazer - Configuração da Cia IA do CIGAM|Configuração da Cia IA do CIGAM]]

=Como a Cia - IA do CIGAM funciona?=

A Cia, a IA do CIGAM, é composta por uma aplicação e um serviço, ambos hospedados na Nuvem CIGAM e executados como um SaaS (Software como Serviço). O SaaS é um modelo de aplicação acessada diretamente pelos usuários finais através do navegador de internet.
 
A execução através do modelo SaaS garante que toda a infraestrutura necessária permaneça sob responsabilidade da CIGAM na Nuvem CIGAM, oferecendo:
 
* Atualizações em tempo real, sem necessidade de intervenção do cliente. 
* Treinamento de forma compartilhada, adicionando novas funcionalidades, otimizando performance e resultados. 

Todas as configurações necessárias estão descritas em [[#Cia Web (SaaS)|Cia Web (SaaS)]]. As seções [[#Portais|Portais]] e [[#Desktop|Desktop]] indicam quais dessas configurações se aplicam a cada forma de acesso. 

=Cia Web (SaaS)=
A Cia será executada como uma página web no navegador de internet, acessando todo o ecossistema do CIGAM através das credenciais do usuário logado, da mesma forma que o usuário acessaria se estivesse logado diretamente no CIGAM.
 
As configurações desta seção garantem o funcionamento da Cia Web, que é a aplicação onde todos os recursos da Cia são disponibilizados.
 
Como os Portais e a aplicação Desktop abrem a mesma Cia Web, essas configurações também se aplicam a eles, conforme indicado nas respectivas seções. 

==Versões de navegadores==

Para garantir o pleno funcionamento da Cia, é aconselhável utilizar os navegadores Google Chrome ou Microsoft Edge, sempre atualizados para a última versão disponível, pois são os navegadores homologados pela CIGAM.
 
Além disso, recomenda-se que a extensão associada ao arquivo .html esteja configurada, por padrão, para abrir em um desses navegadores. Essa configuração assegura que relatórios, portais e páginas sejam carregados corretamente, proporcionando maior compatibilidade, segurança e desempenho.
 
Para mais informações, acesse: [[Requisitos_de_Software#Versões_de_Navegadores|Versões de navegadores]]


==Importância do uso do HTTPS==

A Cia sempre notificará o usuário caso ele esteja utilizando o protocolo HTTP, recomendando o uso do protocolo HTTPS. Isso ocorre por dois motivos principais:
 
1. Segurança: O HTTPS criptografa os dados transmitidos, garantindo maior proteção contra interceptações e ataques. 
2. Funcionalidades: O HTTPS permite que a Cia utilize recursos adicionais, como o microfone para reconhecimento de voz, aplicativo para dispositivos móveis, etc. Caso o usuário esteja em HTTP, a Cia automaticamente desativa essas funcionalidades por questões de segurança. 
 
Para mais informações sobre a importância do uso do HTTPS, acesse: [[GE - Importância do uso do HTTPS|Importância do uso do HTTPS]]


==Autenticação em duas etapas e configurações de envio de e-mail==

Para acessar a Cia Web, é obrigatório que o usuário tenha habilitado a autenticação em duas etapas para realizar o login, independentemente do ambiente. Se precisar de ajuda para configurar, consulte a documentação: [[GE Autenticação em duas etapas]]
 
Caso o envio de e-mails ainda não esteja configurado, será necessário configurá-lo, pois a autenticação em duas etapas depende dessa configuração. Se precisar de ajuda, consulte: [[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]]


==Configurações para Cia no CIGAM==
Algumas configurações e parametrizações no CIGAM são necessárias para garantir o funcionamento adequado da Cia, conforme o seu ambiente. Verifique se todas as aplicações estão em um único site ou distribuídas em mais de um e configure-as conforme a necessidade. 

===Ambiente padrão com único site===
Normalmente, os Portais, API, BI, entre outras aplicações são instalados no mesmo local, ou seja, com mesmo site, domínio e porta. Esse é o ambiente mais fácil de configurar, exigindo apenas os seguintes ajustes:
 
* Para acessar os Portais MVC:
** Acesse a configuração [[GE - AM - 3159 - Local de Instalação dos Portais Base]] e informe o local onde seus Portais MVC estão instalados.
*** Exemplo: http://servidor:porta/
 
* Para acessar os Portais React:
** Acesse a configuração [[GE - AM - 3160 - Local de Instalação dos Portais Complementares]] e informe onde seus Portais React estão instalados.
*** Exemplo: http://servidor:porta/
 
* Para acessar os dashboards do BI:
** Acesse a configuração [[GE - GE - 100325 - URL Base BI Portal]] e informe o endereço onde seu BI está instalado.
*** Exemplo: http://servidor:porta/bi 
 
'''Observação:''' mesmo em ambientes com um único site, é possível configurar as aplicações apenas por meio de '''nomes lógicos''' no arquivo '''Magic.ini'''. Nesse caso, as configurações acima não são necessárias. Para mais informações sobre como configurar nomes lógicos, consulte a documentação: [[GE - Como Fazer - Configuração do menu mosaico nos Portais Web]] 

===Ambiente com mais de um site===
Em alguns casos, as aplicações podem estar instaladas em locais diferentes, ou seja, em sites, domínios ou portas distintas. Nesses cenários, é necessário realizar configurações específicas para que a Cia consiga se comunicar corretamente com cada um deles.
 
* Quando o ambiente possui aplicações distribuídas em sites separados, podemos utilizar a configuração [[GE - AM - 3159 - Local de Instalação dos Portais Base]] para definir o endereço onde a API está hospedada. Para os demais Portais e aplicações, é possível utilizar nomes lógicos no arquivo '''Magic.ini''', informando cada um dos endereços. Alternativamente, todas as aplicações podem ser configuradas apenas por meio de nomes lógicos, sem a necessidade de utilizar essa configuração. Para mais informações sobre como configurar nomes lógicos, consulte a documentação: [[GE - Como Fazer - Configuração do menu mosaico nos Portais Web]]
 
* Para acessar os Portais React:
** Acesse a configuração [[GE - AM - 3160 - Local de Instalação dos Portais Complementares]] e informe onde seus Portais React estão instalados.
*** Exemplo: http://servidor:porta/
 
* Para acessar os dashboards do BI:
** Acesse a configuração [[GE - GE - 100325 - URL Base BI Portal]] e informe o endereço onde seu BI está instalado.
*** Exemplo: http://servidor:porta/bi 

===Configuração do BI para integração com a Cia===
Se o ambiente possuir um BI instalado e for utilizado pela Cia, é necessário garantir que a URL da API CIGAM esteja devidamente configurada. Caso ainda não esteja informada, adicione a URL nas configurações:
 
[[Imagem:apiCigamBI.png|semmoldura|centro|600px]]

===Configurações para compartilhamento de análises por e-mail===

A partir da versão '''Beta 261005''', o recurso [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Recurso_"Analisar_com_a_Cia"|Analisar com a Cia]] no Desktop passa a disponibilizar opções para utilização e compartilhamento das análises geradas, incluindo o envio por e-mail.

Embora a geração das análises não exija parametrizações adicionais no CIGAM, o compartilhamento por e-mail depende de algumas configurações no ambiente.

Para utilizar essa funcionalidade, é necessário:

* Possuir a '''API CIGAM''' instalada no ambiente utilizado.
* Possuir o '''Broker''' do ambiente devidamente configurado e em execução.
* Informar os nomes lógicos '''CDN''' e '''CDN_KEYTOKEN''' no arquivo '''Magic.ini'''.
* Possuir as configurações de envio de e-mails pelo CIGAM devidamente parametrizadas.
 

====Configuração da API====

Para realizar o envio de análises por e-mail, é necessário que a '''API CIGAM''' esteja instalada e acessível no ambiente utilizado.

A configuração [[GE - AM - 3159 - Local de Instalação dos Portais Base|3159 - Local de Instalação dos Portais Base]] deve estar devidamente parametrizada, permitindo que o CIGAM localize a API responsável pelo processamento da solicitação.

Caso a API não esteja instalada ou não possa ser acessada, será apresentada uma mensagem de erro ao tentar realizar o envio.

 
[[Imagem:CiaDesktopErroAPI.png|semmoldura|center|700px]]
 

====Configuração do Broker====

Para realizar o compartilhamento das análises por e-mail, também é necessário que o '''Broker''' do ambiente esteja devidamente configurado e em execução.
Caso o Broker não esteja em execução ou apresente alguma configuração incorreta, será exibida uma mensagem de erro ao tentar enviar a análise por e-mail.
 
[[Imagem:CiaDesktopErroBroker.png|semmoldura|center|700px]]
 

====Configuração dos nomes lógicos====
Além da API e do Broker, é necessário configurar os nomes lógicos '''CDN''' e '''CDN_KEYTOKEN''' no arquivo '''Magic.ini''' do ambiente.
Esses nomes lógicos são utilizados para identificar o endereço e a chave de acesso à CDN, necessária para disponibilizar o arquivo da análise que será enviado como anexo.

* '''CDN:''' deve conter o endereço da CDN utilizada pelo ambiente.
* '''CDN_KEYTOKEN:''' deve conter a chave de acesso utilizada para a comunicação com a CDN.

Caso o nome lógico '''CDN''' não esteja configurado corretamente, será apresentada uma mensagem de erro relacionada ao endereço da CDN.
 
[[Imagem:CiaDesktopErroCaminhoCDN.png|semmoldura|center|700px]]
 

Da mesma forma, caso o nome lógico '''CDN_KEYTOKEN''' não esteja informado corretamente, será apresentada uma mensagem de erro relacionada à chave de acesso.
 
[[Imagem:CiaDesktopErroCDNKey.png|semmoldura|center|700px]]
 

====Configurações de envio de e-mail====

Também é necessário que o ambiente possua as configurações necessárias para realizar o envio de e-mails pelo CIGAM devidamente parametrizadas.
Caso essas configurações estejam ausentes ou incorretas, poderão ocorrer falhas durante o envio da análise.
Para mais informações, consulte [[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]].
 

'''Importante:''' o botão '''E-mail''' permanece disponível mesmo quando alguma das configurações necessárias não está correta. Nesses casos, a mensagem de erro correspondente será apresentada durante a tentativa de envio, e não haverá o compartilhamento da análise.
{{VoltarInicio}}

==Configurações de CORS==

A forma como a Cia é executada, operando como um SaaS, pode causar restrições relacionadas ao CORS (Compartilhamento de Recursos entre Origens Diferentes). O CORS é um mecanismo de segurança implementado pelos navegadores para proteger os usuários, restringindo solicitações de recursos entre diferentes domínios não permitidos. Essas restrições podem causar erros ao tentar acessar cookies e outras informações. 
Cookies são pequenos arquivos armazenados no computador ou dispositivo do usuário que contêm informações sobre a atividade do usuário em sites para melhorar a experiência de navegação. 
Para o navegador, domínios diferentes são tratados de forma separada por questões de segurança. A Cia estará hospedada em um domínio (da CIGAM Corp. na Nuvem CIGAM). E o CIGAM Web do usuário estará em outro domínio, que pode ser em um servidor on-premise (local) ou em qualquer Nuvem, inclusive na Nuvem CIGAM.


==Ambientes com acesso externo às aplicações==

Esse seria o ambiente ideal para utilizar a Cia, o qual possui acesso externo às aplicações do CIGAM, como Portais, APIs, etc. Esse ambiente é acessível via internet e deve possuir HTTPS configurado com um domínio público.


===Como configurar o web server (Microsoft IIS)?===

Para permitir que a Cia acesse as aplicações do ambiente com acesso externo, é necessário configurar o Web Server no Microsoft IIS. O principal ajuste será a inclusão do cabeçalho de resposta denominado CSP (Content-Security-Policy).
 
O CSP define diretrizes que instruem o navegador sobre as fontes permitidas para diferentes tipos de conteúdo em uma página da web. Essa configuração pode ser realizada das seguintes formas:


====Configuração via arquivo web.config====

A maneira mais simples e rápida de realizar essa configuração é por meio da criação ou edição do arquivo Web.config, que funciona como um "manual de instruções" para o sistema. Sempre que você ajusta configurações no Microsoft IIS, esse arquivo pode ser criado ou modificado automaticamente. 
 
No entanto, é importante destacar que o arquivo Web.config pode não existir em alguns ambientes. Isso ocorre porque, até então, não utilizávamos esse tipo de configuração como padrão em todos os portais. Portanto, caso o arquivo não esteja presente, será necessário criá-lo manualmente. 
 
Esse arquivo deve ser criado (ou editado) na pasta raiz do site que engloba todas as aplicações, permitindo que a Cia tenha acesso a todos os domínios e aplicações de forma unificada. Por ser um arquivo geral, o Web.config afeta todas as aplicações vinculadas à raiz do site. Portanto, a configuração nesse local garante abrangência e evita a necessidade de repetir ajustes em cada aplicação individualmente. 
 
Se o Web.config já existir, não é necessário substituí-lo. Basta adicionar ou ajustar as permissões necessárias, tomando cuidado para não alterar outras configurações já existentes, a fim de evitar impactos indesejados no ambiente.
 
'''Se estiver trabalhando com sites separados, além das URLs da Cia, é necessário incluir os endereços de todas as demais aplicações. Caso contrário, elas não poderão ser carregadas corretamente nos demais Portais e aplicações, pois a configuração padrão permite apenas 'self', ou seja, restringe o acesso a aplicações do mesmo site e da Cia.'''
 
'''Lembre-se de que, mesmo que a maioria dos Portais e aplicações estejam todos no mesmo site, se você tiver um Portal em React, ele provavelmente estará hospedado em um site separado. Por isso, é fundamental incluir a URL desse Portal nas configurações. Caso contrário, ele poderá enfrentar restrições ao carregar outras aplicações, causando falhas na exibição dos conteúdos integrados.'''
 
'''Importante: Essas configurações devem ser feitas apenas para os ambientes que tiverem HTTPS configurados.'''
 
Exemplo com as pastas das aplicações do CIGAM Web em C:\inetpub\wwwroot\cigam no Web Server IIS:


[[Imagem:pastaWebConfig.png|semmoldura|centro|770px|Web Config]]
 

Também é possível copiar e utilizar o código abaixo para facilitar a configuração:

''<?xml version="1.0" encoding="UTF-8"?> <configuration>''
''<system.web>''
''<httpCookies requireSSL="true" sameSite="None" />''
''<sessionState cookieSameSite="None"/>''
''</system.web>''
''<system.webServer>''
''<httpProtocol>''
''<customHeaders>''
''<add name="Content-Security-Policy" value="frame-ancestors 'self' https://services.cigam.cloud http://services.cigam.cloud;" />''
''</customHeaders>''
''</httpProtocol>''
''</system.webServer> </configuration>''

====Como dar acesso através do IIS?====

Para configurar o CSP diretamente no IIS, siga os passos abaixo: 
1. Acesse o '''Gerenciador de Serviços de Informações da Internet (IIS)''' e localize o site que deseja liberar o acesso. 
2. Abra a opção '''Cabeçalhos de Resposta HTTP''' no painel do IIS, selecione o site desejado e clique em '''Cabeçalhos de Resposta HTTP'''.


[[Imagem:CabecalhoResp.png|semmoldura|centro|800px]]
 

3. Adicione o cabeçalho '''Content-Security-Policy''' na seção '''Ações''', localizada à direita, clique em '''Adicionar'''.


[[Imagem:CabecalhoResp2.png|semmoldura|centro|800px]]
 

4. Na caixa de diálogo que será exibida, preencha os seguintes campos:
* Nome: Content-Security-Policy.
* Valor: frame-ancestors 'self' https://services.cigam.cloud http://services.cigam.cloud;

 
'''Lembre-se de que, caso esteja com um ambiente com sites separados, além dessas URLs da Cia, é necessário incluir os endereços dos demais sites.'''

====Como configurar o acesso aos cookies no IIS?====

Para permitir que a Cia acesse os Cookies das aplicações, será necessário ajustar algumas permissões. Siga os passos abaixo:
* Acesse o '''Editor de Configurações''' no painel do IIS, localize a opção '''Editor de Configurações''' dentro da seção '''Gerenciamento'''.


[[Imagem:Gerenciamento.png|semmoldura|centro|800px]]
 
 

* Ajuste as configurações em '''httpCookies''':
** Navegue até a seção '''system.web''' e localize a configuração '''httpCookies'''.
** Defina os seguintes valores:
** requireSSL: True
** sameSite: None


[[Imagem:httpCookies.png|semmoldura|centro|800px]]
 


* Configuração de '''sessionState''':
** Ainda em '''system.web''', localize a configuração '''sessionState'''. 
** Altere o valor da propriedade '''cookieSameSite''' para '''None'''.


[[Imagem:sessionStage.png|semmoldura|centro|850px]]
 
Essas configurações garantem que os cookies sejam transmitidos com segurança e permitam o uso adequado em aplicações externas, atendendo aos requisitos da Cia.
{{VoltarInicio}}

==Ambientes internos sem acesso externo às aplicações==

Este ambiente possui acesso restrito à rede interna da empresa e utiliza o protocolo HTTP. Por esse motivo, algumas funcionalidades da Cia serão desabilitadas automaticamente — como recursos que exigem permissões avançadas do navegador, como o uso do microfone, ou o acesso dinâmico a iframes (componentes que permitem exibir conteúdos de outros sistemas dentro da mesma tela, como Portais).
 
'''Importante:''' Você não precisa se preocupar. A Cia detecta automaticamente essas limitações e desativa ou oculta as funcionalidades afetadas, garantindo que a experiência continue fluida e segura. Sempre que necessário, você será notificado com orientações claras sobre o que fazer.
 
Para mais informações sobre a importância do uso do HTTPS, acesse: [[GE - Importância do uso do HTTPS|Importância do uso do HTTPS]]


==Garantindo permissão de acesso aos cookies de terceiros no navegador==

Por padrão, os navegadores geralmente têm a permissão para Cookies de terceiros habilitada. No entanto, é importante verificar e assegurar essa configuração. Abaixo estão os passos para os navegadores '''Microsoft Edge''' e '''Google Chrome''': 
 
* Microsoft Edge
** Em Português:
*** Acesse Configurações → Cookies e permissões de sites → Gerenciar e excluir cookies e dados do site.
*** Desabilite a opção "Bloquear cookies de terceiros".
** Em Inglês:
*** Acesse Settings → Cookies and Site Permissions → Manage and delete cookies and site data.
*** Desabilite a opção "Block third-party cookies".


[[Imagem:settingsEdge.png|semmoldura|centro|800px]]
 
 

* Google Chrome:
** Em Português:
*** Vá para Configurações → Privacidade e segurança → Cookies de terceiros.
*** Habilite a opção "Permitir cookies de terceiros".
** Em Inglês:
*** Vá para Settings → Privacy and security → Third-party cookies.
*** Habilite a opção "Allow third-party cookies".


[[Imagem:settingsChrome.png|semmoldura|centro|800px]]

==Dispositivos móveis==

A Cia também oferece suporte para dispositivos móveis, proporcionando acesso prático e otimizado. Para utilizar a Cia em um dispositivo móvel, basta acessar o endereço normalmente pelo seu navegador. Ao entrar, será exibida uma mensagem convidando o usuário a instalar o aplicativo. A instalação também pode ser realizada diretamente através do ícone de engrenagem, no menu de configurações.


[[Imagem:CiaInstalarAppMobile.png|semmoldura|centro|700px]]


É importante destacar que a instalação do aplicativo no dispositivo móvel só será possível se o ambiente estiver configurado para utilizar HTTPS. Caso contrário, o usuário só poderá acessar a Cia diretamente pelo próprio navegador móvel, porém com algumas restrições de funcionalidades.

{{VoltarInicio}}

=Portais=
Nos Portais CIGAM, os recursos da Cia possuem exigências diferentes de configuração. Os itens abaixo indicam o que é necessário em cada caso. 

==Acesso à Cia Web (SaaS) pelo menu mosaico==
O acesso à Cia a partir do menu de mosaico (Cia - IA do CIGAM) abre a Cia Web (SaaS). Por esse motivo, depende das configurações descritas na seção [[#Cia Web (SaaS)|Cia Web (SaaS)]], em especial: 
* [[#Configurações para Cia no CIGAM|Configurações para Cia no CIGAM]], conforme o ambiente possua um único site ou mais de um.
* [[#Autenticação em duas etapas e configurações de envio de e-mail|Autenticação em duas etapas e configurações de envio de e-mail]].
* As configurações de ambiente, como CSP, cookies e permissões do navegador.
 
[[Imagem:mosaicoCia.png|semmoldura|centro|650px]]
 
Para mais informações sobre como configurar nomes lógicos e o menu mosaico, consulte: [[GE - Como Fazer - Configuração do menu mosaico nos Portais Web]] 

==Agentes e opções generativas==
Não é necessária nenhuma parametrização para utilizar os '''agentes''' e as '''opções generativas''' disponíveis no menu da Cia nos Portais, como melhoria de texto e revisão gramatical. Esses recursos são disponibilizados automaticamente, de acordo com o contexto da tela, e não dependem das configurações de local de instalação nem da autenticação em duas etapas. 
 
Os agentes estão disponíveis a partir da versão '''Beta 260601''', e o '''Editor de Agentes''' a partir da versão '''Beta 261005''', tanto para os Portais MVC quanto para os Portais React. 
 
[[Imagem:MenuCiaPortais.png|semmoldura|centro|600px]]
 
Para saber como utilizar esses recursos, consulte: [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer uso da Cia IA do CIGAM]]
{{VoltarInicio}}

=Desktop=
Na aplicação Desktop, os recursos da Cia possuem exigências distintas de configuração: 
 
{| class="wikitable"
|-
| '''Recurso''' || '''Configuração necessária'''
|-
| '''Acesso rápido à Cia - IA do CIGAM''' || Exige API e Portais instalados, além das configurações da Cia Web (SaaS).
|-
| '''Analisar com a Cia''' || Não exige parametrização no CIGAM. Requer a versão 250505 patch A ou superior e o navegador padrão e a extensão .html configurados no Windows.
|-
| '''Compartilhamento de análises por e-mail''' || Exige API instalada, configuração 3159, nomes lógicos CDN e CDN_KEYTOKEN e configurações de envio de e-mail.
|}

==Acesso rápido à Cia Web (SaaS)==
O botão de acesso rápido (Cia - IA do CIGAM) disponível no menu lateral do Desktop abre a Cia Web (SaaS) em uma janela integrada ao sistema. Por esse motivo, depende de: 
* A API e os Portais instalados, pois são eles que conectam o sistema aos dados do ERP. '''Sem a API, a funcionalidade não funcionará'''.
* As configurações descritas na seção [[#Cia Web (SaaS)|Cia Web (SaaS)]], em especial [[#Configurações para Cia no CIGAM|Configurações para Cia no CIGAM]] e [[#Autenticação em duas etapas e configurações de envio de e-mail|Autenticação em duas etapas e configurações de envio de e-mail]].
 
[[Imagem:CiaIA.png|semmoldura|centro|800px]]
 

==Recurso "Analisar com a Cia"==
O recurso '''"Analisar com a Cia"''', disponível em ferramentas como CGEditor, CGReport, Pesquisa Dinâmica e Dispositivo de Saída, não exige nenhuma parametrização adicional no CIGAM para a geração das análises. Ele também não depende da autenticação em duas etapas nem das configurações de local de instalação dos Portais. 
 
Entretanto, a funcionalidade de '''compartilhamento por e-mail''', disponível a partir da versão '''Beta 261005''', exige configurações adicionais no ambiente, conforme descrito em: [[#Configurações de envio de e-mail|Configurações de envio de e-mail]] 
 
Exemplo do recurso disponível na Pesquisa Dinâmica: 
 
[[Imagem:PesquisaDinamicaComCia.png|semmoldura|centro|800px]]
 
Os requisitos para utilização são: 
* Estar na versão '''250505.a''' ou superior.
* Ter um '''navegador padrão configurado no Windows''', preferencialmente o '''Google Chrome''' ou o '''Microsoft Edge''', por serem os navegadores homologados pela CIGAM.
* Ter a '''extensão .html''' associada a um desses navegadores, para que o conteúdo enviado à Cia seja aberto corretamente.
 
[[Imagem:NavegadorPadraoWindows.png|semmoldura|centro|800px]]
 
Para mais informações sobre os navegadores homologados, acesse: [[Requisitos_de_Software#Versões_de_Navegadores|Versões de navegadores]] 
 
Para saber como utilizar o recurso, consulte: [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer uso da Cia IA do CIGAM]]

=Documentos Relacionados=
[[GE - Como Fazer - Cia - Como acessar]] 
[[GE - Como Fazer - Uso da Cia - IA do CIGAM]] 
[[GE - Importância do uso do HTTPS]] 
[[GE Autenticação em duas etapas]] 
[[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]] 
[[GE - Como Fazer - Configuração do menu mosaico nos Portais Web]]
{{VoltarInicio}}

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-10-19T13:07:20Z

Roger.schneider: /* Recurso "Analisar com a Cia" */

{{VoltarPagina}}
 
[[categoria:Como_Fazer_Utilidades/Diversos]]
[[categoria:Como_Fazer_Utilidades/Diversos_6]]
[[MediaWiki:Como_Fazer_sidebar|Como Fazer]] > [[Como_Fazer_Utilidades/Diversos|Utilidades/Diversos]] > [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer - Uso da Cia - IA do CIGAM]]

=Recursos, configurações e segurança=
A Cia - IA do CIGAM oferece diversas funcionalidades e atua como um hub centralizador para os recursos de inteligência artificial utilizados nas soluções CIGAM. Para garantir o correto funcionamento desses recursos, é necessário verificar se os pré-requisitos e as configurações foram realizados adequadamente. Para mais informações, consulte: [[GE - Como Fazer - Configuração da Cia IA do CIGAM|Como Fazer configuração da Cia IA do CIGAM]]
 
Todas as soluções de IA do CIGAM são integradas por meio dos serviços da Cia. A Cia possui integração com diferentes provedores de IA de terceiros, como OpenAI, Google, Anthropic, entre outros. Essas integrações são realizadas por meio de contas e serviços contratados, com condições de uso que asseguram que os dados trafegados não sejam utilizados para treinamento dos modelos, identificação de origem, publicidade, anúncios ou qualquer outra finalidade não prevista.
 
No caso de IAs open-source integradas à Cia, os modelos são executados dentro dos domínios da CIGAM, mantendo as mesmas premissas aplicadas às IAs contratadas: não utilização dos dados para treinamento de modelos, não identificação da origem das informações e ausência de retenção dos dados processados.
 
Além disso, sempre que houver envio explícito de dados pelo usuário por meio das funcionalidades da Cia disponíveis nas soluções CIGAM, será apresentado um diálogo de confirmação, permitindo que o usuário aceite o envio dessas informações. Os dados enviados serão tratados conforme as mesmas diretrizes de segurança, privacidade e não retenção descritas anteriormente.
 
Esta documentação apresenta o uso da Cia e está organizada conforme a forma de acesso: [[#Cia Web (SaaS)|Cia Web (SaaS)]], [[#Portais|Portais]] e [[#Desktop|Desktop]].
 
Caso tenha dúvidas sobre onde encontrar a Cia em cada uma dessas plataformas, ou sobre quais ferramentas do CIGAM possuem recursos integrados a ela, consulte a documentação específica de acesso: [[GE - Como Fazer - Cia - Como acessar|Como Fazer - Cia - Como acessar]]
{{VoltarInicio}}

=Cia Web (SaaS)=
A Cia Web é a aplicação web que centraliza todas as funcionalidades da Cia. Ela pode ser acessada diretamente pelo navegador do seu computador ou dispositivo móvel, ou ainda a partir do Desktop e dos Portais, sem a necessidade de novo login.
 

<center><youtube>https://youtu.be/DFGtRtPF75A</youtube></center>
 

==Primeiro acesso==
A Cia Web pode ser acessada diretamente pelo navegador, utilizando o seguinte endereço: https://services.cigam.cloud/cia/index.html
 
'''Importante:''' o usuário que for realizar o login precisa ter a autenticação em duas etapas habilitada. Para saber como configurá-la, consulte: [[GE - Como Fazer - Configuração da Cia IA do CIGAM#Autenticação em duas etapas e configurações de envio de e-mail|Autenticação em duas etapas e configurações de envio de e-mail]]
 
Ao acessar pelo endereço, será necessário preencher algumas informações para que a Cia consiga validar seu acesso e consultar seus dados: 
* Informar a API do seu CIGAM Server, para garantir o direcionamento correto da base de dados. 

[[Imagem:CiaAPI.png|semmoldura|center|700px]] 

* Informar usuário e senha de login e seu código de verificação: 

[[Imagem:CiaLogin.png|semmoldura|center|700px]]
 
[[Imagem:CiaCodVerif.png|semmoldura|center|700px]] 

* Caso não queira aguardar ou informar o código de verificação, você pode optar por responder à pergunta secreta, clicando no botão “Pergunta Secreta” exibido na imagem acima. 

[[Imagem:CiaLoginA2F.png|semmoldura|center|700px]]
 

==Conhecendo a tela da Cia==
Após realizar o login, a Cia carregará automaticamente as informações e dados necessários do ambiente e será iniciada no assunto '''#Geral''', identificado pelo botão localizado à esquerda da caixa de texto.

[[Imagem:CiaGeral.png|semmoldura|center|700px]]
 
Ao clicar nesse botão, será exibida uma lista com todos os assuntos disponíveis, permitindo que você selecione aquele com o qual deseja interagir. 
Além disso, você pode digitar diretamente na caixa de texto o '''#Assunto''' que deseja utilizar, e a Cia entenderá automaticamente o tema da sua mensagem. 
Também é possível '''formular uma pergunta seguida de um #Assunto''' para interagir com qualquer assunto, mesmo que ele não esteja selecionado no momento.

[[Imagem:CiaAberta.png|semmoldura|center|700px]]
 
Ao selecionar um assunto, serão exibidas automaticamente dicas e sugestões sobre o tema escolhido, além de exemplos clicáveis que, ao serem selecionados, são processados de forma imediata. 
Além disso, ao digitar um ponto de interrogação (?) na caixa de texto, será exibida uma lista com todas as interações disponíveis para o assunto selecionado, facilitando a descoberta de comandos e possibilidades de uso.

[[Imagem:CiaDicas.png|semmoldura|center|700px]]
 
Outra funcionalidade prática é a possibilidade de reenviar perguntas já feitas no chat. Para isso, basta posicionar o mouse sobre a pergunta desejada e clicar no ícone de “Reenviar”. Ao passar o mouse sobre a mensagem, também será exibido o horário de envio.
 
[[Imagem:CiaReenviar.png|semmoldura|center|400px]]
 
Além disso, você pode utilizar as setas do teclado (⬆️ para cima e ⬇️ para baixo) na caixa de texto para navegar pelas últimas perguntas enviadas para o #Assunto selecionado, facilitando o reuso de interações anteriores.

===Ícones da caixa de texto===
Na caixa de texto, você encontrará alguns ícones com as seguintes funções:

<center>
{| class="wikitable"
|-
! !! Ação
|-
|center|[[Imagem:CiaUltPerg.png]] || '''Histórico de Perguntas''' – Ao clicar, é exibido o histórico das perguntas já realizadas para o assunto selecionado.
|-
|center|[[Imagem:CiaEnviar.png]] || '''Enviar''' – Envia o conteúdo digitado na caixa de texto.
|-
|center|[[Imagem:CiaFala.png]] || '''Falar''' – Permite falar ao invés de digitar, usando o recurso de voz.
|-
|center|[[Imagem:CiaExpandir.png]] || '''Expandir''' – Aumenta a altura da caixa de texto para facilitar a digitação de mensagens longas.
|-
|center|[[Imagem:CiaRecolher.png]] || '''Recolher''' – Reduz a caixa de texto ao tamanho padrão.
|}
</center>
{{VoltarInicio}}

==Assuntos disponíveis==

===Geral===
Nesse assunto, é possível conversar livremente com a Cia sobre qualquer um dos assuntos disponíveis. Se encontrar dificuldades para obter a resposta desejada, experimente selecionar um assunto específico, o que pode gerar resultados mais precisos. 
Se houver muitas respostas correspondentes, a Cia não executará nenhuma automaticamente. Em vez disso, exibirá uma opção com os valores possíveis, permitindo que você selecione manualmente a melhor alternativa.

[[Imagem:CiaGeralOpcoes.png|semmoldura|center|700px]]
 
Caso a Cia encontre uma resposta com confiança significativamente maior que as demais, ela será executada automaticamente.
 
No entanto, se você selecionar a opção “Não era bem isso o que eu queria”, a Cia exibirá outras opções relacionadas ao que foi solicitado, apresentando também um indicador de semáforo com a porcentagem de confiança de cada alternativa.

[[Imagem:CiaGeralOpcaoCerta.png|semmoldura|center|600px]]

===Ajuda, Vídeos e Auditor===
Conheça melhor o ERP com a ajuda da Wiki e Cia, assista vídeos sobre o CIGAM e audite seu ambiente.

====Ajuda====
Nesse assunto, você pode acessar o Chatbot da assistente virtual, onde você pode tirar dúvidas e consultar conteúdos da CIGAM Wiki enviando perguntas diretamente nela. 
 
'''Importante:''' neste assunto, a Cia atua dedicada à Wiki, focada exclusivamente nos conteúdos da documentação. As demais funcionalidades e atalhos da Cia não estarão disponíveis nesse contexto.

====Vídeos====
Nesse assunto, é possível procurar por vídeos relacionados ao tema desejado. O resultado será apresentado em forma de lista, contendo os vídeos encontrados e os tempos exatos em que o assunto começa a ser abordado, de acordo com o termo ou palavra pesquisada.

====Auditor====
Neste assunto, é possível verificar o status do sistema e identificar possíveis problemas ou inconsistências. O resultado será exibido em forma de tabela, contendo os dados retornados para facilitar a análise.

===Painéis BI, Portais e Relatórios===
Explore dashboards do BI, interaja com Portais intuitivos e execute relatórios personalizados.

====Painéis BI====
Nesse assunto, é possível abrir dashboards do BI já configurados para o usuário, permitindo sua visualização diretamente na tela.
Ao abrir um dashboard, você também pode interagir com ele, solicitando inserção de filtros, dimensões, métricas, transformações e outros ajustes. 
Cada dashboard aberto exibirá uma guia com as “Interações” disponíveis para aquele painel específico.
 
Além disso, ao selecionar o assunto '''#Painéis do BI''', é possível solicitar que a Cia crie um dashboard do zero.
Por exemplo: "Crie um dashboard para ver meu fluxo de caixa". Você pode ainda solicitar que métricas, dimensões e filtros sejam adicionados durante a criação, ou pedir dashboards separados por áreas.
 
'''Importante:''' caso o usuário não possua acesso ao BI ou este não esteja implementado na base de dados, será exibida uma mensagem informativa no momento do login na Cia.

====Portais====
Quando este assunto é utilizado, o resultado será sempre a abertura de uma tela dos Portais, permitindo ao usuário acessar diretamente os conteúdos e funcionalidades disponíveis nesse ambiente.
 
Essa abertura é feita de forma integrada, garantindo uma navegação contínua entre a Cia e os Portais, sem necessidade de realizar novo login ou sair da plataforma.

====Relatórios====
Ao utilizar esse assunto, será exibida uma tela para preenchimento de filtros, permitindo a emissão de relatórios web.
 
Para que essa funcionalidade opere corretamente, é necessário garantir que a instalação da CDN e da Pesquisa Dinâmica no servidor de aplicação esteja configurada de forma adequada.
 
Os relatórios exibidos aqui são os mesmos disponíveis nos Portais CIGAM, portanto é essencial que esses componentes também estejam funcionando corretamente nesses Portais.

===Qual, Faça, Consultar, Listar, Analisar e Insights===
Crie registros, analise informações ou liste dados cadastrados no CIGAM.

====Qual====
Nesse assunto, a Cia vai consultar e processar informações diretamente no ERP, usando os dados e relacionamentos disponíveis no CIGAM, e retornar os resultados em forma de texto para você visualizar.
 
'''Importante:''' nem todas as opções estão liberadas. Para ver quais você pode usar, digite ? na caixa de texto. A Cia vai mostrar uma lista com todos os comandos e funções disponíveis.

====Faça====
Nesse assunto, a Cia sempre fará um processamento no CIGAM e retornará o status do resultado. Por exemplo, você pode solicitar que a Cia crie um alerta ou até mesmo crie uma nova empresa no sistema.
 
'''Dica:''' para saber quais treinamentos ou comandos estão disponíveis, digite ? na caixa de texto. A Cia mostrará uma lista com todas as opções implementadas para você usar.

====Consultar====
Nesse assunto, você poderá fazer consultas de dados para obter listagens de registros, conforme os treinamentos de tabelas disponíveis. O resultado será apresentado em forma de tabela, exibindo os dados retornados. Já existem diversas Views prontas, para que você possa listar informações de forma mais completa e rápida.
 
'''Dica:''' para ver exemplos de consultas já implementadas, digite ? na caixa de texto.

====Listar====
Nesse assunto, você pode montar sua própria consulta de dados, escolhendo os filtros e parâmetros para gerar uma listagem personalizada. Diferente do assunto #Consultar, aqui é possível utilizar qualquer tabela do CIGAM para montar sua consulta, escrevendo em linguagem natural o que deseja buscar.
 
'''Dica:''' para ver todas as tabelas disponíveis, digite ? na caixa de texto.

====Analisar====
Analise o arquivo selecionado para gerar gráficos interativos e informativos, apresentando insights relevantes que ajudam a identificar tendências, padrões e oportunidades de melhoria.
 
Esse recurso oferece uma visualização clara e intuitiva dos dados, facilitando a interpretação das informações e apoiando a tomada de decisões estratégicas.
 
'''Aviso:''' para utilizar esta funcionalidade, é necessário concordar que os dados enviados serão processados por modelos de IA de terceiros integrados à Cia.

[[Imagem:AnalisarCia.png|semmoldura|center|600px]]

====Insights====
Gere insights inteligentes a partir dos dados de uma consulta, com análises automáticas realizadas pela Cia, que identificam padrões, tendências e possíveis pontos de atenção. Esse recurso ajuda a transformar dados brutos em informações acionáveis, facilitando a tomada de decisões estratégicas e otimizando processos.
 
'''Aviso:''' ao utilizar o assunto “Insights”, você concorda que os dados e informações analisados poderão ser enviados para modelos de IA de terceiros integrados à Cia, exclusivamente para processamento e geração dos resultados apresentados.

===IA Generativa e Pesquisa na Internet===
Converse com a IA sobre assuntos diversos, crie conteúdos e pesquise na internet sobre qualquer coisa.

====IA Generativa====
Nesse assunto, ao interagir com a IA Generativa, você poderá fazer qualquer tipo de pergunta ou solicitação, de forma livre e criativa.
O resultado exibido será exatamente a resposta gerada pela IA, sem complementos da Cia. Você pode, por exemplo, solicitar que a IA melhore ou reformule um texto, crie conteúdos ou resuma informações.
 
'''Importante:''' nesse assunto, a Cia não estará integrada aos serviços e sistemas do CIGAM — a interação é exclusivamente com a IA Generativa.

====Pesquisa na Internet====
Use esse assunto para fazer pesquisas na internet e visualizar os resultados diretamente integrados na Cia, sem precisar sair da plataforma. Você pode pesquisar qualquer tema de interesse e abrir os links retornados para acessar conteúdos, notícias e informações de forma rápida e prática.
{{VoltarInicio}}

===Compartilhamento de Análises da Cia===

 
<div align="justify">
Na Cia Web (SaaS), é possível gerar análises detalhadas de determinadas informações e compartilhá-las. Essa funcionalidade está disponível nos seguintes assuntos: [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Auditor|Auditor]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Analisar|Analisar]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Insights|Insights]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Listar|Listar]] e [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Consultar|Consultar]].
</div>
 

[[Image: opcoesAnalisarCia.png|semmoldura|center|800px]]

 
<div align="justify">
Essa opção está disponível por meio do botão '''Analisar''', exibido junto à resposta apresentada após a solicitação de um desses assuntos.
</div>
 

[[Image: exemploBotaoAnalisar.png|semmoldura|center|800px]]

 
<div align="justify">
Particularmente para o assunto '''Analisar''', a análise já é exibida diretamente, pois essa é a finalidade desse assunto:
</div>
 

[[Image: analiseAnalisar.png|semmoldura|center|800px]]

 
<div align="justify">
Ao gerar uma análise , a página de resultado passa a disponibilizar opções para compartilhar e utilizar o conteúdo gerado. São disponibilizadas três opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.
</div>
 

[[Image: CiaWebAnalise.png|semmoldura|center|800px]]

=====Compartilhamento por e-mail=====

<div align="justify">
Ao selecionar a opção '''E-mail''', é apresentada uma janela para preenchimento das informações necessárias ao envio da análise.
</div>
 

[[Image: CiaWebModalEmail.png|semmoldura|center|800px]]

 
<div align="justify">
Após informar os destinatários e os demais dados da mensagem, basta selecionar '''Enviar'''. A análise gerada será encaminhada como um arquivo em anexo.

Para utilizar esse recurso, o ambiente deve possuir as configurações necessárias para envio de e-mails pelo CIGAM devidamente parametrizadas. Para mais informações, consulte [[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]].
</div>

==Configurações==
O ícone de engrenagem, localizado no canto superior direito da página, reúne recursos de informação e gerenciamento. As opções disponíveis são:
* '''Respostas com áudio:''' quando ativado, as respostas da Cia são narradas em voz alta.
* '''Ambiente atual do CIGAM:''' exibe na tela o usuário logado e o ambiente em uso.
* '''Ver consumo:''' mostra a quantidade de tokens já utilizados e os usuários que geraram consumo.
* '''Limpar dados de navegação:''' exibe uma mensagem explicando como limpar os dados de navegação do navegador.
* '''Limpar cookies:''' apaga os dados armazenados localmente, permitindo informar novamente a API e realizar um novo login.
* '''Instalar aplicativo:''' instala a Cia como aplicativo no dispositivo, criando um atalho na tela inicial.
* '''Documentação na wiki:''' direciona para a documentação da Cia na CIGAM Wiki.
* '''Sair:''' encerra a sessão do usuário, permitindo realizar login com outro usuário.
 
[[Imagem:ConfiguracoesCia.png|semmoldura|center|500px]]
{{VoltarInicio}}

=Portais=
Nos Portais CIGAM, além do acesso à Cia Web pelo menu de mosaico, estão disponíveis recursos de IA que atuam diretamente nas telas em que você está trabalhando. Esses recursos não exigem parametrização e são apresentados de acordo com o contexto da tela. 

==Acesso à Cia Web (SaaS) pelo menu mosaico==
O acesso à Cia Web a partir dos Portais é feito pelo ícone de mosaico, onde está disponível o ícone da Cia - IA do CIGAM. 
 
[[Imagem:mosaicoCia.png|semmoldura|center|800px]]
 
A Cia será aberta de forma integrada, sem a necessidade de novo login, e todas as funcionalidades descritas na seção [[#Cia Web (SaaS)|Cia Web (SaaS)]] estarão disponíveis normalmente. 

==Geração de conteúdo==
Na barra superior dos Portais está disponível um ícone com um menu de contexto que permite interagir com os '''campos de texto''' de qualquer parte dos Portais. As opções disponíveis permitem melhorar textos, criar conteúdos, revisar a gramática, entre outras ações. 
 
[[Imagem:comandosCia.png|semmoldura|center|650px]]
 
A partir da versão '''Beta 260601''', essas opções passaram a ser exibidas em uma seção separada, chamada '''Geração de conteúdo''', apresentada no mesmo menu em que ficam os agentes. 
 
[[Imagem:MenuGeracaoConteudoAgentes.png|semmoldura|center|800px]]
 
O campo processado é sempre o '''último campo em que o cursor esteve posicionado''' antes de abrir o menu da Cia. Por isso, basta clicar no campo desejado e, em seguida, acionar o menu e escolher o comando. 
 
Para que o comando seja executado, o campo precisa ser um '''campo de texto válido''' e conter, no mínimo, '''três palavras'''. Caso contrário, será apresentada uma mensagem informando que o conteúdo não atende aos requisitos. 
 
Após o processamento, o conteúdo gerado é aplicado automaticamente no campo, substituindo o texto anterior, sem necessidade de confirmação. 
 
Essa funcionalidade também está disponível em telas modais, ou seja, janelas sobrepostas com interações: 
 
[[Imagem:comandosModalCia.png|semmoldura|center|800px]]
 

==Agentes==
A partir da versão '''Beta 260601''', o menu da Cia nos Portais passou a disponibilizar também o acesso aos agentes, tanto nos Portais MVC quanto nos Portais React. 
 
Ao abrir o menu da Cia, os agentes disponíveis são detectados automaticamente de acordo com a tela que está sendo acessada, ou seja, as opções apresentadas variam conforme a página aberta. 
 
[[Imagem:MenuAgentesCia.png|semmoldura|center|800px]]
 

===Como os agentes são disponibilizados===
A disponibilização de cada agente pode ocorrer de quatro formas: 
 
* '''Por contexto:''' o agente é apresentado quando a Cia identifica que a tela acessada corresponde ao assunto tratado por ele. Por exemplo, um agente sobre Ordem de Produção será disponibilizado ao acessar uma página cujo contexto seja identificado como Ordem de Produção.
 
* '''Por parâmetro:''' o agente é apresentado quando a Cia identifica, na tela, um parâmetro com o valor esperado por ele. Por exemplo, um agente de Pedidos será disponibilizado quando existir na tela um parâmetro que contenha o código do pedido.
 
* '''Por contexto e parâmetro:''' o agente é apresentado somente quando as duas condições forem atendidas ao mesmo tempo.
 
* '''Sempre disponível:''' o agente é apresentado em qualquer tela, independentemente do contexto ou dos parâmetros.
 

===Resultado do processamento===
Após o processamento, o retorno do agente pode ser apresentado de duas formas, conforme o que foi executado: 
 
* Em uma '''nova guia''' do navegador, quando o agente gera algum conteúdo ou relatório como resultado.
 
[[Imagem:AgentesRetornoGuia.png|semmoldura|center|800px]]
 
* Em uma '''janela modal''', dentro da própria página em que o usuário está, quando o retorno é uma mensagem.
 
[[Imagem:AgentesRetornoModal.png|semmoldura|center|800px]]
 
<div align="justify>
A partir da versão '''Beta 261005''', quando o resultado do agente é apresentado em uma nova guia, a página passa a disponibilizar também opções para utilização e compartilhamento da análise.
</div>
 
[[Imagem:resultadoAnalise.png|semmoldura|center|800px]]
 
<div align="justify">
No cabeçalho são apresentados o nome do agente executado e as opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.
</div>
<div align="justify">
=====Compartilhamento por e-mail=====
A janela abaixo é exibida quando selecionada a opção '''E-mail''':
</div>
 
[[Imagem:modalEmail.png|semmoldura|center|800px]]
 
<div align="justify">

Para utilizar esse recurso, o ambiente deve possuir as configurações necessárias para envio de e-mails pelo CIGAM devidamente parametrizadas. Para mais informações, consulte [[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]].
</div>

==Editor de Agentes==
A partir da versão '''Beta 261005''', o menu passou a disponibilizar o acesso à ferramenta '''Editor de Agentes''', que permite criar seus próprios agentes. 
 
[[Imagem:EditorAgentesCia.png|semmoldura|center|800px]]
 
Ao clicar na opção, será aberta uma página web no formato de assistente (wizard), com cada etapa explicada de forma detalhada. Basta preencher as informações do agente conforme a sua necessidade e avançar pelos passos até a conclusão. 
 
[[Imagem:EditorAgentesWizard.png|semmoldura|center|800px]]
 
Ao final do processo, será gerado um arquivo com a extensão '''.cgagt''', que contém a definição do agente criado. 
 

===Disponibilizando o agente criado===
Para que o agente passe a ser exibido nos Portais, o arquivo '''.cgagt''' precisa ser colocado na aplicação da API, dentro da pasta raiz da aplicação. 
 
É necessário que existam as pastas '''Exclusivo''' e, dentro dela, '''Agentes'''. Caso não existam, elas devem ser criadas manualmente. O arquivo deve ser colocado dentro dessa estrutura, ficando da seguinte forma: 
 
/api/exclusivo/agentes/
 
Assim que o arquivo é adicionado nesse local, a Cia passa a reconhecer o agente automaticamente, sem necessidade de qualquer outra configuração. Os agentes customizados são exibidos no menu da Cia nos Portais, em uma seção separada dos agentes padrão. 
 
[[Imagem:MenuAgentesCustomizados.png|semmoldura|center|800px]]
 
==Conversar com documentos==
<div align="justify">
A ferramenta de '''Conversar com documentos''' permite analisar, resumir e cruzar informações contidas em arquivos e relatórios através de modelos avançados de Inteligência Artificial integrados ao ERP CIGAM.

O acesso pode ser realizado a partir da tela principal da Cia Web (SaaS), clicando na opção correspondente ou digitando o assunto <code>#Documentos</code>, momento em que a aplicação é aberta em uma nova guia do navegador assim que digitada a primeira mensagem.

Além disto, podemos acessar a aplicação através dos Portais CIGAM, conforme descrito em [[GE_-_Como_Fazer_-_Cia_-_Como_acessar#Conversar_com_documentos|Como acessar]].

Para a utilização da aplicação, é necessário estar autenticado com um token de autorização CIGAM e com o endereço da API CIGAM devidamente parametrizado. Logo ao abrir, o sistema avalia o ambiente e valida a sessão do usuário em tempo real.

Estando os parâmetros validados, será gerado automaticamente um ID de conversação (''Conversation ID'') exclusivo para a sessão. Esta identificação é armazenada em cookies do navegador com validade de 24 horas, permitindo que a Cia armazene e mantenha o contexto contínuo de todas as mensagens e documentos anexados. Caso a página seja atualizada ou fechada dentro deste período, a sessão conectada e os arquivos são recuperados automaticamente.

 
<center>[[Arquivo:cia_conv_docs_01.png|nenhum|750px]]</center>
 

No primeiro acesso, é obrigatório marcar a opção '''Termo de consentimento''' para indicar ciência de que os dados e documentos selecionados para análise serão enviados aos modelos de IA de terceiros integrados com a Cia. Por segurança e conformidade, os campos de envio e a área de anexos permanecem bloqueados até que o consentimento seja confirmado. Uma vez aceito, uma mensagem de registro é inserida no histórico da conversa e a preferência é memorizada para a sessão.

Após confirmar o termo, a área de upload no painel lateral esquerdo é habilitada, permitindo anexar múltiplos arquivos simultaneamente, seja arrastando e soltando os documentos sobre a área de dropzone, seja clicando sobre ela para abrir a janela de seleção de arquivos.

A ferramenta suporta uma ampla variedade de formatos corporativos:
*'''Documentos de Texto e Portáteis:''' PDF (<code>.pdf</code>), Texto Simples (<code>.txt</code>), Word (<code>.doc</code>, <code>.docx</code>).
*'''Planilhas e Dados Tabulares:''' Planilhas Excel (<code>.xlsx</code>, <code>.xls</code>), Valores Separados por Vírgula (<code>.csv</code>).
*'''Arquivos de Estrutura de Dados:''' Arquivos <code>.json</code> e <code>.xml</code>.
*'''Imagens:''' Formatos de imagem (<code>.png</code>, <code>.jpg</code>, <code>.jpeg</code>, etc.).

No painel lateral, é possível visualizar o contador total de documentos anexados, o ícone específico do formato, o nome, o tamanho do arquivo formatado e a indicação de que o documento encontra-se ativo no contexto da conversa. Em dispositivos móveis ou telas menores, o painel lateral pode ser recolhido ou expandido através do botão retrátil no topo da barra.

Uma vez enviados para análise, os documentos permanecem registrados no contexto da conversa no servidor, não sendo necessário reenviá-los a cada nova pergunta. Caso deseje substituir ou remover os arquivos analisados, deve-se reiniciar o contexto através da opção de limpeza da conversa.

 
<center>[[Arquivo:cia_conv_docs_02.png|nenhum|750px]]</center>
 

Clicando no ícone da engrenagem localizado no canto superior direito da tela, temos acesso ao menu de opções e configurações da ferramenta:

*'''Modelo de IA:''' Permite selecionar o modelo de Inteligência Artificial desejado para o processamento documental (ex.: GPT-5.4 Recomendado, GPT-5.4 Mini, GPT-5.2 Alta Precisão, GPT-5.1 Raciocínio, GPT-4.1 Análise Documental, GPT-4o Versátil, GPT-4o Mini Econômico). A lista de modelos é atualizada dinamicamente a partir dos serviços disponíveis na Cia.
*'''Usuário Conectado:''' Exibe os dados do usuário autenticado no ERP CIGAM, incluindo nome, empresa (razão social / fantasia) e código de usuário.
*'''Ambiente & Sessão CIGAM:''' Apresenta o tipo de ambiente (produção ou depuração) e a URL da API CIGAM conectada, acompanhado de um botão de cópia rápida para facilitar diagnósticos e solicitações de suporte técnico.
*'''ID da Conversa Ativa:''' Exibe o identificador único da sessão com indicador visual de status em tempo real e botão para copiar o código do ID diretamente para a área de transferência.
*'''Limpar conversa:''' Permite reiniciar o contexto da conversa. Ao acionar esta opção, um balão interativo de confirmação é apresentado no histórico do chat (com as opções ''Limpar Conversa'' ou ''Cancelar''). Ao confirmar, o sistema solicita a exclusão da conversa no serviço da OpenAI para evitar registros órfãos, remove os documentos e cookies locais e gera um novo ID de conversação limpo.
*'''Documentação na wiki:''' Atalho que direciona diretamente aos manuais e guias de uso na CIGAM Wiki.

 
<center>[[Arquivo:cia_conv_docs_03.png|nenhum|750px]]</center>
 

Com os documentos anexados, podemos enviar perguntas e comandos no campo inferior para obter resumos executivos, explicações pontuais, cruzamento de dados entre arquivos distintos, localização de inconsistências ou extração de indicadores. Caso enviemos os arquivos sem digitar nenhuma mensagem complementar, a Cia aplicará o prompt de sistema padrão para realizar uma leitura analítica e retornar um resumo estruturado dos documentos.

O sistema dispõe de diretrizes de sistema corporativas (''System Prompt'') integradas ao ecossistema do ERP CIGAM, orientando o modelo a analisar com fidelidade os dados fornecidos, sem inventar informações ausentes.

Também é disponibilizado o recurso de '''Reconhecimento de Voz''' através do ícone de microfone (habilitado em conexões seguras HTTPS). O recurso conta com reconhecimento inteligente de pontuação falada: ao ditar expressões como ''"vírgula"'', ''"ponto"'', ''"ponto e vírgula"'', ''"dois pontos"'', ''"interrogação"'', ''"exclamação"'', ''"hífen"'', ''"abre parênteses"'', ''"fecha parênteses"'' ou ''"nova linha"'', os termos são automaticamente substituídos pelos respectivos sinais gráficos e as frases são capitalizadas de forma automática.

 
<center>[[Arquivo:cia_conv_docs_04.png|nenhum|750px]]</center>
 

As respostas retornadas pela Cia contam com formatação Markdown avançada, estruturando o conteúdo em títulos hierárquicos, listas ordenadas ou em tópicos, citações em bloco e tabelas responsivas estilizadas.

Além disso, sempre que a análise envolver dados numéricos comparativos, demonstrativos contábeis/financeiros (como DRE, receitas e despesas), séries temporais ou valores tabulares, a Cia gera automaticamente gráficos visuais e interativos integrados diretamente na resposta:
*'''Tipos de Gráficos Gerados:''' Barras verticais, linhas de tendência, gráficos de pizza e rosca, estilizados na paleta de cores oficial da Cia e com valores numéricos formatados no padrão brasileiro (pt-BR).
*'''Exportação do Gráfico:''' Cada card de gráfico possui um botão de download no canto superior direito, permitindo baixar a imagem em formato PNG em alta resolução para inclusão imediata em relatórios, apresentações ou envio por e-mail.

 
<center>[[Arquivo:cia_conv_docs_05.png|nenhum|750px]]</center>
 

Podemos manter uma conversa contínua com diversos documentos e mensagens em múltiplos turnos de diálogo. A Cia preserva o histórico de perguntas e respostas anteriores, permitindo aprofundar análises, solicitar detalhamentos de itens específicos ou anexar novos arquivos complementares ao longo da conversa.

</div>
{{VoltarInicio}}

=Desktop=
Na aplicação Desktop, além do acesso rápido à Cia Web, algumas ferramentas do sistema disponibilizam o recurso "Analisar com a Cia". 

==Acesso rápido à Cia Web (SaaS)==
O botão de acesso rápido (Cia - IA do CIGAM), disponível no menu lateral do Desktop, abre a Cia Web de forma integrada ao sistema, em uma janela do próprio CIGAM. 
 
Desde que as configurações necessárias tenham sido aplicadas, conforme [[GE - Como Fazer - Configuração da Cia IA do CIGAM#Acesso rápido à Cia Web (SaaS)|Acesso rápido à Cia Web (SaaS)]], '''todas as funcionalidades da Cia Web estarão disponíveis normalmente''', da mesma forma que no acesso pelo navegador. Para conhecê-las, consulte a seção [[#Cia Web (SaaS)|Cia Web (SaaS)]] desta documentação. 
 
[[Imagem:CiaAbertaDesktop.png|semmoldura|center|800px]]
 

==Recurso "Analisar com a Cia"==
O recurso '''"Analisar com a Cia"''' está disponível em ferramentas como CGEditor, CGReport, Pesquisa Dinâmica e Dispositivo de Saída. Em todas elas, o comportamento é o mesmo: a Cia analisa o conteúdo que está em uso na tela e gera um relatório com o resultado da análise, apresentado em uma nova página. 
 
Ao acionar a opção, o fluxo é o seguinte: 
 
'''1. Confirmação dos termos de uso''' 
Antes de qualquer envio, será exibida uma mensagem solicitando que o usuário concorde com o envio das informações para análise. Os dados enviados seguem as diretrizes de segurança, privacidade e não retenção descritas em [[#Recursos, configurações e segurança|Recursos, configurações e segurança]]. 
 
[[Imagem:AnalisarCiaTermos.png|semmoldura|center|500px]]
 
'''2. Complemento do prompt (opcional)''' 
Em seguida, será apresentada uma caixa de texto para que o usuário complemente a solicitação, orientando a análise para algum ponto específico. O preenchimento é opcional e pode ser deixado em branco. 
 
Essa caixa de texto serve apenas para complementar o prompt base que a Cia monta automaticamente, e não altera o conteúdo que está sendo enviado. O recurso considera que o usuário já filtrou os dados na própria tela do CIGAM antes de acionar a análise. O prompt base é mantido oculto por ser extenso e técnico, evitando que o usuário precise conferi-lo a cada utilização. 
 
[[Imagem:AnalisarCiaPrompt.png|semmoldura|center|700px]]
 
'''3. Geração do relatório''' 
Após a confirmação, a Cia processa o conteúdo e apresenta o relatório em uma nova página flutuante, com a análise dos dados enviados. 
 
O próprio relatório informa a quantidade de dados que foi analisada, permitindo que o usuário veja o volume aproximado considerado e identifique se o conteúdo enviado corresponde ao que esperava. 
 
[[Imagem:AnalisarCiaRelatorio.png|semmoldura|center|700px]]
 

A partir da versão '''Beta 261005''', o resultado da análise passa a ser apresentado em uma nova janela flutuante, que disponibiliza opções para utilização e compartilhamento do conteúdo gerado. Nessa versão, o recurso está disponível apenas para a '''Pesquisa Dinâmica/Pesquisa Paginada''' e para o '''FastReport'''. A partir da '''RC 270519''', ele também passa a estar disponível para o '''CGEditor''' e o '''Dispositivo de Saída'''. 
 
No cabeçalho dessa janela, são apresentados o título da análise e três opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.

 
[[Imagem:AnalisarCiaDesktopCompartilhar.png|semmoldura|center|800px]]
 

====Compartilhamento por e-mail====

Ao selecionar a opção '''E-mail''', é apresentada uma janela para preenchimento das informações necessárias ao envio da análise. 
 
[[Imagem:AnalisarCiaDesktopEmail.png|semmoldura|center|700px]]
 
Após informar os destinatários e os demais dados da mensagem, basta selecionar '''Enviar'''. A análise gerada será encaminhada como um arquivo em anexo. 
 

===Limite de conteúdo enviado===
Existe um limite para o volume de conteúdo enviado em cada análise, que varia conforme a versão do ambiente: 
 
* '''150 KB''' — desde a disponibilização do recurso, na versão '''250505.a'''.
* '''3 MB''' — a partir das patches '''250505.i''' e '''251103.a''', e da versão '''RC 260504'''.
 
Quando o conteúdo selecionado ultrapassa esse limite, a Cia exibe uma mensagem informando o tamanho excedido e a análise não é processada, ou seja, nenhum relatório será gerado. 
 
[[Imagem:AnalisarCiaLimite.png|semmoldura|center|600px]]
 
'''Esse limite não é parametrizável e não se trata de uma restrição imposta pela CIGAM.''' Ele decorre da própria capacidade dos modelos de IA integrados à Cia, que possuem um limite técnico de volume de dados que conseguem processar em uma única análise. Quando esse volume é ultrapassado, os modelos passam a analisar as informações por amostragem — ou seja, mesmo que fosse permitido enviar uma quantidade maior de dados, o modelo não analisaria todo o conteúdo, e o resultado seria menos preciso. O limite adotado pela Cia acompanha essa característica dos modelos e assegura que a análise seja feita sobre os dados completos. 
 
Além da qualidade da análise, há também a questão do tempo de processamento: quanto maior o volume enviado, maior o tempo de resposta do modelo, tornando a espera inviável para o uso no dia a dia. 
 
Por isso, o recurso foi feito para ser simples e direto: analisar, com um clique, os dados que o usuário já está visualizando pelos meios tradicionais do CIGAM, como grids filtrados e relatórios. Em ambientes com grande volume de dados, a prática recomendada é '''filtrar e consolidar as informações na própria tela antes de acionar a análise''', reduzindo o período ou o escopo consultado. Para análises de períodos maiores, recomenda-se utilizar dados já consolidados, como totalizadores e relatórios sintéticos, em vez de listagens analíticas completas. 
 
A CIGAM está trabalhando em outras ferramentas que, por processarem os dados de forma diferente, permitirão trabalhar com volumes maiores de informação. 

Para saber como acessar o recurso em cada ferramenta, consulte: [[GE - Como Fazer - Cia - Como acessar]]
{{VoltarInicio}}

=Documentos Relacionados=
[[GE - Como Fazer - Cia - Como acessar]] 
[[GE - Como Fazer - Configuração da Cia IA do CIGAM]]

GE - Como Fazer - Cia - Como acessar

2026-10-16T13:47:53Z

Roger.schneider: /* Conversar com documentos */

{{VoltarPagina}}
 
[[categoria:Como_Fazer_Utilidades/Diversos]]
[[categoria:Como_Fazer_Utilidades/Diversos_6]]
[[MediaWiki:Como_Fazer_sidebar|Como Fazer]] > [[Como_Fazer_Utilidades/Diversos|Utilidades/Diversos]] > [[GE - Como Fazer - Cia - Como acessar|Cia - Como acessar]]

=Cia - IA do CIGAM=
A Cia - IA do CIGAM oferece diversas funcionalidades e atua como um hub centralizador para os recursos de inteligência artificial utilizados nas soluções CIGAM. Para garantir o correto funcionamento desses recursos, é necessário verificar se os pré-requisitos e as configurações foram realizados adequadamente. Para mais informações, consulte: [[GE - Como Fazer - Configuração da Cia IA do CIGAM|Como Fazer configuração da Cia IA do CIGAM]]. 
 
Todas as soluções de IA do CIGAM são integradas por meio dos serviços da Cia. A Cia possui integração com diferentes provedores de IA de terceiros, como OpenAI, Google, Anthropic, entre outros. Essas integrações são realizadas por meio de contas e serviços contratados, com condições de uso que asseguram que os dados trafegados não sejam utilizados para treinamento dos modelos, identificação de origem, publicidade, anúncios ou qualquer outra finalidade não prevista. 
 
Em todos os recursos disponibilizados, a IA do CIGAM respeita os direitos e permissões dos usuários, garantindo que cada função seja utilizada de acordo com as autorizações, independentemente da plataforma. 

==Formas de acesso==
A Cia pode ser acessada a partir de diferentes pontos das soluções CIGAM:

{| class="wikitable"
|-
| '''Forma de acesso''' || '''Descrição''' || '''Onde consultar'''
|-
| '''Cia Web (SaaS)''' || Aplicação web que centraliza todas as funcionalidades da Cia. Pode ser acessada diretamente pelo navegador ou em dispositivos móveis, ou então através do CIGAM e Portais. || [[#Cia Web (SaaS)|Cia Web (SaaS)]]
|-
| '''Portais CIGAM''' || Acesso à Cia e aos agentes pelo menu de mosaico, além dos comandos de IA disponíveis nos campos de texto dos Portais. || [[#Portais|Portais]]
|-
| '''Aplicação Desktop''' || Acesso rápido à Cia pela barra lateral, assistente de voz, ditado e o recurso "Analisar com a Cia" em ferramentas do sistema. || [[#Desktop|Desktop]]
|}
{{VoltarInicio}}

=Cia Web (SaaS)=
A Cia Web é uma aplicação web que centraliza todas as funcionalidades da Cia - IA do CIGAM. É por meio dela que os recursos de inteligência artificial são disponibilizados às demais soluções, seja pelos Portais, pela aplicação Desktop ou pelas ferramentas que possuem integração com a Cia. 

==Acesso pela URL oficial==
A Cia Web pode ser acessada diretamente pelo navegador do seu computador ou dispositivo móvel, utilizando o seguinte endereço:
 
https://services.cigam.cloud/cia/index.html 
 
Para acessar, é necessário que o usuário tenha a autenticação em duas etapas configurada, conforme descrito em [[GE - Como Fazer - Configuração da Cia IA do CIGAM#Autenticação em duas etapas e configurações de envio de e-mail|Autenticação em duas etapas e configurações de envio de e-mail]]
 
 
O acesso também está condicionado às demais configurações descritas em [[GE - Como Fazer - Configuração da Cia IA do CIGAM|Como Fazer configuração da Cia IA do CIGAM]].
 
 
Para saber como utilizar os recursos disponíveis, consulte [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer uso da Cia IA do CIGAM]]
 
 
[[Imagem:CiaAberta.png|semmoldura|centro|800px]]

==Acesso a partir dos Portais e do Desktop==
Além do acesso direto pelo navegador, a Cia Web também pode ser aberta de dentro das demais soluções CIGAM: 
* Pelos Portais CIGAM, conforme descrito em [[#Portais|Portais]];
* Pela aplicação Desktop, conforme descrito em [[#Acesso rápido à Cia Web (SaaS)|Acesso rápido à Cia Web (SaaS)]].

=Portais=
==Acesso à Cia Web (SaaS)==
O acesso da Cia através dos Portais CIGAM ocorre dentro do ícone de mosaico, onde existe o ícone de acesso à Cia - IA do CIGAM:

[[Imagem:mosaicoCia.png|semmoldura|centro|800px]]
 
O acesso será imediato ao clicar, desde que todas as configurações indicadas no documento tenham sido aplicadas conforme [[GE - Como Fazer - Configuração da Cia IA do CIGAM|Como Fazer configuração da Cia IA do CIGAM]]. 

==Comandos de IA em campos de texto==
Além do acesso à Cia, na barra superior dos Portais estará disponível um ícone com um menu de contexto, permitindo interações com os '''campos de texto''' em qualquer parte dos Portais. Com ele, você pode melhorar textos, criar conteúdos, revisar gramática, entre outras funções. 

[[Imagem:comandosCia.png|semmoldura|centro|650px]]

===Telas modais===
Essa funcionalidade também está disponível para telas modais (janelas sobrepostas com interações):

[[Imagem:comandosModalCia.png|semmoldura|centro|800px]]

==Menu de agentes==
A partir da versão '''Beta 260601''', o menu da Cia nos Portais foi alterado e passou a disponibilizar o acesso aos agentes. 
 
Além das opções generativas, como melhoria de texto, revisão gramatical, entre outras, o menu passou a apresentar também os agentes disponíveis de acordo com o contexto da tela e com os parâmetros definidos. Esses agentes são carregados automaticamente conforme esses requisitos. 
 
O menu está disponível tanto para os Portais MVC quanto para os Portais React. 
 
Para saber como utilizar os agentes, consulte: [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer uso da Cia IA do CIGAM]]
 
[[Imagem:MenuAgentesCia.png|semmoldura|centro|800px]]

===Editor de agentes===
A partir da versão '''Beta 261005''', o menu passou a disponibilizar também o acesso à ferramenta '''Editor de Agentes''', que permite criar seus próprios agentes. 
 
[[Imagem:EditorAgentesCia.png|semmoldura|centro|800px]]
 
Para saber como utilizar o Editor de Agentes, consulte: [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer uso da Cia IA do CIGAM]]
 
{{VoltarInicio}}

===Conversar com documentos===
<div align="justify">
A partir da versão '''Beta 261005''', o menu passou a disponibilizar também o acesso à ferramenta '''Conversar com documentos''', que permite criar contexto envolvendo mensagens e documentos para uma análise completa da IA.

Ao clicar na opção "Conversar com documentos" seremos direcionados à página da aplicação.

 
<center>[[Arquivo:cia_conv_docs_acesso_01.png|nenhum|562px]]</center>
 

Precisamos acessar com nosso token de autorização CIGAM e termos nossa API configurada corretamente.

 
<center>[[Arquivo:cia_conv_docs_01.png|nenhum|750px]]</center>
 
</div>
{{VoltarInicio}}

=Desktop=
==Cia Assistente==
O ícone da Cia estará visível na barra superior do CIGAM assim que o sistema for inicializado. 

[[Imagem:Img9.png|semmoldura|centro|800px]]
 
Ao clicar no ícone, a assistente virtual será ativada, juntamente com seus componentes de reconhecimento de voz. Além disso, uma barra lateral será exibida com algumas opções de utilização. Quando ativa, a assistente permite a interação por comandos de voz e também pode emitir mensagens e notificações por áudio. 

[[Imagem:Img10.png|semmoldura|centro|800px]]
 

==Acesso rápido à Cia Web (SaaS)==
Dentro do menu na lateral, há um botão de acesso rápido para abrir a Cia - IA do CIGAM:

[[Imagem:CiaIA.png|semmoldura|centro|800px]]
 
'''Importante:''' Para usar essa funcionalidade no desktop, é preciso ter a API e seus portais instalados, pois eles conectam o sistema aos dados do ERP. Sem a API, a funcionalidade não vai funcionar, apresentando uma mensagem de erro. Se todas as configurações estiverem corretas, ao clicar no botão, a Cia será aberta em uma janela integrada ao sistema. 
Caso ocorra algum problema na abertura devido a configurações ausentes ou incorretas, consulte a documentação: [[GE - Como Fazer - Configuração da Cia IA do CIGAM|Como Fazer configuração da Cia IA do CIGAM]].
 

[[Imagem:CiaAbertaDesktop.png|semmoldura|centro|800px]]
 
{{VoltarInicio}}

==Recurso "Analisar com a Cia"==
Algumas ferramentas do CIGAM disponibilizam o recurso '''"Analisar com a Cia"''', que permite enviar o conteúdo em uso diretamente para a Cia, sem sair da ferramenta. O comportamento é o mesmo em todas as ferramentas: o conteúdo é enviado para análise e a resposta é apresentada pela Cia, respeitando os direitos e permissões do usuário.
 
 
Esse recurso está disponível a partir da versão '''250505.a'''.
 
 
Para saber como utilizar o recurso, em qualquer uma das ferramentas, consulte: [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer uso da Cia IA do CIGAM]]
 
 
O recurso está disponível nas seguintes ferramentas: 

===Pesquisa Dinâmica / Pesquisa Paginada===
Para utilizar o recurso, basta acessar qualquer programa do CIGAM que contenha uma pesquisa dinâmica/paginada, como o cadastro de Ordem de Serviço. A opção '''"Analisar com a Cia"''' estará disponível no menu superior da tela. 
 
[[Imagem:PesquisaDinamicaComCia.png|semmoldura|centro|800px]]
 
 
Para mais informações sobre a Pesquisa Dinâmica, consulte: [[GE - Como Fazer - Pesquisa Dinâmica#Pesquisa Dinâmica Desktop|Pesquisa Dinâmica Desktop]]

===CGEditor===
Para utilizar o recurso, basta estar com o arquivo que deseja analisar aberto e clicar no ícone '''"Visualizar Impressão"'''. 
 
[[Imagem:VisualizarImpressao.png|semmoldura|centro|800px]]
 
Será aberta uma nova janela, na qual estará disponível a opção '''"Analisar com a Cia"'''. 
 
[[Imagem:EditorAnalisarComCia.png|semmoldura|centro|800px]]
 

===CGReport===
Para utilizar o recurso, basta estar com a consulta montada e clicar no ícone '''"Pré-Visualizar"'''. 
 
[[Imagem:PreVisualizar.png|semmoldura|centro|800px]]
 
O relatório será processado e gerado e, na tela apresentada, estará disponível a opção '''"Analisar com a Cia"'''. 
 
[[Imagem:ReportAnalisarComCia.png|semmoldura|centro|800px]]
 

===Dispositivo de Saída===
O Dispositivo de Saída é um visualizador de arquivos, com a finalidade de exibir, salvar e editar relatórios gráficos e de caracteres. Nessa funcionalidade também é possível indicar a impressão e configurar a orientação e o tipo da página. 
 
Ao acessar o Dispositivo de Saída, por exemplo através do atalho '''Ctrl + P''' ou através do menu '''Acesso Rápido''', a opção '''"Analisar com a Cia"''' estará disponível no menu lateral. 
 
[[Imagem:DispositivoSaidaComCia.png|semmoldura|centro|800px]]
 
 
Para mais informações, consulte: [[GE Acesso rápido|Acesso rápido]]
{{VoltarInicio}}

==Grupo do chat==
No grupo do chat, existem algumas opções que facilitam a consulta de informações, permitindo que as solicitações sejam atendidas com mais precisão de acordo com o assunto. As opções disponíveis são:
 
'''Geral:''' Para conversar sobre assuntos gerais. 
'''Suporte:''' Para tratar de questões relacionadas ao suporte e solução de problemas. 
'''Configurações:''' Para obter informações sobre como configurar o CIGAM. 
'''Como Fazer:''' Para aprender a utilizar funcionalidades específicas do CIGAM. 
'''RH:''' Para questões relacionadas a Recursos Humanos. 

[[Imagem:Img11.png|semmoldura|centro|800px]]
 

==Grupo assistente==
A assistente virtual oferece comandos pré-definidos que podem ser utilizados para interações via áudio. Esses comandos podem ser acionados de duas formas: 
1. Por comando de voz: Basta falar o comando para que a assistente responda. 
2. Por seleção manual: O usuário pode clicar em um comando para que a assistente execute a ação e forneça uma resposta em áudio.
 
Além disso, é possível pesquisar os comandos disponíveis para facilitar a localização de um comando de voz específico. 

[[Imagem:Img12.png|semmoldura|centro|800px]]
 
[[Imagem:Img13.png|semmoldura|100px|esquerda]]   Indica um comando de voz '''executável por clique''', ou seja, ao clicar no ícone, a assistente executa a ação e fornece uma resposta por áudio. 
[[Imagem:Img14.png|semmoldura|100px|esquerda]]   Indica um comando de voz que '''deve ser ditado pelo usuário.''' Esse ícone serve apenas para informar que o comando existe e pode ser utilizado via fala, sem resposta ao clique. 

Os comandos de voz acionados por clique serão reordenados automaticamente conforme sua frequência de uso, facilitando o acesso aos comandos mais utilizados. 

===Quais são os comandos interpretados pela Cia?===
A implementação do reconhecimento de voz no CIGAM está implementada de maneira básica. 
Para isso, estão disponíveis os seguintes comandos: 
 
{| class="wikitable"
|-
| '''Tipo''' || '''Comando de voz''' || '''Resultado''' || '''A tela deve estar'''
|-
|rowspan="13"| '''Métodos''' || Cia mostrar acesso rápido || Mostra o painel Acesso rápido || Ativa
|-
| Cia mostrar alertas || Mostra o painel Alertas || Ativa
|-
| Cia fechar alertas || Fecha o painel Alertas pois é um painel lateral || Ativa
|-
| Cia mostrar início || Mostra o painel Início || Ativa
|-
| Cia mostrar favoritos || Mostra o painel Favoritos || Ativa
|-
| Cia mostrar histórico || Mostra o painel Histórico || Ativa
|-
| Cia mostrar mais acessados || Mostra o painel Mais acessados || Ativa
|-
| Cia mostrar marcadores || Mostra o painel Marcadores || Ativa
|-
| Cia mostrar utilidades || Mostra o painel Utilidades || Ativa
|-
| Cia mostrar pesquisar || Mostra o painel Pesquisar || Ativa
|-
| Cia fechar pesquisar || Fecha o painel Pesquisar pois é um painel lateral || Ativa
|-
| Cia escolher área || Mostra o painel para selecionar qual área posicionar. Só irá responder a esse comando caso esteja no painel Início
|| Ativa
|-
| Cia ler este campo || Lê o campo que está posicionado na tela || Ativa
|-
| rowspan="17"| '''Teclas''' || Cia vá para cima || Pressiona a tecla seta para cima || Ativa
|-
| Cia vá para baixo || Pressiona a tecla seta para baixo || Ativa
|-
| Cia vá para direita || Pressiona a tecla seta para a direita || Ativa
|-
| Cia vá para esquerda || Pressiona a tecla seta para a esquerda || Ativa
|-
| Cia modificar || Pressiona a tecla Ctrl+M || Ativa
|-
| Cia pesquisar || Pressiona a tecla Ctrl+Q || Ativa
|-
| Cia criar || Pressiona a tecla Ctrl+I || Ativa
|-
| Cia entrar || Pressiona a tecla Enter || Ativa
|-
| Cia voltar || Aciona o comando de voltar navegação do menu. Equivale ao pressionamento de Ctrl + Seta para esquerda || Ativa
|-
| Cia zoom || Pressiona a tecla F5 || Ativa
|-
| Cia focar || Quando um painel tem mais de um container de mosaicos, alterna o foco entre eles. Exemplo de uso: painéis que tem treeview de divisões (cadastros, movimentos, pesquisas, relatórios...) e também outro container com os mosaicos daquela divisão. Equivale ao pressionamento do Ctrl + Tab. Como o foco irá mudar de container, esse comando automaticamente sai do modo “procurar” se ele estiver ativo. || Ativa
|-
| Cia fechar esta tela || Fecha a tela através do pressionamento da tecla Esc. || Ativa
|-
| Cia capturar esta tela || Faz um print da área de trabalho e coloca na área de transferência || Ativa
|-
| Cia capturar esta tela e salvar || Salva em arquivo o print da área de trabalho || Ativa
|-
| Cia próximo campo || Salta para o próximo campo da tela através do pressionamento da tecla Tab || Ativa
|-
| Cia campo anterior || Salta para o campo anterior da tela através do pressionamento das teclas Shift + Tab || Ativa
|-
| Cia selecionar tudo || Seleciona o conteúdo do campo focado. Equivale a um Ctrl + A. || Ativa
|-
|rowspan="19"| '''Interação''' || Cia aumentar volume || Aumenta o volume da saída de som da aplicação || Indiferente
|-
| Cia diminuir volume || Diminui o volume da saída de som da aplicação || Indiferente
|-
| Cia bom dia || Cumprimento || Ativa
|-
| Cia boa tarde || Cumprimento || Ativa
|-
| Cia boa noite || Cumprimento || Ativa
|-
| Cia que dia é hoje? || Fala a data atual || Ativa
|-
| Cia que horas são? || Fala a hora atual || Ativa
|-
| Cia você me entendeu? || Refaz o reconhecimento da última frase para verificar se tem alguma frase de reconhecimento vinculada que não tenha sido reconhecida anteriormente. || Ativa
|-
| Cia a internet está conectada? || Verifica se o usuário logado tem acesso à internet. || Ativa
|-
| Cia qual sua idade? || Responde com a idade da assistente, que é a idade da empresa Cigam. || Ativa
|-
| Cia me fale sobre assistente virtual || Responde falando a definição || Ativa
|-
| Cia me fale sobre você || Dá uma breve explicação sobre o assistente de voz || Ativa
|-
| Cia me fale sobre o CIGAM || Dá uma breve explicação sobre o produto || Ativa
|-
| Cia qual melhor sistema/software de gestão? || Responde a pergunta || Ativa
|-
| Cia você está me escutando? || É um comando para teste de reconhecimento de entrada e sintetização de saída. || Indiferente
|-
| Cia muito obrigado || Encerra a fala e agradece || Ativa
|-
| Cia pare || Encerra a fala de forma abrupta || Indiferente
|-
| Cia cadê você? || Ativa/foca a tela principal do CIGAM || Indiferente
|-
| Cia repita || Repete a última fala. As falas de diálogos não possuem suporte a repetição pois elas estão vinculadas a um contexto sequencial. || Indiferente
|-
| rowspan="30"| '''Negócio''' || Cia quais os valores a pagar? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o valor a pagar em atraso? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais os valores a receber? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o valor a receber em atraso? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais atendimentos tenho para hoje? ||Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais os atendimento de hoje? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais os alertas de hoje? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais as oportunidades tenho para hoje? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais as oportunidades de hoje? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais as oportunidades tenho para amanhã? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais as oportunidades de amanhã? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o total de ordens de serviços em aberto? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o total de OS's? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais os tipos de ordens de serviços em aberto? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais as OS's abertas? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quantas horas tenho registrado hoje? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual meu total de horas hoje? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quantas horas tenho registrado esta semana? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual meu total de horas nesta semana? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais as ordens de compra para recebimento hoje? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais as OC's para hoje? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o saldo atual? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o total de alçadas para aprovação? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais as alçadas para aprovação? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o valor vendido hoje? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o valor vendido ontem? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o valor faturado hoje? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o valor faturado ontem? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o valor dos pedidos para faturamento? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o valor dos pedidos para faturar? || Consulta a base de dados para montar a resposta || Ativa
|-
| rowspan="17"| '''Comandos''' || Cia faça pra mim || Irá abrir o microfone em modo comando para que o usuário dê a instrução do que fazer. Essa opção exige internet pois irá utilizar o modo ditado. '''Importante:''' Os comandos para tarefas para essa opção são aqueles que podem ter um conteúdo variável ou algum dado que precise ser verificado no momento do comando. Por exemplo “abrir lançamentos 123”. Nesse caso o valor “123” é o valor variável. Após o sinal de abertura do microfone, pode-se falar uma das tarefas a seguir: || Ativa
|-
| '''Tarefas''' → pesquisar previsão do tempo para [localidade] || Previsão do tempo para a localidade de acordo com a fonte CPTEC/Inpe. Exemplo: “previsão do tempo para Novo Hamburgo” || Ativa
|-
| '''Tarefas''' → pesquisar cotação do ou da [moeda] || Cotação da moeda em reais de acordo com o Banco Central do Brasil. Moedas disponíveis: - Dólar - Dólar Australiano - Dólar Canadense - Euro - Iene - Libra Esterlina - Franco Suíço - Coroa Dinamarquesa - Coroa Norueguesa - Coroa Sueca Exemplos: “buscar cotação do dólar” e “buscar cotação da libra esterlina” || Ativa
|-
| '''Tarefas''' → pesquisar no menu por [palavra chave] || Procura no menu por itens com a palavra chave e exibe os resultados no painel de pesquisa. Exemplo: “pesquisar por lançamentos” || Ativa
|-
| '''Tarefas''' → pesquisar aqui por [palavra chave] || Procura no local atual um item de menu pela palavra chave. Se encontrar, foca no item. Exemplo: “procurar aqui por pedidos” || Ativa
|-
| '''Tarefas''' → clicar no botão [nome do botão] ou clicar na página [nome da página] || Clica num determinado controle da tela, que pode ser do tipo botão ou página (guias). O controle deve estar visível e na tela em primeiro plano. Exemplos: “clicar no botão confirmar” “clicar na página financeiro” || Ativa
|-
| '''Tarefas''' → o que é [palavra chave] || Pesquisa no Wikipédia em português || Ativa
|-
| '''Tarefas''' → pesquisar sobre [palavra chave] || Pesquisa no Google em português || Ativa
|-
| '''Tarefas''' → pesquisar vídeos sobre [palavra chave] || Pesquisa vídeos no YouTube. || Ativa
|-
| '''Tarefas''' → abrir mapa [endereço] || Abre o mapa para o endereço no Google Maps. Exemplos: - abrir mapa rua vereador adão rodrigues de oliveira 524 em novo hamburgo - abrir mapa rua cruzeiro do sul gravataí - abrir mapa avenida frederico linck em novo hamburgo || Ativa
|-
| '''Tarefas''' → abrir [categoria menu] [programa do menu] [parâmetro] || Abre um item no menu do CIGAM. Essa opção abrange todos os itens de menu, inclusive os personalizados pelo usuário. O reconhecimento poderá ser feito das seguintes formas: a) Utilizando a categoria do menu, com ou sem plural: “abrir movimento estoque” ou “abrir movimentos estoque” Neste caso, existe um item de menu chamado “Estoque” dentro da categoria “Movimentos”. b) Sem a categoria do menu: “abrir estoque” Indiferente da forma utilizada anteriormente, poderá ser informado um parâmetro para qual registro posicionar '''Importante:''' O parâmetro será a chave-única do registro, não contemplando chaves compostas. Exemplos: “abrir movimento estoque 123” ou “abrir estoque 123”||Ativa
|-
| '''Tarefas''' → calcular [fórmula] || Executa um cálculo conforme os operadores e fatores passados. Exemplos: - calcular 10 mais 10 - calcular 10 menos 5 - calcular 10 mais 50 mais 20 porcento - calcular 10 mais 30 vezes 10 porcento - calcular 50 vezes 15 porcento - calcular 150 ponto 38 vezes 17 - calcular 100 dividido por 25 || Ativa
|-
| Cia aprenda comigo || Executa o comando “Cia faça pra mim”, porem com suporte a aprendizado dos comandos que forem falados. Os novos comandos serão imediatamente disponibilizados. || Ativa
|-
| '''Tarefas''' → apelidar [comando existente] para o apelido [apelido] || Ensina um apelido para um comando já existente. Exemplo: “apelidar mostrar favoritos para o apelido mostrar preferidos” || Ativa
|-
| '''Tarefas''' → apelidar esse programa para o apelido [apelido para o programa aberto] || Ensina um apelido para o programa que está aberto. Se considerado o programa principal, ou seja, aquele que pode ser acessado através de um item de menu. Exemplo: “apelidar esse programa para o apelido indicadores da poupança” (nesse exemplo, o programa “Índices” está aberto) || Ativa
|-
| '''Tarefas''' → quando eu falar [minha fala] me fale [fala] ou quando eu perguntar [minha pergunta] me responda [resposta] || Ensina uma resposta/fala para quando uma fala especifica for falada
Exemplos: "quando eu falar está tudo bem me fale está tudo ótimo" "quando eu perguntar quem eu sou me responda você é meu amigo"
|| Ativa
|-
| '''Tarefas''' → faça [comando do faça pra mim] quando eu falar [fala] || Ensina a ir diretamente num comando do faça pra mim a partir de um apelido. Exemplo: “faça pesquisar cotação do dólar quando eu falar cotação do dólar hoje” || Ativa
|-
|rowspan="7"| '''Músicas''' || Cia tocar minhas músicas || Iniciar o player de músicas. As músicas serão buscadas na pasta de músicas do usuário do Windows, em C:\Usuários\<usuáro>\Musicas e uma lista será montada a partir dos arquivos de música encontrados nesse local. Serão reconhecidos os formatos .mp2, .mp3 e .wma.|| Ativa
|-
| Cia tocar próxima música || Salta para a próxima trilha da lista de músicas || Indiferente
|-
| Cia tocar música anterior || Volta para a trilha anterior da lista de músicas || Indiferente
|-
| Cia parar minhas músicas || Encerra o player de músicas || Indiferente
|-
| Cia volume baixo para as músicas || Ajusta a saída de áudio do player com um volume baixo || Indiferente
|-
| Cia volume médio para as músicas || Ajusta a saída de áudio do player com um volume médio || Indiferente
|-
| Cia volume alto para as músicas || Ajusta a saída de áudio do player com um volume alto || Indiferente
|}
{{VoltarInicio}}

==Ditado==
===Como fazer para abrir o ditado através da Cia?===
Para abrir o ditado através do comando de voz, basta estar com um microfone conectado e falar “Cia, mostrar ditado”, ou clicar na opção no grupo Ditado.

[[Imagem:ImgCia1.png|semmoldura|centro|300px]]

[[Imagem:ImgCia2.png|semmoldura|centro|750px]]

Ao abrir o ditado existem as seguintes opções e Menu: 

[[Arquivo:ImgCia3.png|50x25px|esquerda]]   Sair – Atalho '''“Esc”'''

[[Arquivo:ImgCia4.png|50x25px|esquerda]]   Abrir/Fechar Microfone

[[Arquivo:ImgCia5.png|50x25px|esquerda]]   Colar conteúdo do ditado no campo focado – Atalho '''“Control + Shift + V”'''

[[Arquivo:ImgCia6.png|50x25px|esquerda]]   Copiar conteúdo de ditado para área de transferência – Atalho '''"Control + Shift + C”'''

[[Arquivo:ImgCia7.png|50x25px|esquerda]]   Ler o conteúdo do campo focado – Atalho '''“Control + Shift + L”'''

É possível dar alguns comandos como:

{| class="wikitable"
|-
| rowspan="2"| '''Ditado''' || Cia mostrar ditado || Abre ou foca na tela do ditado contínuo O ditado poderá ser feito alternando pausas sem tempo definido para término. Neste caso, para encerramento e utilização do conteúdo será necessário a interação do usuário através dos botões na área de topo. Estão disponíveis os comandos especiais dentro do ditado para tratamentos de caracteres: - nova linha - ponto final - ponto e vírgula - dois pontos - vírgula - interrogação - exclamação - aspas - aspa - hífen - abre parênteses - abre parêntese - fecha parênteses - fecha parêntese - asterisco - arroba - abre chave - fecha chave - abre colchete - fecha colchete || Ativo
|-
| Cia ditar este campo || Inicia o ditado não-contínuo ou de frase. Após o término da fala, o ditado será automaticamente encerrado e o conteúdo ditado será automaticamente colado no campo que estava focado quando o ditado foi iniciado. || Ativa
|}

===Como exibir os resultados parciais ao ditar um campo para a Cia?===
Ao abrir um programa e executar o comando '''Cia ditar este campo''', é possível visualizar os resultados parciais através de uma tela ou então ter somente a exibição ao finalizar o ditado. Essa configuração é feita através do acesso ao ‘Perfil de Usuários’ na opção: ‘Resultados Parciais em Ditado’, onde possibilita a exibição parcial da informação. Por padrão, a opção vem como Ocultar.

[[Imagem:ImgCia8.png|semmoldura|centro|650px]]
{{VoltarInicio}}

=Go-Global=
A execução do CIGAM em um ambiente de nuvem privada por meio da solução Go-Global permite o acesso remoto a aplicativos Windows de qualquer local, plataforma e sistema operacional. No entanto, essa implementação apresenta algumas particularidades que requerem atenção, especialmente no que se refere a comandos de voz, fala e ditado na Cia, os quais possuem restrições. 
 
'''Lista de particularidades'''
* Sem suporte para tráfego de áudio, exceto bipes;
 
* Sem suporte para microfone ou caixas de som – apesar de esses dispositivos poderem permanecer ativos no Windows, eles não funcionarão devido à ausência de suporte para tráfego de áudio;
 
* Sem suporte para reconhecimento ou sintetização de voz em texto, o que impede a utilização e atualização das funcionalidades da Cia relacionadas a comandos de voz, fala e ditado.
{{VoltarInicio}}

=Documentos Relacionados=
[[GE - Como Fazer - Uso da Cia - IA do CIGAM]] 
[[GE - Como Fazer - Configuração da Cia IA do CIGAM]]

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-10-16T13:44:48Z

Roger.schneider: /* Conversar com documentos */

{{VoltarPagina}}
 
[[categoria:Como_Fazer_Utilidades/Diversos]]
[[categoria:Como_Fazer_Utilidades/Diversos_6]]
[[MediaWiki:Como_Fazer_sidebar|Como Fazer]] > [[Como_Fazer_Utilidades/Diversos|Utilidades/Diversos]] > [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer - Uso da Cia - IA do CIGAM]]

=Recursos, configurações e segurança=
A Cia - IA do CIGAM oferece diversas funcionalidades e atua como um hub centralizador para os recursos de inteligência artificial utilizados nas soluções CIGAM. Para garantir o correto funcionamento desses recursos, é necessário verificar se os pré-requisitos e as configurações foram realizados adequadamente. Para mais informações, consulte: [[GE - Como Fazer - Configuração da Cia IA do CIGAM|Como Fazer configuração da Cia IA do CIGAM]]
 
Todas as soluções de IA do CIGAM são integradas por meio dos serviços da Cia. A Cia possui integração com diferentes provedores de IA de terceiros, como OpenAI, Google, Anthropic, entre outros. Essas integrações são realizadas por meio de contas e serviços contratados, com condições de uso que asseguram que os dados trafegados não sejam utilizados para treinamento dos modelos, identificação de origem, publicidade, anúncios ou qualquer outra finalidade não prevista.
 
No caso de IAs open-source integradas à Cia, os modelos são executados dentro dos domínios da CIGAM, mantendo as mesmas premissas aplicadas às IAs contratadas: não utilização dos dados para treinamento de modelos, não identificação da origem das informações e ausência de retenção dos dados processados.
 
Além disso, sempre que houver envio explícito de dados pelo usuário por meio das funcionalidades da Cia disponíveis nas soluções CIGAM, será apresentado um diálogo de confirmação, permitindo que o usuário aceite o envio dessas informações. Os dados enviados serão tratados conforme as mesmas diretrizes de segurança, privacidade e não retenção descritas anteriormente.
 
Esta documentação apresenta o uso da Cia e está organizada conforme a forma de acesso: [[#Cia Web (SaaS)|Cia Web (SaaS)]], [[#Portais|Portais]] e [[#Desktop|Desktop]].
 
Caso tenha dúvidas sobre onde encontrar a Cia em cada uma dessas plataformas, ou sobre quais ferramentas do CIGAM possuem recursos integrados a ela, consulte a documentação específica de acesso: [[GE - Como Fazer - Cia - Como acessar|Como Fazer - Cia - Como acessar]]
{{VoltarInicio}}

=Cia Web (SaaS)=
A Cia Web é a aplicação web que centraliza todas as funcionalidades da Cia. Ela pode ser acessada diretamente pelo navegador do seu computador ou dispositivo móvel, ou ainda a partir do Desktop e dos Portais, sem a necessidade de novo login.
 

<center><youtube>https://youtu.be/DFGtRtPF75A</youtube></center>
 

==Primeiro acesso==
A Cia Web pode ser acessada diretamente pelo navegador, utilizando o seguinte endereço: https://services.cigam.cloud/cia/index.html
 
'''Importante:''' o usuário que for realizar o login precisa ter a autenticação em duas etapas habilitada. Para saber como configurá-la, consulte: [[GE - Como Fazer - Configuração da Cia IA do CIGAM#Autenticação em duas etapas e configurações de envio de e-mail|Autenticação em duas etapas e configurações de envio de e-mail]]
 
Ao acessar pelo endereço, será necessário preencher algumas informações para que a Cia consiga validar seu acesso e consultar seus dados: 
* Informar a API do seu CIGAM Server, para garantir o direcionamento correto da base de dados. 

[[Imagem:CiaAPI.png|semmoldura|center|700px]] 

* Informar usuário e senha de login e seu código de verificação: 

[[Imagem:CiaLogin.png|semmoldura|center|700px]]
 
[[Imagem:CiaCodVerif.png|semmoldura|center|700px]] 

* Caso não queira aguardar ou informar o código de verificação, você pode optar por responder à pergunta secreta, clicando no botão “Pergunta Secreta” exibido na imagem acima. 

[[Imagem:CiaLoginA2F.png|semmoldura|center|700px]]
 

==Conhecendo a tela da Cia==
Após realizar o login, a Cia carregará automaticamente as informações e dados necessários do ambiente e será iniciada no assunto '''#Geral''', identificado pelo botão localizado à esquerda da caixa de texto.

[[Imagem:CiaGeral.png|semmoldura|center|700px]]
 
Ao clicar nesse botão, será exibida uma lista com todos os assuntos disponíveis, permitindo que você selecione aquele com o qual deseja interagir. 
Além disso, você pode digitar diretamente na caixa de texto o '''#Assunto''' que deseja utilizar, e a Cia entenderá automaticamente o tema da sua mensagem. 
Também é possível '''formular uma pergunta seguida de um #Assunto''' para interagir com qualquer assunto, mesmo que ele não esteja selecionado no momento.

[[Imagem:CiaAberta.png|semmoldura|center|700px]]
 
Ao selecionar um assunto, serão exibidas automaticamente dicas e sugestões sobre o tema escolhido, além de exemplos clicáveis que, ao serem selecionados, são processados de forma imediata. 
Além disso, ao digitar um ponto de interrogação (?) na caixa de texto, será exibida uma lista com todas as interações disponíveis para o assunto selecionado, facilitando a descoberta de comandos e possibilidades de uso.

[[Imagem:CiaDicas.png|semmoldura|center|700px]]
 
Outra funcionalidade prática é a possibilidade de reenviar perguntas já feitas no chat. Para isso, basta posicionar o mouse sobre a pergunta desejada e clicar no ícone de “Reenviar”. Ao passar o mouse sobre a mensagem, também será exibido o horário de envio.
 
[[Imagem:CiaReenviar.png|semmoldura|center|400px]]
 
Além disso, você pode utilizar as setas do teclado (⬆️ para cima e ⬇️ para baixo) na caixa de texto para navegar pelas últimas perguntas enviadas para o #Assunto selecionado, facilitando o reuso de interações anteriores.

===Ícones da caixa de texto===
Na caixa de texto, você encontrará alguns ícones com as seguintes funções:

<center>
{| class="wikitable"
|-
! !! Ação
|-
|center|[[Imagem:CiaUltPerg.png]] || '''Histórico de Perguntas''' – Ao clicar, é exibido o histórico das perguntas já realizadas para o assunto selecionado.
|-
|center|[[Imagem:CiaEnviar.png]] || '''Enviar''' – Envia o conteúdo digitado na caixa de texto.
|-
|center|[[Imagem:CiaFala.png]] || '''Falar''' – Permite falar ao invés de digitar, usando o recurso de voz.
|-
|center|[[Imagem:CiaExpandir.png]] || '''Expandir''' – Aumenta a altura da caixa de texto para facilitar a digitação de mensagens longas.
|-
|center|[[Imagem:CiaRecolher.png]] || '''Recolher''' – Reduz a caixa de texto ao tamanho padrão.
|}
</center>
{{VoltarInicio}}

==Assuntos disponíveis==

===Geral===
Nesse assunto, é possível conversar livremente com a Cia sobre qualquer um dos assuntos disponíveis. Se encontrar dificuldades para obter a resposta desejada, experimente selecionar um assunto específico, o que pode gerar resultados mais precisos. 
Se houver muitas respostas correspondentes, a Cia não executará nenhuma automaticamente. Em vez disso, exibirá uma opção com os valores possíveis, permitindo que você selecione manualmente a melhor alternativa.

[[Imagem:CiaGeralOpcoes.png|semmoldura|center|700px]]
 
Caso a Cia encontre uma resposta com confiança significativamente maior que as demais, ela será executada automaticamente.
 
No entanto, se você selecionar a opção “Não era bem isso o que eu queria”, a Cia exibirá outras opções relacionadas ao que foi solicitado, apresentando também um indicador de semáforo com a porcentagem de confiança de cada alternativa.

[[Imagem:CiaGeralOpcaoCerta.png|semmoldura|center|600px]]

===Ajuda, Vídeos e Auditor===
Conheça melhor o ERP com a ajuda da Wiki e Cia, assista vídeos sobre o CIGAM e audite seu ambiente.

====Ajuda====
Nesse assunto, você pode acessar o Chatbot da assistente virtual, onde você pode tirar dúvidas e consultar conteúdos da CIGAM Wiki enviando perguntas diretamente nela. 
 
'''Importante:''' neste assunto, a Cia atua dedicada à Wiki, focada exclusivamente nos conteúdos da documentação. As demais funcionalidades e atalhos da Cia não estarão disponíveis nesse contexto.

====Vídeos====
Nesse assunto, é possível procurar por vídeos relacionados ao tema desejado. O resultado será apresentado em forma de lista, contendo os vídeos encontrados e os tempos exatos em que o assunto começa a ser abordado, de acordo com o termo ou palavra pesquisada.

====Auditor====
Neste assunto, é possível verificar o status do sistema e identificar possíveis problemas ou inconsistências. O resultado será exibido em forma de tabela, contendo os dados retornados para facilitar a análise.

===Painéis BI, Portais e Relatórios===
Explore dashboards do BI, interaja com Portais intuitivos e execute relatórios personalizados.

====Painéis BI====
Nesse assunto, é possível abrir dashboards do BI já configurados para o usuário, permitindo sua visualização diretamente na tela.
Ao abrir um dashboard, você também pode interagir com ele, solicitando inserção de filtros, dimensões, métricas, transformações e outros ajustes. 
Cada dashboard aberto exibirá uma guia com as “Interações” disponíveis para aquele painel específico.
 
Além disso, ao selecionar o assunto '''#Painéis do BI''', é possível solicitar que a Cia crie um dashboard do zero.
Por exemplo: "Crie um dashboard para ver meu fluxo de caixa". Você pode ainda solicitar que métricas, dimensões e filtros sejam adicionados durante a criação, ou pedir dashboards separados por áreas.
 
'''Importante:''' caso o usuário não possua acesso ao BI ou este não esteja implementado na base de dados, será exibida uma mensagem informativa no momento do login na Cia.

====Portais====
Quando este assunto é utilizado, o resultado será sempre a abertura de uma tela dos Portais, permitindo ao usuário acessar diretamente os conteúdos e funcionalidades disponíveis nesse ambiente.
 
Essa abertura é feita de forma integrada, garantindo uma navegação contínua entre a Cia e os Portais, sem necessidade de realizar novo login ou sair da plataforma.

====Relatórios====
Ao utilizar esse assunto, será exibida uma tela para preenchimento de filtros, permitindo a emissão de relatórios web.
 
Para que essa funcionalidade opere corretamente, é necessário garantir que a instalação da CDN e da Pesquisa Dinâmica no servidor de aplicação esteja configurada de forma adequada.
 
Os relatórios exibidos aqui são os mesmos disponíveis nos Portais CIGAM, portanto é essencial que esses componentes também estejam funcionando corretamente nesses Portais.

===Qual, Faça, Consultar, Listar, Analisar e Insights===
Crie registros, analise informações ou liste dados cadastrados no CIGAM.

====Qual====
Nesse assunto, a Cia vai consultar e processar informações diretamente no ERP, usando os dados e relacionamentos disponíveis no CIGAM, e retornar os resultados em forma de texto para você visualizar.
 
'''Importante:''' nem todas as opções estão liberadas. Para ver quais você pode usar, digite ? na caixa de texto. A Cia vai mostrar uma lista com todos os comandos e funções disponíveis.

====Faça====
Nesse assunto, a Cia sempre fará um processamento no CIGAM e retornará o status do resultado. Por exemplo, você pode solicitar que a Cia crie um alerta ou até mesmo crie uma nova empresa no sistema.
 
'''Dica:''' para saber quais treinamentos ou comandos estão disponíveis, digite ? na caixa de texto. A Cia mostrará uma lista com todas as opções implementadas para você usar.

====Consultar====
Nesse assunto, você poderá fazer consultas de dados para obter listagens de registros, conforme os treinamentos de tabelas disponíveis. O resultado será apresentado em forma de tabela, exibindo os dados retornados. Já existem diversas Views prontas, para que você possa listar informações de forma mais completa e rápida.
 
'''Dica:''' para ver exemplos de consultas já implementadas, digite ? na caixa de texto.

====Listar====
Nesse assunto, você pode montar sua própria consulta de dados, escolhendo os filtros e parâmetros para gerar uma listagem personalizada. Diferente do assunto #Consultar, aqui é possível utilizar qualquer tabela do CIGAM para montar sua consulta, escrevendo em linguagem natural o que deseja buscar.
 
'''Dica:''' para ver todas as tabelas disponíveis, digite ? na caixa de texto.

====Analisar====
Analise o arquivo selecionado para gerar gráficos interativos e informativos, apresentando insights relevantes que ajudam a identificar tendências, padrões e oportunidades de melhoria.
 
Esse recurso oferece uma visualização clara e intuitiva dos dados, facilitando a interpretação das informações e apoiando a tomada de decisões estratégicas.
 
'''Aviso:''' para utilizar esta funcionalidade, é necessário concordar que os dados enviados serão processados por modelos de IA de terceiros integrados à Cia.

[[Imagem:AnalisarCia.png|semmoldura|center|600px]]

====Insights====
Gere insights inteligentes a partir dos dados de uma consulta, com análises automáticas realizadas pela Cia, que identificam padrões, tendências e possíveis pontos de atenção. Esse recurso ajuda a transformar dados brutos em informações acionáveis, facilitando a tomada de decisões estratégicas e otimizando processos.
 
'''Aviso:''' ao utilizar o assunto “Insights”, você concorda que os dados e informações analisados poderão ser enviados para modelos de IA de terceiros integrados à Cia, exclusivamente para processamento e geração dos resultados apresentados.

===IA Generativa e Pesquisa na Internet===
Converse com a IA sobre assuntos diversos, crie conteúdos e pesquise na internet sobre qualquer coisa.

====IA Generativa====
Nesse assunto, ao interagir com a IA Generativa, você poderá fazer qualquer tipo de pergunta ou solicitação, de forma livre e criativa.
O resultado exibido será exatamente a resposta gerada pela IA, sem complementos da Cia. Você pode, por exemplo, solicitar que a IA melhore ou reformule um texto, crie conteúdos ou resuma informações.
 
'''Importante:''' nesse assunto, a Cia não estará integrada aos serviços e sistemas do CIGAM — a interação é exclusivamente com a IA Generativa.

====Pesquisa na Internet====
Use esse assunto para fazer pesquisas na internet e visualizar os resultados diretamente integrados na Cia, sem precisar sair da plataforma. Você pode pesquisar qualquer tema de interesse e abrir os links retornados para acessar conteúdos, notícias e informações de forma rápida e prática.
{{VoltarInicio}}

===Compartilhamento de Análises da Cia===

 
<div align="justify">
Na Cia Web (SaaS), é possível gerar análises detalhadas de determinadas informações e compartilhá-las. Essa funcionalidade está disponível nos seguintes assuntos: [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Auditor|Auditor]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Analisar|Analisar]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Insights|Insights]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Listar|Listar]] e [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Consultar|Consultar]].
</div>
 

[[Image: opcoesAnalisarCia.png|semmoldura|center|800px]]

 
<div align="justify">
Essa opção está disponível por meio do botão '''Analisar''', exibido junto à resposta apresentada após a solicitação de um desses assuntos.
</div>
 

[[Image: exemploBotaoAnalisar.png|semmoldura|center|800px]]

 
<div align="justify">
Particularmente para o assunto '''Analisar''', a análise já é exibida diretamente, pois essa é a finalidade desse assunto:
</div>
 

[[Image: analiseAnalisar.png|semmoldura|center|800px]]

 
<div align="justify">
Ao gerar uma análise , a página de resultado passa a disponibilizar opções para compartilhar e utilizar o conteúdo gerado. São disponibilizadas três opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.
</div>
 

[[Image: CiaWebAnalise.png|semmoldura|center|800px]]

=====Compartilhamento por e-mail=====

<div align="justify">
Ao selecionar a opção '''E-mail''', é apresentada uma janela para preenchimento das informações necessárias ao envio da análise.
</div>
 

[[Image: CiaWebModalEmail.png|semmoldura|center|800px]]

 
<div align="justify">
Após informar os destinatários e os demais dados da mensagem, basta selecionar '''Enviar'''. A análise gerada será encaminhada como um arquivo em anexo.

Para utilizar esse recurso, o ambiente deve possuir as configurações necessárias para envio de e-mails pelo CIGAM devidamente parametrizadas. Para mais informações, consulte [[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]].
</div>

==Configurações==
O ícone de engrenagem, localizado no canto superior direito da página, reúne recursos de informação e gerenciamento. As opções disponíveis são:
* '''Respostas com áudio:''' quando ativado, as respostas da Cia são narradas em voz alta.
* '''Ambiente atual do CIGAM:''' exibe na tela o usuário logado e o ambiente em uso.
* '''Ver consumo:''' mostra a quantidade de tokens já utilizados e os usuários que geraram consumo.
* '''Limpar dados de navegação:''' exibe uma mensagem explicando como limpar os dados de navegação do navegador.
* '''Limpar cookies:''' apaga os dados armazenados localmente, permitindo informar novamente a API e realizar um novo login.
* '''Instalar aplicativo:''' instala a Cia como aplicativo no dispositivo, criando um atalho na tela inicial.
* '''Documentação na wiki:''' direciona para a documentação da Cia na CIGAM Wiki.
* '''Sair:''' encerra a sessão do usuário, permitindo realizar login com outro usuário.
 
[[Imagem:ConfiguracoesCia.png|semmoldura|center|500px]]
{{VoltarInicio}}

=Portais=
Nos Portais CIGAM, além do acesso à Cia Web pelo menu de mosaico, estão disponíveis recursos de IA que atuam diretamente nas telas em que você está trabalhando. Esses recursos não exigem parametrização e são apresentados de acordo com o contexto da tela. 

==Acesso à Cia Web (SaaS) pelo menu mosaico==
O acesso à Cia Web a partir dos Portais é feito pelo ícone de mosaico, onde está disponível o ícone da Cia - IA do CIGAM. 
 
[[Imagem:mosaicoCia.png|semmoldura|center|800px]]
 
A Cia será aberta de forma integrada, sem a necessidade de novo login, e todas as funcionalidades descritas na seção [[#Cia Web (SaaS)|Cia Web (SaaS)]] estarão disponíveis normalmente. 

==Geração de conteúdo==
Na barra superior dos Portais está disponível um ícone com um menu de contexto que permite interagir com os '''campos de texto''' de qualquer parte dos Portais. As opções disponíveis permitem melhorar textos, criar conteúdos, revisar a gramática, entre outras ações. 
 
[[Imagem:comandosCia.png|semmoldura|center|650px]]
 
A partir da versão '''Beta 260601''', essas opções passaram a ser exibidas em uma seção separada, chamada '''Geração de conteúdo''', apresentada no mesmo menu em que ficam os agentes. 
 
[[Imagem:MenuGeracaoConteudoAgentes.png|semmoldura|center|800px]]
 
O campo processado é sempre o '''último campo em que o cursor esteve posicionado''' antes de abrir o menu da Cia. Por isso, basta clicar no campo desejado e, em seguida, acionar o menu e escolher o comando. 
 
Para que o comando seja executado, o campo precisa ser um '''campo de texto válido''' e conter, no mínimo, '''três palavras'''. Caso contrário, será apresentada uma mensagem informando que o conteúdo não atende aos requisitos. 
 
Após o processamento, o conteúdo gerado é aplicado automaticamente no campo, substituindo o texto anterior, sem necessidade de confirmação. 
 
Essa funcionalidade também está disponível em telas modais, ou seja, janelas sobrepostas com interações: 
 
[[Imagem:comandosModalCia.png|semmoldura|center|800px]]
 

==Agentes==
A partir da versão '''Beta 260601''', o menu da Cia nos Portais passou a disponibilizar também o acesso aos agentes, tanto nos Portais MVC quanto nos Portais React. 
 
Ao abrir o menu da Cia, os agentes disponíveis são detectados automaticamente de acordo com a tela que está sendo acessada, ou seja, as opções apresentadas variam conforme a página aberta. 
 
[[Imagem:MenuAgentesCia.png|semmoldura|center|800px]]
 

===Como os agentes são disponibilizados===
A disponibilização de cada agente pode ocorrer de quatro formas: 
 
* '''Por contexto:''' o agente é apresentado quando a Cia identifica que a tela acessada corresponde ao assunto tratado por ele. Por exemplo, um agente sobre Ordem de Produção será disponibilizado ao acessar uma página cujo contexto seja identificado como Ordem de Produção.
 
* '''Por parâmetro:''' o agente é apresentado quando a Cia identifica, na tela, um parâmetro com o valor esperado por ele. Por exemplo, um agente de Pedidos será disponibilizado quando existir na tela um parâmetro que contenha o código do pedido.
 
* '''Por contexto e parâmetro:''' o agente é apresentado somente quando as duas condições forem atendidas ao mesmo tempo.
 
* '''Sempre disponível:''' o agente é apresentado em qualquer tela, independentemente do contexto ou dos parâmetros.
 

===Resultado do processamento===
Após o processamento, o retorno do agente pode ser apresentado de duas formas, conforme o que foi executado: 
 
* Em uma '''nova guia''' do navegador, quando o agente gera algum conteúdo ou relatório como resultado.
 
[[Imagem:AgentesRetornoGuia.png|semmoldura|center|800px]]
 
* Em uma '''janela modal''', dentro da própria página em que o usuário está, quando o retorno é uma mensagem.
 
[[Imagem:AgentesRetornoModal.png|semmoldura|center|800px]]
 
<div align="justify>
A partir da versão '''Beta 261005''', quando o resultado do agente é apresentado em uma nova guia, a página passa a disponibilizar também opções para utilização e compartilhamento da análise.
</div>
 
[[Imagem:resultadoAnalise.png|semmoldura|center|800px]]
 
<div align="justify">
No cabeçalho são apresentados o nome do agente executado e as opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.
</div>
<div align="justify">
=====Compartilhamento por e-mail=====
A janela abaixo é exibida quando selecionada a opção '''E-mail''':
</div>
 
[[Imagem:modalEmail.png|semmoldura|center|800px]]
 
<div align="justify">

Para utilizar esse recurso, o ambiente deve possuir as configurações necessárias para envio de e-mails pelo CIGAM devidamente parametrizadas. Para mais informações, consulte [[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]].
</div>

==Editor de Agentes==
A partir da versão '''Beta 261005''', o menu passou a disponibilizar o acesso à ferramenta '''Editor de Agentes''', que permite criar seus próprios agentes. 
 
[[Imagem:EditorAgentesCia.png|semmoldura|center|800px]]
 
Ao clicar na opção, será aberta uma página web no formato de assistente (wizard), com cada etapa explicada de forma detalhada. Basta preencher as informações do agente conforme a sua necessidade e avançar pelos passos até a conclusão. 
 
[[Imagem:EditorAgentesWizard.png|semmoldura|center|800px]]
 
Ao final do processo, será gerado um arquivo com a extensão '''.cgagt''', que contém a definição do agente criado. 
 

===Disponibilizando o agente criado===
Para que o agente passe a ser exibido nos Portais, o arquivo '''.cgagt''' precisa ser colocado na aplicação da API, dentro da pasta raiz da aplicação. 
 
É necessário que existam as pastas '''Exclusivo''' e, dentro dela, '''Agentes'''. Caso não existam, elas devem ser criadas manualmente. O arquivo deve ser colocado dentro dessa estrutura, ficando da seguinte forma: 
 
/api/exclusivo/agentes/
 
Assim que o arquivo é adicionado nesse local, a Cia passa a reconhecer o agente automaticamente, sem necessidade de qualquer outra configuração. Os agentes customizados são exibidos no menu da Cia nos Portais, em uma seção separada dos agentes padrão. 
 
[[Imagem:MenuAgentesCustomizados.png|semmoldura|center|800px]]
 
==Conversar com documentos==
<div align="justify">
A ferramenta de '''Conversar com documentos''' permite analisar, resumir e cruzar informações contidas em arquivos e relatórios através de modelos avançados de Inteligência Artificial integrados ao ERP CIGAM.

O acesso pode ser realizado a partir da tela principal da Cia Web (SaaS), clicando na opção correspondente ou digitando o assunto <code>#Documentos</code>, momento em que a aplicação é aberta em uma nova guia do navegador assim que digitada a primeira mensagem.

Além disto, podemos acessar a aplicação através dos Portais CIGAM, conforme descrito em [[GE_-_Como_Fazer_-_Cia_-_Como_acessar#Conversar_com_documentos|Como acessar]].

Para a utilização da aplicação, é necessário estar autenticado com um token de autorização CIGAM e com o endereço da API CIGAM devidamente parametrizado. Logo ao abrir, o sistema avalia o ambiente e valida a sessão do usuário em tempo real.

Estando os parâmetros validados, será gerado automaticamente um ID de conversação (''Conversation ID'') exclusivo para a sessão. Esta identificação é armazenada em cookies do navegador com validade de 24 horas, permitindo que a Cia armazene e mantenha o contexto contínuo de todas as mensagens e documentos anexados. Caso a página seja atualizada ou fechada dentro deste período, a sessão conectada e os arquivos são recuperados automaticamente.

 
<center>[[Arquivo:cia_conv_docs_01.png|nenhum|750px]]</center>
 

No primeiro acesso, é obrigatório marcar a opção '''Termo de consentimento''' para indicar ciência de que os dados e documentos selecionados para análise serão enviados aos modelos de IA de terceiros integrados com a Cia. Por segurança e conformidade, os campos de envio e a área de anexos permanecem bloqueados até que o consentimento seja confirmado. Uma vez aceito, uma mensagem de registro é inserida no histórico da conversa e a preferência é memorizada para a sessão.

Após confirmar o termo, a área de upload no painel lateral esquerdo é habilitada, permitindo anexar múltiplos arquivos simultaneamente, seja arrastando e soltando os documentos sobre a área de dropzone, seja clicando sobre ela para abrir a janela de seleção de arquivos.

A ferramenta suporta uma ampla variedade de formatos corporativos:
*'''Documentos de Texto e Portáteis:''' PDF (<code>.pdf</code>), Texto Simples (<code>.txt</code>), Word (<code>.doc</code>, <code>.docx</code>).
*'''Planilhas e Dados Tabulares:''' Planilhas Excel (<code>.xlsx</code>, <code>.xls</code>), Valores Separados por Vírgula (<code>.csv</code>).
*'''Arquivos de Estrutura de Dados:''' Arquivos <code>.json</code> e <code>.xml</code>.
*'''Imagens:''' Formatos de imagem (<code>.png</code>, <code>.jpg</code>, <code>.jpeg</code>, etc.).

No painel lateral, é possível visualizar o contador total de documentos anexados, o ícone específico do formato, o nome, o tamanho do arquivo formatado e a indicação de que o documento encontra-se ativo no contexto da conversa. Em dispositivos móveis ou telas menores, o painel lateral pode ser recolhido ou expandido através do botão retrátil no topo da barra.

Uma vez enviados para análise, os documentos permanecem registrados no contexto da conversa no servidor, não sendo necessário reenviá-los a cada nova pergunta. Caso deseje substituir ou remover os arquivos analisados, deve-se reiniciar o contexto através da opção de limpeza da conversa.

 
<center>[[Arquivo:cia_conv_docs_02.png|nenhum|750px]]</center>
 

Clicando no ícone da engrenagem localizado no canto superior direito da tela, temos acesso ao menu de opções e configurações da ferramenta:

*'''Modelo de IA:''' Permite selecionar o modelo de Inteligência Artificial desejado para o processamento documental (ex.: GPT-5.4 Recomendado, GPT-5.4 Mini, GPT-5.2 Alta Precisão, GPT-5.1 Raciocínio, GPT-4.1 Análise Documental, GPT-4o Versátil, GPT-4o Mini Econômico). A lista de modelos é atualizada dinamicamente a partir dos serviços disponíveis na Cia.
*'''Usuário Conectado:''' Exibe os dados do usuário autenticado no ERP CIGAM, incluindo nome, empresa (razão social / fantasia) e código de usuário.
*'''Ambiente & Sessão CIGAM:''' Apresenta o tipo de ambiente (produção ou depuração) e a URL da API CIGAM conectada, acompanhado de um botão de cópia rápida para facilitar diagnósticos e solicitações de suporte técnico.
*'''ID da Conversa Ativa:''' Exibe o identificador único da sessão com indicador visual de status em tempo real e botão para copiar o código do ID diretamente para a área de transferência.
*'''Limpar conversa:''' Permite reiniciar o contexto da conversa. Ao acionar esta opção, um balão interativo de confirmação é apresentado no histórico do chat (com as opções ''Limpar Conversa'' ou ''Cancelar''). Ao confirmar, o sistema solicita a exclusão da conversa no serviço da OpenAI para evitar registros órfãos, remove os documentos e cookies locais e gera um novo ID de conversação limpo.
*'''Documentação na wiki:''' Atalho que direciona diretamente aos manuais e guias de uso na CIGAM Wiki.

 
<center>[[Arquivo:cia_conv_docs_03.png|nenhum|750px]]</center>
 

Com os documentos anexados, podemos enviar perguntas e comandos no campo inferior para obter resumos executivos, explicações pontuais, cruzamento de dados entre arquivos distintos, localização de inconsistências ou extração de indicadores. Caso enviemos os arquivos sem digitar nenhuma mensagem complementar, a Cia aplicará o prompt de sistema padrão para realizar uma leitura analítica e retornar um resumo estruturado dos documentos.

O sistema dispõe de diretrizes de sistema corporativas (''System Prompt'') integradas ao ecossistema do ERP CIGAM, orientando o modelo a analisar com fidelidade os dados fornecidos, sem inventar informações ausentes.

Também é disponibilizado o recurso de '''Reconhecimento de Voz''' através do ícone de microfone (habilitado em conexões seguras HTTPS). O recurso conta com reconhecimento inteligente de pontuação falada: ao ditar expressões como ''"vírgula"'', ''"ponto"'', ''"ponto e vírgula"'', ''"dois pontos"'', ''"interrogação"'', ''"exclamação"'', ''"hífen"'', ''"abre parênteses"'', ''"fecha parênteses"'' ou ''"nova linha"'', os termos são automaticamente substituídos pelos respectivos sinais gráficos e as frases são capitalizadas de forma automática.

 
<center>[[Arquivo:cia_conv_docs_04.png|nenhum|750px]]</center>
 

As respostas retornadas pela Cia contam com formatação Markdown avançada, estruturando o conteúdo em títulos hierárquicos, listas ordenadas ou em tópicos, citações em bloco e tabelas responsivas estilizadas.

Além disso, sempre que a análise envolver dados numéricos comparativos, demonstrativos contábeis/financeiros (como DRE, receitas e despesas), séries temporais ou valores tabulares, a Cia gera automaticamente gráficos visuais e interativos integrados diretamente na resposta:
*'''Tipos de Gráficos Gerados:''' Barras verticais, linhas de tendência, gráficos de pizza e rosca, estilizados na paleta de cores oficial da Cia e com valores numéricos formatados no padrão brasileiro (pt-BR).
*'''Exportação do Gráfico:''' Cada card de gráfico possui um botão de download no canto superior direito, permitindo baixar a imagem em formato PNG em alta resolução para inclusão imediata em relatórios, apresentações ou envio por e-mail.

 
<center>[[Arquivo:cia_conv_docs_05.png|nenhum|750px]]</center>
 

Podemos manter uma conversa contínua com diversos documentos e mensagens em múltiplos turnos de diálogo. A Cia preserva o histórico de perguntas e respostas anteriores, permitindo aprofundar análises, solicitar detalhamentos de itens específicos ou anexar novos arquivos complementares ao longo da conversa.

</div>
{{VoltarInicio}}

=Desktop=
Na aplicação Desktop, além do acesso rápido à Cia Web, algumas ferramentas do sistema disponibilizam o recurso "Analisar com a Cia". 

==Acesso rápido à Cia Web (SaaS)==
O botão de acesso rápido (Cia - IA do CIGAM), disponível no menu lateral do Desktop, abre a Cia Web de forma integrada ao sistema, em uma janela do próprio CIGAM. 
 
Desde que as configurações necessárias tenham sido aplicadas, conforme [[GE - Como Fazer - Configuração da Cia IA do CIGAM#Acesso rápido à Cia Web (SaaS)|Acesso rápido à Cia Web (SaaS)]], '''todas as funcionalidades da Cia Web estarão disponíveis normalmente''', da mesma forma que no acesso pelo navegador. Para conhecê-las, consulte a seção [[#Cia Web (SaaS)|Cia Web (SaaS)]] desta documentação. 
 
[[Imagem:CiaAbertaDesktop.png|semmoldura|center|800px]]
 

==Recurso "Analisar com a Cia"==
O recurso '''"Analisar com a Cia"''' está disponível em ferramentas como CGEditor, CGReport, Pesquisa Dinâmica e Dispositivo de Saída. Em todas elas, o comportamento é o mesmo: a Cia analisa o conteúdo que está em uso na tela e gera um relatório com o resultado da análise, apresentado em uma nova página. 
 
Ao acionar a opção, o fluxo é o seguinte: 
 
'''1. Confirmação dos termos de uso''' 
Antes de qualquer envio, será exibida uma mensagem solicitando que o usuário concorde com o envio das informações para análise. Os dados enviados seguem as diretrizes de segurança, privacidade e não retenção descritas em [[#Recursos, configurações e segurança|Recursos, configurações e segurança]]. 
 
[[Imagem:AnalisarCiaTermos.png|semmoldura|center|500px]]
 
'''2. Complemento do prompt (opcional)''' 
Em seguida, será apresentada uma caixa de texto para que o usuário complemente a solicitação, orientando a análise para algum ponto específico. O preenchimento é opcional e pode ser deixado em branco. 
 
Essa caixa de texto serve apenas para complementar o prompt base que a Cia monta automaticamente, e não altera o conteúdo que está sendo enviado. O recurso considera que o usuário já filtrou os dados na própria tela do CIGAM antes de acionar a análise. O prompt base é mantido oculto por ser extenso e técnico, evitando que o usuário precise conferi-lo a cada utilização. 
 
[[Imagem:AnalisarCiaPrompt.png|semmoldura|center|700px]]
 
'''3. Geração do relatório''' 
Após a confirmação, a Cia processa o conteúdo e apresenta o relatório em uma nova página flutuante, com a análise dos dados enviados. 
 
O próprio relatório informa a quantidade de dados que foi analisada, permitindo que o usuário veja o volume aproximado considerado e identifique se o conteúdo enviado corresponde ao que esperava. 
 
[[Imagem:AnalisarCiaRelatorio.png|semmoldura|center|700px]]
 

A partir da versão '''Beta 261005''', o resultado da análise passa a ser apresentado em uma nova janela flutuante, que disponibiliza opções para utilização e compartilhamento do conteúdo gerado. 
 
No cabeçalho dessa janela, são apresentados o título da análise e três opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.

 
[[Imagem:AnalisarCiaDesktopCompartilhar.png|semmoldura|center|800px]]
 

====Compartilhamento por e-mail====

Ao selecionar a opção '''E-mail''', é apresentada uma janela para preenchimento das informações necessárias ao envio da análise. 
 
[[Imagem:AnalisarCiaDesktopEmail.png|semmoldura|center|700px]]
 
Após informar os destinatários e os demais dados da mensagem, basta selecionar '''Enviar'''. A análise gerada será encaminhada como um arquivo em anexo. 
 

===Limite de conteúdo enviado===
Existe um limite para o volume de conteúdo enviado em cada análise, que varia conforme a versão do ambiente: 
 
* '''150 KB''' — desde a disponibilização do recurso, na versão '''250505.a'''.
* '''3 MB''' — a partir das patches '''250505.i''' e '''251103.a''', e da versão '''RC 260504'''.
 
Quando o conteúdo selecionado ultrapassa esse limite, a Cia exibe uma mensagem informando o tamanho excedido e a análise não é processada, ou seja, nenhum relatório será gerado. 
 
[[Imagem:AnalisarCiaLimite.png|semmoldura|center|600px]]
 
'''Esse limite não é parametrizável e não se trata de uma restrição imposta pela CIGAM.''' Ele decorre da própria capacidade dos modelos de IA integrados à Cia, que possuem um limite técnico de volume de dados que conseguem processar em uma única análise. Quando esse volume é ultrapassado, os modelos passam a analisar as informações por amostragem — ou seja, mesmo que fosse permitido enviar uma quantidade maior de dados, o modelo não analisaria todo o conteúdo, e o resultado seria menos preciso. O limite adotado pela Cia acompanha essa característica dos modelos e assegura que a análise seja feita sobre os dados completos. 
 
Além da qualidade da análise, há também a questão do tempo de processamento: quanto maior o volume enviado, maior o tempo de resposta do modelo, tornando a espera inviável para o uso no dia a dia. 
 
Por isso, o recurso foi feito para ser simples e direto: analisar, com um clique, os dados que o usuário já está visualizando pelos meios tradicionais do CIGAM, como grids filtrados e relatórios. Em ambientes com grande volume de dados, a prática recomendada é '''filtrar e consolidar as informações na própria tela antes de acionar a análise''', reduzindo o período ou o escopo consultado. Para análises de períodos maiores, recomenda-se utilizar dados já consolidados, como totalizadores e relatórios sintéticos, em vez de listagens analíticas completas. 
 
A CIGAM está trabalhando em outras ferramentas que, por processarem os dados de forma diferente, permitirão trabalhar com volumes maiores de informação. 

Para saber como acessar o recurso em cada ferramenta, consulte: [[GE - Como Fazer - Cia - Como acessar]]
{{VoltarInicio}}

=Documentos Relacionados=
[[GE - Como Fazer - Cia - Como acessar]] 
[[GE - Como Fazer - Configuração da Cia IA do CIGAM]]

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-10-16T13:39:15Z

Roger.schneider: /* Compartilhamento por e-mail */

{{VoltarPagina}}
 
[[categoria:Como_Fazer_Utilidades/Diversos]]
[[categoria:Como_Fazer_Utilidades/Diversos_6]]
[[MediaWiki:Como_Fazer_sidebar|Como Fazer]] > [[Como_Fazer_Utilidades/Diversos|Utilidades/Diversos]] > [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer - Uso da Cia - IA do CIGAM]]

=Recursos, configurações e segurança=
A Cia - IA do CIGAM oferece diversas funcionalidades e atua como um hub centralizador para os recursos de inteligência artificial utilizados nas soluções CIGAM. Para garantir o correto funcionamento desses recursos, é necessário verificar se os pré-requisitos e as configurações foram realizados adequadamente. Para mais informações, consulte: [[GE - Como Fazer - Configuração da Cia IA do CIGAM|Como Fazer configuração da Cia IA do CIGAM]]
 
Todas as soluções de IA do CIGAM são integradas por meio dos serviços da Cia. A Cia possui integração com diferentes provedores de IA de terceiros, como OpenAI, Google, Anthropic, entre outros. Essas integrações são realizadas por meio de contas e serviços contratados, com condições de uso que asseguram que os dados trafegados não sejam utilizados para treinamento dos modelos, identificação de origem, publicidade, anúncios ou qualquer outra finalidade não prevista.
 
No caso de IAs open-source integradas à Cia, os modelos são executados dentro dos domínios da CIGAM, mantendo as mesmas premissas aplicadas às IAs contratadas: não utilização dos dados para treinamento de modelos, não identificação da origem das informações e ausência de retenção dos dados processados.
 
Além disso, sempre que houver envio explícito de dados pelo usuário por meio das funcionalidades da Cia disponíveis nas soluções CIGAM, será apresentado um diálogo de confirmação, permitindo que o usuário aceite o envio dessas informações. Os dados enviados serão tratados conforme as mesmas diretrizes de segurança, privacidade e não retenção descritas anteriormente.
 
Esta documentação apresenta o uso da Cia e está organizada conforme a forma de acesso: [[#Cia Web (SaaS)|Cia Web (SaaS)]], [[#Portais|Portais]] e [[#Desktop|Desktop]].
 
Caso tenha dúvidas sobre onde encontrar a Cia em cada uma dessas plataformas, ou sobre quais ferramentas do CIGAM possuem recursos integrados a ela, consulte a documentação específica de acesso: [[GE - Como Fazer - Cia - Como acessar|Como Fazer - Cia - Como acessar]]
{{VoltarInicio}}

=Cia Web (SaaS)=
A Cia Web é a aplicação web que centraliza todas as funcionalidades da Cia. Ela pode ser acessada diretamente pelo navegador do seu computador ou dispositivo móvel, ou ainda a partir do Desktop e dos Portais, sem a necessidade de novo login.
 

<center><youtube>https://youtu.be/DFGtRtPF75A</youtube></center>
 

==Primeiro acesso==
A Cia Web pode ser acessada diretamente pelo navegador, utilizando o seguinte endereço: https://services.cigam.cloud/cia/index.html
 
'''Importante:''' o usuário que for realizar o login precisa ter a autenticação em duas etapas habilitada. Para saber como configurá-la, consulte: [[GE - Como Fazer - Configuração da Cia IA do CIGAM#Autenticação em duas etapas e configurações de envio de e-mail|Autenticação em duas etapas e configurações de envio de e-mail]]
 
Ao acessar pelo endereço, será necessário preencher algumas informações para que a Cia consiga validar seu acesso e consultar seus dados: 
* Informar a API do seu CIGAM Server, para garantir o direcionamento correto da base de dados. 

[[Imagem:CiaAPI.png|semmoldura|center|700px]] 

* Informar usuário e senha de login e seu código de verificação: 

[[Imagem:CiaLogin.png|semmoldura|center|700px]]
 
[[Imagem:CiaCodVerif.png|semmoldura|center|700px]] 

* Caso não queira aguardar ou informar o código de verificação, você pode optar por responder à pergunta secreta, clicando no botão “Pergunta Secreta” exibido na imagem acima. 

[[Imagem:CiaLoginA2F.png|semmoldura|center|700px]]
 

==Conhecendo a tela da Cia==
Após realizar o login, a Cia carregará automaticamente as informações e dados necessários do ambiente e será iniciada no assunto '''#Geral''', identificado pelo botão localizado à esquerda da caixa de texto.

[[Imagem:CiaGeral.png|semmoldura|center|700px]]
 
Ao clicar nesse botão, será exibida uma lista com todos os assuntos disponíveis, permitindo que você selecione aquele com o qual deseja interagir. 
Além disso, você pode digitar diretamente na caixa de texto o '''#Assunto''' que deseja utilizar, e a Cia entenderá automaticamente o tema da sua mensagem. 
Também é possível '''formular uma pergunta seguida de um #Assunto''' para interagir com qualquer assunto, mesmo que ele não esteja selecionado no momento.

[[Imagem:CiaAberta.png|semmoldura|center|700px]]
 
Ao selecionar um assunto, serão exibidas automaticamente dicas e sugestões sobre o tema escolhido, além de exemplos clicáveis que, ao serem selecionados, são processados de forma imediata. 
Além disso, ao digitar um ponto de interrogação (?) na caixa de texto, será exibida uma lista com todas as interações disponíveis para o assunto selecionado, facilitando a descoberta de comandos e possibilidades de uso.

[[Imagem:CiaDicas.png|semmoldura|center|700px]]
 
Outra funcionalidade prática é a possibilidade de reenviar perguntas já feitas no chat. Para isso, basta posicionar o mouse sobre a pergunta desejada e clicar no ícone de “Reenviar”. Ao passar o mouse sobre a mensagem, também será exibido o horário de envio.
 
[[Imagem:CiaReenviar.png|semmoldura|center|400px]]
 
Além disso, você pode utilizar as setas do teclado (⬆️ para cima e ⬇️ para baixo) na caixa de texto para navegar pelas últimas perguntas enviadas para o #Assunto selecionado, facilitando o reuso de interações anteriores.

===Ícones da caixa de texto===
Na caixa de texto, você encontrará alguns ícones com as seguintes funções:

<center>
{| class="wikitable"
|-
! !! Ação
|-
|center|[[Imagem:CiaUltPerg.png]] || '''Histórico de Perguntas''' – Ao clicar, é exibido o histórico das perguntas já realizadas para o assunto selecionado.
|-
|center|[[Imagem:CiaEnviar.png]] || '''Enviar''' – Envia o conteúdo digitado na caixa de texto.
|-
|center|[[Imagem:CiaFala.png]] || '''Falar''' – Permite falar ao invés de digitar, usando o recurso de voz.
|-
|center|[[Imagem:CiaExpandir.png]] || '''Expandir''' – Aumenta a altura da caixa de texto para facilitar a digitação de mensagens longas.
|-
|center|[[Imagem:CiaRecolher.png]] || '''Recolher''' – Reduz a caixa de texto ao tamanho padrão.
|}
</center>
{{VoltarInicio}}

==Assuntos disponíveis==

===Geral===
Nesse assunto, é possível conversar livremente com a Cia sobre qualquer um dos assuntos disponíveis. Se encontrar dificuldades para obter a resposta desejada, experimente selecionar um assunto específico, o que pode gerar resultados mais precisos. 
Se houver muitas respostas correspondentes, a Cia não executará nenhuma automaticamente. Em vez disso, exibirá uma opção com os valores possíveis, permitindo que você selecione manualmente a melhor alternativa.

[[Imagem:CiaGeralOpcoes.png|semmoldura|center|700px]]
 
Caso a Cia encontre uma resposta com confiança significativamente maior que as demais, ela será executada automaticamente.
 
No entanto, se você selecionar a opção “Não era bem isso o que eu queria”, a Cia exibirá outras opções relacionadas ao que foi solicitado, apresentando também um indicador de semáforo com a porcentagem de confiança de cada alternativa.

[[Imagem:CiaGeralOpcaoCerta.png|semmoldura|center|600px]]

===Ajuda, Vídeos e Auditor===
Conheça melhor o ERP com a ajuda da Wiki e Cia, assista vídeos sobre o CIGAM e audite seu ambiente.

====Ajuda====
Nesse assunto, você pode acessar o Chatbot da assistente virtual, onde você pode tirar dúvidas e consultar conteúdos da CIGAM Wiki enviando perguntas diretamente nela. 
 
'''Importante:''' neste assunto, a Cia atua dedicada à Wiki, focada exclusivamente nos conteúdos da documentação. As demais funcionalidades e atalhos da Cia não estarão disponíveis nesse contexto.

====Vídeos====
Nesse assunto, é possível procurar por vídeos relacionados ao tema desejado. O resultado será apresentado em forma de lista, contendo os vídeos encontrados e os tempos exatos em que o assunto começa a ser abordado, de acordo com o termo ou palavra pesquisada.

====Auditor====
Neste assunto, é possível verificar o status do sistema e identificar possíveis problemas ou inconsistências. O resultado será exibido em forma de tabela, contendo os dados retornados para facilitar a análise.

===Painéis BI, Portais e Relatórios===
Explore dashboards do BI, interaja com Portais intuitivos e execute relatórios personalizados.

====Painéis BI====
Nesse assunto, é possível abrir dashboards do BI já configurados para o usuário, permitindo sua visualização diretamente na tela.
Ao abrir um dashboard, você também pode interagir com ele, solicitando inserção de filtros, dimensões, métricas, transformações e outros ajustes. 
Cada dashboard aberto exibirá uma guia com as “Interações” disponíveis para aquele painel específico.
 
Além disso, ao selecionar o assunto '''#Painéis do BI''', é possível solicitar que a Cia crie um dashboard do zero.
Por exemplo: "Crie um dashboard para ver meu fluxo de caixa". Você pode ainda solicitar que métricas, dimensões e filtros sejam adicionados durante a criação, ou pedir dashboards separados por áreas.
 
'''Importante:''' caso o usuário não possua acesso ao BI ou este não esteja implementado na base de dados, será exibida uma mensagem informativa no momento do login na Cia.

====Portais====
Quando este assunto é utilizado, o resultado será sempre a abertura de uma tela dos Portais, permitindo ao usuário acessar diretamente os conteúdos e funcionalidades disponíveis nesse ambiente.
 
Essa abertura é feita de forma integrada, garantindo uma navegação contínua entre a Cia e os Portais, sem necessidade de realizar novo login ou sair da plataforma.

====Relatórios====
Ao utilizar esse assunto, será exibida uma tela para preenchimento de filtros, permitindo a emissão de relatórios web.
 
Para que essa funcionalidade opere corretamente, é necessário garantir que a instalação da CDN e da Pesquisa Dinâmica no servidor de aplicação esteja configurada de forma adequada.
 
Os relatórios exibidos aqui são os mesmos disponíveis nos Portais CIGAM, portanto é essencial que esses componentes também estejam funcionando corretamente nesses Portais.

===Qual, Faça, Consultar, Listar, Analisar e Insights===
Crie registros, analise informações ou liste dados cadastrados no CIGAM.

====Qual====
Nesse assunto, a Cia vai consultar e processar informações diretamente no ERP, usando os dados e relacionamentos disponíveis no CIGAM, e retornar os resultados em forma de texto para você visualizar.
 
'''Importante:''' nem todas as opções estão liberadas. Para ver quais você pode usar, digite ? na caixa de texto. A Cia vai mostrar uma lista com todos os comandos e funções disponíveis.

====Faça====
Nesse assunto, a Cia sempre fará um processamento no CIGAM e retornará o status do resultado. Por exemplo, você pode solicitar que a Cia crie um alerta ou até mesmo crie uma nova empresa no sistema.
 
'''Dica:''' para saber quais treinamentos ou comandos estão disponíveis, digite ? na caixa de texto. A Cia mostrará uma lista com todas as opções implementadas para você usar.

====Consultar====
Nesse assunto, você poderá fazer consultas de dados para obter listagens de registros, conforme os treinamentos de tabelas disponíveis. O resultado será apresentado em forma de tabela, exibindo os dados retornados. Já existem diversas Views prontas, para que você possa listar informações de forma mais completa e rápida.
 
'''Dica:''' para ver exemplos de consultas já implementadas, digite ? na caixa de texto.

====Listar====
Nesse assunto, você pode montar sua própria consulta de dados, escolhendo os filtros e parâmetros para gerar uma listagem personalizada. Diferente do assunto #Consultar, aqui é possível utilizar qualquer tabela do CIGAM para montar sua consulta, escrevendo em linguagem natural o que deseja buscar.
 
'''Dica:''' para ver todas as tabelas disponíveis, digite ? na caixa de texto.

====Analisar====
Analise o arquivo selecionado para gerar gráficos interativos e informativos, apresentando insights relevantes que ajudam a identificar tendências, padrões e oportunidades de melhoria.
 
Esse recurso oferece uma visualização clara e intuitiva dos dados, facilitando a interpretação das informações e apoiando a tomada de decisões estratégicas.
 
'''Aviso:''' para utilizar esta funcionalidade, é necessário concordar que os dados enviados serão processados por modelos de IA de terceiros integrados à Cia.

[[Imagem:AnalisarCia.png|semmoldura|center|600px]]

====Insights====
Gere insights inteligentes a partir dos dados de uma consulta, com análises automáticas realizadas pela Cia, que identificam padrões, tendências e possíveis pontos de atenção. Esse recurso ajuda a transformar dados brutos em informações acionáveis, facilitando a tomada de decisões estratégicas e otimizando processos.
 
'''Aviso:''' ao utilizar o assunto “Insights”, você concorda que os dados e informações analisados poderão ser enviados para modelos de IA de terceiros integrados à Cia, exclusivamente para processamento e geração dos resultados apresentados.

===IA Generativa e Pesquisa na Internet===
Converse com a IA sobre assuntos diversos, crie conteúdos e pesquise na internet sobre qualquer coisa.

====IA Generativa====
Nesse assunto, ao interagir com a IA Generativa, você poderá fazer qualquer tipo de pergunta ou solicitação, de forma livre e criativa.
O resultado exibido será exatamente a resposta gerada pela IA, sem complementos da Cia. Você pode, por exemplo, solicitar que a IA melhore ou reformule um texto, crie conteúdos ou resuma informações.
 
'''Importante:''' nesse assunto, a Cia não estará integrada aos serviços e sistemas do CIGAM — a interação é exclusivamente com a IA Generativa.

====Pesquisa na Internet====
Use esse assunto para fazer pesquisas na internet e visualizar os resultados diretamente integrados na Cia, sem precisar sair da plataforma. Você pode pesquisar qualquer tema de interesse e abrir os links retornados para acessar conteúdos, notícias e informações de forma rápida e prática.
{{VoltarInicio}}

===Compartilhamento de Análises da Cia===

 
<div align="justify">
Na Cia Web (SaaS), é possível gerar análises detalhadas de determinadas informações e compartilhá-las. Essa funcionalidade está disponível nos seguintes assuntos: [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Auditor|Auditor]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Analisar|Analisar]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Insights|Insights]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Listar|Listar]] e [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Consultar|Consultar]].
</div>
 

[[Image: opcoesAnalisarCia.png|semmoldura|center|800px]]

 
<div align="justify">
Essa opção está disponível por meio do botão '''Analisar''', exibido junto à resposta apresentada após a solicitação de um desses assuntos.
</div>
 

[[Image: exemploBotaoAnalisar.png|semmoldura|center|800px]]

 
<div align="justify">
Particularmente para o assunto '''Analisar''', a análise já é exibida diretamente, pois essa é a finalidade desse assunto:
</div>
 

[[Image: analiseAnalisar.png|semmoldura|center|800px]]

 
<div align="justify">
Ao gerar uma análise , a página de resultado passa a disponibilizar opções para compartilhar e utilizar o conteúdo gerado. São disponibilizadas três opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.
</div>
 

[[Image: CiaWebAnalise.png|semmoldura|center|800px]]

=====Compartilhamento por e-mail=====

<div align="justify">
Ao selecionar a opção '''E-mail''', é apresentada uma janela para preenchimento das informações necessárias ao envio da análise.
</div>
 

[[Image: CiaWebModalEmail.png|semmoldura|center|800px]]

 
<div align="justify">
Após informar os destinatários e os demais dados da mensagem, basta selecionar '''Enviar'''. A análise gerada será encaminhada como um arquivo em anexo.

Para utilizar esse recurso, o ambiente deve possuir as configurações necessárias para envio de e-mails pelo CIGAM devidamente parametrizadas. Para mais informações, consulte [[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]].
</div>

==Configurações==
O ícone de engrenagem, localizado no canto superior direito da página, reúne recursos de informação e gerenciamento. As opções disponíveis são:
* '''Respostas com áudio:''' quando ativado, as respostas da Cia são narradas em voz alta.
* '''Ambiente atual do CIGAM:''' exibe na tela o usuário logado e o ambiente em uso.
* '''Ver consumo:''' mostra a quantidade de tokens já utilizados e os usuários que geraram consumo.
* '''Limpar dados de navegação:''' exibe uma mensagem explicando como limpar os dados de navegação do navegador.
* '''Limpar cookies:''' apaga os dados armazenados localmente, permitindo informar novamente a API e realizar um novo login.
* '''Instalar aplicativo:''' instala a Cia como aplicativo no dispositivo, criando um atalho na tela inicial.
* '''Documentação na wiki:''' direciona para a documentação da Cia na CIGAM Wiki.
* '''Sair:''' encerra a sessão do usuário, permitindo realizar login com outro usuário.
 
[[Imagem:ConfiguracoesCia.png|semmoldura|center|500px]]
{{VoltarInicio}}

=Portais=
Nos Portais CIGAM, além do acesso à Cia Web pelo menu de mosaico, estão disponíveis recursos de IA que atuam diretamente nas telas em que você está trabalhando. Esses recursos não exigem parametrização e são apresentados de acordo com o contexto da tela. 

==Acesso à Cia Web (SaaS) pelo menu mosaico==
O acesso à Cia Web a partir dos Portais é feito pelo ícone de mosaico, onde está disponível o ícone da Cia - IA do CIGAM. 
 
[[Imagem:mosaicoCia.png|semmoldura|center|800px]]
 
A Cia será aberta de forma integrada, sem a necessidade de novo login, e todas as funcionalidades descritas na seção [[#Cia Web (SaaS)|Cia Web (SaaS)]] estarão disponíveis normalmente. 

==Geração de conteúdo==
Na barra superior dos Portais está disponível um ícone com um menu de contexto que permite interagir com os '''campos de texto''' de qualquer parte dos Portais. As opções disponíveis permitem melhorar textos, criar conteúdos, revisar a gramática, entre outras ações. 
 
[[Imagem:comandosCia.png|semmoldura|center|650px]]
 
A partir da versão '''Beta 260601''', essas opções passaram a ser exibidas em uma seção separada, chamada '''Geração de conteúdo''', apresentada no mesmo menu em que ficam os agentes. 
 
[[Imagem:MenuGeracaoConteudoAgentes.png|semmoldura|center|800px]]
 
O campo processado é sempre o '''último campo em que o cursor esteve posicionado''' antes de abrir o menu da Cia. Por isso, basta clicar no campo desejado e, em seguida, acionar o menu e escolher o comando. 
 
Para que o comando seja executado, o campo precisa ser um '''campo de texto válido''' e conter, no mínimo, '''três palavras'''. Caso contrário, será apresentada uma mensagem informando que o conteúdo não atende aos requisitos. 
 
Após o processamento, o conteúdo gerado é aplicado automaticamente no campo, substituindo o texto anterior, sem necessidade de confirmação. 
 
Essa funcionalidade também está disponível em telas modais, ou seja, janelas sobrepostas com interações: 
 
[[Imagem:comandosModalCia.png|semmoldura|center|800px]]
 

==Agentes==
A partir da versão '''Beta 260601''', o menu da Cia nos Portais passou a disponibilizar também o acesso aos agentes, tanto nos Portais MVC quanto nos Portais React. 
 
Ao abrir o menu da Cia, os agentes disponíveis são detectados automaticamente de acordo com a tela que está sendo acessada, ou seja, as opções apresentadas variam conforme a página aberta. 
 
[[Imagem:MenuAgentesCia.png|semmoldura|center|800px]]
 

===Como os agentes são disponibilizados===
A disponibilização de cada agente pode ocorrer de quatro formas: 
 
* '''Por contexto:''' o agente é apresentado quando a Cia identifica que a tela acessada corresponde ao assunto tratado por ele. Por exemplo, um agente sobre Ordem de Produção será disponibilizado ao acessar uma página cujo contexto seja identificado como Ordem de Produção.
 
* '''Por parâmetro:''' o agente é apresentado quando a Cia identifica, na tela, um parâmetro com o valor esperado por ele. Por exemplo, um agente de Pedidos será disponibilizado quando existir na tela um parâmetro que contenha o código do pedido.
 
* '''Por contexto e parâmetro:''' o agente é apresentado somente quando as duas condições forem atendidas ao mesmo tempo.
 
* '''Sempre disponível:''' o agente é apresentado em qualquer tela, independentemente do contexto ou dos parâmetros.
 

===Resultado do processamento===
Após o processamento, o retorno do agente pode ser apresentado de duas formas, conforme o que foi executado: 
 
* Em uma '''nova guia''' do navegador, quando o agente gera algum conteúdo ou relatório como resultado.
 
[[Imagem:AgentesRetornoGuia.png|semmoldura|center|800px]]
 
* Em uma '''janela modal''', dentro da própria página em que o usuário está, quando o retorno é uma mensagem.
 
[[Imagem:AgentesRetornoModal.png|semmoldura|center|800px]]
 
<div align="justify>
A partir da versão '''Beta 261005''', quando o resultado do agente é apresentado em uma nova guia, a página passa a disponibilizar também opções para utilização e compartilhamento da análise.
</div>
 
[[Imagem:resultadoAnalise.png|semmoldura|center|800px]]
 
<div align="justify">
No cabeçalho são apresentados o nome do agente executado e as opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.
</div>
<div align="justify">
=====Compartilhamento por e-mail=====
A janela abaixo é exibida quando selecionada a opção '''E-mail''':
</div>
 
[[Imagem:modalEmail.png|semmoldura|center|800px]]
 
<div align="justify">

Para utilizar esse recurso, o ambiente deve possuir as configurações necessárias para envio de e-mails pelo CIGAM devidamente parametrizadas. Para mais informações, consulte [[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]].
</div>

==Editor de Agentes==
A partir da versão '''Beta 261005''', o menu passou a disponibilizar o acesso à ferramenta '''Editor de Agentes''', que permite criar seus próprios agentes. 
 
[[Imagem:EditorAgentesCia.png|semmoldura|center|800px]]
 
Ao clicar na opção, será aberta uma página web no formato de assistente (wizard), com cada etapa explicada de forma detalhada. Basta preencher as informações do agente conforme a sua necessidade e avançar pelos passos até a conclusão. 
 
[[Imagem:EditorAgentesWizard.png|semmoldura|center|800px]]
 
Ao final do processo, será gerado um arquivo com a extensão '''.cgagt''', que contém a definição do agente criado. 
 

===Disponibilizando o agente criado===
Para que o agente passe a ser exibido nos Portais, o arquivo '''.cgagt''' precisa ser colocado na aplicação da API, dentro da pasta raiz da aplicação. 
 
É necessário que existam as pastas '''Exclusivo''' e, dentro dela, '''Agentes'''. Caso não existam, elas devem ser criadas manualmente. O arquivo deve ser colocado dentro dessa estrutura, ficando da seguinte forma: 
 
/api/exclusivo/agentes/
 
Assim que o arquivo é adicionado nesse local, a Cia passa a reconhecer o agente automaticamente, sem necessidade de qualquer outra configuração. Os agentes customizados são exibidos no menu da Cia nos Portais, em uma seção separada dos agentes padrão. 
 
[[Imagem:MenuAgentesCustomizados.png|semmoldura|center|800px]]
 
==Conversar com documentos==
<div align="justify">
A ferramenta de '''Conversar com documentos''' permite analisar, resumir e cruzar informações contidas em arquivos e relatórios através de modelos avançados de Inteligência Artificial integrados ao ERP CIGAM.

O acesso pode ser realizado a partir da tela principal da Cia Web (SaaS), clicando na opção correspondente ou digitando o assunto <code>#Documentos</code>, momento em que a aplicação é aberta em uma nova guia do navegador assim que digitada a primeira mensagem.

Além disto, podemos acessar a aplicação através dos Portais CIGAM, conforme descrito em [[GE_-_Como_Fazer_-_Cia_-_Como_acessar#Conversar_com_documentos|Como acessar]].

Para a utilização da aplicação, é necessário estar autenticado com um token de autorização CIGAM e com o endereço da API CIGAM devidamente parametrizado. Logo ao abrir, o sistema avalia o ambiente e valida a sessão do usuário em tempo real.

Estando os parâmetros validados, será gerado automaticamente um ID de conversação (''Conversation ID'') exclusivo para a sessão. Esta identificação é armazenada em cookies do navegador com validade de 24 horas, permitindo que a Cia armazene e mantenha o contexto contínuo de todas as mensagens e documentos anexados. Caso a página seja atualizada ou fechada dentro deste período, a sessão conectada e os arquivos são recuperados automaticamente.

 
<center>[[Arquivo:cia_conv_docs_01.png|nenhum|750px]]</center>
 

No primeiro acesso, é obrigatório marcar a opção '''Termo de consentimento''' para indicar ciência de que os dados e documentos selecionados para análise serão enviados aos modelos de IA de terceiros integrados com a Cia. Por segurança e conformidade, os campos de envio e a área de anexos permanecem bloqueados até que o consentimento seja confirmado. Uma vez aceito, uma mensagem de registro é inserida no histórico da conversa e a preferência é memorizada para a sessão.

Após confirmar o termo, a área de upload no painel lateral esquerdo é habilitada, permitindo anexar múltiplos arquivos simultaneamente, seja arrastando e soltando os documentos sobre a área de dropzone, seja clicando sobre ela para abrir a janela de seleção de arquivos.

A ferramenta suporta uma ampla variedade de formatos corporativos:
*'''Documentos de Texto e Portáteis:''' PDF (<code>.pdf</code>), Texto Simples (<code>.txt</code>), Word (<code>.doc</code>, <code>.docx</code>).
*'''Planilhas e Dados Tabulares:''' Planilhas Excel (<code>.xlsx</code>, <code>.xls</code>), Valores Separados por Vírgula (<code>.csv</code>).
*'''Arquivos de Estrutura de Dados:''' Arquivos <code>.json</code> e <code>.xml</code>.
*'''Imagens:''' Formatos de imagem (<code>.png</code>, <code>.jpg</code>, <code>.jpeg</code>, etc.).

No painel lateral, é possível visualizar o contador total de documentos anexados, o ícone específico do formato, o nome, o tamanho do arquivo formatado e a indicação de que o documento encontra-se ativo no contexto da conversa. Em dispositivos móveis ou telas menores, o painel lateral pode ser recolhido ou expandido através do botão retrátil no topo da barra.

Uma vez enviados para análise, os documentos permanecem registrados no contexto da conversa no servidor, não sendo necessário reenviá-los a cada nova pergunta. Caso deseje substituir ou remover os arquivos analisados, deve-se reiniciar o contexto através da opção de limpeza da conversa.

 
<center>[[Arquivo:cia_conv_docs_02.png|nenhum|750px]]</center>
 

Clicando no ícone da engrenagem localizado no canto superior direito da tela, temos acesso ao menu de opções e configurações da ferramenta:

*'''Modelo de IA:''' Permite selecionar o modelo de Inteligência Artificial desejado para o processamento documental (ex.: GPT-5.4 Recomendado, GPT-5.4 Mini, GPT-5.2 Alta Precisão, GPT-5.1 Raciocínio, GPT-4.1 Análise Documental, GPT-4o Versátil, GPT-4o Mini Econômico). A lista de modelos é atualizada dinamicamente a partir dos serviços disponíveis na Cia.
*'''Usuário Conectado:''' Exibe os dados do usuário autenticado no ERP CIGAM, incluindo nome, empresa (razão social / fantasia) e código de usuário.
*'''Ambiente & Sessão CIGAM:''' Apresenta o tipo de ambiente (produção ou depuração) e a URL da API CIGAM conectada, acompanhado de um botão de cópia rápida para facilitar diagnósticos e solicitações de suporte técnico.
*'''ID da Conversa Ativa:''' Exibe o identificador único da sessão com indicador visual de status em tempo real e botão para copiar o código do ID diretamente para a área de transferência.
*'''Limpar conversa:''' Permite reiniciar o contexto da conversa. Ao acionar esta opção, um balão interativo de confirmação é apresentado no histórico do chat (com as opções ''Limpar Conversa'' ou ''Cancelar''). Ao confirmar, o sistema solicita a exclusão da conversa no serviço da OpenAI para evitar registros órfãos, remove os documentos e cookies locais e gera um novo ID de conversação limpo.
*'''Documentação na wiki:''' Atalho que direciona diretamente aos manuais e guias de uso na CIGAM Wiki.

 
<center>[[Arquivo:cia_conv_docs_03.png|nenhum|750px]]</center>
 

Com os documentos anexados, podemos enviar perguntas e comandos no campo inferior para obter resumos executivos, explicações pontuais, cruzamento de dados entre arquivos distintos, localização de inconsistências ou extração de indicadores. Caso enviemos os arquivos sem digitar nenhuma mensagem complementar, a Cia aplicará o prompt de sistema padrão para realizar uma leitura analítica e retornar um resumo estruturado dos documentos.

O sistema dispõe de diretrizes de sistema corporativas (''System Prompt'') integradas ao ecossistema do ERP CIGAM, orientando o modelo a analisar com fidelidade os dados fornecidos, sem inventar informações ausentes.

Também é disponibilizado o recurso de '''Reconhecimento de Voz''' através do ícone de microfone (habilitado em conexões seguras HTTPS ou localhost). O recurso conta com reconhecimento inteligente de pontuação falada: ao ditar expressões como ''"vírgula"'', ''"ponto"'', ''"ponto e vírgula"'', ''"dois pontos"'', ''"interrogação"'', ''"exclamação"'', ''"hífen"'', ''"abre parênteses"'', ''"fecha parênteses"'' ou ''"nova linha"'', os termos são automaticamente substituídos pelos respectivos sinais gráficos e as frases são capitalizadas de forma automática.

 
<center>[[Arquivo:cia_conv_docs_04.png|nenhum|750px]]</center>
 

As respostas retornadas pela Cia contam com formatação Markdown avançada, estruturando o conteúdo em títulos hierárquicos, listas ordenadas ou em tópicos, citações em bloco e tabelas responsivas estilizadas.

Além disso, sempre que a análise envolver dados numéricos comparativos, demonstrativos contábeis/financeiros (como DRE, receitas e despesas), séries temporais ou valores tabulares, a Cia gera automaticamente gráficos visuais e interativos integrados diretamente na resposta:
*'''Tipos de Gráficos Gerados:''' Barras verticais, linhas de tendência, gráficos de pizza e rosca, estilizados na paleta de cores oficial da Cia e com valores numéricos formatados no padrão brasileiro (pt-BR).
*'''Exportação do Gráfico:''' Cada card de gráfico possui um botão de download no canto superior direito, permitindo baixar a imagem em formato PNG em alta resolução para inclusão imediata em relatórios, apresentações ou envio por e-mail.

 
<center>[[Arquivo:cia_conv_docs_05.png|nenhum|750px]]</center>
 

Podemos manter uma conversa contínua com diversos documentos e mensagens em múltiplos turnos de diálogo. A Cia preserva o histórico de perguntas e respostas anteriores, permitindo aprofundar análises, solicitar detalhamentos de itens específicos ou anexar novos arquivos complementares ao longo da conversa.

</div>
{{VoltarInicio}}

=Desktop=
Na aplicação Desktop, além do acesso rápido à Cia Web, algumas ferramentas do sistema disponibilizam o recurso "Analisar com a Cia". 

==Acesso rápido à Cia Web (SaaS)==
O botão de acesso rápido (Cia - IA do CIGAM), disponível no menu lateral do Desktop, abre a Cia Web de forma integrada ao sistema, em uma janela do próprio CIGAM. 
 
Desde que as configurações necessárias tenham sido aplicadas, conforme [[GE - Como Fazer - Configuração da Cia IA do CIGAM#Acesso rápido à Cia Web (SaaS)|Acesso rápido à Cia Web (SaaS)]], '''todas as funcionalidades da Cia Web estarão disponíveis normalmente''', da mesma forma que no acesso pelo navegador. Para conhecê-las, consulte a seção [[#Cia Web (SaaS)|Cia Web (SaaS)]] desta documentação. 
 
[[Imagem:CiaAbertaDesktop.png|semmoldura|center|800px]]
 

==Recurso "Analisar com a Cia"==
O recurso '''"Analisar com a Cia"''' está disponível em ferramentas como CGEditor, CGReport, Pesquisa Dinâmica e Dispositivo de Saída. Em todas elas, o comportamento é o mesmo: a Cia analisa o conteúdo que está em uso na tela e gera um relatório com o resultado da análise, apresentado em uma nova página. 
 
Ao acionar a opção, o fluxo é o seguinte: 
 
'''1. Confirmação dos termos de uso''' 
Antes de qualquer envio, será exibida uma mensagem solicitando que o usuário concorde com o envio das informações para análise. Os dados enviados seguem as diretrizes de segurança, privacidade e não retenção descritas em [[#Recursos, configurações e segurança|Recursos, configurações e segurança]]. 
 
[[Imagem:AnalisarCiaTermos.png|semmoldura|center|500px]]
 
'''2. Complemento do prompt (opcional)''' 
Em seguida, será apresentada uma caixa de texto para que o usuário complemente a solicitação, orientando a análise para algum ponto específico. O preenchimento é opcional e pode ser deixado em branco. 
 
Essa caixa de texto serve apenas para complementar o prompt base que a Cia monta automaticamente, e não altera o conteúdo que está sendo enviado. O recurso considera que o usuário já filtrou os dados na própria tela do CIGAM antes de acionar a análise. O prompt base é mantido oculto por ser extenso e técnico, evitando que o usuário precise conferi-lo a cada utilização. 
 
[[Imagem:AnalisarCiaPrompt.png|semmoldura|center|700px]]
 
'''3. Geração do relatório''' 
Após a confirmação, a Cia processa o conteúdo e apresenta o relatório em uma nova página flutuante, com a análise dos dados enviados. 
 
O próprio relatório informa a quantidade de dados que foi analisada, permitindo que o usuário veja o volume aproximado considerado e identifique se o conteúdo enviado corresponde ao que esperava. 
 
[[Imagem:AnalisarCiaRelatorio.png|semmoldura|center|700px]]
 

A partir da versão '''Beta 261005''', o resultado da análise passa a ser apresentado em uma nova janela flutuante, que disponibiliza opções para utilização e compartilhamento do conteúdo gerado. 
 
No cabeçalho dessa janela, são apresentados o título da análise e três opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.

 
[[Imagem:AnalisarCiaDesktopCompartilhar.png|semmoldura|center|800px]]
 

====Compartilhamento por e-mail====

Ao selecionar a opção '''E-mail''', é apresentada uma janela para preenchimento das informações necessárias ao envio da análise. 
 
[[Imagem:AnalisarCiaDesktopEmail.png|semmoldura|center|700px]]
 
Após informar os destinatários e os demais dados da mensagem, basta selecionar '''Enviar'''. A análise gerada será encaminhada como um arquivo em anexo. 
 

===Limite de conteúdo enviado===
Existe um limite para o volume de conteúdo enviado em cada análise, que varia conforme a versão do ambiente: 
 
* '''150 KB''' — desde a disponibilização do recurso, na versão '''250505.a'''.
* '''3 MB''' — a partir das patches '''250505.i''' e '''251103.a''', e da versão '''RC 260504'''.
 
Quando o conteúdo selecionado ultrapassa esse limite, a Cia exibe uma mensagem informando o tamanho excedido e a análise não é processada, ou seja, nenhum relatório será gerado. 
 
[[Imagem:AnalisarCiaLimite.png|semmoldura|center|600px]]
 
'''Esse limite não é parametrizável e não se trata de uma restrição imposta pela CIGAM.''' Ele decorre da própria capacidade dos modelos de IA integrados à Cia, que possuem um limite técnico de volume de dados que conseguem processar em uma única análise. Quando esse volume é ultrapassado, os modelos passam a analisar as informações por amostragem — ou seja, mesmo que fosse permitido enviar uma quantidade maior de dados, o modelo não analisaria todo o conteúdo, e o resultado seria menos preciso. O limite adotado pela Cia acompanha essa característica dos modelos e assegura que a análise seja feita sobre os dados completos. 
 
Além da qualidade da análise, há também a questão do tempo de processamento: quanto maior o volume enviado, maior o tempo de resposta do modelo, tornando a espera inviável para o uso no dia a dia. 
 
Por isso, o recurso foi feito para ser simples e direto: analisar, com um clique, os dados que o usuário já está visualizando pelos meios tradicionais do CIGAM, como grids filtrados e relatórios. Em ambientes com grande volume de dados, a prática recomendada é '''filtrar e consolidar as informações na própria tela antes de acionar a análise''', reduzindo o período ou o escopo consultado. Para análises de períodos maiores, recomenda-se utilizar dados já consolidados, como totalizadores e relatórios sintéticos, em vez de listagens analíticas completas. 
 
A CIGAM está trabalhando em outras ferramentas que, por processarem os dados de forma diferente, permitirão trabalhar com volumes maiores de informação. 

Para saber como acessar o recurso em cada ferramenta, consulte: [[GE - Como Fazer - Cia - Como acessar]]
{{VoltarInicio}}

=Documentos Relacionados=
[[GE - Como Fazer - Cia - Como acessar]] 
[[GE - Como Fazer - Configuração da Cia IA do CIGAM]]

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-10-16T13:34:51Z

Roger.schneider: /* Compartilhamento de Análises da Cia */

{{VoltarPagina}}
 
[[categoria:Como_Fazer_Utilidades/Diversos]]
[[categoria:Como_Fazer_Utilidades/Diversos_6]]
[[MediaWiki:Como_Fazer_sidebar|Como Fazer]] > [[Como_Fazer_Utilidades/Diversos|Utilidades/Diversos]] > [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer - Uso da Cia - IA do CIGAM]]

=Recursos, configurações e segurança=
A Cia - IA do CIGAM oferece diversas funcionalidades e atua como um hub centralizador para os recursos de inteligência artificial utilizados nas soluções CIGAM. Para garantir o correto funcionamento desses recursos, é necessário verificar se os pré-requisitos e as configurações foram realizados adequadamente. Para mais informações, consulte: [[GE - Como Fazer - Configuração da Cia IA do CIGAM|Como Fazer configuração da Cia IA do CIGAM]]
 
Todas as soluções de IA do CIGAM são integradas por meio dos serviços da Cia. A Cia possui integração com diferentes provedores de IA de terceiros, como OpenAI, Google, Anthropic, entre outros. Essas integrações são realizadas por meio de contas e serviços contratados, com condições de uso que asseguram que os dados trafegados não sejam utilizados para treinamento dos modelos, identificação de origem, publicidade, anúncios ou qualquer outra finalidade não prevista.
 
No caso de IAs open-source integradas à Cia, os modelos são executados dentro dos domínios da CIGAM, mantendo as mesmas premissas aplicadas às IAs contratadas: não utilização dos dados para treinamento de modelos, não identificação da origem das informações e ausência de retenção dos dados processados.
 
Além disso, sempre que houver envio explícito de dados pelo usuário por meio das funcionalidades da Cia disponíveis nas soluções CIGAM, será apresentado um diálogo de confirmação, permitindo que o usuário aceite o envio dessas informações. Os dados enviados serão tratados conforme as mesmas diretrizes de segurança, privacidade e não retenção descritas anteriormente.
 
Esta documentação apresenta o uso da Cia e está organizada conforme a forma de acesso: [[#Cia Web (SaaS)|Cia Web (SaaS)]], [[#Portais|Portais]] e [[#Desktop|Desktop]].
 
Caso tenha dúvidas sobre onde encontrar a Cia em cada uma dessas plataformas, ou sobre quais ferramentas do CIGAM possuem recursos integrados a ela, consulte a documentação específica de acesso: [[GE - Como Fazer - Cia - Como acessar|Como Fazer - Cia - Como acessar]]
{{VoltarInicio}}

=Cia Web (SaaS)=
A Cia Web é a aplicação web que centraliza todas as funcionalidades da Cia. Ela pode ser acessada diretamente pelo navegador do seu computador ou dispositivo móvel, ou ainda a partir do Desktop e dos Portais, sem a necessidade de novo login.
 

<center><youtube>https://youtu.be/DFGtRtPF75A</youtube></center>
 

==Primeiro acesso==
A Cia Web pode ser acessada diretamente pelo navegador, utilizando o seguinte endereço: https://services.cigam.cloud/cia/index.html
 
'''Importante:''' o usuário que for realizar o login precisa ter a autenticação em duas etapas habilitada. Para saber como configurá-la, consulte: [[GE - Como Fazer - Configuração da Cia IA do CIGAM#Autenticação em duas etapas e configurações de envio de e-mail|Autenticação em duas etapas e configurações de envio de e-mail]]
 
Ao acessar pelo endereço, será necessário preencher algumas informações para que a Cia consiga validar seu acesso e consultar seus dados: 
* Informar a API do seu CIGAM Server, para garantir o direcionamento correto da base de dados. 

[[Imagem:CiaAPI.png|semmoldura|center|700px]] 

* Informar usuário e senha de login e seu código de verificação: 

[[Imagem:CiaLogin.png|semmoldura|center|700px]]
 
[[Imagem:CiaCodVerif.png|semmoldura|center|700px]] 

* Caso não queira aguardar ou informar o código de verificação, você pode optar por responder à pergunta secreta, clicando no botão “Pergunta Secreta” exibido na imagem acima. 

[[Imagem:CiaLoginA2F.png|semmoldura|center|700px]]
 

==Conhecendo a tela da Cia==
Após realizar o login, a Cia carregará automaticamente as informações e dados necessários do ambiente e será iniciada no assunto '''#Geral''', identificado pelo botão localizado à esquerda da caixa de texto.

[[Imagem:CiaGeral.png|semmoldura|center|700px]]
 
Ao clicar nesse botão, será exibida uma lista com todos os assuntos disponíveis, permitindo que você selecione aquele com o qual deseja interagir. 
Além disso, você pode digitar diretamente na caixa de texto o '''#Assunto''' que deseja utilizar, e a Cia entenderá automaticamente o tema da sua mensagem. 
Também é possível '''formular uma pergunta seguida de um #Assunto''' para interagir com qualquer assunto, mesmo que ele não esteja selecionado no momento.

[[Imagem:CiaAberta.png|semmoldura|center|700px]]
 
Ao selecionar um assunto, serão exibidas automaticamente dicas e sugestões sobre o tema escolhido, além de exemplos clicáveis que, ao serem selecionados, são processados de forma imediata. 
Além disso, ao digitar um ponto de interrogação (?) na caixa de texto, será exibida uma lista com todas as interações disponíveis para o assunto selecionado, facilitando a descoberta de comandos e possibilidades de uso.

[[Imagem:CiaDicas.png|semmoldura|center|700px]]
 
Outra funcionalidade prática é a possibilidade de reenviar perguntas já feitas no chat. Para isso, basta posicionar o mouse sobre a pergunta desejada e clicar no ícone de “Reenviar”. Ao passar o mouse sobre a mensagem, também será exibido o horário de envio.
 
[[Imagem:CiaReenviar.png|semmoldura|center|400px]]
 
Além disso, você pode utilizar as setas do teclado (⬆️ para cima e ⬇️ para baixo) na caixa de texto para navegar pelas últimas perguntas enviadas para o #Assunto selecionado, facilitando o reuso de interações anteriores.

===Ícones da caixa de texto===
Na caixa de texto, você encontrará alguns ícones com as seguintes funções:

<center>
{| class="wikitable"
|-
! !! Ação
|-
|center|[[Imagem:CiaUltPerg.png]] || '''Histórico de Perguntas''' – Ao clicar, é exibido o histórico das perguntas já realizadas para o assunto selecionado.
|-
|center|[[Imagem:CiaEnviar.png]] || '''Enviar''' – Envia o conteúdo digitado na caixa de texto.
|-
|center|[[Imagem:CiaFala.png]] || '''Falar''' – Permite falar ao invés de digitar, usando o recurso de voz.
|-
|center|[[Imagem:CiaExpandir.png]] || '''Expandir''' – Aumenta a altura da caixa de texto para facilitar a digitação de mensagens longas.
|-
|center|[[Imagem:CiaRecolher.png]] || '''Recolher''' – Reduz a caixa de texto ao tamanho padrão.
|}
</center>
{{VoltarInicio}}

==Assuntos disponíveis==

===Geral===
Nesse assunto, é possível conversar livremente com a Cia sobre qualquer um dos assuntos disponíveis. Se encontrar dificuldades para obter a resposta desejada, experimente selecionar um assunto específico, o que pode gerar resultados mais precisos. 
Se houver muitas respostas correspondentes, a Cia não executará nenhuma automaticamente. Em vez disso, exibirá uma opção com os valores possíveis, permitindo que você selecione manualmente a melhor alternativa.

[[Imagem:CiaGeralOpcoes.png|semmoldura|center|700px]]
 
Caso a Cia encontre uma resposta com confiança significativamente maior que as demais, ela será executada automaticamente.
 
No entanto, se você selecionar a opção “Não era bem isso o que eu queria”, a Cia exibirá outras opções relacionadas ao que foi solicitado, apresentando também um indicador de semáforo com a porcentagem de confiança de cada alternativa.

[[Imagem:CiaGeralOpcaoCerta.png|semmoldura|center|600px]]

===Ajuda, Vídeos e Auditor===
Conheça melhor o ERP com a ajuda da Wiki e Cia, assista vídeos sobre o CIGAM e audite seu ambiente.

====Ajuda====
Nesse assunto, você pode acessar o Chatbot da assistente virtual, onde você pode tirar dúvidas e consultar conteúdos da CIGAM Wiki enviando perguntas diretamente nela. 
 
'''Importante:''' neste assunto, a Cia atua dedicada à Wiki, focada exclusivamente nos conteúdos da documentação. As demais funcionalidades e atalhos da Cia não estarão disponíveis nesse contexto.

====Vídeos====
Nesse assunto, é possível procurar por vídeos relacionados ao tema desejado. O resultado será apresentado em forma de lista, contendo os vídeos encontrados e os tempos exatos em que o assunto começa a ser abordado, de acordo com o termo ou palavra pesquisada.

====Auditor====
Neste assunto, é possível verificar o status do sistema e identificar possíveis problemas ou inconsistências. O resultado será exibido em forma de tabela, contendo os dados retornados para facilitar a análise.

===Painéis BI, Portais e Relatórios===
Explore dashboards do BI, interaja com Portais intuitivos e execute relatórios personalizados.

====Painéis BI====
Nesse assunto, é possível abrir dashboards do BI já configurados para o usuário, permitindo sua visualização diretamente na tela.
Ao abrir um dashboard, você também pode interagir com ele, solicitando inserção de filtros, dimensões, métricas, transformações e outros ajustes. 
Cada dashboard aberto exibirá uma guia com as “Interações” disponíveis para aquele painel específico.
 
Além disso, ao selecionar o assunto '''#Painéis do BI''', é possível solicitar que a Cia crie um dashboard do zero.
Por exemplo: "Crie um dashboard para ver meu fluxo de caixa". Você pode ainda solicitar que métricas, dimensões e filtros sejam adicionados durante a criação, ou pedir dashboards separados por áreas.
 
'''Importante:''' caso o usuário não possua acesso ao BI ou este não esteja implementado na base de dados, será exibida uma mensagem informativa no momento do login na Cia.

====Portais====
Quando este assunto é utilizado, o resultado será sempre a abertura de uma tela dos Portais, permitindo ao usuário acessar diretamente os conteúdos e funcionalidades disponíveis nesse ambiente.
 
Essa abertura é feita de forma integrada, garantindo uma navegação contínua entre a Cia e os Portais, sem necessidade de realizar novo login ou sair da plataforma.

====Relatórios====
Ao utilizar esse assunto, será exibida uma tela para preenchimento de filtros, permitindo a emissão de relatórios web.
 
Para que essa funcionalidade opere corretamente, é necessário garantir que a instalação da CDN e da Pesquisa Dinâmica no servidor de aplicação esteja configurada de forma adequada.
 
Os relatórios exibidos aqui são os mesmos disponíveis nos Portais CIGAM, portanto é essencial que esses componentes também estejam funcionando corretamente nesses Portais.

===Qual, Faça, Consultar, Listar, Analisar e Insights===
Crie registros, analise informações ou liste dados cadastrados no CIGAM.

====Qual====
Nesse assunto, a Cia vai consultar e processar informações diretamente no ERP, usando os dados e relacionamentos disponíveis no CIGAM, e retornar os resultados em forma de texto para você visualizar.
 
'''Importante:''' nem todas as opções estão liberadas. Para ver quais você pode usar, digite ? na caixa de texto. A Cia vai mostrar uma lista com todos os comandos e funções disponíveis.

====Faça====
Nesse assunto, a Cia sempre fará um processamento no CIGAM e retornará o status do resultado. Por exemplo, você pode solicitar que a Cia crie um alerta ou até mesmo crie uma nova empresa no sistema.
 
'''Dica:''' para saber quais treinamentos ou comandos estão disponíveis, digite ? na caixa de texto. A Cia mostrará uma lista com todas as opções implementadas para você usar.

====Consultar====
Nesse assunto, você poderá fazer consultas de dados para obter listagens de registros, conforme os treinamentos de tabelas disponíveis. O resultado será apresentado em forma de tabela, exibindo os dados retornados. Já existem diversas Views prontas, para que você possa listar informações de forma mais completa e rápida.
 
'''Dica:''' para ver exemplos de consultas já implementadas, digite ? na caixa de texto.

====Listar====
Nesse assunto, você pode montar sua própria consulta de dados, escolhendo os filtros e parâmetros para gerar uma listagem personalizada. Diferente do assunto #Consultar, aqui é possível utilizar qualquer tabela do CIGAM para montar sua consulta, escrevendo em linguagem natural o que deseja buscar.
 
'''Dica:''' para ver todas as tabelas disponíveis, digite ? na caixa de texto.

====Analisar====
Analise o arquivo selecionado para gerar gráficos interativos e informativos, apresentando insights relevantes que ajudam a identificar tendências, padrões e oportunidades de melhoria.
 
Esse recurso oferece uma visualização clara e intuitiva dos dados, facilitando a interpretação das informações e apoiando a tomada de decisões estratégicas.
 
'''Aviso:''' para utilizar esta funcionalidade, é necessário concordar que os dados enviados serão processados por modelos de IA de terceiros integrados à Cia.

[[Imagem:AnalisarCia.png|semmoldura|center|600px]]

====Insights====
Gere insights inteligentes a partir dos dados de uma consulta, com análises automáticas realizadas pela Cia, que identificam padrões, tendências e possíveis pontos de atenção. Esse recurso ajuda a transformar dados brutos em informações acionáveis, facilitando a tomada de decisões estratégicas e otimizando processos.
 
'''Aviso:''' ao utilizar o assunto “Insights”, você concorda que os dados e informações analisados poderão ser enviados para modelos de IA de terceiros integrados à Cia, exclusivamente para processamento e geração dos resultados apresentados.

===IA Generativa e Pesquisa na Internet===
Converse com a IA sobre assuntos diversos, crie conteúdos e pesquise na internet sobre qualquer coisa.

====IA Generativa====
Nesse assunto, ao interagir com a IA Generativa, você poderá fazer qualquer tipo de pergunta ou solicitação, de forma livre e criativa.
O resultado exibido será exatamente a resposta gerada pela IA, sem complementos da Cia. Você pode, por exemplo, solicitar que a IA melhore ou reformule um texto, crie conteúdos ou resuma informações.
 
'''Importante:''' nesse assunto, a Cia não estará integrada aos serviços e sistemas do CIGAM — a interação é exclusivamente com a IA Generativa.

====Pesquisa na Internet====
Use esse assunto para fazer pesquisas na internet e visualizar os resultados diretamente integrados na Cia, sem precisar sair da plataforma. Você pode pesquisar qualquer tema de interesse e abrir os links retornados para acessar conteúdos, notícias e informações de forma rápida e prática.
{{VoltarInicio}}

===Compartilhamento de Análises da Cia===

 
<div align="justify">
Na Cia Web (SaaS), é possível gerar análises detalhadas de determinadas informações e compartilhá-las. Essa funcionalidade está disponível nos seguintes assuntos: [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Auditor|Auditor]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Analisar|Analisar]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Insights|Insights]], [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Listar|Listar]] e [[GE_-_Como_Fazer_-_Uso_da_Cia_-_IA_do_CIGAM#Consultar|Consultar]].
</div>
 

[[Image: opcoesAnalisarCia.png|semmoldura|center|800px]]

 
<div align="justify">
Essa opção está disponível por meio do botão '''Analisar''', exibido junto à resposta apresentada após a solicitação de um desses assuntos.
</div>
 

[[Image: exemploBotaoAnalisar.png|semmoldura|center|800px]]

 
<div align="justify">
Particularmente para o assunto '''Analisar''', a análise já é exibida diretamente, pois essa é a finalidade desse assunto:
</div>
 

[[Image: analiseAnalisar.png|semmoldura|center|800px]]

 
<div align="justify">
Ao gerar uma análise , a página de resultado passa a disponibilizar opções para compartilhar e utilizar o conteúdo gerado. São disponibilizadas três opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.
</div>
 

[[Image: CiaWebAnalise.png|semmoldura|center|800px]]

=====Compartilhamento por e-mail=====

<div align="justify">
Ao selecionar a opção '''E-mail''', é apresentada uma janela para preenchimento das informações necessárias ao envio da análise.
</div>
 

[[Image: CiaWebModalEmail.png|semmoldura|center|800px]]

 
<div align="justify">
Após informar os destinatários e os demais dados da mensagem, basta selecionar '''Enviar'''. A análise gerada será encaminhada como um arquivo em anexo.

Para utilizar esse recurso, o ambiente deve possuir as configurações necessárias para envio de e-mails pelo CIGAM devidamente parametrizadas. Para mais informações, consulte [[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]].
</div>

==Configurações==
O ícone de engrenagem, localizado no canto superior direito da página, reúne recursos de informação e gerenciamento. As opções disponíveis são:
* '''Respostas com áudio:''' quando ativado, as respostas da Cia são narradas em voz alta.
* '''Ambiente atual do CIGAM:''' exibe na tela o usuário logado e o ambiente em uso.
* '''Ver consumo:''' mostra a quantidade de tokens já utilizados e os usuários que geraram consumo.
* '''Limpar dados de navegação:''' exibe uma mensagem explicando como limpar os dados de navegação do navegador.
* '''Limpar cookies:''' apaga os dados armazenados localmente, permitindo informar novamente a API e realizar um novo login.
* '''Instalar aplicativo:''' instala a Cia como aplicativo no dispositivo, criando um atalho na tela inicial.
* '''Documentação na wiki:''' direciona para a documentação da Cia na CIGAM Wiki.
* '''Sair:''' encerra a sessão do usuário, permitindo realizar login com outro usuário.
 
[[Imagem:ConfiguracoesCia.png|semmoldura|center|500px]]
{{VoltarInicio}}

=Portais=
Nos Portais CIGAM, além do acesso à Cia Web pelo menu de mosaico, estão disponíveis recursos de IA que atuam diretamente nas telas em que você está trabalhando. Esses recursos não exigem parametrização e são apresentados de acordo com o contexto da tela. 

==Acesso à Cia Web (SaaS) pelo menu mosaico==
O acesso à Cia Web a partir dos Portais é feito pelo ícone de mosaico, onde está disponível o ícone da Cia - IA do CIGAM. 
 
[[Imagem:mosaicoCia.png|semmoldura|center|800px]]
 
A Cia será aberta de forma integrada, sem a necessidade de novo login, e todas as funcionalidades descritas na seção [[#Cia Web (SaaS)|Cia Web (SaaS)]] estarão disponíveis normalmente. 

==Geração de conteúdo==
Na barra superior dos Portais está disponível um ícone com um menu de contexto que permite interagir com os '''campos de texto''' de qualquer parte dos Portais. As opções disponíveis permitem melhorar textos, criar conteúdos, revisar a gramática, entre outras ações. 
 
[[Imagem:comandosCia.png|semmoldura|center|650px]]
 
A partir da versão '''Beta 260601''', essas opções passaram a ser exibidas em uma seção separada, chamada '''Geração de conteúdo''', apresentada no mesmo menu em que ficam os agentes. 
 
[[Imagem:MenuGeracaoConteudoAgentes.png|semmoldura|center|800px]]
 
O campo processado é sempre o '''último campo em que o cursor esteve posicionado''' antes de abrir o menu da Cia. Por isso, basta clicar no campo desejado e, em seguida, acionar o menu e escolher o comando. 
 
Para que o comando seja executado, o campo precisa ser um '''campo de texto válido''' e conter, no mínimo, '''três palavras'''. Caso contrário, será apresentada uma mensagem informando que o conteúdo não atende aos requisitos. 
 
Após o processamento, o conteúdo gerado é aplicado automaticamente no campo, substituindo o texto anterior, sem necessidade de confirmação. 
 
Essa funcionalidade também está disponível em telas modais, ou seja, janelas sobrepostas com interações: 
 
[[Imagem:comandosModalCia.png|semmoldura|center|800px]]
 

==Agentes==
A partir da versão '''Beta 260601''', o menu da Cia nos Portais passou a disponibilizar também o acesso aos agentes, tanto nos Portais MVC quanto nos Portais React. 
 
Ao abrir o menu da Cia, os agentes disponíveis são detectados automaticamente de acordo com a tela que está sendo acessada, ou seja, as opções apresentadas variam conforme a página aberta. 
 
[[Imagem:MenuAgentesCia.png|semmoldura|center|800px]]
 

===Como os agentes são disponibilizados===
A disponibilização de cada agente pode ocorrer de quatro formas: 
 
* '''Por contexto:''' o agente é apresentado quando a Cia identifica que a tela acessada corresponde ao assunto tratado por ele. Por exemplo, um agente sobre Ordem de Produção será disponibilizado ao acessar uma página cujo contexto seja identificado como Ordem de Produção.
 
* '''Por parâmetro:''' o agente é apresentado quando a Cia identifica, na tela, um parâmetro com o valor esperado por ele. Por exemplo, um agente de Pedidos será disponibilizado quando existir na tela um parâmetro que contenha o código do pedido.
 
* '''Por contexto e parâmetro:''' o agente é apresentado somente quando as duas condições forem atendidas ao mesmo tempo.
 
* '''Sempre disponível:''' o agente é apresentado em qualquer tela, independentemente do contexto ou dos parâmetros.
 

===Resultado do processamento===
Após o processamento, o retorno do agente pode ser apresentado de duas formas, conforme o que foi executado: 
 
* Em uma '''nova guia''' do navegador, quando o agente gera algum conteúdo ou relatório como resultado.
 
[[Imagem:AgentesRetornoGuia.png|semmoldura|center|800px]]
 
* Em uma '''janela modal''', dentro da própria página em que o usuário está, quando o retorno é uma mensagem.
 
[[Imagem:AgentesRetornoModal.png|semmoldura|center|800px]]
 
<div align="justify>
A partir da versão '''Beta 261005''', quando o resultado do agente é apresentado em uma nova guia, a página passa a disponibilizar também opções para utilização e compartilhamento da análise.
</div>
 
[[Imagem:resultadoAnalise.png|semmoldura|center|800px]]
 
<div align="justify">
No cabeçalho são apresentados o nome do agente executado e as opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.
</div>
<div align="justify">
=====Compartilhamento por e-mail=====
A janela abaixo é exibida ao quando selecionada a opção '''E-mail''':
</div>
 
[[Imagem:modalEmail.png|semmoldura|center|800px]]
 
<div align="justify">

Para utilizar esse recurso, o ambiente deve possuir as configurações necessárias para envio de e-mails pelo CIGAM devidamente parametrizadas. Para mais informações, consulte [[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]].
</div>

==Editor de Agentes==
A partir da versão '''Beta 261005''', o menu passou a disponibilizar o acesso à ferramenta '''Editor de Agentes''', que permite criar seus próprios agentes. 
 
[[Imagem:EditorAgentesCia.png|semmoldura|center|800px]]
 
Ao clicar na opção, será aberta uma página web no formato de assistente (wizard), com cada etapa explicada de forma detalhada. Basta preencher as informações do agente conforme a sua necessidade e avançar pelos passos até a conclusão. 
 
[[Imagem:EditorAgentesWizard.png|semmoldura|center|800px]]
 
Ao final do processo, será gerado um arquivo com a extensão '''.cgagt''', que contém a definição do agente criado. 
 

===Disponibilizando o agente criado===
Para que o agente passe a ser exibido nos Portais, o arquivo '''.cgagt''' precisa ser colocado na aplicação da API, dentro da pasta raiz da aplicação. 
 
É necessário que existam as pastas '''Exclusivo''' e, dentro dela, '''Agentes'''. Caso não existam, elas devem ser criadas manualmente. O arquivo deve ser colocado dentro dessa estrutura, ficando da seguinte forma: 
 
/api/exclusivo/agentes/
 
Assim que o arquivo é adicionado nesse local, a Cia passa a reconhecer o agente automaticamente, sem necessidade de qualquer outra configuração. Os agentes customizados são exibidos no menu da Cia nos Portais, em uma seção separada dos agentes padrão. 
 
[[Imagem:MenuAgentesCustomizados.png|semmoldura|center|800px]]
 
==Conversar com documentos==
<div align="justify">
A ferramenta de '''Conversar com documentos''' permite analisar, resumir e cruzar informações contidas em arquivos e relatórios através de modelos avançados de Inteligência Artificial integrados ao ERP CIGAM.

O acesso pode ser realizado a partir da tela principal da Cia Web (SaaS), clicando na opção correspondente ou digitando o assunto <code>#Documentos</code>, momento em que a aplicação é aberta em uma nova guia do navegador assim que digitada a primeira mensagem.

Além disto, podemos acessar a aplicação através dos Portais CIGAM, conforme descrito em [[GE_-_Como_Fazer_-_Cia_-_Como_acessar#Conversar_com_documentos|Como acessar]].

Para a utilização da aplicação, é necessário estar autenticado com um token de autorização CIGAM e com o endereço da API CIGAM devidamente parametrizado. Logo ao abrir, o sistema avalia o ambiente e valida a sessão do usuário em tempo real.

Estando os parâmetros validados, será gerado automaticamente um ID de conversação (''Conversation ID'') exclusivo para a sessão. Esta identificação é armazenada em cookies do navegador com validade de 24 horas, permitindo que a Cia armazene e mantenha o contexto contínuo de todas as mensagens e documentos anexados. Caso a página seja atualizada ou fechada dentro deste período, a sessão conectada e os arquivos são recuperados automaticamente.

 
<center>[[Arquivo:cia_conv_docs_01.png|nenhum|750px]]</center>
 

No primeiro acesso, é obrigatório marcar a opção '''Termo de consentimento''' para indicar ciência de que os dados e documentos selecionados para análise serão enviados aos modelos de IA de terceiros integrados com a Cia. Por segurança e conformidade, os campos de envio e a área de anexos permanecem bloqueados até que o consentimento seja confirmado. Uma vez aceito, uma mensagem de registro é inserida no histórico da conversa e a preferência é memorizada para a sessão.

Após confirmar o termo, a área de upload no painel lateral esquerdo é habilitada, permitindo anexar múltiplos arquivos simultaneamente, seja arrastando e soltando os documentos sobre a área de dropzone, seja clicando sobre ela para abrir a janela de seleção de arquivos.

A ferramenta suporta uma ampla variedade de formatos corporativos:
*'''Documentos de Texto e Portáteis:''' PDF (<code>.pdf</code>), Texto Simples (<code>.txt</code>), Word (<code>.doc</code>, <code>.docx</code>).
*'''Planilhas e Dados Tabulares:''' Planilhas Excel (<code>.xlsx</code>, <code>.xls</code>), Valores Separados por Vírgula (<code>.csv</code>).
*'''Arquivos de Estrutura de Dados:''' Arquivos <code>.json</code> e <code>.xml</code>.
*'''Imagens:''' Formatos de imagem (<code>.png</code>, <code>.jpg</code>, <code>.jpeg</code>, etc.).

No painel lateral, é possível visualizar o contador total de documentos anexados, o ícone específico do formato, o nome, o tamanho do arquivo formatado e a indicação de que o documento encontra-se ativo no contexto da conversa. Em dispositivos móveis ou telas menores, o painel lateral pode ser recolhido ou expandido através do botão retrátil no topo da barra.

Uma vez enviados para análise, os documentos permanecem registrados no contexto da conversa no servidor, não sendo necessário reenviá-los a cada nova pergunta. Caso deseje substituir ou remover os arquivos analisados, deve-se reiniciar o contexto através da opção de limpeza da conversa.

 
<center>[[Arquivo:cia_conv_docs_02.png|nenhum|750px]]</center>
 

Clicando no ícone da engrenagem localizado no canto superior direito da tela, temos acesso ao menu de opções e configurações da ferramenta:

*'''Modelo de IA:''' Permite selecionar o modelo de Inteligência Artificial desejado para o processamento documental (ex.: GPT-5.4 Recomendado, GPT-5.4 Mini, GPT-5.2 Alta Precisão, GPT-5.1 Raciocínio, GPT-4.1 Análise Documental, GPT-4o Versátil, GPT-4o Mini Econômico). A lista de modelos é atualizada dinamicamente a partir dos serviços disponíveis na Cia.
*'''Usuário Conectado:''' Exibe os dados do usuário autenticado no ERP CIGAM, incluindo nome, empresa (razão social / fantasia) e código de usuário.
*'''Ambiente & Sessão CIGAM:''' Apresenta o tipo de ambiente (produção ou depuração) e a URL da API CIGAM conectada, acompanhado de um botão de cópia rápida para facilitar diagnósticos e solicitações de suporte técnico.
*'''ID da Conversa Ativa:''' Exibe o identificador único da sessão com indicador visual de status em tempo real e botão para copiar o código do ID diretamente para a área de transferência.
*'''Limpar conversa:''' Permite reiniciar o contexto da conversa. Ao acionar esta opção, um balão interativo de confirmação é apresentado no histórico do chat (com as opções ''Limpar Conversa'' ou ''Cancelar''). Ao confirmar, o sistema solicita a exclusão da conversa no serviço da OpenAI para evitar registros órfãos, remove os documentos e cookies locais e gera um novo ID de conversação limpo.
*'''Documentação na wiki:''' Atalho que direciona diretamente aos manuais e guias de uso na CIGAM Wiki.

 
<center>[[Arquivo:cia_conv_docs_03.png|nenhum|750px]]</center>
 

Com os documentos anexados, podemos enviar perguntas e comandos no campo inferior para obter resumos executivos, explicações pontuais, cruzamento de dados entre arquivos distintos, localização de inconsistências ou extração de indicadores. Caso enviemos os arquivos sem digitar nenhuma mensagem complementar, a Cia aplicará o prompt de sistema padrão para realizar uma leitura analítica e retornar um resumo estruturado dos documentos.

O sistema dispõe de diretrizes de sistema corporativas (''System Prompt'') integradas ao ecossistema do ERP CIGAM, orientando o modelo a analisar com fidelidade os dados fornecidos, sem inventar informações ausentes.

Também é disponibilizado o recurso de '''Reconhecimento de Voz''' através do ícone de microfone (habilitado em conexões seguras HTTPS ou localhost). O recurso conta com reconhecimento inteligente de pontuação falada: ao ditar expressões como ''"vírgula"'', ''"ponto"'', ''"ponto e vírgula"'', ''"dois pontos"'', ''"interrogação"'', ''"exclamação"'', ''"hífen"'', ''"abre parênteses"'', ''"fecha parênteses"'' ou ''"nova linha"'', os termos são automaticamente substituídos pelos respectivos sinais gráficos e as frases são capitalizadas de forma automática.

 
<center>[[Arquivo:cia_conv_docs_04.png|nenhum|750px]]</center>
 

As respostas retornadas pela Cia contam com formatação Markdown avançada, estruturando o conteúdo em títulos hierárquicos, listas ordenadas ou em tópicos, citações em bloco e tabelas responsivas estilizadas.

Além disso, sempre que a análise envolver dados numéricos comparativos, demonstrativos contábeis/financeiros (como DRE, receitas e despesas), séries temporais ou valores tabulares, a Cia gera automaticamente gráficos visuais e interativos integrados diretamente na resposta:
*'''Tipos de Gráficos Gerados:''' Barras verticais, linhas de tendência, gráficos de pizza e rosca, estilizados na paleta de cores oficial da Cia e com valores numéricos formatados no padrão brasileiro (pt-BR).
*'''Exportação do Gráfico:''' Cada card de gráfico possui um botão de download no canto superior direito, permitindo baixar a imagem em formato PNG em alta resolução para inclusão imediata em relatórios, apresentações ou envio por e-mail.

 
<center>[[Arquivo:cia_conv_docs_05.png|nenhum|750px]]</center>
 

Podemos manter uma conversa contínua com diversos documentos e mensagens em múltiplos turnos de diálogo. A Cia preserva o histórico de perguntas e respostas anteriores, permitindo aprofundar análises, solicitar detalhamentos de itens específicos ou anexar novos arquivos complementares ao longo da conversa.

</div>
{{VoltarInicio}}

=Desktop=
Na aplicação Desktop, além do acesso rápido à Cia Web, algumas ferramentas do sistema disponibilizam o recurso "Analisar com a Cia". 

==Acesso rápido à Cia Web (SaaS)==
O botão de acesso rápido (Cia - IA do CIGAM), disponível no menu lateral do Desktop, abre a Cia Web de forma integrada ao sistema, em uma janela do próprio CIGAM. 
 
Desde que as configurações necessárias tenham sido aplicadas, conforme [[GE - Como Fazer - Configuração da Cia IA do CIGAM#Acesso rápido à Cia Web (SaaS)|Acesso rápido à Cia Web (SaaS)]], '''todas as funcionalidades da Cia Web estarão disponíveis normalmente''', da mesma forma que no acesso pelo navegador. Para conhecê-las, consulte a seção [[#Cia Web (SaaS)|Cia Web (SaaS)]] desta documentação. 
 
[[Imagem:CiaAbertaDesktop.png|semmoldura|center|800px]]
 

==Recurso "Analisar com a Cia"==
O recurso '''"Analisar com a Cia"''' está disponível em ferramentas como CGEditor, CGReport, Pesquisa Dinâmica e Dispositivo de Saída. Em todas elas, o comportamento é o mesmo: a Cia analisa o conteúdo que está em uso na tela e gera um relatório com o resultado da análise, apresentado em uma nova página. 
 
Ao acionar a opção, o fluxo é o seguinte: 
 
'''1. Confirmação dos termos de uso''' 
Antes de qualquer envio, será exibida uma mensagem solicitando que o usuário concorde com o envio das informações para análise. Os dados enviados seguem as diretrizes de segurança, privacidade e não retenção descritas em [[#Recursos, configurações e segurança|Recursos, configurações e segurança]]. 
 
[[Imagem:AnalisarCiaTermos.png|semmoldura|center|500px]]
 
'''2. Complemento do prompt (opcional)''' 
Em seguida, será apresentada uma caixa de texto para que o usuário complemente a solicitação, orientando a análise para algum ponto específico. O preenchimento é opcional e pode ser deixado em branco. 
 
Essa caixa de texto serve apenas para complementar o prompt base que a Cia monta automaticamente, e não altera o conteúdo que está sendo enviado. O recurso considera que o usuário já filtrou os dados na própria tela do CIGAM antes de acionar a análise. O prompt base é mantido oculto por ser extenso e técnico, evitando que o usuário precise conferi-lo a cada utilização. 
 
[[Imagem:AnalisarCiaPrompt.png|semmoldura|center|700px]]
 
'''3. Geração do relatório''' 
Após a confirmação, a Cia processa o conteúdo e apresenta o relatório em uma nova página flutuante, com a análise dos dados enviados. 
 
O próprio relatório informa a quantidade de dados que foi analisada, permitindo que o usuário veja o volume aproximado considerado e identifique se o conteúdo enviado corresponde ao que esperava. 
 
[[Imagem:AnalisarCiaRelatorio.png|semmoldura|center|700px]]
 

A partir da versão '''Beta 261005''', o resultado da análise passa a ser apresentado em uma nova janela flutuante, que disponibiliza opções para utilização e compartilhamento do conteúdo gerado. 
 
No cabeçalho dessa janela, são apresentados o título da análise e três opções:

* '''E-mail:''' compartilhar a análise por e-mail. Ao selecionar essa opção, é apresentada uma janela para informar os destinatários, o assunto e o texto da mensagem. A análise gerada é enviada como um arquivo em anexo.
* '''Baixar:''' realizar o download da análise para o computador.
* '''Imprimir:''' abrir a opção de impressão da análise exibida.

 
[[Imagem:AnalisarCiaDesktopCompartilhar.png|semmoldura|center|800px]]
 

====Compartilhamento por e-mail====

Ao selecionar a opção '''E-mail''', é apresentada uma janela para preenchimento das informações necessárias ao envio da análise. 
 
[[Imagem:AnalisarCiaDesktopEmail.png|semmoldura|center|700px]]
 
Após informar os destinatários e os demais dados da mensagem, basta selecionar '''Enviar'''. A análise gerada será encaminhada como um arquivo em anexo. 
 

===Limite de conteúdo enviado===
Existe um limite para o volume de conteúdo enviado em cada análise, que varia conforme a versão do ambiente: 
 
* '''150 KB''' — desde a disponibilização do recurso, na versão '''250505.a'''.
* '''3 MB''' — a partir das patches '''250505.i''' e '''251103.a''', e da versão '''RC 260504'''.
 
Quando o conteúdo selecionado ultrapassa esse limite, a Cia exibe uma mensagem informando o tamanho excedido e a análise não é processada, ou seja, nenhum relatório será gerado. 
 
[[Imagem:AnalisarCiaLimite.png|semmoldura|center|600px]]
 
'''Esse limite não é parametrizável e não se trata de uma restrição imposta pela CIGAM.''' Ele decorre da própria capacidade dos modelos de IA integrados à Cia, que possuem um limite técnico de volume de dados que conseguem processar em uma única análise. Quando esse volume é ultrapassado, os modelos passam a analisar as informações por amostragem — ou seja, mesmo que fosse permitido enviar uma quantidade maior de dados, o modelo não analisaria todo o conteúdo, e o resultado seria menos preciso. O limite adotado pela Cia acompanha essa característica dos modelos e assegura que a análise seja feita sobre os dados completos. 
 
Além da qualidade da análise, há também a questão do tempo de processamento: quanto maior o volume enviado, maior o tempo de resposta do modelo, tornando a espera inviável para o uso no dia a dia. 
 
Por isso, o recurso foi feito para ser simples e direto: analisar, com um clique, os dados que o usuário já está visualizando pelos meios tradicionais do CIGAM, como grids filtrados e relatórios. Em ambientes com grande volume de dados, a prática recomendada é '''filtrar e consolidar as informações na própria tela antes de acionar a análise''', reduzindo o período ou o escopo consultado. Para análises de períodos maiores, recomenda-se utilizar dados já consolidados, como totalizadores e relatórios sintéticos, em vez de listagens analíticas completas. 
 
A CIGAM está trabalhando em outras ferramentas que, por processarem os dados de forma diferente, permitirão trabalhar com volumes maiores de informação. 

Para saber como acessar o recurso em cada ferramenta, consulte: [[GE - Como Fazer - Cia - Como acessar]]
{{VoltarInicio}}

=Documentos Relacionados=
[[GE - Como Fazer - Cia - Como acessar]] 
[[GE - Como Fazer - Configuração da Cia IA do CIGAM]]

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-10-08T13:51:23Z

Roger.schneider: /* Portais */

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-09-30T13:17:26Z

Roger.schneider: /* Recurso "Analisar com a Cia" */

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-09-30T13:16:38Z

Roger.schneider: /* Recurso "Analisar com a Cia" */

GE - Como Fazer - Configuração da Cia IA do CIGAM

2026-09-24T13:57:18Z

Roger.schneider: /* Recurso "Analisar com a Cia" */

{{VoltarPagina}}
 
[[categoria:Como_Fazer_Utilidades/Diversos]]
[[categoria:Como Fazer Utilidades/Diversos_2]]
[[MediaWiki:Como_Fazer_sidebar|Como Fazer]] > [[Como_Fazer_Utilidades/Diversos|Utilidades/Diversos]] > [[GE - Como_Fazer - Configuração da Cia IA do CIGAM|Configuração da Cia IA do CIGAM]]

=Como a Cia - IA do CIGAM funciona?=

A Cia, a IA do CIGAM, é composta por uma aplicação e um serviço, ambos hospedados na Nuvem CIGAM e executados como um SaaS (Software como Serviço). O SaaS é um modelo de aplicação acessada diretamente pelos usuários finais através do navegador de internet.
 
A execução através do modelo SaaS garante que toda a infraestrutura necessária permaneça sob responsabilidade da CIGAM na Nuvem CIGAM, oferecendo:
 
* Atualizações em tempo real, sem necessidade de intervenção do cliente. 
* Treinamento de forma compartilhada, adicionando novas funcionalidades, otimizando performance e resultados. 

Todas as configurações necessárias estão descritas em [[#Cia Web (SaaS)|Cia Web (SaaS)]]. As seções [[#Portais|Portais]] e [[#Desktop|Desktop]] indicam quais dessas configurações se aplicam a cada forma de acesso. 

=Cia Web (SaaS)=
A Cia será executada como uma página web no navegador de internet, acessando todo o ecossistema do CIGAM através das credenciais do usuário logado, da mesma forma que o usuário acessaria se estivesse logado diretamente no CIGAM.
 
As configurações desta seção garantem o funcionamento da Cia Web, que é a aplicação onde todos os recursos da Cia são disponibilizados.
 
Como os Portais e a aplicação Desktop abrem a mesma Cia Web, essas configurações também se aplicam a eles, conforme indicado nas respectivas seções. 

==Versões de navegadores==

Para garantir o pleno funcionamento da Cia, é aconselhável utilizar os navegadores Google Chrome ou Microsoft Edge, sempre atualizados para a última versão disponível, pois são os navegadores homologados pela CIGAM.
 
Além disso, recomenda-se que a extensão associada ao arquivo .html esteja configurada, por padrão, para abrir em um desses navegadores. Essa configuração assegura que relatórios, portais e páginas sejam carregados corretamente, proporcionando maior compatibilidade, segurança e desempenho.
 
Para mais informações, acesse: [[Requisitos_de_Software#Versões_de_Navegadores|Versões de navegadores]]


==Importância do uso do HTTPS==

A Cia sempre notificará o usuário caso ele esteja utilizando o protocolo HTTP, recomendando o uso do protocolo HTTPS. Isso ocorre por dois motivos principais:
 
1. Segurança: O HTTPS criptografa os dados transmitidos, garantindo maior proteção contra interceptações e ataques. 
2. Funcionalidades: O HTTPS permite que a Cia utilize recursos adicionais, como o microfone para reconhecimento de voz, aplicativo para dispositivos móveis, etc. Caso o usuário esteja em HTTP, a Cia automaticamente desativa essas funcionalidades por questões de segurança. 
 
Para mais informações sobre a importância do uso do HTTPS, acesse: [[GE - Importância do uso do HTTPS|Importância do uso do HTTPS]]


==Autenticação em duas etapas e configurações de envio de e-mail==

Para acessar a Cia Web, é obrigatório que o usuário tenha habilitado a autenticação em duas etapas para realizar o login, independentemente do ambiente. Se precisar de ajuda para configurar, consulte a documentação: [[GE Autenticação em duas etapas]]
 
Caso o envio de e-mails ainda não esteja configurado, será necessário configurá-lo, pois a autenticação em duas etapas depende dessa configuração. Se precisar de ajuda, consulte: [[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]]


==Configurações para Cia no CIGAM==
Algumas configurações e parametrizações no CIGAM são necessárias para garantir o funcionamento adequado da Cia, conforme o seu ambiente. Verifique se todas as aplicações estão em um único site ou distribuídas em mais de um e configure-as conforme a necessidade. 

===Ambiente padrão com único site===
Normalmente, os Portais, API, BI, entre outras aplicações são instalados no mesmo local, ou seja, com mesmo site, domínio e porta. Esse é o ambiente mais fácil de configurar, exigindo apenas os seguintes ajustes:
 
* Para acessar os Portais MVC:
** Acesse a configuração [[GE - AM - 3159 - Local de Instalação dos Portais Base]] e informe o local onde seus Portais MVC estão instalados.
*** Exemplo: http://servidor:porta/
 
* Para acessar os Portais React:
** Acesse a configuração [[GE - AM - 3160 - Local de Instalação dos Portais Complementares]] e informe onde seus Portais React estão instalados.
*** Exemplo: http://servidor:porta/
 
* Para acessar os dashboards do BI:
** Acesse a configuração [[GE - GE - 100325 - URL Base BI Portal]] e informe o endereço onde seu BI está instalado.
*** Exemplo: http://servidor:porta/bi 
 
'''Observação:''' mesmo em ambientes com um único site, é possível configurar as aplicações apenas por meio de '''nomes lógicos''' no arquivo '''Magic.ini'''. Nesse caso, as configurações acima não são necessárias. Para mais informações sobre como configurar nomes lógicos, consulte a documentação: [[GE - Como Fazer - Configuração do menu mosaico nos Portais Web]] 

===Ambiente com mais de um site===
Em alguns casos, as aplicações podem estar instaladas em locais diferentes, ou seja, em sites, domínios ou portas distintas. Nesses cenários, é necessário realizar configurações específicas para que a Cia consiga se comunicar corretamente com cada um deles.
 
* Quando o ambiente possui aplicações distribuídas em sites separados, podemos utilizar a configuração [[GE - AM - 3159 - Local de Instalação dos Portais Base]] para definir o endereço onde a API está hospedada. Para os demais Portais e aplicações, é possível utilizar nomes lógicos no arquivo '''Magic.ini''', informando cada um dos endereços. Alternativamente, todas as aplicações podem ser configuradas apenas por meio de nomes lógicos, sem a necessidade de utilizar essa configuração. Para mais informações sobre como configurar nomes lógicos, consulte a documentação: [[GE - Como Fazer - Configuração do menu mosaico nos Portais Web]]
 
* Para acessar os Portais React:
** Acesse a configuração [[GE - AM - 3160 - Local de Instalação dos Portais Complementares]] e informe onde seus Portais React estão instalados.
*** Exemplo: http://servidor:porta/
 
* Para acessar os dashboards do BI:
** Acesse a configuração [[GE - GE - 100325 - URL Base BI Portal]] e informe o endereço onde seu BI está instalado.
*** Exemplo: http://servidor:porta/bi 

===Configuração do BI para integração com a Cia===
Se o ambiente possuir um BI instalado e for utilizado pela Cia, é necessário garantir que a URL da API CIGAM esteja devidamente configurada. Caso ainda não esteja informada, adicione a URL nas configurações:
 
[[Imagem:apiCigamBI.png|semmoldura|centro|600px]]
{{VoltarInicio}}

==Configurações de CORS==

A forma como a Cia é executada, operando como um SaaS, pode causar restrições relacionadas ao CORS (Compartilhamento de Recursos entre Origens Diferentes). O CORS é um mecanismo de segurança implementado pelos navegadores para proteger os usuários, restringindo solicitações de recursos entre diferentes domínios não permitidos. Essas restrições podem causar erros ao tentar acessar cookies e outras informações. 
Cookies são pequenos arquivos armazenados no computador ou dispositivo do usuário que contêm informações sobre a atividade do usuário em sites para melhorar a experiência de navegação. 
Para o navegador, domínios diferentes são tratados de forma separada por questões de segurança. A Cia estará hospedada em um domínio (da CIGAM Corp. na Nuvem CIGAM). E o CIGAM Web do usuário estará em outro domínio, que pode ser em um servidor on-premise (local) ou em qualquer Nuvem, inclusive na Nuvem CIGAM.


==Ambientes com acesso externo às aplicações==

Esse seria o ambiente ideal para utilizar a Cia, o qual possui acesso externo às aplicações do CIGAM, como Portais, APIs, etc. Esse ambiente é acessível via internet e deve possuir HTTPS configurado com um domínio público.


===Como configurar o web server (Microsoft IIS)?===

Para permitir que a Cia acesse as aplicações do ambiente com acesso externo, é necessário configurar o Web Server no Microsoft IIS. O principal ajuste será a inclusão do cabeçalho de resposta denominado CSP (Content-Security-Policy).
 
O CSP define diretrizes que instruem o navegador sobre as fontes permitidas para diferentes tipos de conteúdo em uma página da web. Essa configuração pode ser realizada das seguintes formas:


====Configuração via arquivo web.config====

A maneira mais simples e rápida de realizar essa configuração é por meio da criação ou edição do arquivo Web.config, que funciona como um "manual de instruções" para o sistema. Sempre que você ajusta configurações no Microsoft IIS, esse arquivo pode ser criado ou modificado automaticamente. 
 
No entanto, é importante destacar que o arquivo Web.config pode não existir em alguns ambientes. Isso ocorre porque, até então, não utilizávamos esse tipo de configuração como padrão em todos os portais. Portanto, caso o arquivo não esteja presente, será necessário criá-lo manualmente. 
 
Esse arquivo deve ser criado (ou editado) na pasta raiz do site que engloba todas as aplicações, permitindo que a Cia tenha acesso a todos os domínios e aplicações de forma unificada. Por ser um arquivo geral, o Web.config afeta todas as aplicações vinculadas à raiz do site. Portanto, a configuração nesse local garante abrangência e evita a necessidade de repetir ajustes em cada aplicação individualmente. 
 
Se o Web.config já existir, não é necessário substituí-lo. Basta adicionar ou ajustar as permissões necessárias, tomando cuidado para não alterar outras configurações já existentes, a fim de evitar impactos indesejados no ambiente.
 
'''Se estiver trabalhando com sites separados, além das URLs da Cia, é necessário incluir os endereços de todas as demais aplicações. Caso contrário, elas não poderão ser carregadas corretamente nos demais Portais e aplicações, pois a configuração padrão permite apenas 'self', ou seja, restringe o acesso a aplicações do mesmo site e da Cia.'''
 
'''Lembre-se de que, mesmo que a maioria dos Portais e aplicações estejam todos no mesmo site, se você tiver um Portal em React, ele provavelmente estará hospedado em um site separado. Por isso, é fundamental incluir a URL desse Portal nas configurações. Caso contrário, ele poderá enfrentar restrições ao carregar outras aplicações, causando falhas na exibição dos conteúdos integrados.'''
 
'''Importante: Essas configurações devem ser feitas apenas para os ambientes que tiverem HTTPS configurados.'''
 
Exemplo com as pastas das aplicações do CIGAM Web em C:\inetpub\wwwroot\cigam no Web Server IIS:


[[Imagem:pastaWebConfig.png|semmoldura|centro|770px|Web Config]]
 

Também é possível copiar e utilizar o código abaixo para facilitar a configuração:

''<?xml version="1.0" encoding="UTF-8"?> <configuration>''
''<system.web>''
''<httpCookies requireSSL="true" sameSite="None" />''
''<sessionState cookieSameSite="None"/>''
''</system.web>''
''<system.webServer>''
''<httpProtocol>''
''<customHeaders>''
''<add name="Content-Security-Policy" value="frame-ancestors 'self' https://services.cigam.cloud http://services.cigam.cloud;" />''
''</customHeaders>''
''</httpProtocol>''
''</system.webServer> </configuration>''

====Como dar acesso através do IIS?====

Para configurar o CSP diretamente no IIS, siga os passos abaixo: 
1. Acesse o '''Gerenciador de Serviços de Informações da Internet (IIS)''' e localize o site que deseja liberar o acesso. 
2. Abra a opção '''Cabeçalhos de Resposta HTTP''' no painel do IIS, selecione o site desejado e clique em '''Cabeçalhos de Resposta HTTP'''.


[[Imagem:CabecalhoResp.png|semmoldura|centro|800px]]
 

3. Adicione o cabeçalho '''Content-Security-Policy''' na seção '''Ações''', localizada à direita, clique em '''Adicionar'''.


[[Imagem:CabecalhoResp2.png|semmoldura|centro|800px]]
 

4. Na caixa de diálogo que será exibida, preencha os seguintes campos:
* Nome: Content-Security-Policy.
* Valor: frame-ancestors 'self' https://services.cigam.cloud http://services.cigam.cloud;

 
'''Lembre-se de que, caso esteja com um ambiente com sites separados, além dessas URLs da Cia, é necessário incluir os endereços dos demais sites.'''

====Como configurar o acesso aos cookies no IIS?====

Para permitir que a Cia acesse os Cookies das aplicações, será necessário ajustar algumas permissões. Siga os passos abaixo:
* Acesse o '''Editor de Configurações''' no painel do IIS, localize a opção '''Editor de Configurações''' dentro da seção '''Gerenciamento'''.


[[Imagem:Gerenciamento.png|semmoldura|centro|800px]]
 
 

* Ajuste as configurações em '''httpCookies''':
** Navegue até a seção '''system.web''' e localize a configuração '''httpCookies'''.
** Defina os seguintes valores:
** requireSSL: True
** sameSite: None


[[Imagem:httpCookies.png|semmoldura|centro|800px]]
 


* Configuração de '''sessionState''':
** Ainda em '''system.web''', localize a configuração '''sessionState'''. 
** Altere o valor da propriedade '''cookieSameSite''' para '''None'''.


[[Imagem:sessionStage.png|semmoldura|centro|850px]]
 
Essas configurações garantem que os cookies sejam transmitidos com segurança e permitam o uso adequado em aplicações externas, atendendo aos requisitos da Cia.
{{VoltarInicio}}

==Ambientes internos sem acesso externo às aplicações==

Este ambiente possui acesso restrito à rede interna da empresa e utiliza o protocolo HTTP. Por esse motivo, algumas funcionalidades da Cia serão desabilitadas automaticamente — como recursos que exigem permissões avançadas do navegador, como o uso do microfone, ou o acesso dinâmico a iframes (componentes que permitem exibir conteúdos de outros sistemas dentro da mesma tela, como Portais).
 
'''Importante:''' Você não precisa se preocupar. A Cia detecta automaticamente essas limitações e desativa ou oculta as funcionalidades afetadas, garantindo que a experiência continue fluida e segura. Sempre que necessário, você será notificado com orientações claras sobre o que fazer.
 
Para mais informações sobre a importância do uso do HTTPS, acesse: [[GE - Importância do uso do HTTPS|Importância do uso do HTTPS]]


==Garantindo permissão de acesso aos cookies de terceiros no navegador==

Por padrão, os navegadores geralmente têm a permissão para Cookies de terceiros habilitada. No entanto, é importante verificar e assegurar essa configuração. Abaixo estão os passos para os navegadores '''Microsoft Edge''' e '''Google Chrome''': 
 
* Microsoft Edge
** Em Português:
*** Acesse Configurações → Cookies e permissões de sites → Gerenciar e excluir cookies e dados do site.
*** Desabilite a opção "Bloquear cookies de terceiros".
** Em Inglês:
*** Acesse Settings → Cookies and Site Permissions → Manage and delete cookies and site data.
*** Desabilite a opção "Block third-party cookies".


[[Imagem:settingsEdge.png|semmoldura|centro|800px]]
 
 

* Google Chrome:
** Em Português:
*** Vá para Configurações → Privacidade e segurança → Cookies de terceiros.
*** Habilite a opção "Permitir cookies de terceiros".
** Em Inglês:
*** Vá para Settings → Privacy and security → Third-party cookies.
*** Habilite a opção "Allow third-party cookies".


[[Imagem:settingsChrome.png|semmoldura|centro|800px]]

==Dispositivos móveis==

A Cia também oferece suporte para dispositivos móveis, proporcionando acesso prático e otimizado. Para utilizar a Cia em um dispositivo móvel, basta acessar o endereço normalmente pelo seu navegador. Ao entrar, será exibida uma mensagem convidando o usuário a instalar o aplicativo. A instalação também pode ser realizada diretamente através do ícone de engrenagem, no menu de configurações.


[[Imagem:CiaInstalarAppMobile.png|semmoldura|centro|700px]]


É importante destacar que a instalação do aplicativo no dispositivo móvel só será possível se o ambiente estiver configurado para utilizar HTTPS. Caso contrário, o usuário só poderá acessar a Cia diretamente pelo próprio navegador móvel, porém com algumas restrições de funcionalidades.

{{VoltarInicio}}

=Portais=
Nos Portais CIGAM, os recursos da Cia possuem exigências diferentes de configuração. Os itens abaixo indicam o que é necessário em cada caso. 

==Acesso à Cia Web (SaaS) pelo menu mosaico==
O acesso à Cia a partir do menu de mosaico (Cia - IA do CIGAM) abre a Cia Web (SaaS). Por esse motivo, depende das configurações descritas na seção [[#Cia Web (SaaS)|Cia Web (SaaS)]], em especial: 
* [[#Configurações para Cia no CIGAM|Configurações para Cia no CIGAM]], conforme o ambiente possua um único site ou mais de um.
* [[#Autenticação em duas etapas e configurações de envio de e-mail|Autenticação em duas etapas e configurações de envio de e-mail]].
* As configurações de ambiente, como CSP, cookies e permissões do navegador.
 
[[Imagem:mosaicoCia.png|semmoldura|centro|650px]]
 
Para mais informações sobre como configurar nomes lógicos e o menu mosaico, consulte: [[GE - Como Fazer - Configuração do menu mosaico nos Portais Web]] 

==Agentes e opções generativas==
Não é necessária nenhuma parametrização para utilizar os '''agentes''' e as '''opções generativas''' disponíveis no menu da Cia nos Portais, como melhoria de texto e revisão gramatical. Esses recursos são disponibilizados automaticamente, de acordo com o contexto da tela, e não dependem das configurações de local de instalação nem da autenticação em duas etapas. 
 
Os agentes estão disponíveis a partir da versão '''Beta 260601''', e o '''Editor de Agentes''' a partir da versão '''Beta 261005''', tanto para os Portais MVC quanto para os Portais React. 
 
[[Imagem:MenuCiaPortais.png|semmoldura|centro|600px]]
 
Para saber como utilizar esses recursos, consulte: [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer uso da Cia IA do CIGAM]]
{{VoltarInicio}}

=Desktop=
Na aplicação Desktop, os recursos da Cia possuem exigências distintas de configuração: 
 
{| class="wikitable"
|-
| '''Recurso''' || '''Configuração necessária'''
|-
| '''Acesso rápido à Cia - IA do CIGAM''' || Exige API e Portais instalados, além das configurações da Cia Web (SaaS).
|-
| '''Analisar com a Cia''' || Não exige parametrização no CIGAM. Requer a versão 250505 patch A ou superior e o navegador padrão e a extensão .html configurados no Windows.
|}

==Acesso rápido à Cia Web (SaaS)==
O botão de acesso rápido (Cia - IA do CIGAM) disponível no menu lateral do Desktop abre a Cia Web (SaaS) em uma janela integrada ao sistema. Por esse motivo, depende de: 
* A API e os Portais instalados, pois são eles que conectam o sistema aos dados do ERP. '''Sem a API, a funcionalidade não funcionará'''.
* As configurações descritas na seção [[#Cia Web (SaaS)|Cia Web (SaaS)]], em especial [[#Configurações para Cia no CIGAM|Configurações para Cia no CIGAM]] e [[#Autenticação em duas etapas e configurações de envio de e-mail|Autenticação em duas etapas e configurações de envio de e-mail]].
 
[[Imagem:CiaIA.png|semmoldura|centro|800px]]
 

==Recurso "Analisar com a Cia"==
O recurso '''"Analisar com a Cia"''', disponível em ferramentas como CGEditor, CGReport, Pesquisa Dinâmica e Dispositivo de Saída, não exige nenhuma parametrização no CIGAM. Ele também não depende da autenticação em duas etapas nem das configurações de local de instalação dos Portais. 
 
Exemplo do recurso disponível na Pesquisa Dinâmica: 
 
[[Imagem:PesquisaDinamicaComCia.png|semmoldura|centro|800px]]
 
Os requisitos para utilização são: 
* Estar na versão '''250505.a''' ou superior.
* Ter um '''navegador padrão configurado no Windows''', preferencialmente o '''Google Chrome''' ou o '''Microsoft Edge''', por serem os navegadores homologados pela CIGAM.
* Ter a '''extensão .html''' associada a um desses navegadores, para que o conteúdo enviado à Cia seja aberto corretamente.
 
[[Imagem:NavegadorPadraoWindows.png|semmoldura|centro|800px]]
 
Para mais informações sobre os navegadores homologados, acesse: [[Requisitos_de_Software#Versões_de_Navegadores|Versões de navegadores]] 
 
Para saber como utilizar o recurso, consulte: [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer uso da Cia IA do CIGAM]]

=Documentos Relacionados=
[[GE - Como Fazer - Cia - Como acessar]] 
[[GE - Como Fazer - Uso da Cia - IA do CIGAM]] 
[[GE - Importância do uso do HTTPS]] 
[[GE Autenticação em duas etapas]] 
[[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]] 
[[GE - Como Fazer - Configuração do menu mosaico nos Portais Web]]
{{VoltarInicio}}

GE - Como Fazer - Configuração da Cia IA do CIGAM

2026-09-24T13:56:22Z

Roger.schneider: /* Agentes e opções generativas */

{{VoltarPagina}}
 
[[categoria:Como_Fazer_Utilidades/Diversos]]
[[categoria:Como Fazer Utilidades/Diversos_2]]
[[MediaWiki:Como_Fazer_sidebar|Como Fazer]] > [[Como_Fazer_Utilidades/Diversos|Utilidades/Diversos]] > [[GE - Como_Fazer - Configuração da Cia IA do CIGAM|Configuração da Cia IA do CIGAM]]

=Como a Cia - IA do CIGAM funciona?=

A Cia, a IA do CIGAM, é composta por uma aplicação e um serviço, ambos hospedados na Nuvem CIGAM e executados como um SaaS (Software como Serviço). O SaaS é um modelo de aplicação acessada diretamente pelos usuários finais através do navegador de internet.
 
A execução através do modelo SaaS garante que toda a infraestrutura necessária permaneça sob responsabilidade da CIGAM na Nuvem CIGAM, oferecendo:
 
* Atualizações em tempo real, sem necessidade de intervenção do cliente. 
* Treinamento de forma compartilhada, adicionando novas funcionalidades, otimizando performance e resultados. 

Todas as configurações necessárias estão descritas em [[#Cia Web (SaaS)|Cia Web (SaaS)]]. As seções [[#Portais|Portais]] e [[#Desktop|Desktop]] indicam quais dessas configurações se aplicam a cada forma de acesso. 

=Cia Web (SaaS)=
A Cia será executada como uma página web no navegador de internet, acessando todo o ecossistema do CIGAM através das credenciais do usuário logado, da mesma forma que o usuário acessaria se estivesse logado diretamente no CIGAM.
 
As configurações desta seção garantem o funcionamento da Cia Web, que é a aplicação onde todos os recursos da Cia são disponibilizados.
 
Como os Portais e a aplicação Desktop abrem a mesma Cia Web, essas configurações também se aplicam a eles, conforme indicado nas respectivas seções. 

==Versões de navegadores==

Para garantir o pleno funcionamento da Cia, é aconselhável utilizar os navegadores Google Chrome ou Microsoft Edge, sempre atualizados para a última versão disponível, pois são os navegadores homologados pela CIGAM.
 
Além disso, recomenda-se que a extensão associada ao arquivo .html esteja configurada, por padrão, para abrir em um desses navegadores. Essa configuração assegura que relatórios, portais e páginas sejam carregados corretamente, proporcionando maior compatibilidade, segurança e desempenho.
 
Para mais informações, acesse: [[Requisitos_de_Software#Versões_de_Navegadores|Versões de navegadores]]


==Importância do uso do HTTPS==

A Cia sempre notificará o usuário caso ele esteja utilizando o protocolo HTTP, recomendando o uso do protocolo HTTPS. Isso ocorre por dois motivos principais:
 
1. Segurança: O HTTPS criptografa os dados transmitidos, garantindo maior proteção contra interceptações e ataques. 
2. Funcionalidades: O HTTPS permite que a Cia utilize recursos adicionais, como o microfone para reconhecimento de voz, aplicativo para dispositivos móveis, etc. Caso o usuário esteja em HTTP, a Cia automaticamente desativa essas funcionalidades por questões de segurança. 
 
Para mais informações sobre a importância do uso do HTTPS, acesse: [[GE - Importância do uso do HTTPS|Importância do uso do HTTPS]]


==Autenticação em duas etapas e configurações de envio de e-mail==

Para acessar a Cia Web, é obrigatório que o usuário tenha habilitado a autenticação em duas etapas para realizar o login, independentemente do ambiente. Se precisar de ajuda para configurar, consulte a documentação: [[GE Autenticação em duas etapas]]
 
Caso o envio de e-mails ainda não esteja configurado, será necessário configurá-lo, pois a autenticação em duas etapas depende dessa configuração. Se precisar de ajuda, consulte: [[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]]


==Configurações para Cia no CIGAM==
Algumas configurações e parametrizações no CIGAM são necessárias para garantir o funcionamento adequado da Cia, conforme o seu ambiente. Verifique se todas as aplicações estão em um único site ou distribuídas em mais de um e configure-as conforme a necessidade. 

===Ambiente padrão com único site===
Normalmente, os Portais, API, BI, entre outras aplicações são instalados no mesmo local, ou seja, com mesmo site, domínio e porta. Esse é o ambiente mais fácil de configurar, exigindo apenas os seguintes ajustes:
 
* Para acessar os Portais MVC:
** Acesse a configuração [[GE - AM - 3159 - Local de Instalação dos Portais Base]] e informe o local onde seus Portais MVC estão instalados.
*** Exemplo: http://servidor:porta/
 
* Para acessar os Portais React:
** Acesse a configuração [[GE - AM - 3160 - Local de Instalação dos Portais Complementares]] e informe onde seus Portais React estão instalados.
*** Exemplo: http://servidor:porta/
 
* Para acessar os dashboards do BI:
** Acesse a configuração [[GE - GE - 100325 - URL Base BI Portal]] e informe o endereço onde seu BI está instalado.
*** Exemplo: http://servidor:porta/bi 
 
'''Observação:''' mesmo em ambientes com um único site, é possível configurar as aplicações apenas por meio de '''nomes lógicos''' no arquivo '''Magic.ini'''. Nesse caso, as configurações acima não são necessárias. Para mais informações sobre como configurar nomes lógicos, consulte a documentação: [[GE - Como Fazer - Configuração do menu mosaico nos Portais Web]] 

===Ambiente com mais de um site===
Em alguns casos, as aplicações podem estar instaladas em locais diferentes, ou seja, em sites, domínios ou portas distintas. Nesses cenários, é necessário realizar configurações específicas para que a Cia consiga se comunicar corretamente com cada um deles.
 
* Quando o ambiente possui aplicações distribuídas em sites separados, podemos utilizar a configuração [[GE - AM - 3159 - Local de Instalação dos Portais Base]] para definir o endereço onde a API está hospedada. Para os demais Portais e aplicações, é possível utilizar nomes lógicos no arquivo '''Magic.ini''', informando cada um dos endereços. Alternativamente, todas as aplicações podem ser configuradas apenas por meio de nomes lógicos, sem a necessidade de utilizar essa configuração. Para mais informações sobre como configurar nomes lógicos, consulte a documentação: [[GE - Como Fazer - Configuração do menu mosaico nos Portais Web]]
 
* Para acessar os Portais React:
** Acesse a configuração [[GE - AM - 3160 - Local de Instalação dos Portais Complementares]] e informe onde seus Portais React estão instalados.
*** Exemplo: http://servidor:porta/
 
* Para acessar os dashboards do BI:
** Acesse a configuração [[GE - GE - 100325 - URL Base BI Portal]] e informe o endereço onde seu BI está instalado.
*** Exemplo: http://servidor:porta/bi 

===Configuração do BI para integração com a Cia===
Se o ambiente possuir um BI instalado e for utilizado pela Cia, é necessário garantir que a URL da API CIGAM esteja devidamente configurada. Caso ainda não esteja informada, adicione a URL nas configurações:
 
[[Imagem:apiCigamBI.png|semmoldura|centro|600px]]
{{VoltarInicio}}

==Configurações de CORS==

A forma como a Cia é executada, operando como um SaaS, pode causar restrições relacionadas ao CORS (Compartilhamento de Recursos entre Origens Diferentes). O CORS é um mecanismo de segurança implementado pelos navegadores para proteger os usuários, restringindo solicitações de recursos entre diferentes domínios não permitidos. Essas restrições podem causar erros ao tentar acessar cookies e outras informações. 
Cookies são pequenos arquivos armazenados no computador ou dispositivo do usuário que contêm informações sobre a atividade do usuário em sites para melhorar a experiência de navegação. 
Para o navegador, domínios diferentes são tratados de forma separada por questões de segurança. A Cia estará hospedada em um domínio (da CIGAM Corp. na Nuvem CIGAM). E o CIGAM Web do usuário estará em outro domínio, que pode ser em um servidor on-premise (local) ou em qualquer Nuvem, inclusive na Nuvem CIGAM.


==Ambientes com acesso externo às aplicações==

Esse seria o ambiente ideal para utilizar a Cia, o qual possui acesso externo às aplicações do CIGAM, como Portais, APIs, etc. Esse ambiente é acessível via internet e deve possuir HTTPS configurado com um domínio público.


===Como configurar o web server (Microsoft IIS)?===

Para permitir que a Cia acesse as aplicações do ambiente com acesso externo, é necessário configurar o Web Server no Microsoft IIS. O principal ajuste será a inclusão do cabeçalho de resposta denominado CSP (Content-Security-Policy).
 
O CSP define diretrizes que instruem o navegador sobre as fontes permitidas para diferentes tipos de conteúdo em uma página da web. Essa configuração pode ser realizada das seguintes formas:


====Configuração via arquivo web.config====

A maneira mais simples e rápida de realizar essa configuração é por meio da criação ou edição do arquivo Web.config, que funciona como um "manual de instruções" para o sistema. Sempre que você ajusta configurações no Microsoft IIS, esse arquivo pode ser criado ou modificado automaticamente. 
 
No entanto, é importante destacar que o arquivo Web.config pode não existir em alguns ambientes. Isso ocorre porque, até então, não utilizávamos esse tipo de configuração como padrão em todos os portais. Portanto, caso o arquivo não esteja presente, será necessário criá-lo manualmente. 
 
Esse arquivo deve ser criado (ou editado) na pasta raiz do site que engloba todas as aplicações, permitindo que a Cia tenha acesso a todos os domínios e aplicações de forma unificada. Por ser um arquivo geral, o Web.config afeta todas as aplicações vinculadas à raiz do site. Portanto, a configuração nesse local garante abrangência e evita a necessidade de repetir ajustes em cada aplicação individualmente. 
 
Se o Web.config já existir, não é necessário substituí-lo. Basta adicionar ou ajustar as permissões necessárias, tomando cuidado para não alterar outras configurações já existentes, a fim de evitar impactos indesejados no ambiente.
 
'''Se estiver trabalhando com sites separados, além das URLs da Cia, é necessário incluir os endereços de todas as demais aplicações. Caso contrário, elas não poderão ser carregadas corretamente nos demais Portais e aplicações, pois a configuração padrão permite apenas 'self', ou seja, restringe o acesso a aplicações do mesmo site e da Cia.'''
 
'''Lembre-se de que, mesmo que a maioria dos Portais e aplicações estejam todos no mesmo site, se você tiver um Portal em React, ele provavelmente estará hospedado em um site separado. Por isso, é fundamental incluir a URL desse Portal nas configurações. Caso contrário, ele poderá enfrentar restrições ao carregar outras aplicações, causando falhas na exibição dos conteúdos integrados.'''
 
'''Importante: Essas configurações devem ser feitas apenas para os ambientes que tiverem HTTPS configurados.'''
 
Exemplo com as pastas das aplicações do CIGAM Web em C:\inetpub\wwwroot\cigam no Web Server IIS:


[[Imagem:pastaWebConfig.png|semmoldura|centro|770px|Web Config]]
 

Também é possível copiar e utilizar o código abaixo para facilitar a configuração:

''<?xml version="1.0" encoding="UTF-8"?> <configuration>''
''<system.web>''
''<httpCookies requireSSL="true" sameSite="None" />''
''<sessionState cookieSameSite="None"/>''
''</system.web>''
''<system.webServer>''
''<httpProtocol>''
''<customHeaders>''
''<add name="Content-Security-Policy" value="frame-ancestors 'self' https://services.cigam.cloud http://services.cigam.cloud;" />''
''</customHeaders>''
''</httpProtocol>''
''</system.webServer> </configuration>''

====Como dar acesso através do IIS?====

Para configurar o CSP diretamente no IIS, siga os passos abaixo: 
1. Acesse o '''Gerenciador de Serviços de Informações da Internet (IIS)''' e localize o site que deseja liberar o acesso. 
2. Abra a opção '''Cabeçalhos de Resposta HTTP''' no painel do IIS, selecione o site desejado e clique em '''Cabeçalhos de Resposta HTTP'''.


[[Imagem:CabecalhoResp.png|semmoldura|centro|800px]]
 

3. Adicione o cabeçalho '''Content-Security-Policy''' na seção '''Ações''', localizada à direita, clique em '''Adicionar'''.


[[Imagem:CabecalhoResp2.png|semmoldura|centro|800px]]
 

4. Na caixa de diálogo que será exibida, preencha os seguintes campos:
* Nome: Content-Security-Policy.
* Valor: frame-ancestors 'self' https://services.cigam.cloud http://services.cigam.cloud;

 
'''Lembre-se de que, caso esteja com um ambiente com sites separados, além dessas URLs da Cia, é necessário incluir os endereços dos demais sites.'''

====Como configurar o acesso aos cookies no IIS?====

Para permitir que a Cia acesse os Cookies das aplicações, será necessário ajustar algumas permissões. Siga os passos abaixo:
* Acesse o '''Editor de Configurações''' no painel do IIS, localize a opção '''Editor de Configurações''' dentro da seção '''Gerenciamento'''.


[[Imagem:Gerenciamento.png|semmoldura|centro|800px]]
 
 

* Ajuste as configurações em '''httpCookies''':
** Navegue até a seção '''system.web''' e localize a configuração '''httpCookies'''.
** Defina os seguintes valores:
** requireSSL: True
** sameSite: None


[[Imagem:httpCookies.png|semmoldura|centro|800px]]
 


* Configuração de '''sessionState''':
** Ainda em '''system.web''', localize a configuração '''sessionState'''. 
** Altere o valor da propriedade '''cookieSameSite''' para '''None'''.


[[Imagem:sessionStage.png|semmoldura|centro|850px]]
 
Essas configurações garantem que os cookies sejam transmitidos com segurança e permitam o uso adequado em aplicações externas, atendendo aos requisitos da Cia.
{{VoltarInicio}}

==Ambientes internos sem acesso externo às aplicações==

Este ambiente possui acesso restrito à rede interna da empresa e utiliza o protocolo HTTP. Por esse motivo, algumas funcionalidades da Cia serão desabilitadas automaticamente — como recursos que exigem permissões avançadas do navegador, como o uso do microfone, ou o acesso dinâmico a iframes (componentes que permitem exibir conteúdos de outros sistemas dentro da mesma tela, como Portais).
 
'''Importante:''' Você não precisa se preocupar. A Cia detecta automaticamente essas limitações e desativa ou oculta as funcionalidades afetadas, garantindo que a experiência continue fluida e segura. Sempre que necessário, você será notificado com orientações claras sobre o que fazer.
 
Para mais informações sobre a importância do uso do HTTPS, acesse: [[GE - Importância do uso do HTTPS|Importância do uso do HTTPS]]


==Garantindo permissão de acesso aos cookies de terceiros no navegador==

Por padrão, os navegadores geralmente têm a permissão para Cookies de terceiros habilitada. No entanto, é importante verificar e assegurar essa configuração. Abaixo estão os passos para os navegadores '''Microsoft Edge''' e '''Google Chrome''': 
 
* Microsoft Edge
** Em Português:
*** Acesse Configurações → Cookies e permissões de sites → Gerenciar e excluir cookies e dados do site.
*** Desabilite a opção "Bloquear cookies de terceiros".
** Em Inglês:
*** Acesse Settings → Cookies and Site Permissions → Manage and delete cookies and site data.
*** Desabilite a opção "Block third-party cookies".


[[Imagem:settingsEdge.png|semmoldura|centro|800px]]
 
 

* Google Chrome:
** Em Português:
*** Vá para Configurações → Privacidade e segurança → Cookies de terceiros.
*** Habilite a opção "Permitir cookies de terceiros".
** Em Inglês:
*** Vá para Settings → Privacy and security → Third-party cookies.
*** Habilite a opção "Allow third-party cookies".


[[Imagem:settingsChrome.png|semmoldura|centro|800px]]

==Dispositivos móveis==

A Cia também oferece suporte para dispositivos móveis, proporcionando acesso prático e otimizado. Para utilizar a Cia em um dispositivo móvel, basta acessar o endereço normalmente pelo seu navegador. Ao entrar, será exibida uma mensagem convidando o usuário a instalar o aplicativo. A instalação também pode ser realizada diretamente através do ícone de engrenagem, no menu de configurações.


[[Imagem:CiaInstalarAppMobile.png|semmoldura|centro|700px]]


É importante destacar que a instalação do aplicativo no dispositivo móvel só será possível se o ambiente estiver configurado para utilizar HTTPS. Caso contrário, o usuário só poderá acessar a Cia diretamente pelo próprio navegador móvel, porém com algumas restrições de funcionalidades.

{{VoltarInicio}}

=Portais=
Nos Portais CIGAM, os recursos da Cia possuem exigências diferentes de configuração. Os itens abaixo indicam o que é necessário em cada caso. 

==Acesso à Cia Web (SaaS) pelo menu mosaico==
O acesso à Cia a partir do menu de mosaico (Cia - IA do CIGAM) abre a Cia Web (SaaS). Por esse motivo, depende das configurações descritas na seção [[#Cia Web (SaaS)|Cia Web (SaaS)]], em especial: 
* [[#Configurações para Cia no CIGAM|Configurações para Cia no CIGAM]], conforme o ambiente possua um único site ou mais de um.
* [[#Autenticação em duas etapas e configurações de envio de e-mail|Autenticação em duas etapas e configurações de envio de e-mail]].
* As configurações de ambiente, como CSP, cookies e permissões do navegador.
 
[[Imagem:mosaicoCia.png|semmoldura|centro|650px]]
 
Para mais informações sobre como configurar nomes lógicos e o menu mosaico, consulte: [[GE - Como Fazer - Configuração do menu mosaico nos Portais Web]] 

==Agentes e opções generativas==
Não é necessária nenhuma parametrização para utilizar os '''agentes''' e as '''opções generativas''' disponíveis no menu da Cia nos Portais, como melhoria de texto e revisão gramatical. Esses recursos são disponibilizados automaticamente, de acordo com o contexto da tela, e não dependem das configurações de local de instalação nem da autenticação em duas etapas. 
 
Os agentes estão disponíveis a partir da versão '''Beta 260601''', e o '''Editor de Agentes''' a partir da versão '''Beta 261005''', tanto para os Portais MVC quanto para os Portais React. 
 
[[Imagem:MenuCiaPortais.png|semmoldura|centro|600px]]
 
Para saber como utilizar esses recursos, consulte: [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer uso da Cia IA do CIGAM]]
{{VoltarInicio}}

=Desktop=
Na aplicação Desktop, os recursos da Cia possuem exigências distintas de configuração: 
 
{| class="wikitable"
|-
| '''Recurso''' || '''Configuração necessária'''
|-
| '''Acesso rápido à Cia - IA do CIGAM''' || Exige API e Portais instalados, além das configurações da Cia Web (SaaS).
|-
| '''Analisar com a Cia''' || Não exige parametrização no CIGAM. Requer a versão 250505 patch A ou superior e o navegador padrão e a extensão .html configurados no Windows.
|}

==Acesso rápido à Cia Web (SaaS)==
O botão de acesso rápido (Cia - IA do CIGAM) disponível no menu lateral do Desktop abre a Cia Web (SaaS) em uma janela integrada ao sistema. Por esse motivo, depende de: 
* A API e os Portais instalados, pois são eles que conectam o sistema aos dados do ERP. '''Sem a API, a funcionalidade não funcionará'''.
* As configurações descritas na seção [[#Cia Web (SaaS)|Cia Web (SaaS)]], em especial [[#Configurações para Cia no CIGAM|Configurações para Cia no CIGAM]] e [[#Autenticação em duas etapas e configurações de envio de e-mail|Autenticação em duas etapas e configurações de envio de e-mail]].
 
[[Imagem:CiaIA.png|semmoldura|centro|800px]]
 

==Recurso "Analisar com a Cia"==
O recurso '''"Analisar com a Cia"''', disponível em ferramentas como CGEditor, CGReport, Pesquisa Dinâmica e Dispositivo de Saída, não exige nenhuma parametrização no CIGAM. Ele também não depende da autenticação em duas etapas nem das configurações de local de instalação dos Portais. 
 
Exemplo do recurso disponível na Pesquisa Dinâmica: 
 
[[Imagem:PesquisaDinamicaComCia.png|semmoldura|centro|800px]]
 
Os requisitos para utilização são: 
* Estar na versão '''250505 patch A''' ou superior.
* Ter um '''navegador padrão configurado no Windows''', preferencialmente o '''Google Chrome''' ou o '''Microsoft Edge''', por serem os navegadores homologados pela CIGAM.
* Ter a '''extensão .html''' associada a um desses navegadores, para que o conteúdo enviado à Cia seja aberto corretamente.
 
[[Imagem:NavegadorPadraoWindows.png|semmoldura|centro|800px]]
 
Para mais informações sobre os navegadores homologados, acesse: [[Requisitos_de_Software#Versões_de_Navegadores|Versões de navegadores]] 
 
Para saber como utilizar o recurso, consulte: [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer uso da Cia IA do CIGAM]]

=Documentos Relacionados=
[[GE - Como Fazer - Cia - Como acessar]] 
[[GE - Como Fazer - Uso da Cia - IA do CIGAM]] 
[[GE - Importância do uso do HTTPS]] 
[[GE Autenticação em duas etapas]] 
[[GE - Como Fazer - Configuração de Envio de E-mail no CIGAM]] 
[[GE - Como Fazer - Configuração do menu mosaico nos Portais Web]]
{{VoltarInicio}}

GE - Como Fazer - Cia - Como acessar

2026-09-24T13:53:19Z

Roger.schneider: /* Recurso "Analisar com a Cia" */

{{VoltarPagina}}
 
[[categoria:Como_Fazer_Utilidades/Diversos]]
[[categoria:Como_Fazer_Utilidades/Diversos_6]]
[[MediaWiki:Como_Fazer_sidebar|Como Fazer]] > [[Como_Fazer_Utilidades/Diversos|Utilidades/Diversos]] > [[GE - Como Fazer - Cia - Como acessar|Cia - Como acessar]]

=Cia - IA do CIGAM=
A Cia - IA do CIGAM oferece diversas funcionalidades e atua como um hub centralizador para os recursos de inteligência artificial utilizados nas soluções CIGAM. Para garantir o correto funcionamento desses recursos, é necessário verificar se os pré-requisitos e as configurações foram realizados adequadamente. Para mais informações, consulte: [[GE - Como Fazer - Configuração da Cia IA do CIGAM|Como Fazer configuração da Cia IA do CIGAM]]. 
 
Todas as soluções de IA do CIGAM são integradas por meio dos serviços da Cia. A Cia possui integração com diferentes provedores de IA de terceiros, como OpenAI, Google, Anthropic, entre outros. Essas integrações são realizadas por meio de contas e serviços contratados, com condições de uso que asseguram que os dados trafegados não sejam utilizados para treinamento dos modelos, identificação de origem, publicidade, anúncios ou qualquer outra finalidade não prevista. 
 
Em todos os recursos disponibilizados, a IA do CIGAM respeita os direitos e permissões dos usuários, garantindo que cada função seja utilizada de acordo com as autorizações, independentemente da plataforma. 

==Formas de acesso==
A Cia pode ser acessada a partir de diferentes pontos das soluções CIGAM:

{| class="wikitable"
|-
| '''Forma de acesso''' || '''Descrição''' || '''Onde consultar'''
|-
| '''Cia Web (SaaS)''' || Aplicação web que centraliza todas as funcionalidades da Cia. Pode ser acessada diretamente pelo navegador ou em dispositivos móveis, ou então através do CIGAM e Portais. || [[#Cia Web (SaaS)|Cia Web (SaaS)]]
|-
| '''Portais CIGAM''' || Acesso à Cia e aos agentes pelo menu de mosaico, além dos comandos de IA disponíveis nos campos de texto dos Portais. || [[#Portais|Portais]]
|-
| '''Aplicação Desktop''' || Acesso rápido à Cia pela barra lateral, assistente de voz, ditado e o recurso "Analisar com a Cia" em ferramentas do sistema. || [[#Desktop|Desktop]]
|}
{{VoltarInicio}}

=Cia Web (SaaS)=
A Cia Web é uma aplicação web que centraliza todas as funcionalidades da Cia - IA do CIGAM. É por meio dela que os recursos de inteligência artificial são disponibilizados às demais soluções, seja pelos Portais, pela aplicação Desktop ou pelas ferramentas que possuem integração com a Cia. 

==Acesso pela URL oficial==
A Cia Web pode ser acessada diretamente pelo navegador do seu computador ou dispositivo móvel, utilizando o seguinte endereço:
 
https://services.cigam.cloud/cia/index.html 
 
Para acessar, é necessário que o usuário tenha a autenticação em duas etapas configurada, conforme descrito em [[GE - Como Fazer - Configuração da Cia IA do CIGAM#Autenticação em duas etapas e configurações de envio de e-mail|Autenticação em duas etapas e configurações de envio de e-mail]]
 
 
O acesso também está condicionado às demais configurações descritas em [[GE - Como Fazer - Configuração da Cia IA do CIGAM|Como Fazer configuração da Cia IA do CIGAM]].
 
 
Para saber como utilizar os recursos disponíveis, consulte [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer uso da Cia IA do CIGAM]]
 
 
[[Imagem:CiaAberta.png|semmoldura|centro|800px]]

==Acesso a partir dos Portais e do Desktop==
Além do acesso direto pelo navegador, a Cia Web também pode ser aberta de dentro das demais soluções CIGAM: 
* Pelos Portais CIGAM, conforme descrito em [[#Portais|Portais]];
* Pela aplicação Desktop, conforme descrito em [[#Acesso rápido à Cia Web (SaaS)|Acesso rápido à Cia Web (SaaS)]].

=Portais=
==Acesso à Cia Web (SaaS)==
O acesso da Cia através dos Portais CIGAM ocorre dentro do ícone de mosaico, onde existe o ícone de acesso à Cia - IA do CIGAM:

[[Imagem:mosaicoCia.png|semmoldura|centro|800px]]
 
O acesso será imediato ao clicar, desde que todas as configurações indicadas no documento tenham sido aplicadas conforme [[GE - Como Fazer - Configuração da Cia IA do CIGAM|Como Fazer configuração da Cia IA do CIGAM]]. 

==Comandos de IA em campos de texto==
Além do acesso à Cia, na barra superior dos Portais estará disponível um ícone com um menu de contexto, permitindo interações com os '''campos de texto''' em qualquer parte dos Portais. Com ele, você pode melhorar textos, criar conteúdos, revisar gramática, entre outras funções. 

[[Imagem:comandosCia.png|semmoldura|centro|650px]]

===Telas modais===
Essa funcionalidade também está disponível para telas modais (janelas sobrepostas com interações):

[[Imagem:comandosModalCia.png|semmoldura|centro|800px]]

==Menu de agentes==
A partir da versão '''Beta 260601''', o menu da Cia nos Portais foi alterado e passou a disponibilizar o acesso aos agentes. 
 
Além das opções generativas, como melhoria de texto, revisão gramatical, entre outras, o menu passou a apresentar também os agentes disponíveis de acordo com o contexto da tela e com os parâmetros definidos. Esses agentes são carregados automaticamente conforme esses requisitos. 
 
O menu está disponível tanto para os Portais MVC quanto para os Portais React. 
 
Para saber como utilizar os agentes, consulte: [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer uso da Cia IA do CIGAM]]
 
[[Imagem:MenuAgentesCia.png|semmoldura|centro|800px]]

===Editor de agentes===
A partir da versão '''Beta 261005''', o menu passou a disponibilizar também o acesso à ferramenta '''Editor de Agentes''', que permite criar seus próprios agentes. 
 
[[Imagem:EditorAgentesCia.png|semmoldura|centro|800px]]
 
Para saber como utilizar o Editor de Agentes, consulte: [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer uso da Cia IA do CIGAM]]
 
{{VoltarInicio}}

=Desktop=
==Cia Assistente==
O ícone da Cia estará visível na barra superior do CIGAM assim que o sistema for inicializado. 

[[Imagem:Img9.png|semmoldura|centro|800px]]
 
Ao clicar no ícone, a assistente virtual será ativada, juntamente com seus componentes de reconhecimento de voz. Além disso, uma barra lateral será exibida com algumas opções de utilização. Quando ativa, a assistente permite a interação por comandos de voz e também pode emitir mensagens e notificações por áudio. 

[[Imagem:Img10.png|semmoldura|centro|800px]]
 

==Acesso rápido à Cia Web (SaaS)==
Dentro do menu na lateral, há um botão de acesso rápido para abrir a Cia - IA do CIGAM:

[[Imagem:CiaIA.png|semmoldura|centro|800px]]
 
'''Importante:''' Para usar essa funcionalidade no desktop, é preciso ter a API e seus portais instalados, pois eles conectam o sistema aos dados do ERP. Sem a API, a funcionalidade não vai funcionar, apresentando uma mensagem de erro. Se todas as configurações estiverem corretas, ao clicar no botão, a Cia será aberta em uma janela integrada ao sistema. 
Caso ocorra algum problema na abertura devido a configurações ausentes ou incorretas, consulte a documentação: [[GE - Como Fazer - Configuração da Cia IA do CIGAM|Como Fazer configuração da Cia IA do CIGAM]].
 

[[Imagem:CiaAbertaDesktop.png|semmoldura|centro|800px]]
 
{{VoltarInicio}}

==Recurso "Analisar com a Cia"==
Algumas ferramentas do CIGAM disponibilizam o recurso '''"Analisar com a Cia"''', que permite enviar o conteúdo em uso diretamente para a Cia, sem sair da ferramenta. O comportamento é o mesmo em todas as ferramentas: o conteúdo é enviado para análise e a resposta é apresentada pela Cia, respeitando os direitos e permissões do usuário.
 
 
Esse recurso está disponível a partir da versão '''250505.a'''.
 
 
Para saber como utilizar o recurso, em qualquer uma das ferramentas, consulte: [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer uso da Cia IA do CIGAM]]
 
 
O recurso está disponível nas seguintes ferramentas: 

===Pesquisa Dinâmica / Pesquisa Paginada===
Para utilizar o recurso, basta acessar qualquer programa do CIGAM que contenha uma pesquisa dinâmica/paginada, como o cadastro de Ordem de Serviço. A opção '''"Analisar com a Cia"''' estará disponível no menu superior da tela. 
 
[[Imagem:PesquisaDinamicaComCia.png|semmoldura|centro|800px]]
 
 
Para mais informações sobre a Pesquisa Dinâmica, consulte: [[GE - Como Fazer - Pesquisa Dinâmica#Pesquisa Dinâmica Desktop|Pesquisa Dinâmica Desktop]]

===CGEditor===
Para utilizar o recurso, basta estar com o arquivo que deseja analisar aberto e clicar no ícone '''"Visualizar Impressão"'''. 
 
[[Imagem:VisualizarImpressao.png|semmoldura|centro|800px]]
 
Será aberta uma nova janela, na qual estará disponível a opção '''"Analisar com a Cia"'''. 
 
[[Imagem:EditorAnalisarComCia.png|semmoldura|centro|800px]]
 

===CGReport===
Para utilizar o recurso, basta estar com a consulta montada e clicar no ícone '''"Pré-Visualizar"'''. 
 
[[Imagem:PreVisualizar.png|semmoldura|centro|800px]]
 
O relatório será processado e gerado e, na tela apresentada, estará disponível a opção '''"Analisar com a Cia"'''. 
 
[[Imagem:ReportAnalisarComCia.png|semmoldura|centro|800px]]
 

===Dispositivo de Saída===
O Dispositivo de Saída é um visualizador de arquivos, com a finalidade de exibir, salvar e editar relatórios gráficos e de caracteres. Nessa funcionalidade também é possível indicar a impressão e configurar a orientação e o tipo da página. 
 
Ao acessar o Dispositivo de Saída, por exemplo através do atalho '''Ctrl + P''' ou através do menu '''Acesso Rápido''', a opção '''"Analisar com a Cia"''' estará disponível no menu lateral. 
 
[[Imagem:DispositivoSaidaComCia.png|semmoldura|centro|800px]]
 
 
Para mais informações, consulte: [[GE Acesso rápido|Acesso rápido]]
{{VoltarInicio}}

==Grupo do chat==
No grupo do chat, existem algumas opções que facilitam a consulta de informações, permitindo que as solicitações sejam atendidas com mais precisão de acordo com o assunto. As opções disponíveis são:
 
'''Geral:''' Para conversar sobre assuntos gerais. 
'''Suporte:''' Para tratar de questões relacionadas ao suporte e solução de problemas. 
'''Configurações:''' Para obter informações sobre como configurar o CIGAM. 
'''Como Fazer:''' Para aprender a utilizar funcionalidades específicas do CIGAM. 
'''RH:''' Para questões relacionadas a Recursos Humanos. 

[[Imagem:Img11.png|semmoldura|centro|800px]]
 

==Grupo assistente==
A assistente virtual oferece comandos pré-definidos que podem ser utilizados para interações via áudio. Esses comandos podem ser acionados de duas formas: 
1. Por comando de voz: Basta falar o comando para que a assistente responda. 
2. Por seleção manual: O usuário pode clicar em um comando para que a assistente execute a ação e forneça uma resposta em áudio.
 
Além disso, é possível pesquisar os comandos disponíveis para facilitar a localização de um comando de voz específico. 

[[Imagem:Img12.png|semmoldura|centro|800px]]
 
[[Imagem:Img13.png|semmoldura|100px|esquerda]]   Indica um comando de voz '''executável por clique''', ou seja, ao clicar no ícone, a assistente executa a ação e fornece uma resposta por áudio. 
[[Imagem:Img14.png|semmoldura|100px|esquerda]]   Indica um comando de voz que '''deve ser ditado pelo usuário.''' Esse ícone serve apenas para informar que o comando existe e pode ser utilizado via fala, sem resposta ao clique. 

Os comandos de voz acionados por clique serão reordenados automaticamente conforme sua frequência de uso, facilitando o acesso aos comandos mais utilizados. 

===Quais são os comandos interpretados pela Cia?===
A implementação do reconhecimento de voz no CIGAM está implementada de maneira básica. 
Para isso, estão disponíveis os seguintes comandos: 
 
{| class="wikitable"
|-
| '''Tipo''' || '''Comando de voz''' || '''Resultado''' || '''A tela deve estar'''
|-
|rowspan="13"| '''Métodos''' || Cia mostrar acesso rápido || Mostra o painel Acesso rápido || Ativa
|-
| Cia mostrar alertas || Mostra o painel Alertas || Ativa
|-
| Cia fechar alertas || Fecha o painel Alertas pois é um painel lateral || Ativa
|-
| Cia mostrar início || Mostra o painel Início || Ativa
|-
| Cia mostrar favoritos || Mostra o painel Favoritos || Ativa
|-
| Cia mostrar histórico || Mostra o painel Histórico || Ativa
|-
| Cia mostrar mais acessados || Mostra o painel Mais acessados || Ativa
|-
| Cia mostrar marcadores || Mostra o painel Marcadores || Ativa
|-
| Cia mostrar utilidades || Mostra o painel Utilidades || Ativa
|-
| Cia mostrar pesquisar || Mostra o painel Pesquisar || Ativa
|-
| Cia fechar pesquisar || Fecha o painel Pesquisar pois é um painel lateral || Ativa
|-
| Cia escolher área || Mostra o painel para selecionar qual área posicionar. Só irá responder a esse comando caso esteja no painel Início
|| Ativa
|-
| Cia ler este campo || Lê o campo que está posicionado na tela || Ativa
|-
| rowspan="17"| '''Teclas''' || Cia vá para cima || Pressiona a tecla seta para cima || Ativa
|-
| Cia vá para baixo || Pressiona a tecla seta para baixo || Ativa
|-
| Cia vá para direita || Pressiona a tecla seta para a direita || Ativa
|-
| Cia vá para esquerda || Pressiona a tecla seta para a esquerda || Ativa
|-
| Cia modificar || Pressiona a tecla Ctrl+M || Ativa
|-
| Cia pesquisar || Pressiona a tecla Ctrl+Q || Ativa
|-
| Cia criar || Pressiona a tecla Ctrl+I || Ativa
|-
| Cia entrar || Pressiona a tecla Enter || Ativa
|-
| Cia voltar || Aciona o comando de voltar navegação do menu. Equivale ao pressionamento de Ctrl + Seta para esquerda || Ativa
|-
| Cia zoom || Pressiona a tecla F5 || Ativa
|-
| Cia focar || Quando um painel tem mais de um container de mosaicos, alterna o foco entre eles. Exemplo de uso: painéis que tem treeview de divisões (cadastros, movimentos, pesquisas, relatórios...) e também outro container com os mosaicos daquela divisão. Equivale ao pressionamento do Ctrl + Tab. Como o foco irá mudar de container, esse comando automaticamente sai do modo “procurar” se ele estiver ativo. || Ativa
|-
| Cia fechar esta tela || Fecha a tela através do pressionamento da tecla Esc. || Ativa
|-
| Cia capturar esta tela || Faz um print da área de trabalho e coloca na área de transferência || Ativa
|-
| Cia capturar esta tela e salvar || Salva em arquivo o print da área de trabalho || Ativa
|-
| Cia próximo campo || Salta para o próximo campo da tela através do pressionamento da tecla Tab || Ativa
|-
| Cia campo anterior || Salta para o campo anterior da tela através do pressionamento das teclas Shift + Tab || Ativa
|-
| Cia selecionar tudo || Seleciona o conteúdo do campo focado. Equivale a um Ctrl + A. || Ativa
|-
|rowspan="19"| '''Interação''' || Cia aumentar volume || Aumenta o volume da saída de som da aplicação || Indiferente
|-
| Cia diminuir volume || Diminui o volume da saída de som da aplicação || Indiferente
|-
| Cia bom dia || Cumprimento || Ativa
|-
| Cia boa tarde || Cumprimento || Ativa
|-
| Cia boa noite || Cumprimento || Ativa
|-
| Cia que dia é hoje? || Fala a data atual || Ativa
|-
| Cia que horas são? || Fala a hora atual || Ativa
|-
| Cia você me entendeu? || Refaz o reconhecimento da última frase para verificar se tem alguma frase de reconhecimento vinculada que não tenha sido reconhecida anteriormente. || Ativa
|-
| Cia a internet está conectada? || Verifica se o usuário logado tem acesso à internet. || Ativa
|-
| Cia qual sua idade? || Responde com a idade da assistente, que é a idade da empresa Cigam. || Ativa
|-
| Cia me fale sobre assistente virtual || Responde falando a definição || Ativa
|-
| Cia me fale sobre você || Dá uma breve explicação sobre o assistente de voz || Ativa
|-
| Cia me fale sobre o CIGAM || Dá uma breve explicação sobre o produto || Ativa
|-
| Cia qual melhor sistema/software de gestão? || Responde a pergunta || Ativa
|-
| Cia você está me escutando? || É um comando para teste de reconhecimento de entrada e sintetização de saída. || Indiferente
|-
| Cia muito obrigado || Encerra a fala e agradece || Ativa
|-
| Cia pare || Encerra a fala de forma abrupta || Indiferente
|-
| Cia cadê você? || Ativa/foca a tela principal do CIGAM || Indiferente
|-
| Cia repita || Repete a última fala. As falas de diálogos não possuem suporte a repetição pois elas estão vinculadas a um contexto sequencial. || Indiferente
|-
| rowspan="30"| '''Negócio''' || Cia quais os valores a pagar? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o valor a pagar em atraso? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais os valores a receber? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o valor a receber em atraso? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais atendimentos tenho para hoje? ||Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais os atendimento de hoje? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais os alertas de hoje? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais as oportunidades tenho para hoje? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais as oportunidades de hoje? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais as oportunidades tenho para amanhã? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais as oportunidades de amanhã? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o total de ordens de serviços em aberto? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o total de OS's? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais os tipos de ordens de serviços em aberto? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais as OS's abertas? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quantas horas tenho registrado hoje? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual meu total de horas hoje? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quantas horas tenho registrado esta semana? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual meu total de horas nesta semana? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais as ordens de compra para recebimento hoje? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais as OC's para hoje? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o saldo atual? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o total de alçadas para aprovação? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais as alçadas para aprovação? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o valor vendido hoje? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o valor vendido ontem? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o valor faturado hoje? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o valor faturado ontem? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o valor dos pedidos para faturamento? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o valor dos pedidos para faturar? || Consulta a base de dados para montar a resposta || Ativa
|-
| rowspan="17"| '''Comandos''' || Cia faça pra mim || Irá abrir o microfone em modo comando para que o usuário dê a instrução do que fazer. Essa opção exige internet pois irá utilizar o modo ditado. '''Importante:''' Os comandos para tarefas para essa opção são aqueles que podem ter um conteúdo variável ou algum dado que precise ser verificado no momento do comando. Por exemplo “abrir lançamentos 123”. Nesse caso o valor “123” é o valor variável. Após o sinal de abertura do microfone, pode-se falar uma das tarefas a seguir: || Ativa
|-
| '''Tarefas''' → pesquisar previsão do tempo para [localidade] || Previsão do tempo para a localidade de acordo com a fonte CPTEC/Inpe. Exemplo: “previsão do tempo para Novo Hamburgo” || Ativa
|-
| '''Tarefas''' → pesquisar cotação do ou da [moeda] || Cotação da moeda em reais de acordo com o Banco Central do Brasil. Moedas disponíveis: - Dólar - Dólar Australiano - Dólar Canadense - Euro - Iene - Libra Esterlina - Franco Suíço - Coroa Dinamarquesa - Coroa Norueguesa - Coroa Sueca Exemplos: “buscar cotação do dólar” e “buscar cotação da libra esterlina” || Ativa
|-
| '''Tarefas''' → pesquisar no menu por [palavra chave] || Procura no menu por itens com a palavra chave e exibe os resultados no painel de pesquisa. Exemplo: “pesquisar por lançamentos” || Ativa
|-
| '''Tarefas''' → pesquisar aqui por [palavra chave] || Procura no local atual um item de menu pela palavra chave. Se encontrar, foca no item. Exemplo: “procurar aqui por pedidos” || Ativa
|-
| '''Tarefas''' → clicar no botão [nome do botão] ou clicar na página [nome da página] || Clica num determinado controle da tela, que pode ser do tipo botão ou página (guias). O controle deve estar visível e na tela em primeiro plano. Exemplos: “clicar no botão confirmar” “clicar na página financeiro” || Ativa
|-
| '''Tarefas''' → o que é [palavra chave] || Pesquisa no Wikipédia em português || Ativa
|-
| '''Tarefas''' → pesquisar sobre [palavra chave] || Pesquisa no Google em português || Ativa
|-
| '''Tarefas''' → pesquisar vídeos sobre [palavra chave] || Pesquisa vídeos no YouTube. || Ativa
|-
| '''Tarefas''' → abrir mapa [endereço] || Abre o mapa para o endereço no Google Maps. Exemplos: - abrir mapa rua vereador adão rodrigues de oliveira 524 em novo hamburgo - abrir mapa rua cruzeiro do sul gravataí - abrir mapa avenida frederico linck em novo hamburgo || Ativa
|-
| '''Tarefas''' → abrir [categoria menu] [programa do menu] [parâmetro] || Abre um item no menu do CIGAM. Essa opção abrange todos os itens de menu, inclusive os personalizados pelo usuário. O reconhecimento poderá ser feito das seguintes formas: a) Utilizando a categoria do menu, com ou sem plural: “abrir movimento estoque” ou “abrir movimentos estoque” Neste caso, existe um item de menu chamado “Estoque” dentro da categoria “Movimentos”. b) Sem a categoria do menu: “abrir estoque” Indiferente da forma utilizada anteriormente, poderá ser informado um parâmetro para qual registro posicionar '''Importante:''' O parâmetro será a chave-única do registro, não contemplando chaves compostas. Exemplos: “abrir movimento estoque 123” ou “abrir estoque 123”||Ativa
|-
| '''Tarefas''' → calcular [fórmula] || Executa um cálculo conforme os operadores e fatores passados. Exemplos: - calcular 10 mais 10 - calcular 10 menos 5 - calcular 10 mais 50 mais 20 porcento - calcular 10 mais 30 vezes 10 porcento - calcular 50 vezes 15 porcento - calcular 150 ponto 38 vezes 17 - calcular 100 dividido por 25 || Ativa
|-
| Cia aprenda comigo || Executa o comando “Cia faça pra mim”, porem com suporte a aprendizado dos comandos que forem falados. Os novos comandos serão imediatamente disponibilizados. || Ativa
|-
| '''Tarefas''' → apelidar [comando existente] para o apelido [apelido] || Ensina um apelido para um comando já existente. Exemplo: “apelidar mostrar favoritos para o apelido mostrar preferidos” || Ativa
|-
| '''Tarefas''' → apelidar esse programa para o apelido [apelido para o programa aberto] || Ensina um apelido para o programa que está aberto. Se considerado o programa principal, ou seja, aquele que pode ser acessado através de um item de menu. Exemplo: “apelidar esse programa para o apelido indicadores da poupança” (nesse exemplo, o programa “Índices” está aberto) || Ativa
|-
| '''Tarefas''' → quando eu falar [minha fala] me fale [fala] ou quando eu perguntar [minha pergunta] me responda [resposta] || Ensina uma resposta/fala para quando uma fala especifica for falada
Exemplos: "quando eu falar está tudo bem me fale está tudo ótimo" "quando eu perguntar quem eu sou me responda você é meu amigo"
|| Ativa
|-
| '''Tarefas''' → faça [comando do faça pra mim] quando eu falar [fala] || Ensina a ir diretamente num comando do faça pra mim a partir de um apelido. Exemplo: “faça pesquisar cotação do dólar quando eu falar cotação do dólar hoje” || Ativa
|-
|rowspan="7"| '''Músicas''' || Cia tocar minhas músicas || Iniciar o player de músicas. As músicas serão buscadas na pasta de músicas do usuário do Windows, em C:\Usuários\<usuáro>\Musicas e uma lista será montada a partir dos arquivos de música encontrados nesse local. Serão reconhecidos os formatos .mp2, .mp3 e .wma.|| Ativa
|-
| Cia tocar próxima música || Salta para a próxima trilha da lista de músicas || Indiferente
|-
| Cia tocar música anterior || Volta para a trilha anterior da lista de músicas || Indiferente
|-
| Cia parar minhas músicas || Encerra o player de músicas || Indiferente
|-
| Cia volume baixo para as músicas || Ajusta a saída de áudio do player com um volume baixo || Indiferente
|-
| Cia volume médio para as músicas || Ajusta a saída de áudio do player com um volume médio || Indiferente
|-
| Cia volume alto para as músicas || Ajusta a saída de áudio do player com um volume alto || Indiferente
|}
{{VoltarInicio}}

==Ditado==
===Como fazer para abrir o ditado através da Cia?===
Para abrir o ditado através do comando de voz, basta estar com um microfone conectado e falar “Cia, mostrar ditado”, ou clicar na opção no grupo Ditado.

[[Imagem:ImgCia1.png|semmoldura|centro|300px]]

[[Imagem:ImgCia2.png|semmoldura|centro|750px]]

Ao abrir o ditado existem as seguintes opções e Menu: 

[[Arquivo:ImgCia3.png|50x25px|esquerda]]   Sair – Atalho '''“Esc”'''

[[Arquivo:ImgCia4.png|50x25px|esquerda]]   Abrir/Fechar Microfone

[[Arquivo:ImgCia5.png|50x25px|esquerda]]   Colar conteúdo do ditado no campo focado – Atalho '''“Control + Shift + V”'''

[[Arquivo:ImgCia6.png|50x25px|esquerda]]   Copiar conteúdo de ditado para área de transferência – Atalho '''"Control + Shift + C”'''

[[Arquivo:ImgCia7.png|50x25px|esquerda]]   Ler o conteúdo do campo focado – Atalho '''“Control + Shift + L”'''

É possível dar alguns comandos como:

{| class="wikitable"
|-
| rowspan="2"| '''Ditado''' || Cia mostrar ditado || Abre ou foca na tela do ditado contínuo O ditado poderá ser feito alternando pausas sem tempo definido para término. Neste caso, para encerramento e utilização do conteúdo será necessário a interação do usuário através dos botões na área de topo. Estão disponíveis os comandos especiais dentro do ditado para tratamentos de caracteres: - nova linha - ponto final - ponto e vírgula - dois pontos - vírgula - interrogação - exclamação - aspas - aspa - hífen - abre parênteses - abre parêntese - fecha parênteses - fecha parêntese - asterisco - arroba - abre chave - fecha chave - abre colchete - fecha colchete || Ativo
|-
| Cia ditar este campo || Inicia o ditado não-contínuo ou de frase. Após o término da fala, o ditado será automaticamente encerrado e o conteúdo ditado será automaticamente colado no campo que estava focado quando o ditado foi iniciado. || Ativa
|}

===Como exibir os resultados parciais ao ditar um campo para a Cia?===
Ao abrir um programa e executar o comando '''Cia ditar este campo''', é possível visualizar os resultados parciais através de uma tela ou então ter somente a exibição ao finalizar o ditado. Essa configuração é feita através do acesso ao ‘Perfil de Usuários’ na opção: ‘Resultados Parciais em Ditado’, onde possibilita a exibição parcial da informação. Por padrão, a opção vem como Ocultar.

[[Imagem:ImgCia8.png|semmoldura|centro|650px]]
{{VoltarInicio}}

=Go-Global=
A execução do CIGAM em um ambiente de nuvem privada por meio da solução Go-Global permite o acesso remoto a aplicativos Windows de qualquer local, plataforma e sistema operacional. No entanto, essa implementação apresenta algumas particularidades que requerem atenção, especialmente no que se refere a comandos de voz, fala e ditado na Cia, os quais possuem restrições. 
 
'''Lista de particularidades'''
* Sem suporte para tráfego de áudio, exceto bipes;
 
* Sem suporte para microfone ou caixas de som – apesar de esses dispositivos poderem permanecer ativos no Windows, eles não funcionarão devido à ausência de suporte para tráfego de áudio;
 
* Sem suporte para reconhecimento ou sintetização de voz em texto, o que impede a utilização e atualização das funcionalidades da Cia relacionadas a comandos de voz, fala e ditado.
{{VoltarInicio}}

=Documentos Relacionados=
[[GE - Como Fazer - Uso da Cia - IA do CIGAM]] 
[[GE - Como Fazer - Configuração da Cia IA do CIGAM]]

GE - Como Fazer - Cia - Como acessar

2026-09-24T13:52:29Z

Roger.schneider: /* Menu de agentes */

{{VoltarPagina}}
 
[[categoria:Como_Fazer_Utilidades/Diversos]]
[[categoria:Como_Fazer_Utilidades/Diversos_6]]
[[MediaWiki:Como_Fazer_sidebar|Como Fazer]] > [[Como_Fazer_Utilidades/Diversos|Utilidades/Diversos]] > [[GE - Como Fazer - Cia - Como acessar|Cia - Como acessar]]

=Cia - IA do CIGAM=
A Cia - IA do CIGAM oferece diversas funcionalidades e atua como um hub centralizador para os recursos de inteligência artificial utilizados nas soluções CIGAM. Para garantir o correto funcionamento desses recursos, é necessário verificar se os pré-requisitos e as configurações foram realizados adequadamente. Para mais informações, consulte: [[GE - Como Fazer - Configuração da Cia IA do CIGAM|Como Fazer configuração da Cia IA do CIGAM]]. 
 
Todas as soluções de IA do CIGAM são integradas por meio dos serviços da Cia. A Cia possui integração com diferentes provedores de IA de terceiros, como OpenAI, Google, Anthropic, entre outros. Essas integrações são realizadas por meio de contas e serviços contratados, com condições de uso que asseguram que os dados trafegados não sejam utilizados para treinamento dos modelos, identificação de origem, publicidade, anúncios ou qualquer outra finalidade não prevista. 
 
Em todos os recursos disponibilizados, a IA do CIGAM respeita os direitos e permissões dos usuários, garantindo que cada função seja utilizada de acordo com as autorizações, independentemente da plataforma. 

==Formas de acesso==
A Cia pode ser acessada a partir de diferentes pontos das soluções CIGAM:

{| class="wikitable"
|-
| '''Forma de acesso''' || '''Descrição''' || '''Onde consultar'''
|-
| '''Cia Web (SaaS)''' || Aplicação web que centraliza todas as funcionalidades da Cia. Pode ser acessada diretamente pelo navegador ou em dispositivos móveis, ou então através do CIGAM e Portais. || [[#Cia Web (SaaS)|Cia Web (SaaS)]]
|-
| '''Portais CIGAM''' || Acesso à Cia e aos agentes pelo menu de mosaico, além dos comandos de IA disponíveis nos campos de texto dos Portais. || [[#Portais|Portais]]
|-
| '''Aplicação Desktop''' || Acesso rápido à Cia pela barra lateral, assistente de voz, ditado e o recurso "Analisar com a Cia" em ferramentas do sistema. || [[#Desktop|Desktop]]
|}
{{VoltarInicio}}

=Cia Web (SaaS)=
A Cia Web é uma aplicação web que centraliza todas as funcionalidades da Cia - IA do CIGAM. É por meio dela que os recursos de inteligência artificial são disponibilizados às demais soluções, seja pelos Portais, pela aplicação Desktop ou pelas ferramentas que possuem integração com a Cia. 

==Acesso pela URL oficial==
A Cia Web pode ser acessada diretamente pelo navegador do seu computador ou dispositivo móvel, utilizando o seguinte endereço:
 
https://services.cigam.cloud/cia/index.html 
 
Para acessar, é necessário que o usuário tenha a autenticação em duas etapas configurada, conforme descrito em [[GE - Como Fazer - Configuração da Cia IA do CIGAM#Autenticação em duas etapas e configurações de envio de e-mail|Autenticação em duas etapas e configurações de envio de e-mail]]
 
 
O acesso também está condicionado às demais configurações descritas em [[GE - Como Fazer - Configuração da Cia IA do CIGAM|Como Fazer configuração da Cia IA do CIGAM]].
 
 
Para saber como utilizar os recursos disponíveis, consulte [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer uso da Cia IA do CIGAM]]
 
 
[[Imagem:CiaAberta.png|semmoldura|centro|800px]]

==Acesso a partir dos Portais e do Desktop==
Além do acesso direto pelo navegador, a Cia Web também pode ser aberta de dentro das demais soluções CIGAM: 
* Pelos Portais CIGAM, conforme descrito em [[#Portais|Portais]];
* Pela aplicação Desktop, conforme descrito em [[#Acesso rápido à Cia Web (SaaS)|Acesso rápido à Cia Web (SaaS)]].

=Portais=
==Acesso à Cia Web (SaaS)==
O acesso da Cia através dos Portais CIGAM ocorre dentro do ícone de mosaico, onde existe o ícone de acesso à Cia - IA do CIGAM:

[[Imagem:mosaicoCia.png|semmoldura|centro|800px]]
 
O acesso será imediato ao clicar, desde que todas as configurações indicadas no documento tenham sido aplicadas conforme [[GE - Como Fazer - Configuração da Cia IA do CIGAM|Como Fazer configuração da Cia IA do CIGAM]]. 

==Comandos de IA em campos de texto==
Além do acesso à Cia, na barra superior dos Portais estará disponível um ícone com um menu de contexto, permitindo interações com os '''campos de texto''' em qualquer parte dos Portais. Com ele, você pode melhorar textos, criar conteúdos, revisar gramática, entre outras funções. 

[[Imagem:comandosCia.png|semmoldura|centro|650px]]

===Telas modais===
Essa funcionalidade também está disponível para telas modais (janelas sobrepostas com interações):

[[Imagem:comandosModalCia.png|semmoldura|centro|800px]]

==Menu de agentes==
A partir da versão '''Beta 260601''', o menu da Cia nos Portais foi alterado e passou a disponibilizar o acesso aos agentes. 
 
Além das opções generativas, como melhoria de texto, revisão gramatical, entre outras, o menu passou a apresentar também os agentes disponíveis de acordo com o contexto da tela e com os parâmetros definidos. Esses agentes são carregados automaticamente conforme esses requisitos. 
 
O menu está disponível tanto para os Portais MVC quanto para os Portais React. 
 
Para saber como utilizar os agentes, consulte: [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer uso da Cia IA do CIGAM]]
 
[[Imagem:MenuAgentesCia.png|semmoldura|centro|800px]]

===Editor de agentes===
A partir da versão '''Beta 261005''', o menu passou a disponibilizar também o acesso à ferramenta '''Editor de Agentes''', que permite criar seus próprios agentes. 
 
[[Imagem:EditorAgentesCia.png|semmoldura|centro|800px]]
 
Para saber como utilizar o Editor de Agentes, consulte: [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer uso da Cia IA do CIGAM]]
 
{{VoltarInicio}}

=Desktop=
==Cia Assistente==
O ícone da Cia estará visível na barra superior do CIGAM assim que o sistema for inicializado. 

[[Imagem:Img9.png|semmoldura|centro|800px]]
 
Ao clicar no ícone, a assistente virtual será ativada, juntamente com seus componentes de reconhecimento de voz. Além disso, uma barra lateral será exibida com algumas opções de utilização. Quando ativa, a assistente permite a interação por comandos de voz e também pode emitir mensagens e notificações por áudio. 

[[Imagem:Img10.png|semmoldura|centro|800px]]
 

==Acesso rápido à Cia Web (SaaS)==
Dentro do menu na lateral, há um botão de acesso rápido para abrir a Cia - IA do CIGAM:

[[Imagem:CiaIA.png|semmoldura|centro|800px]]
 
'''Importante:''' Para usar essa funcionalidade no desktop, é preciso ter a API e seus portais instalados, pois eles conectam o sistema aos dados do ERP. Sem a API, a funcionalidade não vai funcionar, apresentando uma mensagem de erro. Se todas as configurações estiverem corretas, ao clicar no botão, a Cia será aberta em uma janela integrada ao sistema. 
Caso ocorra algum problema na abertura devido a configurações ausentes ou incorretas, consulte a documentação: [[GE - Como Fazer - Configuração da Cia IA do CIGAM|Como Fazer configuração da Cia IA do CIGAM]].
 

[[Imagem:CiaAbertaDesktop.png|semmoldura|centro|800px]]
 
{{VoltarInicio}}

==Recurso "Analisar com a Cia"==
Algumas ferramentas do CIGAM disponibilizam o recurso '''"Analisar com a Cia"''', que permite enviar o conteúdo em uso diretamente para a Cia, sem sair da ferramenta. O comportamento é o mesmo em todas as ferramentas: o conteúdo é enviado para análise e a resposta é apresentada pela Cia, respeitando os direitos e permissões do usuário.
 
 
Esse recurso está disponível a partir da versão '''250505 patch a'''.
 
 
Para saber como utilizar o recurso, em qualquer uma das ferramentas, consulte: [[GE - Como Fazer - Uso da Cia - IA do CIGAM|Como Fazer uso da Cia IA do CIGAM]]
 
 
O recurso está disponível nas seguintes ferramentas: 

===Pesquisa Dinâmica / Pesquisa Paginada===
Para utilizar o recurso, basta acessar qualquer programa do CIGAM que contenha uma pesquisa dinâmica/paginada, como o cadastro de Ordem de Serviço. A opção '''"Analisar com a Cia"''' estará disponível no menu superior da tela. 
 
[[Imagem:PesquisaDinamicaComCia.png|semmoldura|centro|800px]]
 
 
Para mais informações sobre a Pesquisa Dinâmica, consulte: [[GE - Como Fazer - Pesquisa Dinâmica#Pesquisa Dinâmica Desktop|Pesquisa Dinâmica Desktop]]

===CGEditor===
Para utilizar o recurso, basta estar com o arquivo que deseja analisar aberto e clicar no ícone '''"Visualizar Impressão"'''. 
 
[[Imagem:VisualizarImpressao.png|semmoldura|centro|800px]]
 
Será aberta uma nova janela, na qual estará disponível a opção '''"Analisar com a Cia"'''. 
 
[[Imagem:EditorAnalisarComCia.png|semmoldura|centro|800px]]
 

===CGReport===
Para utilizar o recurso, basta estar com a consulta montada e clicar no ícone '''"Pré-Visualizar"'''. 
 
[[Imagem:PreVisualizar.png|semmoldura|centro|800px]]
 
O relatório será processado e gerado e, na tela apresentada, estará disponível a opção '''"Analisar com a Cia"'''. 
 
[[Imagem:ReportAnalisarComCia.png|semmoldura|centro|800px]]
 

===Dispositivo de Saída===
O Dispositivo de Saída é um visualizador de arquivos, com a finalidade de exibir, salvar e editar relatórios gráficos e de caracteres. Nessa funcionalidade também é possível indicar a impressão e configurar a orientação e o tipo da página. 
 
Ao acessar o Dispositivo de Saída, por exemplo através do atalho '''Ctrl + P''' ou através do menu '''Acesso Rápido''', a opção '''"Analisar com a Cia"''' estará disponível no menu lateral. 
 
[[Imagem:DispositivoSaidaComCia.png|semmoldura|centro|800px]]
 
 
Para mais informações, consulte: [[GE Acesso rápido|Acesso rápido]]
{{VoltarInicio}}

==Grupo do chat==
No grupo do chat, existem algumas opções que facilitam a consulta de informações, permitindo que as solicitações sejam atendidas com mais precisão de acordo com o assunto. As opções disponíveis são:
 
'''Geral:''' Para conversar sobre assuntos gerais. 
'''Suporte:''' Para tratar de questões relacionadas ao suporte e solução de problemas. 
'''Configurações:''' Para obter informações sobre como configurar o CIGAM. 
'''Como Fazer:''' Para aprender a utilizar funcionalidades específicas do CIGAM. 
'''RH:''' Para questões relacionadas a Recursos Humanos. 

[[Imagem:Img11.png|semmoldura|centro|800px]]
 

==Grupo assistente==
A assistente virtual oferece comandos pré-definidos que podem ser utilizados para interações via áudio. Esses comandos podem ser acionados de duas formas: 
1. Por comando de voz: Basta falar o comando para que a assistente responda. 
2. Por seleção manual: O usuário pode clicar em um comando para que a assistente execute a ação e forneça uma resposta em áudio.
 
Além disso, é possível pesquisar os comandos disponíveis para facilitar a localização de um comando de voz específico. 

[[Imagem:Img12.png|semmoldura|centro|800px]]
 
[[Imagem:Img13.png|semmoldura|100px|esquerda]]   Indica um comando de voz '''executável por clique''', ou seja, ao clicar no ícone, a assistente executa a ação e fornece uma resposta por áudio. 
[[Imagem:Img14.png|semmoldura|100px|esquerda]]   Indica um comando de voz que '''deve ser ditado pelo usuário.''' Esse ícone serve apenas para informar que o comando existe e pode ser utilizado via fala, sem resposta ao clique. 

Os comandos de voz acionados por clique serão reordenados automaticamente conforme sua frequência de uso, facilitando o acesso aos comandos mais utilizados. 

===Quais são os comandos interpretados pela Cia?===
A implementação do reconhecimento de voz no CIGAM está implementada de maneira básica. 
Para isso, estão disponíveis os seguintes comandos: 
 
{| class="wikitable"
|-
| '''Tipo''' || '''Comando de voz''' || '''Resultado''' || '''A tela deve estar'''
|-
|rowspan="13"| '''Métodos''' || Cia mostrar acesso rápido || Mostra o painel Acesso rápido || Ativa
|-
| Cia mostrar alertas || Mostra o painel Alertas || Ativa
|-
| Cia fechar alertas || Fecha o painel Alertas pois é um painel lateral || Ativa
|-
| Cia mostrar início || Mostra o painel Início || Ativa
|-
| Cia mostrar favoritos || Mostra o painel Favoritos || Ativa
|-
| Cia mostrar histórico || Mostra o painel Histórico || Ativa
|-
| Cia mostrar mais acessados || Mostra o painel Mais acessados || Ativa
|-
| Cia mostrar marcadores || Mostra o painel Marcadores || Ativa
|-
| Cia mostrar utilidades || Mostra o painel Utilidades || Ativa
|-
| Cia mostrar pesquisar || Mostra o painel Pesquisar || Ativa
|-
| Cia fechar pesquisar || Fecha o painel Pesquisar pois é um painel lateral || Ativa
|-
| Cia escolher área || Mostra o painel para selecionar qual área posicionar. Só irá responder a esse comando caso esteja no painel Início
|| Ativa
|-
| Cia ler este campo || Lê o campo que está posicionado na tela || Ativa
|-
| rowspan="17"| '''Teclas''' || Cia vá para cima || Pressiona a tecla seta para cima || Ativa
|-
| Cia vá para baixo || Pressiona a tecla seta para baixo || Ativa
|-
| Cia vá para direita || Pressiona a tecla seta para a direita || Ativa
|-
| Cia vá para esquerda || Pressiona a tecla seta para a esquerda || Ativa
|-
| Cia modificar || Pressiona a tecla Ctrl+M || Ativa
|-
| Cia pesquisar || Pressiona a tecla Ctrl+Q || Ativa
|-
| Cia criar || Pressiona a tecla Ctrl+I || Ativa
|-
| Cia entrar || Pressiona a tecla Enter || Ativa
|-
| Cia voltar || Aciona o comando de voltar navegação do menu. Equivale ao pressionamento de Ctrl + Seta para esquerda || Ativa
|-
| Cia zoom || Pressiona a tecla F5 || Ativa
|-
| Cia focar || Quando um painel tem mais de um container de mosaicos, alterna o foco entre eles. Exemplo de uso: painéis que tem treeview de divisões (cadastros, movimentos, pesquisas, relatórios...) e também outro container com os mosaicos daquela divisão. Equivale ao pressionamento do Ctrl + Tab. Como o foco irá mudar de container, esse comando automaticamente sai do modo “procurar” se ele estiver ativo. || Ativa
|-
| Cia fechar esta tela || Fecha a tela através do pressionamento da tecla Esc. || Ativa
|-
| Cia capturar esta tela || Faz um print da área de trabalho e coloca na área de transferência || Ativa
|-
| Cia capturar esta tela e salvar || Salva em arquivo o print da área de trabalho || Ativa
|-
| Cia próximo campo || Salta para o próximo campo da tela através do pressionamento da tecla Tab || Ativa
|-
| Cia campo anterior || Salta para o campo anterior da tela através do pressionamento das teclas Shift + Tab || Ativa
|-
| Cia selecionar tudo || Seleciona o conteúdo do campo focado. Equivale a um Ctrl + A. || Ativa
|-
|rowspan="19"| '''Interação''' || Cia aumentar volume || Aumenta o volume da saída de som da aplicação || Indiferente
|-
| Cia diminuir volume || Diminui o volume da saída de som da aplicação || Indiferente
|-
| Cia bom dia || Cumprimento || Ativa
|-
| Cia boa tarde || Cumprimento || Ativa
|-
| Cia boa noite || Cumprimento || Ativa
|-
| Cia que dia é hoje? || Fala a data atual || Ativa
|-
| Cia que horas são? || Fala a hora atual || Ativa
|-
| Cia você me entendeu? || Refaz o reconhecimento da última frase para verificar se tem alguma frase de reconhecimento vinculada que não tenha sido reconhecida anteriormente. || Ativa
|-
| Cia a internet está conectada? || Verifica se o usuário logado tem acesso à internet. || Ativa
|-
| Cia qual sua idade? || Responde com a idade da assistente, que é a idade da empresa Cigam. || Ativa
|-
| Cia me fale sobre assistente virtual || Responde falando a definição || Ativa
|-
| Cia me fale sobre você || Dá uma breve explicação sobre o assistente de voz || Ativa
|-
| Cia me fale sobre o CIGAM || Dá uma breve explicação sobre o produto || Ativa
|-
| Cia qual melhor sistema/software de gestão? || Responde a pergunta || Ativa
|-
| Cia você está me escutando? || É um comando para teste de reconhecimento de entrada e sintetização de saída. || Indiferente
|-
| Cia muito obrigado || Encerra a fala e agradece || Ativa
|-
| Cia pare || Encerra a fala de forma abrupta || Indiferente
|-
| Cia cadê você? || Ativa/foca a tela principal do CIGAM || Indiferente
|-
| Cia repita || Repete a última fala. As falas de diálogos não possuem suporte a repetição pois elas estão vinculadas a um contexto sequencial. || Indiferente
|-
| rowspan="30"| '''Negócio''' || Cia quais os valores a pagar? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o valor a pagar em atraso? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais os valores a receber? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o valor a receber em atraso? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais atendimentos tenho para hoje? ||Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais os atendimento de hoje? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais os alertas de hoje? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais as oportunidades tenho para hoje? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais as oportunidades de hoje? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais as oportunidades tenho para amanhã? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais as oportunidades de amanhã? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o total de ordens de serviços em aberto? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o total de OS's? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais os tipos de ordens de serviços em aberto? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais as OS's abertas? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quantas horas tenho registrado hoje? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual meu total de horas hoje? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quantas horas tenho registrado esta semana? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual meu total de horas nesta semana? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais as ordens de compra para recebimento hoje? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais as OC's para hoje? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o saldo atual? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o total de alçadas para aprovação? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia quais as alçadas para aprovação? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o valor vendido hoje? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o valor vendido ontem? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o valor faturado hoje? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o valor faturado ontem? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o valor dos pedidos para faturamento? || Consulta a base de dados para montar a resposta || Ativa
|-
| Cia qual o valor dos pedidos para faturar? || Consulta a base de dados para montar a resposta || Ativa
|-
| rowspan="17"| '''Comandos''' || Cia faça pra mim || Irá abrir o microfone em modo comando para que o usuário dê a instrução do que fazer. Essa opção exige internet pois irá utilizar o modo ditado. '''Importante:''' Os comandos para tarefas para essa opção são aqueles que podem ter um conteúdo variável ou algum dado que precise ser verificado no momento do comando. Por exemplo “abrir lançamentos 123”. Nesse caso o valor “123” é o valor variável. Após o sinal de abertura do microfone, pode-se falar uma das tarefas a seguir: || Ativa
|-
| '''Tarefas''' → pesquisar previsão do tempo para [localidade] || Previsão do tempo para a localidade de acordo com a fonte CPTEC/Inpe. Exemplo: “previsão do tempo para Novo Hamburgo” || Ativa
|-
| '''Tarefas''' → pesquisar cotação do ou da [moeda] || Cotação da moeda em reais de acordo com o Banco Central do Brasil. Moedas disponíveis: - Dólar - Dólar Australiano - Dólar Canadense - Euro - Iene - Libra Esterlina - Franco Suíço - Coroa Dinamarquesa - Coroa Norueguesa - Coroa Sueca Exemplos: “buscar cotação do dólar” e “buscar cotação da libra esterlina” || Ativa
|-
| '''Tarefas''' → pesquisar no menu por [palavra chave] || Procura no menu por itens com a palavra chave e exibe os resultados no painel de pesquisa. Exemplo: “pesquisar por lançamentos” || Ativa
|-
| '''Tarefas''' → pesquisar aqui por [palavra chave] || Procura no local atual um item de menu pela palavra chave. Se encontrar, foca no item. Exemplo: “procurar aqui por pedidos” || Ativa
|-
| '''Tarefas''' → clicar no botão [nome do botão] ou clicar na página [nome da página] || Clica num determinado controle da tela, que pode ser do tipo botão ou página (guias). O controle deve estar visível e na tela em primeiro plano. Exemplos: “clicar no botão confirmar” “clicar na página financeiro” || Ativa
|-
| '''Tarefas''' → o que é [palavra chave] || Pesquisa no Wikipédia em português || Ativa
|-
| '''Tarefas''' → pesquisar sobre [palavra chave] || Pesquisa no Google em português || Ativa
|-
| '''Tarefas''' → pesquisar vídeos sobre [palavra chave] || Pesquisa vídeos no YouTube. || Ativa
|-
| '''Tarefas''' → abrir mapa [endereço] || Abre o mapa para o endereço no Google Maps. Exemplos: - abrir mapa rua vereador adão rodrigues de oliveira 524 em novo hamburgo - abrir mapa rua cruzeiro do sul gravataí - abrir mapa avenida frederico linck em novo hamburgo || Ativa
|-
| '''Tarefas''' → abrir [categoria menu] [programa do menu] [parâmetro] || Abre um item no menu do CIGAM. Essa opção abrange todos os itens de menu, inclusive os personalizados pelo usuário. O reconhecimento poderá ser feito das seguintes formas: a) Utilizando a categoria do menu, com ou sem plural: “abrir movimento estoque” ou “abrir movimentos estoque” Neste caso, existe um item de menu chamado “Estoque” dentro da categoria “Movimentos”. b) Sem a categoria do menu: “abrir estoque” Indiferente da forma utilizada anteriormente, poderá ser informado um parâmetro para qual registro posicionar '''Importante:''' O parâmetro será a chave-única do registro, não contemplando chaves compostas. Exemplos: “abrir movimento estoque 123” ou “abrir estoque 123”||Ativa
|-
| '''Tarefas''' → calcular [fórmula] || Executa um cálculo conforme os operadores e fatores passados. Exemplos: - calcular 10 mais 10 - calcular 10 menos 5 - calcular 10 mais 50 mais 20 porcento - calcular 10 mais 30 vezes 10 porcento - calcular 50 vezes 15 porcento - calcular 150 ponto 38 vezes 17 - calcular 100 dividido por 25 || Ativa
|-
| Cia aprenda comigo || Executa o comando “Cia faça pra mim”, porem com suporte a aprendizado dos comandos que forem falados. Os novos comandos serão imediatamente disponibilizados. || Ativa
|-
| '''Tarefas''' → apelidar [comando existente] para o apelido [apelido] || Ensina um apelido para um comando já existente. Exemplo: “apelidar mostrar favoritos para o apelido mostrar preferidos” || Ativa
|-
| '''Tarefas''' → apelidar esse programa para o apelido [apelido para o programa aberto] || Ensina um apelido para o programa que está aberto. Se considerado o programa principal, ou seja, aquele que pode ser acessado através de um item de menu. Exemplo: “apelidar esse programa para o apelido indicadores da poupança” (nesse exemplo, o programa “Índices” está aberto) || Ativa
|-
| '''Tarefas''' → quando eu falar [minha fala] me fale [fala] ou quando eu perguntar [minha pergunta] me responda [resposta] || Ensina uma resposta/fala para quando uma fala especifica for falada
Exemplos: "quando eu falar está tudo bem me fale está tudo ótimo" "quando eu perguntar quem eu sou me responda você é meu amigo"
|| Ativa
|-
| '''Tarefas''' → faça [comando do faça pra mim] quando eu falar [fala] || Ensina a ir diretamente num comando do faça pra mim a partir de um apelido. Exemplo: “faça pesquisar cotação do dólar quando eu falar cotação do dólar hoje” || Ativa
|-
|rowspan="7"| '''Músicas''' || Cia tocar minhas músicas || Iniciar o player de músicas. As músicas serão buscadas na pasta de músicas do usuário do Windows, em C:\Usuários\<usuáro>\Musicas e uma lista será montada a partir dos arquivos de música encontrados nesse local. Serão reconhecidos os formatos .mp2, .mp3 e .wma.|| Ativa
|-
| Cia tocar próxima música || Salta para a próxima trilha da lista de músicas || Indiferente
|-
| Cia tocar música anterior || Volta para a trilha anterior da lista de músicas || Indiferente
|-
| Cia parar minhas músicas || Encerra o player de músicas || Indiferente
|-
| Cia volume baixo para as músicas || Ajusta a saída de áudio do player com um volume baixo || Indiferente
|-
| Cia volume médio para as músicas || Ajusta a saída de áudio do player com um volume médio || Indiferente
|-
| Cia volume alto para as músicas || Ajusta a saída de áudio do player com um volume alto || Indiferente
|}
{{VoltarInicio}}

==Ditado==
===Como fazer para abrir o ditado através da Cia?===
Para abrir o ditado através do comando de voz, basta estar com um microfone conectado e falar “Cia, mostrar ditado”, ou clicar na opção no grupo Ditado.

[[Imagem:ImgCia1.png|semmoldura|centro|300px]]

[[Imagem:ImgCia2.png|semmoldura|centro|750px]]

Ao abrir o ditado existem as seguintes opções e Menu: 

[[Arquivo:ImgCia3.png|50x25px|esquerda]]   Sair – Atalho '''“Esc”'''

[[Arquivo:ImgCia4.png|50x25px|esquerda]]   Abrir/Fechar Microfone

[[Arquivo:ImgCia5.png|50x25px|esquerda]]   Colar conteúdo do ditado no campo focado – Atalho '''“Control + Shift + V”'''

[[Arquivo:ImgCia6.png|50x25px|esquerda]]   Copiar conteúdo de ditado para área de transferência – Atalho '''"Control + Shift + C”'''

[[Arquivo:ImgCia7.png|50x25px|esquerda]]   Ler o conteúdo do campo focado – Atalho '''“Control + Shift + L”'''

É possível dar alguns comandos como:

{| class="wikitable"
|-
| rowspan="2"| '''Ditado''' || Cia mostrar ditado || Abre ou foca na tela do ditado contínuo O ditado poderá ser feito alternando pausas sem tempo definido para término. Neste caso, para encerramento e utilização do conteúdo será necessário a interação do usuário através dos botões na área de topo. Estão disponíveis os comandos especiais dentro do ditado para tratamentos de caracteres: - nova linha - ponto final - ponto e vírgula - dois pontos - vírgula - interrogação - exclamação - aspas - aspa - hífen - abre parênteses - abre parêntese - fecha parênteses - fecha parêntese - asterisco - arroba - abre chave - fecha chave - abre colchete - fecha colchete || Ativo
|-
| Cia ditar este campo || Inicia o ditado não-contínuo ou de frase. Após o término da fala, o ditado será automaticamente encerrado e o conteúdo ditado será automaticamente colado no campo que estava focado quando o ditado foi iniciado. || Ativa
|}

===Como exibir os resultados parciais ao ditar um campo para a Cia?===
Ao abrir um programa e executar o comando '''Cia ditar este campo''', é possível visualizar os resultados parciais através de uma tela ou então ter somente a exibição ao finalizar o ditado. Essa configuração é feita através do acesso ao ‘Perfil de Usuários’ na opção: ‘Resultados Parciais em Ditado’, onde possibilita a exibição parcial da informação. Por padrão, a opção vem como Ocultar.

[[Imagem:ImgCia8.png|semmoldura|centro|650px]]
{{VoltarInicio}}

=Go-Global=
A execução do CIGAM em um ambiente de nuvem privada por meio da solução Go-Global permite o acesso remoto a aplicativos Windows de qualquer local, plataforma e sistema operacional. No entanto, essa implementação apresenta algumas particularidades que requerem atenção, especialmente no que se refere a comandos de voz, fala e ditado na Cia, os quais possuem restrições. 
 
'''Lista de particularidades'''
* Sem suporte para tráfego de áudio, exceto bipes;
 
* Sem suporte para microfone ou caixas de som – apesar de esses dispositivos poderem permanecer ativos no Windows, eles não funcionarão devido à ausência de suporte para tráfego de áudio;
 
* Sem suporte para reconhecimento ou sintetização de voz em texto, o que impede a utilização e atualização das funcionalidades da Cia relacionadas a comandos de voz, fala e ditado.
{{VoltarInicio}}

=Documentos Relacionados=
[[GE - Como Fazer - Uso da Cia - IA do CIGAM]] 
[[GE - Como Fazer - Configuração da Cia IA do CIGAM]]

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-09-24T13:49:34Z

Roger.schneider: /* Geração de conteúdo */

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-09-24T13:49:00Z

Roger.schneider: /* Agentes */

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-09-24T13:47:35Z

Roger.schneider: /* Editor de Agentes */

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-09-24T13:46:03Z

Roger.schneider: /* Limite de conteúdo enviado */

Arquivo:MenuGeracaoConteudoAgentes.png

2026-09-22T18:54:26Z

Roger.schneider:

Arquivo:AgentesRetornoGuia.png

2026-09-22T18:52:37Z

Roger.schneider:

Arquivo:AgentesRetornoModal.png

2026-09-22T18:46:05Z

Roger.schneider:

Arquivo:MenuAgentesCustomizados.png

2026-09-22T18:18:10Z

Roger.schneider:

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-09-21T20:04:44Z

Roger.schneider: /* Limite de conteúdo enviado */

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-09-21T20:03:24Z

Roger.schneider: /* Limite de conteúdo enviado */

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-09-21T19:51:17Z

Roger.schneider: /* Como os agentes são disponibilizados */

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-09-21T19:50:50Z

Roger.schneider: /* Agentes */

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-09-21T19:46:15Z

Roger.schneider: /* Agentes */

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-09-21T19:37:53Z

Roger.schneider: /* Geração de conteúdo */

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-09-21T19:36:36Z

Roger.schneider: /* Geração de conteúdo */

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-09-21T19:35:15Z

Roger.schneider: /* Comandos de IA em campos de texto */

Arquivo:EditorAgentesWizard.png

2026-09-21T19:30:31Z

Roger.schneider:

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-09-21T19:29:41Z

Roger.schneider: /* Editor de Agentes */

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-09-21T19:20:23Z

Roger.schneider: /* Disponibilizando o agente criado */

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-09-21T19:19:16Z

Roger.schneider: /* Editor de Agentes */

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-09-21T19:12:37Z

Roger.schneider: /* Portais */

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-09-21T19:07:49Z

Roger.schneider: /* Limite de conteúdo enviado */

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-09-21T19:05:59Z

Roger.schneider: /* Limite de conteúdo enviado */

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-09-21T19:05:45Z

Roger.schneider: /* Limite de conteúdo enviado */

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-09-21T18:01:12Z

Roger.schneider: /* Recurso "Analisar com a Cia" */

Arquivo:AnalisarCiaRelatorio.png

2026-09-21T18:00:06Z

Roger.schneider:

GE - Como Fazer - Uso da Cia - IA do CIGAM

2026-09-21T17:56:43Z

Roger.schneider: /* Recurso "Analisar com a Cia" */