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

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

2026-10-20T19:05:27Z

Oseias.rodrigues: /* 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, GPT-4.1, GPT-4o, GPT-4o Mini). 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-20T18:40:40Z

Oseias.rodrigues: /* 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==
<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, GPT-4.1, GPT-4o, GPT-4o Mini). 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-20T18:39:55Z

Oseias.rodrigues: /* Limite de conteúdo enviado */

{{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, GPT-4.1, GPT-4o, GPT-4o Mini). 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====

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===
<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-20T18:39:13Z

Oseias.rodrigues: /* Limite de conteúdo enviado */

{{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, GPT-4.1, GPT-4o, GPT-4o Mini). 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====

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]]

Arquivo:Cia conv docs 05.png

2026-10-20T12:05:05Z

Oseias.rodrigues: Oseias.rodrigues carregada uma nova versão de Arquivo:Cia conv docs 05.png

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

2026-10-20T12:03:29Z

Oseias.rodrigues: /* 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, GPT-4.1, GPT-4o, GPT-4o Mini). 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====

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]]

Arquivo:Cia conv docs 04.png

2026-10-20T11:56:15Z

Oseias.rodrigues: Oseias.rodrigues carregada uma nova versão de Arquivo:Cia conv docs 04.png

Arquivo:Cia conv docs 03.png

2026-10-20T11:54:31Z

Oseias.rodrigues: Oseias.rodrigues carregada uma nova versão de Arquivo:Cia conv docs 03.png

Arquivo:Cia conv docs 02.png

2026-10-20T11:51:07Z

Oseias.rodrigues: Oseias.rodrigues carregada uma nova versão de Arquivo:Cia conv docs 02.png

Arquivo:Cia conv docs 01.png

2026-10-20T11:49:40Z

Oseias.rodrigues: Oseias.rodrigues carregada uma nova versão de Arquivo:Cia conv docs 01.png

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

2026-10-19T14:43:38Z

Oseias.rodrigues: /* Editor 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 - 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 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]]

Arquivo:EditorAgentesWizardBaixar.png

2026-10-19T14:40:29Z

Oseias.rodrigues:

Arquivo:EditorAgentesCiaBloqueio.png

2026-10-19T14:39:44Z

Oseias.rodrigues:

Arquivo:EditorAgentesCiaValidandoAuth.png

2026-10-19T14:39:36Z

Oseias.rodrigues:

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

2026-10-19T14:39:15Z

Oseias.rodrigues: /* Editor 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 - 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.

 
[[Imagem:EditorAgentesWizard.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 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 - Uso da Cia - IA do CIGAM

2026-10-19T14:30:56Z

Oseias.rodrigues: /* Editor 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 - 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|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. 
 
</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]]
 

</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 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]]

Arquivo:EditorAgentesCia logado.png

2026-10-19T14:28:17Z

Oseias.rodrigues:

GE - Como Fazer - Cia - Como acessar

2026-10-19T14:28:04Z

Oseias.rodrigues: /* Editor 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===
<div align="justify">
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|750px]]
 

Precisamos acessar com nosso token de autorização CIGAM e termos nossa API configurada corretamente.

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

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}}
</div>

===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-15T13:39:48Z

Oseias.rodrigues: /* 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}}

==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]]
 

===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-15T13:18:18Z

Oseias.rodrigues: /* 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}}

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

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]]
 

===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-15T13:13:17Z

Oseias.rodrigues: /* 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}}

==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''' (Cia 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 do Cia Chatbot, 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.

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]]
 

===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-13T13:12:33Z

Oseias.rodrigues: /* 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 anexos 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 - Cia - Como acessar

2026-10-13T13:05:31Z

Oseias.rodrigues: /* 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">
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]]

Arquivo:Cia conv docs acesso 01.png

2026-10-13T13:04:59Z

Oseias.rodrigues:

GE - Como Fazer - Cia - Como acessar

2026-10-13T13:02:25Z

Oseias.rodrigues: /* 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">
Ao clicar na opção "Conversar com documentos" seremos direcionados à página da aplicação.

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

Precisamos acessar com nosso token de autorização CIGAM e termos nossa API configurada corretamente.

 
<center>[[Arquivo:cia_conv_docs_acesso_02.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-13T13:00:50Z

Oseias.rodrigues: /* 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}}

==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">
Ao clicar na opção "Conversar com documentos" seremos direcionados à página da aplicação.

Precisamos acessar com nosso token de autorização CIGAM e termos nossa API configurada corretamente.

Tendo isto devidamente parametrizado, ao iniciar a aplicação, será gerado um ID de conversação para nossa sessão, esta informação é importante porque através deste ID a Cia armazena o contexto de todas as mensagens e documentos que enviarmos nesta conversa.

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

No primeiro acesso, teremos de marcar o checkbox "Termo de consentimento" para indicar que estamos cientes de que os dados serão analisados e enviados para os modelos de IA de terceiros integrados com a Cia.

Confirmando esta opção, teremos como anexar arquivos no menu lateral esquerdo, arrastando os arquivos e soltando na área, ou clicando e selecionando, podendo selecionar múltiplos arquivos de uma única vez.

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

Clicando no ícone da engrenagem localizada no canto superior direito da tela, poderemos acessar as opções.

*Podemos selecionar o modelo de IA escolhido.
*Podemos visualizar o usuário autenticado e as informações de licença.
*Podemos visualizar e copiar as informações de sessão de API.
*Podemos visualizar e copiar nosso ID de conversação.
*Podemos limpar a conversa, forçando o sistema a gerar um novo ID de conversação, com objetivo de recomeçar nosso contexto de análise. Será apresentada uma mensagem de confirmação antes de limpar o contexto.
*Podemos acessar a documentação da ferramenta na Wiki.

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

Podemos enviar arquivos e mensagens para complementar a análise. O sistema possui um prompt de sistema padrão para auxiliar o modelo a analisar e retornar os dados de maneira estruturada.

Há um ícone de microfone para reconhecimento de voz.

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

As análises são geradas contendo gráficos e/ou tabelas quando aplicável.

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

Podemos ter diversos documentos e mensagens.

</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]]
 

===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]]

Arquivo:Cia conv docs 02.png

2026-10-13T12:55:08Z

Oseias.rodrigues: Oseias.rodrigues carregada uma nova versão de Arquivo:Cia conv docs 02.png

GE - Como Fazer - Cia - Como acessar

2026-10-13T12:52:33Z

Oseias.rodrigues: /* 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">
Ao clicar na opção "Conversar com documentos" seremos direcionados à página da aplicação.

Precisamos acessar com nosso token de autorização CIGAM e termos nossa API configurada corretamente.

Tendo isto devidamente parametrizado, ao iniciar a aplicação, será gerado um ID de conversação para nossa sessão, esta informação é importante porque através deste ID a Cia armazena o contexto de todas as mensagens e documentos que enviarmos nesta conversa.

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

No primeiro acesso, teremos de marcar o checkbox "Termo de consentimento" para indicar que estamos cientes de que os dados serão analisados e enviados para os modelos de IA de terceiros integrados com a Cia.

Confirmando esta opção, teremos como anexar arquivos no menu lateral esquerdo, arrastando os arquivos e soltando na área, ou clicando e selecionando, podendo selecionar múltiplos arquivos de uma única vez.

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

Clicando no ícone da engrenagem localizada no canto superior direito da tela, poderemos acessar as opções.

*Podemos selecionar o modelo de IA escolhido.
*Podemos visualizar o usuário autenticado e as informações de licença.
*Podemos visualizar e copiar as informações de sessão de API.
*Podemos visualizar e copiar nosso ID de conversação.
*Podemos limpar a conversa, forçando o sistema a gerar um novo ID de conversação, com objetivo de recomeçar nosso contexto de análise. Será apresentada uma mensagem de confirmação antes de limpar o contexto.
*Podemos acessar a documentação da ferramenta na Wiki.

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

Podemos enviar arquivos e mensagens para complementar a análise. O sistema possui um prompt de sistema padrão para auxiliar o modelo a analisar e retornar os dados de maneira estruturada.

Há um ícone de microfone para reconhecimento de voz.

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

As análises são geradas contendo gráficos e/ou tabelas quando aplicável.

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

Podemos ter diversos documentos e mensagens.

</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]]

Arquivo:Cia conv docs 05.png

2026-10-13T12:50:12Z

Oseias.rodrigues:

Arquivo:Cia conv docs 04.png

2026-10-13T12:50:04Z

Oseias.rodrigues:

Arquivo:Cia conv docs 03.png

2026-10-13T12:49:55Z

Oseias.rodrigues:

Arquivo:Cia conv docs 02.png

2026-10-13T12:32:59Z

Oseias.rodrigues:

Arquivo:Cia conv docs 01.png

2026-10-13T12:32:32Z

Oseias.rodrigues:

GE - Como Fazer - Cia - Como acessar

2026-10-13T12:31:56Z

Oseias.rodrigues: /* 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">
Ao clicar na opção "Conversar com documentos" seremos direcionados à página da aplicação.

Precisamos acessar com nosso token de autorização CIGAM e termos nossa API configurada corretamente.

Tendo isto devidamente parametrizado, ao iniciar a aplicação, será gerado um ID de conversação para nossa sessão, esta informação é importante porque através deste ID a Cia armazena o contexto de todas as mensagens e documentos que enviarmos nesta conversa.

[[Arquivo:cia_conv_docs_01.png|nenhum|750px]]

No primeiro acesso, teremos de marcar o checkbox "Termo de consentimento" para indicar que estamos cientes de que os dados serão analisados e enviados para os modelos de IA de terceiros integrados com a Cia.

Confirmando esta opção, teremos como anexar arquivos no menu lateral esquerdo, arrastando os arquivos e soltando na área, ou clicando e selecionando, podendo selecionar múltiplos arquivos de uma única vez.

[[Arquivo:cia_conv_docs_02.png|nenhum|750px]]

Clicando no ícone da engrenagem localizada no canto superior direito da tela, poderemos acessar as opções.

*Podemos selecionar o modelo de IA escolhido.
*Podemos visualizar o usuário autenticado e as informações de licença.
*Podemos visualizar e copiar as informações de sessão de API.
*Podemos visualizar e copiar nosso ID de conversação.
*Podemos limpar a conversa, forçando o sistema a gerar um novo ID de conversação, com objetivo de recomeçar nosso contexto de análise. Será apresentada uma mensagem de confirmação antes de limpar o contexto.
*Podemos acessar a documentação da ferramenta na Wiki.

[[Arquivo:cia_conv_docs_03.png|nenhum|750px]]

Podemos enviar arquivos e mensagens para complementar a análise. O sistema possui um prompt de sistema padrão para auxiliar o modelo a analisar e retornar os dados de maneira estruturada.

Há um ícone de microfone para reconhecimento de voz.

[[Arquivo:cia_conv_docs_04.png|nenhum|750px]]

As análises são geradas contendo gráficos e/ou tabelas quando aplicável.

[[Arquivo:cia_conv_docs_05.png|nenhum|750px]]

Podemos ter diversos documentos e mensagens.

</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 - Cia - Como acessar

2026-10-13T12:30:33Z

Oseias.rodrigues: /* 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">
Ao clicar na opção "Conversar com documentos" seremos direcionados à página da aplicação.

Precisamos acessar com nosso token de autorização CIGAM e termos nossa API configurada corretamente.

Tendo isto devidamente parametrizado, ao iniciar a aplicação, será gerado um ID de conversação para nossa sessão, esta informação é importante porque através deste ID a Cia armazena o contexto de todas as mensagens e documentos que enviarmos nesta conversa.

[[Arquivo:cia_conv_docs_01|nenhum|750px]]

No primeiro acesso, teremos de marcar o checkbox "Termo de consentimento" para indicar que estamos cientes de que os dados serão analisados e enviados para os modelos de IA de terceiros integrados com a Cia.

Confirmando esta opção, teremos como anexar arquivos no menu lateral esquerdo, arrastando os arquivos e soltando na área, ou clicando e selecionando, podendo selecionar múltiplos arquivos de uma única vez.

[[Arquivo:cia_conv_docs_02|nenhum|750px]]

Clicando no ícone da engrenagem localizada no canto superior direito da tela, poderemos acessar as opções.

*Podemos selecionar o modelo de IA escolhido.
*Podemos visualizar o usuário autenticado e as informações de licença.
*Podemos visualizar e copiar as informações de sessão de API.
*Podemos visualizar e copiar nosso ID de conversação.
*Podemos limpar a conversa, forçando o sistema a gerar um novo ID de conversação, com objetivo de recomeçar nosso contexto de análise. Será apresentada uma mensagem de confirmação antes de limpar o contexto.
*Podemos acessar a documentação da ferramenta na Wiki.

[[Arquivo:cia_conv_docs_03|nenhum|750px]]

Podemos enviar arquivos e mensagens para complementar a análise. O sistema possui um prompt de sistema padrão para auxiliar o modelo a analisar e retornar os dados de maneira estruturada.

Há um ícone de microfone para reconhecimento de voz.

[[Arquivo:cia_conv_docs_04|nenhum|750px]]

As análises são geradas contendo gráficos e/ou tabelas quando aplicável.

[[Arquivo:cia_conv_docs_05|nenhum|750px]]

Podemos ter diversos documentos e mensagens.

</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 - Cia - Como acessar

2026-10-13T12:26:51Z

Oseias.rodrigues: /* 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">
Ao clicar na opção "Conversar com documentos" seremos direcionados à página da aplicação.

Precisamos acessar com nosso token de autorização CIGAM e termos nossa API configurada corretamente.

Tendo isto devidamente parametrizado, ao iniciar a aplicação, será gerado um ID de conversação para nossa sessão, esta informação é importante porque através deste ID a Cia armazena o contexto de todas as mensagens e documentos que enviarmos nesta conversa.

[[Arquivo:cia_conv_docs_01|nenhum|750px]]

No primeiro acesso, teremos de marcar o checkbox "Termo de consentimento" para indicar que estamos cientes de que os dados serão analisados e enviados para os modelos de IA de terceiros integrados com a Cia.

Confirmando esta opção, teremos como anexar arquivos no menu lateral esquerdo, arrastando os arquivos e soltando na área, ou clicando e selecionando, podendo selecionar múltiplos arquivos de uma única vez.

[[Arquivo:cia_conv_docs_02|nenhum|750px]]

Podemos enviar arquivos e mensagens para complementar a análise. O sistema possui um prompt de sistema padrão para auxiliar o modelo a analisar e retornar os dados de maneira estruturada.

Há um ícone de microfone para reconhecimento de voz.

[[Arquivo:cia_conv_docs_03|nenhum|750px]]

Clicando no ícone da engrenagem localizada no canto superior direito da tela, poderemos acessar as opções.

*Podemos selecionar o modelo de IA escolhido.
*Podemos visualizar o usuário autenticado e as informações de licença.
*Podemos visualizar e copiar as informações de sessão de API.
*Podemos visualizar e copiar nosso ID de conversação.
*Podemos limpar a conversa, forçando o sistema a gerar um novo ID de conversação, com objetivo de recomeçar nosso contexto de análise. Será apresentada uma mensagem de confirmação antes de limpar o contexto.
*Podemos acessar a documentação da ferramenta na Wiki.

[[Arquivo:cia_conv_docs_04|nenhum|750px]]

[[Arquivo:cia_conv_docs_05|nenhum|750px]]

</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 - Cia - Como acessar

2026-10-13T12:20:28Z

Oseias.rodrigues: /* 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">
Ao clicar na opção "Conversar com documentos" seremos direcionados à página da aplicação.

Precisamos acessar com nosso token de autorização CIGAM e termos nossa API configurada corretamente.

Tendo isto devidamente parametrizado, ao iniciar a aplicação, será gerado um ID de conversação para nossa sessão, esta informação é importante porque através deste ID a Cia armazena o contexto de todas as mensagens e documentos que enviarmos nesta conversa.

[[Arquivo:cia_conv_docs_01|nenhum|750px]]

No primeiro acesso, teremos de marcar o checkbox "Termo de consentimento" para indicar que estamos cientes de que os dados serão analisados e enviados para os modelos de IA de terceiros integrados com a Cia.

Confirmando esta opção, teremos como anexar arquivos no menu lateral esquerdo, arrastando os arquivos e soltando na área, ou clicando e selecionando, podendo selecionar múltiplos arquivos de uma única vez.

[[Arquivo:cia_conv_docs_02|nenhum|750px]]

[[Arquivo:cia_conv_docs_03|nenhum|750px]]

[[Arquivo:cia_conv_docs_04|nenhum|750px]]

[[Arquivo:cia_conv_docs_05|nenhum|750px]]

</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 - Cia - Como acessar

2026-10-13T12:11:17Z

Oseias.rodrigues: /* 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">
Em construção.

[[Arquivo:cia_conv_docs_01|nenhum|750px]]

[[Arquivo:cia_conv_docs_02|nenhum|750px]]

[[Arquivo:cia_conv_docs_03|nenhum|750px]]

[[Arquivo:cia_conv_docs_04|nenhum|750px]]

[[Arquivo:cia_conv_docs_05|nenhum|750px]]

</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 - Cia - Como acessar

2026-10-07T18:59:35Z

Oseias.rodrigues: /* 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">
Em construção.
</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 - Cia - Como acessar

2026-10-07T18:58:35Z

Oseias.rodrigues: /* Editor 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}}

===Conversar com documentos===

=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]]

CGDiagnosticos

2026-07-16T13:13:54Z

Oseias.rodrigues: /* Rede */

<div align="justify">
O '''CIGAM Diagnósticos''' é uma ferramenta avançada para análise e monitoramento da infraestrutura do seu ambiente. Com ele, é possível validar a comunicação com o banco de dados, aferir a velocidade da rede, coletar informações detalhadas do sistema operacional, listar versões do .NET e testar requisições e integrações Web.

Abaixo, detalhamos cada uma de suas funcionalidades para guiar a utilização correta da aplicação.
</div>
=== Acesso à Ferramenta ===
<div align="justify">
Ao executar o aplicativo, será exibida a tela de login inicial solicitando suas credenciais de acesso.

[[Image: CGDiagnosticos_01.png|300px|centro]]

Informe o '''Usuário''' e a '''Senha''' válidos e clique em '''OK''' para prosseguir.

:: '''Extrema Importância:''' O uso inadequado de algumas funções de diagnóstico (como testes de estresse e sobrecarga de submissões no banco de dados) pode impactar a performance do ambiente do cliente. Utilize a ferramenta com cautela e, preferencialmente, alinhado com a equipe de suporte. 
</div>

=== Tempo de acesso ===
<div align="justify">
A aba principal de tempo de acesso é dividida em dois sub-monitoramentos essenciais: Banco de Dados (DB) e Rede.
</div>
==== DB (Banco de Dados) ====
<div align="justify">
Esta seção é focada em testar a latência, a capacidade de resposta e a saúde geral do banco de dados conectado.

[[Image: CGDiagnosticos_02.png|750px|centro]]

* '''Connection-string:''' A ferramenta permite identificar automaticamente o banco e atualizar o SQL padrão, ou inserir manualmente uma porta/instância diferente após o Data Source. Quando a Connection-string possuir a senha, será aplicada uma criptografia para evitar exposição.
* '''Componentes para conexão:''' Permite escolher o provedor (ex: OleDb Genérica).
* '''SQL:''' Área de script onde a consulta de teste é inserida.
* '''Ações rápidas:''' Estão disponíveis botões auxiliares à direita para '''Carregar Script''', obter a '''Versão do Banco''', o '''Tamanho do Banco''' (necessita de permissão especial no usuário de banco) e listar as '''Consultas mais pesadas'''.

:: Ao clicar em '''Consultas mais pesadas''', o sistema abrirá uma janela com o "Top 50" de instruções, detalhando o Tempo de CPU, Tempo total worker e a quantidade de execuções.

[[Image: CGDiagnosticos_03.png|750px|centro]]

Ainda na guia DB, o envio dos testes pode ser realizado de duas maneiras distintas:

'''1. Submissão Manual'''
Permite configurar o volume de carga, definindo quantas vezes a consulta será submetida e em quantos ciclos.
Ao ativar indicadores de eficiência, o log mostrará na tela se a resposta foi Ruim, Regular, Bom, Ótimo ou Excelente. Se deixar o mouse posicionado sobre o checkbox "Incluir indicador de eficiência" será apresentado um tooltip com as faixas:

[[Image: CGDiagnosticos_05_1.png|535px|centro]]

Ao marcar a opção de "incluir connection-string", a senha será mostrada criptografada caso esteja incluída nela.

[[Image: CGDiagnosticos_05.png|750px|centro]]

'''2. Submissão Automática'''
Ideal para monitoramento contínuo. Define-se um intervalo em milissegundos e aponta-se um arquivo (ex: C:\Temp\Log.txt) para gravar o histórico e rastrear o log da última execução.

[[Image: CGDiagnosticos_04.png|750px|centro]]
</div>

==== Rede ====
<div align="justify">
Responsável por medir a velocidade de transferência e a estabilidade da conexão de rede até o armazenamento ou servidor de destino.

[[Image: CGDiagnosticos_06.png|750px|centro]]

* '''Arquivo:''' Informe o caminho de um arquivo local ou mapeado na rede.
* '''Parâmetros:''' Defina o tamanho máximo da transferência (em MB) e o número de repetições do teste.
* '''Execução:''' Ao clicar no botão '''Transferir''', a área de log inferior começará a exibir a velocidade de leitura (mbits/ps), o tamanho dos bytes trafegados e a latência (ms).

Se deixar o mouse posicionado sobre o checkbox "Incluir indicador de eficiência" será apresentado um tooltip com as faixas:

[[Image: CGDiagnosticos_08_1.png|573px|centro]]

Ao executar temos o diagnóstico de rede.

[[Image: CGDiagnosticos_08.png|750px|centro]]

:: Utilize o campo '''Pingar endereço (IP ou nome)''' para validar a conectividade básica com o destino antes de iniciar transferências pesadas.
</div>

=== .NET ===
Página destinada à validação de pré-requisitos lógicos da máquina.

[[Image: CGDiagnosticos_07.png|750px|centro]]

Clicando no botão '''Verificar versões instaladas''', o CIGAM Diagnósticos varre o registro do Windows e lista de forma clara todas as versões do Microsoft .NET Framework presentes, além de detalhar as atualizações de segurança e Hotfixes (KB) aplicados no sistema operacional.

=== Sistema ===
Esta seção extrai um raio-X do servidor ou máquina atual conectando-se diretamente com as APIs WMI (Windows Management Instrumentation).

[[Image: CGDiagnosticos_09.png|750px|centro]]

* Selecione a API correspondente no menu suspenso (por exemplo, <code>Win32_OperatingSystem</code>).
* Clique em '''Buscar informações da API selecionada'''.
* O quadro exibirá propriedades aprofundadas como a versão exata do Windows Server, a quantidade de RAM utilizável e os diretórios de BootDevice.

=== Web ===
Uma área projetada como um cliente HTTP/API integrado, permitindo simular chamadas externas e validar acessos de serviços.

[[Image: CGDiagnosticos_10.png|750px|centro]]

* '''Endpoint:''' Informe a URL completa que será alvo da requisição.
* '''Headers:''' Adicione cabeçalhos necessários para autenticação ou tipo de conteúdo (um por linha).
* '''Parâmetros por POST:''' Envie os parâmetros em formato de lista ou ative a opção para envio direto no Corpo (Body).
* Com a quantidade de requisições definida, clique em '''Invoke Request'''. O retorno do serviço (JSON, XML ou Texto) será apresentado na caixa de Resposta.

=== Timer ===
Esta aba funciona como um cronômetro de precisão, ideal para medir intervalos de execução de tarefas ou tempo de resposta entre ações dentro do sistema.

[[Image: CGDiagnosticos_12.png|750px|centro]]

* '''(Re)Start:''' Inicia ou reinicia a contagem do tempo.
* '''Stop:''' Interrompe a contagem.
* '''Check-point:''' Registra uma marcação de tempo (timestamp) na tela, permitindo comparar lapsos entre diferentes etapas de um processo.

=== Interação ===
<div align="justify">
Utilizada para automatizar ou manipular mensagens do Windows (Win32) enviadas entre janelas.

É necessário estar logado com um usuário com permissão de administrador para visualizar esta guia.

[[Image: CGDiagnosticos_13.png|750px|centro]]

* '''Intervalo:''' Define a frequência (em milissegundos) para os processos de busca.
* '''Handle manual:''' Permite injetar manualmente um identificador de janela (Handle) para interações específicas.
* '''Avisar se receber essa Message:''' Monitora o recebimento de mensagens específicas do sistema.
* '''Configurações de busca:''' Opções como "Buscar paizão" facilitam a localização da hierarquia de formulários (OpenForms) e a extração de metadados como tamanho de borda e informações de ''TopMost''.
* '''user32.SendMessage():''' Ferramenta avançada para forçar o envio de comandos (Handle, Message, WParam, LParam) diretamente a um componente da interface.

:: '''Extrema Importância:''' O uso indevido das funções da aba "Interação" e do "SendMessage" pode causar comportamentos inesperados ou travamentos em formulários ativos. Utilize apenas sob estrita necessidade de diagnóstico.
</div>

=== Inspeção ===
<div align="justify">
Oferece um resumo completo e estruturado das propriedades da janela ou do componente focado no momento.

É necessário estar logado com um usuário com permissão de administrador para visualizar esta guia.

[[Image: CGDiagnosticos_14.png|750px|centro]]

Esta tabela exibe em tempo real o estado de objetos, tais como:
* '''this.Handle:''' Identificador único do componente.
* '''GetActiveWindow / GetForegroundWindow:''' Identificação da janela em foco no sistema operacional.
* '''GetText:''' Texto exibido no componente (ex: título da janela ou rótulo de botão).
* '''Hierarquia:''' Informações sobre a relação pai/filho dos componentes na estrutura da aplicação.

A opção "Sempre Visível" deixará a janela do CGDiagnósticos visível mesmo que estejamos posicionados em outra tela, de modo que possamos visualizar as propriedades do objeto posicionado. Além disto, recomenda-se usar esta opção em conjunto com a opção "Monitoramento parado" desmarcada, assim a janela em foco terá suas propriedades exibidas na tabela. Ao marcar "Monitoramento parado" a tabela é "congelada" com os dados atuais, permitindo uma análise sem que os dados sejam atualizados conforme alteramos o foco entre campos e janelas.
</div>

=== Spy ===
<div align="justify">
Esta funcionalidade atua como um "identificador de objetos", permitindo capturar informações de qualquer controle da interface gráfica do Windows.

É necessário estar logado com um usuário com permissão de administrador para visualizar esta guia.

[[Image: CGDiagnosticos_15.png|750px|centro]]

* '''Captura via Arraste:''' Clique e segure o retângulo cinza e arraste-o sobre qualquer elemento de qualquer aplicação aberta.
* '''Informações capturadas:''' O sistema preenche automaticamente os campos com o '''Handle''' (em formato decimal e hex), a posição (Rectangle), o '''ClassName''' da classe do objeto e o '''Text''' (conteúdo textual do elemento).
</div>

=== Statistics ===
<div align="justify">
Dedicada ao monitoramento detalhado do consumo de recursos de processos específicos em execução no Windows.

[[Image: CGDiagnosticos_11.png|750px|centro]]

* '''Processo:''' Selecione na lista o processo desejado (ou marque "Somente meu usuário" para filtrar).
* '''Métricas disponíveis:''' É possível monitorar em tempo real:
** Memory Peak e Memory Size64.
** Counters e GUI.
** Processor Timers, CPU Usage, entre outros.
* '''Check Point:''' Permite nomear e sequenciar listas de monitoramento para coletar métricas em momentos distintos.
* '''Log:''' Exibe os dados coletados (DateTime, estado, memória privada, handles, threads, entre outros).

:: Ao finalizar a coleta, utilize o botão '''Salvar''' para exportar os dados do log para análise posterior ou envio à equipe de suporte.
</div>

=== Sobre ===
<div align="justify">
Na guia "Sobre" temos as informações da versão da aplicação e links para documentação e site da CIGAM.

[[Image: CGDiagnosticos_16.png|750px|centro]]

</div>

Arquivo:CGDiagnosticos 08 1.png

2026-07-16T13:13:25Z

Oseias.rodrigues:

CGDiagnosticos

2026-07-16T13:12:07Z

Oseias.rodrigues: /* DB (Banco de Dados) */

<div align="justify">
O '''CIGAM Diagnósticos''' é uma ferramenta avançada para análise e monitoramento da infraestrutura do seu ambiente. Com ele, é possível validar a comunicação com o banco de dados, aferir a velocidade da rede, coletar informações detalhadas do sistema operacional, listar versões do .NET e testar requisições e integrações Web.

Abaixo, detalhamos cada uma de suas funcionalidades para guiar a utilização correta da aplicação.
</div>
=== Acesso à Ferramenta ===
<div align="justify">
Ao executar o aplicativo, será exibida a tela de login inicial solicitando suas credenciais de acesso.

[[Image: CGDiagnosticos_01.png|300px|centro]]

Informe o '''Usuário''' e a '''Senha''' válidos e clique em '''OK''' para prosseguir.

:: '''Extrema Importância:''' O uso inadequado de algumas funções de diagnóstico (como testes de estresse e sobrecarga de submissões no banco de dados) pode impactar a performance do ambiente do cliente. Utilize a ferramenta com cautela e, preferencialmente, alinhado com a equipe de suporte. 
</div>

=== Tempo de acesso ===
<div align="justify">
A aba principal de tempo de acesso é dividida em dois sub-monitoramentos essenciais: Banco de Dados (DB) e Rede.
</div>
==== DB (Banco de Dados) ====
<div align="justify">
Esta seção é focada em testar a latência, a capacidade de resposta e a saúde geral do banco de dados conectado.

[[Image: CGDiagnosticos_02.png|750px|centro]]

* '''Connection-string:''' A ferramenta permite identificar automaticamente o banco e atualizar o SQL padrão, ou inserir manualmente uma porta/instância diferente após o Data Source. Quando a Connection-string possuir a senha, será aplicada uma criptografia para evitar exposição.
* '''Componentes para conexão:''' Permite escolher o provedor (ex: OleDb Genérica).
* '''SQL:''' Área de script onde a consulta de teste é inserida.
* '''Ações rápidas:''' Estão disponíveis botões auxiliares à direita para '''Carregar Script''', obter a '''Versão do Banco''', o '''Tamanho do Banco''' (necessita de permissão especial no usuário de banco) e listar as '''Consultas mais pesadas'''.

:: Ao clicar em '''Consultas mais pesadas''', o sistema abrirá uma janela com o "Top 50" de instruções, detalhando o Tempo de CPU, Tempo total worker e a quantidade de execuções.

[[Image: CGDiagnosticos_03.png|750px|centro]]

Ainda na guia DB, o envio dos testes pode ser realizado de duas maneiras distintas:

'''1. Submissão Manual'''
Permite configurar o volume de carga, definindo quantas vezes a consulta será submetida e em quantos ciclos.
Ao ativar indicadores de eficiência, o log mostrará na tela se a resposta foi Ruim, Regular, Bom, Ótimo ou Excelente. Se deixar o mouse posicionado sobre o checkbox "Incluir indicador de eficiência" será apresentado um tooltip com as faixas:

[[Image: CGDiagnosticos_05_1.png|535px|centro]]

Ao marcar a opção de "incluir connection-string", a senha será mostrada criptografada caso esteja incluída nela.

[[Image: CGDiagnosticos_05.png|750px|centro]]

'''2. Submissão Automática'''
Ideal para monitoramento contínuo. Define-se um intervalo em milissegundos e aponta-se um arquivo (ex: C:\Temp\Log.txt) para gravar o histórico e rastrear o log da última execução.

[[Image: CGDiagnosticos_04.png|750px|centro]]
</div>

==== Rede ====
<div align="justify">
Responsável por medir a velocidade de transferência e a estabilidade da conexão de rede até o armazenamento ou servidor de destino.

[[Image: CGDiagnosticos_06.png|750px|centro]]

* '''Arquivo:''' Informe o caminho de um arquivo local ou mapeado na rede.
* '''Parâmetros:''' Defina o tamanho máximo da transferência (em MB) e o número de repetições do teste.
* '''Execução:''' Ao clicar no botão '''Transferir''', a área de log inferior começará a exibir a velocidade de leitura (mbits/ps), o tamanho dos bytes trafegados e a latência (ms).

[[Image: CGDiagnosticos_08.png|750px|centro]]

:: Utilize o campo '''Pingar endereço (IP ou nome)''' para validar a conectividade básica com o destino antes de iniciar transferências pesadas.
</div>

=== .NET ===
Página destinada à validação de pré-requisitos lógicos da máquina.

[[Image: CGDiagnosticos_07.png|750px|centro]]

Clicando no botão '''Verificar versões instaladas''', o CIGAM Diagnósticos varre o registro do Windows e lista de forma clara todas as versões do Microsoft .NET Framework presentes, além de detalhar as atualizações de segurança e Hotfixes (KB) aplicados no sistema operacional.

=== Sistema ===
Esta seção extrai um raio-X do servidor ou máquina atual conectando-se diretamente com as APIs WMI (Windows Management Instrumentation).

[[Image: CGDiagnosticos_09.png|750px|centro]]

* Selecione a API correspondente no menu suspenso (por exemplo, <code>Win32_OperatingSystem</code>).
* Clique em '''Buscar informações da API selecionada'''.
* O quadro exibirá propriedades aprofundadas como a versão exata do Windows Server, a quantidade de RAM utilizável e os diretórios de BootDevice.

=== Web ===
Uma área projetada como um cliente HTTP/API integrado, permitindo simular chamadas externas e validar acessos de serviços.

[[Image: CGDiagnosticos_10.png|750px|centro]]

* '''Endpoint:''' Informe a URL completa que será alvo da requisição.
* '''Headers:''' Adicione cabeçalhos necessários para autenticação ou tipo de conteúdo (um por linha).
* '''Parâmetros por POST:''' Envie os parâmetros em formato de lista ou ative a opção para envio direto no Corpo (Body).
* Com a quantidade de requisições definida, clique em '''Invoke Request'''. O retorno do serviço (JSON, XML ou Texto) será apresentado na caixa de Resposta.

=== Timer ===
Esta aba funciona como um cronômetro de precisão, ideal para medir intervalos de execução de tarefas ou tempo de resposta entre ações dentro do sistema.

[[Image: CGDiagnosticos_12.png|750px|centro]]

* '''(Re)Start:''' Inicia ou reinicia a contagem do tempo.
* '''Stop:''' Interrompe a contagem.
* '''Check-point:''' Registra uma marcação de tempo (timestamp) na tela, permitindo comparar lapsos entre diferentes etapas de um processo.

=== Interação ===
<div align="justify">
Utilizada para automatizar ou manipular mensagens do Windows (Win32) enviadas entre janelas.

É necessário estar logado com um usuário com permissão de administrador para visualizar esta guia.

[[Image: CGDiagnosticos_13.png|750px|centro]]

* '''Intervalo:''' Define a frequência (em milissegundos) para os processos de busca.
* '''Handle manual:''' Permite injetar manualmente um identificador de janela (Handle) para interações específicas.
* '''Avisar se receber essa Message:''' Monitora o recebimento de mensagens específicas do sistema.
* '''Configurações de busca:''' Opções como "Buscar paizão" facilitam a localização da hierarquia de formulários (OpenForms) e a extração de metadados como tamanho de borda e informações de ''TopMost''.
* '''user32.SendMessage():''' Ferramenta avançada para forçar o envio de comandos (Handle, Message, WParam, LParam) diretamente a um componente da interface.

:: '''Extrema Importância:''' O uso indevido das funções da aba "Interação" e do "SendMessage" pode causar comportamentos inesperados ou travamentos em formulários ativos. Utilize apenas sob estrita necessidade de diagnóstico.
</div>

=== Inspeção ===
<div align="justify">
Oferece um resumo completo e estruturado das propriedades da janela ou do componente focado no momento.

É necessário estar logado com um usuário com permissão de administrador para visualizar esta guia.

[[Image: CGDiagnosticos_14.png|750px|centro]]

Esta tabela exibe em tempo real o estado de objetos, tais como:
* '''this.Handle:''' Identificador único do componente.
* '''GetActiveWindow / GetForegroundWindow:''' Identificação da janela em foco no sistema operacional.
* '''GetText:''' Texto exibido no componente (ex: título da janela ou rótulo de botão).
* '''Hierarquia:''' Informações sobre a relação pai/filho dos componentes na estrutura da aplicação.

A opção "Sempre Visível" deixará a janela do CGDiagnósticos visível mesmo que estejamos posicionados em outra tela, de modo que possamos visualizar as propriedades do objeto posicionado. Além disto, recomenda-se usar esta opção em conjunto com a opção "Monitoramento parado" desmarcada, assim a janela em foco terá suas propriedades exibidas na tabela. Ao marcar "Monitoramento parado" a tabela é "congelada" com os dados atuais, permitindo uma análise sem que os dados sejam atualizados conforme alteramos o foco entre campos e janelas.
</div>

=== Spy ===
<div align="justify">
Esta funcionalidade atua como um "identificador de objetos", permitindo capturar informações de qualquer controle da interface gráfica do Windows.

É necessário estar logado com um usuário com permissão de administrador para visualizar esta guia.

[[Image: CGDiagnosticos_15.png|750px|centro]]

* '''Captura via Arraste:''' Clique e segure o retângulo cinza e arraste-o sobre qualquer elemento de qualquer aplicação aberta.
* '''Informações capturadas:''' O sistema preenche automaticamente os campos com o '''Handle''' (em formato decimal e hex), a posição (Rectangle), o '''ClassName''' da classe do objeto e o '''Text''' (conteúdo textual do elemento).
</div>

=== Statistics ===
<div align="justify">
Dedicada ao monitoramento detalhado do consumo de recursos de processos específicos em execução no Windows.

[[Image: CGDiagnosticos_11.png|750px|centro]]

* '''Processo:''' Selecione na lista o processo desejado (ou marque "Somente meu usuário" para filtrar).
* '''Métricas disponíveis:''' É possível monitorar em tempo real:
** Memory Peak e Memory Size64.
** Counters e GUI.
** Processor Timers, CPU Usage, entre outros.
* '''Check Point:''' Permite nomear e sequenciar listas de monitoramento para coletar métricas em momentos distintos.
* '''Log:''' Exibe os dados coletados (DateTime, estado, memória privada, handles, threads, entre outros).

:: Ao finalizar a coleta, utilize o botão '''Salvar''' para exportar os dados do log para análise posterior ou envio à equipe de suporte.
</div>

=== Sobre ===
<div align="justify">
Na guia "Sobre" temos as informações da versão da aplicação e links para documentação e site da CIGAM.

[[Image: CGDiagnosticos_16.png|750px|centro]]

</div>

Arquivo:CGDiagnosticos 05 1.png

2026-07-16T13:11:15Z

Oseias.rodrigues:

CGDiagnosticos

2026-07-15T18:25:49Z

Oseias.rodrigues: /* Sobre */

<div align="justify">
O '''CIGAM Diagnósticos''' é uma ferramenta avançada para análise e monitoramento da infraestrutura do seu ambiente. Com ele, é possível validar a comunicação com o banco de dados, aferir a velocidade da rede, coletar informações detalhadas do sistema operacional, listar versões do .NET e testar requisições e integrações Web.

Abaixo, detalhamos cada uma de suas funcionalidades para guiar a utilização correta da aplicação.
</div>
=== Acesso à Ferramenta ===
<div align="justify">
Ao executar o aplicativo, será exibida a tela de login inicial solicitando suas credenciais de acesso.

[[Image: CGDiagnosticos_01.png|300px|centro]]

Informe o '''Usuário''' e a '''Senha''' válidos e clique em '''OK''' para prosseguir.

:: '''Extrema Importância:''' O uso inadequado de algumas funções de diagnóstico (como testes de estresse e sobrecarga de submissões no banco de dados) pode impactar a performance do ambiente do cliente. Utilize a ferramenta com cautela e, preferencialmente, alinhado com a equipe de suporte. 
</div>

=== Tempo de acesso ===
<div align="justify">
A aba principal de tempo de acesso é dividida em dois sub-monitoramentos essenciais: Banco de Dados (DB) e Rede.
</div>
==== DB (Banco de Dados) ====
<div align="justify">
Esta seção é focada em testar a latência, a capacidade de resposta e a saúde geral do banco de dados conectado.

[[Image: CGDiagnosticos_02.png|750px|centro]]

* '''Connection-string:''' A ferramenta permite identificar automaticamente o banco e atualizar o SQL padrão, ou inserir manualmente uma porta/instância diferente após o Data Source. Quando a Connection-string possuir a senha, será aplicada uma criptografia para evitar exposição.
* '''Componentes para conexão:''' Permite escolher o provedor (ex: OleDb Genérica).
* '''SQL:''' Área de script onde a consulta de teste é inserida.
* '''Ações rápidas:''' Estão disponíveis botões auxiliares à direita para '''Carregar Script''', obter a '''Versão do Banco''', o '''Tamanho do Banco''' (necessita de permissão especial no usuário de banco) e listar as '''Consultas mais pesadas'''.

:: Ao clicar em '''Consultas mais pesadas''', o sistema abrirá uma janela com o "Top 50" de instruções, detalhando o Tempo de CPU, Tempo total worker e a quantidade de execuções.

[[Image: CGDiagnosticos_03.png|750px|centro]]

Ainda na guia DB, o envio dos testes pode ser realizado de duas maneiras distintas:

'''1. Submissão Manual'''
Permite configurar o volume de carga, definindo quantas vezes a consulta será submetida e em quantos ciclos.
Ao ativar indicadores de eficiência, o log mostrará na tela se a resposta foi Ruim, Regular, Bom, Ótimo ou Excelente. Ao marcar a opção de "incluir connection-string", a senha será mostrada criptografada caso esteja incluída nela.

[[Image: CGDiagnosticos_05.png|750px|centro]]

'''2. Submissão Automática'''
Ideal para monitoramento contínuo. Define-se um intervalo em milissegundos e aponta-se um arquivo (ex: C:\Temp\Log.txt) para gravar o histórico e rastrear o log da última execução.

[[Image: CGDiagnosticos_04.png|750px|centro]]
</div>

==== Rede ====
<div align="justify">
Responsável por medir a velocidade de transferência e a estabilidade da conexão de rede até o armazenamento ou servidor de destino.

[[Image: CGDiagnosticos_06.png|750px|centro]]

* '''Arquivo:''' Informe o caminho de um arquivo local ou mapeado na rede.
* '''Parâmetros:''' Defina o tamanho máximo da transferência (em MB) e o número de repetições do teste.
* '''Execução:''' Ao clicar no botão '''Transferir''', a área de log inferior começará a exibir a velocidade de leitura (mbits/ps), o tamanho dos bytes trafegados e a latência (ms).

[[Image: CGDiagnosticos_08.png|750px|centro]]

:: Utilize o campo '''Pingar endereço (IP ou nome)''' para validar a conectividade básica com o destino antes de iniciar transferências pesadas.
</div>

=== .NET ===
Página destinada à validação de pré-requisitos lógicos da máquina.

[[Image: CGDiagnosticos_07.png|750px|centro]]

Clicando no botão '''Verificar versões instaladas''', o CIGAM Diagnósticos varre o registro do Windows e lista de forma clara todas as versões do Microsoft .NET Framework presentes, além de detalhar as atualizações de segurança e Hotfixes (KB) aplicados no sistema operacional.

=== Sistema ===
Esta seção extrai um raio-X do servidor ou máquina atual conectando-se diretamente com as APIs WMI (Windows Management Instrumentation).

[[Image: CGDiagnosticos_09.png|750px|centro]]

* Selecione a API correspondente no menu suspenso (por exemplo, <code>Win32_OperatingSystem</code>).
* Clique em '''Buscar informações da API selecionada'''.
* O quadro exibirá propriedades aprofundadas como a versão exata do Windows Server, a quantidade de RAM utilizável e os diretórios de BootDevice.

=== Web ===
Uma área projetada como um cliente HTTP/API integrado, permitindo simular chamadas externas e validar acessos de serviços.

[[Image: CGDiagnosticos_10.png|750px|centro]]

* '''Endpoint:''' Informe a URL completa que será alvo da requisição.
* '''Headers:''' Adicione cabeçalhos necessários para autenticação ou tipo de conteúdo (um por linha).
* '''Parâmetros por POST:''' Envie os parâmetros em formato de lista ou ative a opção para envio direto no Corpo (Body).
* Com a quantidade de requisições definida, clique em '''Invoke Request'''. O retorno do serviço (JSON, XML ou Texto) será apresentado na caixa de Resposta.

=== Timer ===
Esta aba funciona como um cronômetro de precisão, ideal para medir intervalos de execução de tarefas ou tempo de resposta entre ações dentro do sistema.

[[Image: CGDiagnosticos_12.png|750px|centro]]

* '''(Re)Start:''' Inicia ou reinicia a contagem do tempo.
* '''Stop:''' Interrompe a contagem.
* '''Check-point:''' Registra uma marcação de tempo (timestamp) na tela, permitindo comparar lapsos entre diferentes etapas de um processo.

=== Interação ===
<div align="justify">
Utilizada para automatizar ou manipular mensagens do Windows (Win32) enviadas entre janelas.

É necessário estar logado com um usuário com permissão de administrador para visualizar esta guia.

[[Image: CGDiagnosticos_13.png|750px|centro]]

* '''Intervalo:''' Define a frequência (em milissegundos) para os processos de busca.
* '''Handle manual:''' Permite injetar manualmente um identificador de janela (Handle) para interações específicas.
* '''Avisar se receber essa Message:''' Monitora o recebimento de mensagens específicas do sistema.
* '''Configurações de busca:''' Opções como "Buscar paizão" facilitam a localização da hierarquia de formulários (OpenForms) e a extração de metadados como tamanho de borda e informações de ''TopMost''.
* '''user32.SendMessage():''' Ferramenta avançada para forçar o envio de comandos (Handle, Message, WParam, LParam) diretamente a um componente da interface.

:: '''Extrema Importância:''' O uso indevido das funções da aba "Interação" e do "SendMessage" pode causar comportamentos inesperados ou travamentos em formulários ativos. Utilize apenas sob estrita necessidade de diagnóstico.
</div>

=== Inspeção ===
<div align="justify">
Oferece um resumo completo e estruturado das propriedades da janela ou do componente focado no momento.

É necessário estar logado com um usuário com permissão de administrador para visualizar esta guia.

[[Image: CGDiagnosticos_14.png|750px|centro]]

Esta tabela exibe em tempo real o estado de objetos, tais como:
* '''this.Handle:''' Identificador único do componente.
* '''GetActiveWindow / GetForegroundWindow:''' Identificação da janela em foco no sistema operacional.
* '''GetText:''' Texto exibido no componente (ex: título da janela ou rótulo de botão).
* '''Hierarquia:''' Informações sobre a relação pai/filho dos componentes na estrutura da aplicação.

A opção "Sempre Visível" deixará a janela do CGDiagnósticos visível mesmo que estejamos posicionados em outra tela, de modo que possamos visualizar as propriedades do objeto posicionado. Além disto, recomenda-se usar esta opção em conjunto com a opção "Monitoramento parado" desmarcada, assim a janela em foco terá suas propriedades exibidas na tabela. Ao marcar "Monitoramento parado" a tabela é "congelada" com os dados atuais, permitindo uma análise sem que os dados sejam atualizados conforme alteramos o foco entre campos e janelas.
</div>

=== Spy ===
<div align="justify">
Esta funcionalidade atua como um "identificador de objetos", permitindo capturar informações de qualquer controle da interface gráfica do Windows.

É necessário estar logado com um usuário com permissão de administrador para visualizar esta guia.

[[Image: CGDiagnosticos_15.png|750px|centro]]

* '''Captura via Arraste:''' Clique e segure o retângulo cinza e arraste-o sobre qualquer elemento de qualquer aplicação aberta.
* '''Informações capturadas:''' O sistema preenche automaticamente os campos com o '''Handle''' (em formato decimal e hex), a posição (Rectangle), o '''ClassName''' da classe do objeto e o '''Text''' (conteúdo textual do elemento).
</div>

=== Statistics ===
<div align="justify">
Dedicada ao monitoramento detalhado do consumo de recursos de processos específicos em execução no Windows.

[[Image: CGDiagnosticos_11.png|750px|centro]]

* '''Processo:''' Selecione na lista o processo desejado (ou marque "Somente meu usuário" para filtrar).
* '''Métricas disponíveis:''' É possível monitorar em tempo real:
** Memory Peak e Memory Size64.
** Counters e GUI.
** Processor Timers, CPU Usage, entre outros.
* '''Check Point:''' Permite nomear e sequenciar listas de monitoramento para coletar métricas em momentos distintos.
* '''Log:''' Exibe os dados coletados (DateTime, estado, memória privada, handles, threads, entre outros).

:: Ao finalizar a coleta, utilize o botão '''Salvar''' para exportar os dados do log para análise posterior ou envio à equipe de suporte.
</div>

=== Sobre ===
<div align="justify">
Na guia "Sobre" temos as informações da versão da aplicação e links para documentação e site da CIGAM.

[[Image: CGDiagnosticos_16.png|750px|centro]]

</div>

Arquivo:CGDiagnosticos 16.png

2026-07-15T18:25:33Z

Oseias.rodrigues:

CGDiagnosticos

2026-07-15T18:25:20Z

Oseias.rodrigues: /* Sobre */

<div align="justify">
O '''CIGAM Diagnósticos''' é uma ferramenta avançada para análise e monitoramento da infraestrutura do seu ambiente. Com ele, é possível validar a comunicação com o banco de dados, aferir a velocidade da rede, coletar informações detalhadas do sistema operacional, listar versões do .NET e testar requisições e integrações Web.

Abaixo, detalhamos cada uma de suas funcionalidades para guiar a utilização correta da aplicação.
</div>
=== Acesso à Ferramenta ===
<div align="justify">
Ao executar o aplicativo, será exibida a tela de login inicial solicitando suas credenciais de acesso.

[[Image: CGDiagnosticos_01.png|300px|centro]]

Informe o '''Usuário''' e a '''Senha''' válidos e clique em '''OK''' para prosseguir.

:: '''Extrema Importância:''' O uso inadequado de algumas funções de diagnóstico (como testes de estresse e sobrecarga de submissões no banco de dados) pode impactar a performance do ambiente do cliente. Utilize a ferramenta com cautela e, preferencialmente, alinhado com a equipe de suporte. 
</div>

=== Tempo de acesso ===
<div align="justify">
A aba principal de tempo de acesso é dividida em dois sub-monitoramentos essenciais: Banco de Dados (DB) e Rede.
</div>
==== DB (Banco de Dados) ====
<div align="justify">
Esta seção é focada em testar a latência, a capacidade de resposta e a saúde geral do banco de dados conectado.

[[Image: CGDiagnosticos_02.png|750px|centro]]

* '''Connection-string:''' A ferramenta permite identificar automaticamente o banco e atualizar o SQL padrão, ou inserir manualmente uma porta/instância diferente após o Data Source. Quando a Connection-string possuir a senha, será aplicada uma criptografia para evitar exposição.
* '''Componentes para conexão:''' Permite escolher o provedor (ex: OleDb Genérica).
* '''SQL:''' Área de script onde a consulta de teste é inserida.
* '''Ações rápidas:''' Estão disponíveis botões auxiliares à direita para '''Carregar Script''', obter a '''Versão do Banco''', o '''Tamanho do Banco''' (necessita de permissão especial no usuário de banco) e listar as '''Consultas mais pesadas'''.

:: Ao clicar em '''Consultas mais pesadas''', o sistema abrirá uma janela com o "Top 50" de instruções, detalhando o Tempo de CPU, Tempo total worker e a quantidade de execuções.

[[Image: CGDiagnosticos_03.png|750px|centro]]

Ainda na guia DB, o envio dos testes pode ser realizado de duas maneiras distintas:

'''1. Submissão Manual'''
Permite configurar o volume de carga, definindo quantas vezes a consulta será submetida e em quantos ciclos.
Ao ativar indicadores de eficiência, o log mostrará na tela se a resposta foi Ruim, Regular, Bom, Ótimo ou Excelente. Ao marcar a opção de "incluir connection-string", a senha será mostrada criptografada caso esteja incluída nela.

[[Image: CGDiagnosticos_05.png|750px|centro]]

'''2. Submissão Automática'''
Ideal para monitoramento contínuo. Define-se um intervalo em milissegundos e aponta-se um arquivo (ex: C:\Temp\Log.txt) para gravar o histórico e rastrear o log da última execução.

[[Image: CGDiagnosticos_04.png|750px|centro]]
</div>

==== Rede ====
<div align="justify">
Responsável por medir a velocidade de transferência e a estabilidade da conexão de rede até o armazenamento ou servidor de destino.

[[Image: CGDiagnosticos_06.png|750px|centro]]

* '''Arquivo:''' Informe o caminho de um arquivo local ou mapeado na rede.
* '''Parâmetros:''' Defina o tamanho máximo da transferência (em MB) e o número de repetições do teste.
* '''Execução:''' Ao clicar no botão '''Transferir''', a área de log inferior começará a exibir a velocidade de leitura (mbits/ps), o tamanho dos bytes trafegados e a latência (ms).

[[Image: CGDiagnosticos_08.png|750px|centro]]

:: Utilize o campo '''Pingar endereço (IP ou nome)''' para validar a conectividade básica com o destino antes de iniciar transferências pesadas.
</div>

=== .NET ===
Página destinada à validação de pré-requisitos lógicos da máquina.

[[Image: CGDiagnosticos_07.png|750px|centro]]

Clicando no botão '''Verificar versões instaladas''', o CIGAM Diagnósticos varre o registro do Windows e lista de forma clara todas as versões do Microsoft .NET Framework presentes, além de detalhar as atualizações de segurança e Hotfixes (KB) aplicados no sistema operacional.

=== Sistema ===
Esta seção extrai um raio-X do servidor ou máquina atual conectando-se diretamente com as APIs WMI (Windows Management Instrumentation).

[[Image: CGDiagnosticos_09.png|750px|centro]]

* Selecione a API correspondente no menu suspenso (por exemplo, <code>Win32_OperatingSystem</code>).
* Clique em '''Buscar informações da API selecionada'''.
* O quadro exibirá propriedades aprofundadas como a versão exata do Windows Server, a quantidade de RAM utilizável e os diretórios de BootDevice.

=== Web ===
Uma área projetada como um cliente HTTP/API integrado, permitindo simular chamadas externas e validar acessos de serviços.

[[Image: CGDiagnosticos_10.png|750px|centro]]

* '''Endpoint:''' Informe a URL completa que será alvo da requisição.
* '''Headers:''' Adicione cabeçalhos necessários para autenticação ou tipo de conteúdo (um por linha).
* '''Parâmetros por POST:''' Envie os parâmetros em formato de lista ou ative a opção para envio direto no Corpo (Body).
* Com a quantidade de requisições definida, clique em '''Invoke Request'''. O retorno do serviço (JSON, XML ou Texto) será apresentado na caixa de Resposta.

=== Timer ===
Esta aba funciona como um cronômetro de precisão, ideal para medir intervalos de execução de tarefas ou tempo de resposta entre ações dentro do sistema.

[[Image: CGDiagnosticos_12.png|750px|centro]]

* '''(Re)Start:''' Inicia ou reinicia a contagem do tempo.
* '''Stop:''' Interrompe a contagem.
* '''Check-point:''' Registra uma marcação de tempo (timestamp) na tela, permitindo comparar lapsos entre diferentes etapas de um processo.

=== Interação ===
<div align="justify">
Utilizada para automatizar ou manipular mensagens do Windows (Win32) enviadas entre janelas.

É necessário estar logado com um usuário com permissão de administrador para visualizar esta guia.

[[Image: CGDiagnosticos_13.png|750px|centro]]

* '''Intervalo:''' Define a frequência (em milissegundos) para os processos de busca.
* '''Handle manual:''' Permite injetar manualmente um identificador de janela (Handle) para interações específicas.
* '''Avisar se receber essa Message:''' Monitora o recebimento de mensagens específicas do sistema.
* '''Configurações de busca:''' Opções como "Buscar paizão" facilitam a localização da hierarquia de formulários (OpenForms) e a extração de metadados como tamanho de borda e informações de ''TopMost''.
* '''user32.SendMessage():''' Ferramenta avançada para forçar o envio de comandos (Handle, Message, WParam, LParam) diretamente a um componente da interface.

:: '''Extrema Importância:''' O uso indevido das funções da aba "Interação" e do "SendMessage" pode causar comportamentos inesperados ou travamentos em formulários ativos. Utilize apenas sob estrita necessidade de diagnóstico.
</div>

=== Inspeção ===
<div align="justify">
Oferece um resumo completo e estruturado das propriedades da janela ou do componente focado no momento.

É necessário estar logado com um usuário com permissão de administrador para visualizar esta guia.

[[Image: CGDiagnosticos_14.png|750px|centro]]

Esta tabela exibe em tempo real o estado de objetos, tais como:
* '''this.Handle:''' Identificador único do componente.
* '''GetActiveWindow / GetForegroundWindow:''' Identificação da janela em foco no sistema operacional.
* '''GetText:''' Texto exibido no componente (ex: título da janela ou rótulo de botão).
* '''Hierarquia:''' Informações sobre a relação pai/filho dos componentes na estrutura da aplicação.

A opção "Sempre Visível" deixará a janela do CGDiagnósticos visível mesmo que estejamos posicionados em outra tela, de modo que possamos visualizar as propriedades do objeto posicionado. Além disto, recomenda-se usar esta opção em conjunto com a opção "Monitoramento parado" desmarcada, assim a janela em foco terá suas propriedades exibidas na tabela. Ao marcar "Monitoramento parado" a tabela é "congelada" com os dados atuais, permitindo uma análise sem que os dados sejam atualizados conforme alteramos o foco entre campos e janelas.
</div>

=== Spy ===
<div align="justify">
Esta funcionalidade atua como um "identificador de objetos", permitindo capturar informações de qualquer controle da interface gráfica do Windows.

É necessário estar logado com um usuário com permissão de administrador para visualizar esta guia.

[[Image: CGDiagnosticos_15.png|750px|centro]]

* '''Captura via Arraste:''' Clique e segure o retângulo cinza e arraste-o sobre qualquer elemento de qualquer aplicação aberta.
* '''Informações capturadas:''' O sistema preenche automaticamente os campos com o '''Handle''' (em formato decimal e hex), a posição (Rectangle), o '''ClassName''' da classe do objeto e o '''Text''' (conteúdo textual do elemento).
</div>

=== Statistics ===
<div align="justify">
Dedicada ao monitoramento detalhado do consumo de recursos de processos específicos em execução no Windows.

[[Image: CGDiagnosticos_11.png|750px|centro]]

* '''Processo:''' Selecione na lista o processo desejado (ou marque "Somente meu usuário" para filtrar).
* '''Métricas disponíveis:''' É possível monitorar em tempo real:
** Memory Peak e Memory Size64.
** Counters e GUI.
** Processor Timers, CPU Usage, entre outros.
* '''Check Point:''' Permite nomear e sequenciar listas de monitoramento para coletar métricas em momentos distintos.
* '''Log:''' Exibe os dados coletados (DateTime, estado, memória privada, handles, threads, entre outros).

:: Ao finalizar a coleta, utilize o botão '''Salvar''' para exportar os dados do log para análise posterior ou envio à equipe de suporte.
</div>

=== Sobre ===
<div align="justify">
Na guia "Sobre" temos as informações da versão da aplicação e links para documentação e site da CIGAM.

[[Image: CGDiagnosticos_16.png|300px|centro]]

</div>

CGDiagnosticos

2026-07-15T18:24:11Z

Oseias.rodrigues: /* Statistics */

<div align="justify">
O '''CIGAM Diagnósticos''' é uma ferramenta avançada para análise e monitoramento da infraestrutura do seu ambiente. Com ele, é possível validar a comunicação com o banco de dados, aferir a velocidade da rede, coletar informações detalhadas do sistema operacional, listar versões do .NET e testar requisições e integrações Web.

Abaixo, detalhamos cada uma de suas funcionalidades para guiar a utilização correta da aplicação.
</div>
=== Acesso à Ferramenta ===
<div align="justify">
Ao executar o aplicativo, será exibida a tela de login inicial solicitando suas credenciais de acesso.

[[Image: CGDiagnosticos_01.png|300px|centro]]

Informe o '''Usuário''' e a '''Senha''' válidos e clique em '''OK''' para prosseguir.

:: '''Extrema Importância:''' O uso inadequado de algumas funções de diagnóstico (como testes de estresse e sobrecarga de submissões no banco de dados) pode impactar a performance do ambiente do cliente. Utilize a ferramenta com cautela e, preferencialmente, alinhado com a equipe de suporte. 
</div>

=== Tempo de acesso ===
<div align="justify">
A aba principal de tempo de acesso é dividida em dois sub-monitoramentos essenciais: Banco de Dados (DB) e Rede.
</div>
==== DB (Banco de Dados) ====
<div align="justify">
Esta seção é focada em testar a latência, a capacidade de resposta e a saúde geral do banco de dados conectado.

[[Image: CGDiagnosticos_02.png|750px|centro]]

* '''Connection-string:''' A ferramenta permite identificar automaticamente o banco e atualizar o SQL padrão, ou inserir manualmente uma porta/instância diferente após o Data Source. Quando a Connection-string possuir a senha, será aplicada uma criptografia para evitar exposição.
* '''Componentes para conexão:''' Permite escolher o provedor (ex: OleDb Genérica).
* '''SQL:''' Área de script onde a consulta de teste é inserida.
* '''Ações rápidas:''' Estão disponíveis botões auxiliares à direita para '''Carregar Script''', obter a '''Versão do Banco''', o '''Tamanho do Banco''' (necessita de permissão especial no usuário de banco) e listar as '''Consultas mais pesadas'''.

:: Ao clicar em '''Consultas mais pesadas''', o sistema abrirá uma janela com o "Top 50" de instruções, detalhando o Tempo de CPU, Tempo total worker e a quantidade de execuções.

[[Image: CGDiagnosticos_03.png|750px|centro]]

Ainda na guia DB, o envio dos testes pode ser realizado de duas maneiras distintas:

'''1. Submissão Manual'''
Permite configurar o volume de carga, definindo quantas vezes a consulta será submetida e em quantos ciclos.
Ao ativar indicadores de eficiência, o log mostrará na tela se a resposta foi Ruim, Regular, Bom, Ótimo ou Excelente. Ao marcar a opção de "incluir connection-string", a senha será mostrada criptografada caso esteja incluída nela.

[[Image: CGDiagnosticos_05.png|750px|centro]]

'''2. Submissão Automática'''
Ideal para monitoramento contínuo. Define-se um intervalo em milissegundos e aponta-se um arquivo (ex: C:\Temp\Log.txt) para gravar o histórico e rastrear o log da última execução.

[[Image: CGDiagnosticos_04.png|750px|centro]]
</div>

==== Rede ====
<div align="justify">
Responsável por medir a velocidade de transferência e a estabilidade da conexão de rede até o armazenamento ou servidor de destino.

[[Image: CGDiagnosticos_06.png|750px|centro]]

* '''Arquivo:''' Informe o caminho de um arquivo local ou mapeado na rede.
* '''Parâmetros:''' Defina o tamanho máximo da transferência (em MB) e o número de repetições do teste.
* '''Execução:''' Ao clicar no botão '''Transferir''', a área de log inferior começará a exibir a velocidade de leitura (mbits/ps), o tamanho dos bytes trafegados e a latência (ms).

[[Image: CGDiagnosticos_08.png|750px|centro]]

:: Utilize o campo '''Pingar endereço (IP ou nome)''' para validar a conectividade básica com o destino antes de iniciar transferências pesadas.
</div>

=== .NET ===
Página destinada à validação de pré-requisitos lógicos da máquina.

[[Image: CGDiagnosticos_07.png|750px|centro]]

Clicando no botão '''Verificar versões instaladas''', o CIGAM Diagnósticos varre o registro do Windows e lista de forma clara todas as versões do Microsoft .NET Framework presentes, além de detalhar as atualizações de segurança e Hotfixes (KB) aplicados no sistema operacional.

=== Sistema ===
Esta seção extrai um raio-X do servidor ou máquina atual conectando-se diretamente com as APIs WMI (Windows Management Instrumentation).

[[Image: CGDiagnosticos_09.png|750px|centro]]

* Selecione a API correspondente no menu suspenso (por exemplo, <code>Win32_OperatingSystem</code>).
* Clique em '''Buscar informações da API selecionada'''.
* O quadro exibirá propriedades aprofundadas como a versão exata do Windows Server, a quantidade de RAM utilizável e os diretórios de BootDevice.

=== Web ===
Uma área projetada como um cliente HTTP/API integrado, permitindo simular chamadas externas e validar acessos de serviços.

[[Image: CGDiagnosticos_10.png|750px|centro]]

* '''Endpoint:''' Informe a URL completa que será alvo da requisição.
* '''Headers:''' Adicione cabeçalhos necessários para autenticação ou tipo de conteúdo (um por linha).
* '''Parâmetros por POST:''' Envie os parâmetros em formato de lista ou ative a opção para envio direto no Corpo (Body).
* Com a quantidade de requisições definida, clique em '''Invoke Request'''. O retorno do serviço (JSON, XML ou Texto) será apresentado na caixa de Resposta.

=== Timer ===
Esta aba funciona como um cronômetro de precisão, ideal para medir intervalos de execução de tarefas ou tempo de resposta entre ações dentro do sistema.

[[Image: CGDiagnosticos_12.png|750px|centro]]

* '''(Re)Start:''' Inicia ou reinicia a contagem do tempo.
* '''Stop:''' Interrompe a contagem.
* '''Check-point:''' Registra uma marcação de tempo (timestamp) na tela, permitindo comparar lapsos entre diferentes etapas de um processo.

=== Interação ===
<div align="justify">
Utilizada para automatizar ou manipular mensagens do Windows (Win32) enviadas entre janelas.

É necessário estar logado com um usuário com permissão de administrador para visualizar esta guia.

[[Image: CGDiagnosticos_13.png|750px|centro]]

* '''Intervalo:''' Define a frequência (em milissegundos) para os processos de busca.
* '''Handle manual:''' Permite injetar manualmente um identificador de janela (Handle) para interações específicas.
* '''Avisar se receber essa Message:''' Monitora o recebimento de mensagens específicas do sistema.
* '''Configurações de busca:''' Opções como "Buscar paizão" facilitam a localização da hierarquia de formulários (OpenForms) e a extração de metadados como tamanho de borda e informações de ''TopMost''.
* '''user32.SendMessage():''' Ferramenta avançada para forçar o envio de comandos (Handle, Message, WParam, LParam) diretamente a um componente da interface.

:: '''Extrema Importância:''' O uso indevido das funções da aba "Interação" e do "SendMessage" pode causar comportamentos inesperados ou travamentos em formulários ativos. Utilize apenas sob estrita necessidade de diagnóstico.
</div>

=== Inspeção ===
<div align="justify">
Oferece um resumo completo e estruturado das propriedades da janela ou do componente focado no momento.

É necessário estar logado com um usuário com permissão de administrador para visualizar esta guia.

[[Image: CGDiagnosticos_14.png|750px|centro]]

Esta tabela exibe em tempo real o estado de objetos, tais como:
* '''this.Handle:''' Identificador único do componente.
* '''GetActiveWindow / GetForegroundWindow:''' Identificação da janela em foco no sistema operacional.
* '''GetText:''' Texto exibido no componente (ex: título da janela ou rótulo de botão).
* '''Hierarquia:''' Informações sobre a relação pai/filho dos componentes na estrutura da aplicação.

A opção "Sempre Visível" deixará a janela do CGDiagnósticos visível mesmo que estejamos posicionados em outra tela, de modo que possamos visualizar as propriedades do objeto posicionado. Além disto, recomenda-se usar esta opção em conjunto com a opção "Monitoramento parado" desmarcada, assim a janela em foco terá suas propriedades exibidas na tabela. Ao marcar "Monitoramento parado" a tabela é "congelada" com os dados atuais, permitindo uma análise sem que os dados sejam atualizados conforme alteramos o foco entre campos e janelas.
</div>

=== Spy ===
<div align="justify">
Esta funcionalidade atua como um "identificador de objetos", permitindo capturar informações de qualquer controle da interface gráfica do Windows.

É necessário estar logado com um usuário com permissão de administrador para visualizar esta guia.

[[Image: CGDiagnosticos_15.png|750px|centro]]

* '''Captura via Arraste:''' Clique e segure o retângulo cinza e arraste-o sobre qualquer elemento de qualquer aplicação aberta.
* '''Informações capturadas:''' O sistema preenche automaticamente os campos com o '''Handle''' (em formato decimal e hex), a posição (Rectangle), o '''ClassName''' da classe do objeto e o '''Text''' (conteúdo textual do elemento).
</div>

=== Statistics ===
<div align="justify">
Dedicada ao monitoramento detalhado do consumo de recursos de processos específicos em execução no Windows.

[[Image: CGDiagnosticos_11.png|750px|centro]]

* '''Processo:''' Selecione na lista o processo desejado (ou marque "Somente meu usuário" para filtrar).
* '''Métricas disponíveis:''' É possível monitorar em tempo real:
** Memory Peak e Memory Size64.
** Counters e GUI.
** Processor Timers, CPU Usage, entre outros.
* '''Check Point:''' Permite nomear e sequenciar listas de monitoramento para coletar métricas em momentos distintos.
* '''Log:''' Exibe os dados coletados (DateTime, estado, memória privada, handles, threads, entre outros).

:: Ao finalizar a coleta, utilize o botão '''Salvar''' para exportar os dados do log para análise posterior ou envio à equipe de suporte.
</div>

=== Sobre ===
<div align="justify">
</div>

CGDiagnosticos

2026-07-15T18:21:30Z

Oseias.rodrigues: /* Spy */

<div align="justify">
O '''CIGAM Diagnósticos''' é uma ferramenta avançada para análise e monitoramento da infraestrutura do seu ambiente. Com ele, é possível validar a comunicação com o banco de dados, aferir a velocidade da rede, coletar informações detalhadas do sistema operacional, listar versões do .NET e testar requisições e integrações Web.

Abaixo, detalhamos cada uma de suas funcionalidades para guiar a utilização correta da aplicação.
</div>
=== Acesso à Ferramenta ===
<div align="justify">
Ao executar o aplicativo, será exibida a tela de login inicial solicitando suas credenciais de acesso.

[[Image: CGDiagnosticos_01.png|300px|centro]]

Informe o '''Usuário''' e a '''Senha''' válidos e clique em '''OK''' para prosseguir.

:: '''Extrema Importância:''' O uso inadequado de algumas funções de diagnóstico (como testes de estresse e sobrecarga de submissões no banco de dados) pode impactar a performance do ambiente do cliente. Utilize a ferramenta com cautela e, preferencialmente, alinhado com a equipe de suporte. 
</div>

=== Tempo de acesso ===
<div align="justify">
A aba principal de tempo de acesso é dividida em dois sub-monitoramentos essenciais: Banco de Dados (DB) e Rede.
</div>
==== DB (Banco de Dados) ====
<div align="justify">
Esta seção é focada em testar a latência, a capacidade de resposta e a saúde geral do banco de dados conectado.

[[Image: CGDiagnosticos_02.png|750px|centro]]

* '''Connection-string:''' A ferramenta permite identificar automaticamente o banco e atualizar o SQL padrão, ou inserir manualmente uma porta/instância diferente após o Data Source. Quando a Connection-string possuir a senha, será aplicada uma criptografia para evitar exposição.
* '''Componentes para conexão:''' Permite escolher o provedor (ex: OleDb Genérica).
* '''SQL:''' Área de script onde a consulta de teste é inserida.
* '''Ações rápidas:''' Estão disponíveis botões auxiliares à direita para '''Carregar Script''', obter a '''Versão do Banco''', o '''Tamanho do Banco''' (necessita de permissão especial no usuário de banco) e listar as '''Consultas mais pesadas'''.

:: Ao clicar em '''Consultas mais pesadas''', o sistema abrirá uma janela com o "Top 50" de instruções, detalhando o Tempo de CPU, Tempo total worker e a quantidade de execuções.

[[Image: CGDiagnosticos_03.png|750px|centro]]

Ainda na guia DB, o envio dos testes pode ser realizado de duas maneiras distintas:

'''1. Submissão Manual'''
Permite configurar o volume de carga, definindo quantas vezes a consulta será submetida e em quantos ciclos.
Ao ativar indicadores de eficiência, o log mostrará na tela se a resposta foi Ruim, Regular, Bom, Ótimo ou Excelente. Ao marcar a opção de "incluir connection-string", a senha será mostrada criptografada caso esteja incluída nela.

[[Image: CGDiagnosticos_05.png|750px|centro]]

'''2. Submissão Automática'''
Ideal para monitoramento contínuo. Define-se um intervalo em milissegundos e aponta-se um arquivo (ex: C:\Temp\Log.txt) para gravar o histórico e rastrear o log da última execução.

[[Image: CGDiagnosticos_04.png|750px|centro]]
</div>

==== Rede ====
<div align="justify">
Responsável por medir a velocidade de transferência e a estabilidade da conexão de rede até o armazenamento ou servidor de destino.

[[Image: CGDiagnosticos_06.png|750px|centro]]

* '''Arquivo:''' Informe o caminho de um arquivo local ou mapeado na rede.
* '''Parâmetros:''' Defina o tamanho máximo da transferência (em MB) e o número de repetições do teste.
* '''Execução:''' Ao clicar no botão '''Transferir''', a área de log inferior começará a exibir a velocidade de leitura (mbits/ps), o tamanho dos bytes trafegados e a latência (ms).

[[Image: CGDiagnosticos_08.png|750px|centro]]

:: Utilize o campo '''Pingar endereço (IP ou nome)''' para validar a conectividade básica com o destino antes de iniciar transferências pesadas.
</div>

=== .NET ===
Página destinada à validação de pré-requisitos lógicos da máquina.

[[Image: CGDiagnosticos_07.png|750px|centro]]

Clicando no botão '''Verificar versões instaladas''', o CIGAM Diagnósticos varre o registro do Windows e lista de forma clara todas as versões do Microsoft .NET Framework presentes, além de detalhar as atualizações de segurança e Hotfixes (KB) aplicados no sistema operacional.

=== Sistema ===
Esta seção extrai um raio-X do servidor ou máquina atual conectando-se diretamente com as APIs WMI (Windows Management Instrumentation).

[[Image: CGDiagnosticos_09.png|750px|centro]]

* Selecione a API correspondente no menu suspenso (por exemplo, <code>Win32_OperatingSystem</code>).
* Clique em '''Buscar informações da API selecionada'''.
* O quadro exibirá propriedades aprofundadas como a versão exata do Windows Server, a quantidade de RAM utilizável e os diretórios de BootDevice.

=== Web ===
Uma área projetada como um cliente HTTP/API integrado, permitindo simular chamadas externas e validar acessos de serviços.

[[Image: CGDiagnosticos_10.png|750px|centro]]

* '''Endpoint:''' Informe a URL completa que será alvo da requisição.
* '''Headers:''' Adicione cabeçalhos necessários para autenticação ou tipo de conteúdo (um por linha).
* '''Parâmetros por POST:''' Envie os parâmetros em formato de lista ou ative a opção para envio direto no Corpo (Body).
* Com a quantidade de requisições definida, clique em '''Invoke Request'''. O retorno do serviço (JSON, XML ou Texto) será apresentado na caixa de Resposta.

=== Timer ===
Esta aba funciona como um cronômetro de precisão, ideal para medir intervalos de execução de tarefas ou tempo de resposta entre ações dentro do sistema.

[[Image: CGDiagnosticos_12.png|750px|centro]]

* '''(Re)Start:''' Inicia ou reinicia a contagem do tempo.
* '''Stop:''' Interrompe a contagem.
* '''Check-point:''' Registra uma marcação de tempo (timestamp) na tela, permitindo comparar lapsos entre diferentes etapas de um processo.

=== Interação ===
<div align="justify">
Utilizada para automatizar ou manipular mensagens do Windows (Win32) enviadas entre janelas.

É necessário estar logado com um usuário com permissão de administrador para visualizar esta guia.

[[Image: CGDiagnosticos_13.png|750px|centro]]

* '''Intervalo:''' Define a frequência (em milissegundos) para os processos de busca.
* '''Handle manual:''' Permite injetar manualmente um identificador de janela (Handle) para interações específicas.
* '''Avisar se receber essa Message:''' Monitora o recebimento de mensagens específicas do sistema.
* '''Configurações de busca:''' Opções como "Buscar paizão" facilitam a localização da hierarquia de formulários (OpenForms) e a extração de metadados como tamanho de borda e informações de ''TopMost''.
* '''user32.SendMessage():''' Ferramenta avançada para forçar o envio de comandos (Handle, Message, WParam, LParam) diretamente a um componente da interface.

:: '''Extrema Importância:''' O uso indevido das funções da aba "Interação" e do "SendMessage" pode causar comportamentos inesperados ou travamentos em formulários ativos. Utilize apenas sob estrita necessidade de diagnóstico.
</div>

=== Inspeção ===
<div align="justify">
Oferece um resumo completo e estruturado das propriedades da janela ou do componente focado no momento.

É necessário estar logado com um usuário com permissão de administrador para visualizar esta guia.

[[Image: CGDiagnosticos_14.png|750px|centro]]

Esta tabela exibe em tempo real o estado de objetos, tais como:
* '''this.Handle:''' Identificador único do componente.
* '''GetActiveWindow / GetForegroundWindow:''' Identificação da janela em foco no sistema operacional.
* '''GetText:''' Texto exibido no componente (ex: título da janela ou rótulo de botão).
* '''Hierarquia:''' Informações sobre a relação pai/filho dos componentes na estrutura da aplicação.

A opção "Sempre Visível" deixará a janela do CGDiagnósticos visível mesmo que estejamos posicionados em outra tela, de modo que possamos visualizar as propriedades do objeto posicionado. Além disto, recomenda-se usar esta opção em conjunto com a opção "Monitoramento parado" desmarcada, assim a janela em foco terá suas propriedades exibidas na tabela. Ao marcar "Monitoramento parado" a tabela é "congelada" com os dados atuais, permitindo uma análise sem que os dados sejam atualizados conforme alteramos o foco entre campos e janelas.
</div>

=== Spy ===
<div align="justify">
Esta funcionalidade atua como um "identificador de objetos", permitindo capturar informações de qualquer controle da interface gráfica do Windows.

É necessário estar logado com um usuário com permissão de administrador para visualizar esta guia.

[[Image: CGDiagnosticos_15.png|750px|centro]]

* '''Captura via Arraste:''' Clique e segure o retângulo cinza e arraste-o sobre qualquer elemento de qualquer aplicação aberta.
* '''Informações capturadas:''' O sistema preenche automaticamente os campos com o '''Handle''' (em formato decimal e hex), a posição (Rectangle), o '''ClassName''' da classe do objeto e o '''Text''' (conteúdo textual do elemento).
</div>

=== Statistics ===
<div align="justify">
Dedicada ao monitoramento detalhado do consumo de recursos de processos específicos em execução no Windows.

[[Image: CGDiagnosticos_11.png|750px|centro]]

* '''Processo:''' Selecione na lista o processo desejado (ou marque "Somente meu usuário" para filtrar).
* '''Métricas disponíveis:''' É possível monitorar em tempo real:
** Memory Peak e Memory Size64.
** Counters e GUI.
** Processor Timers, CPU Usage, entre outros.
* '''Check Point:''' Permite nomear e sequenciar listas de monitoramento para coletar métricas em momentos distintos.
* '''Log:''' Exibe os dados coletados (DateTime, estado, memória privada, handles, threads, entre outros).

:: Ao finalizar a coleta, utilize o botão '''Salvar''' para exportar os dados do log para análise posterior ou envio à equipe de suporte.
</div>

CGDiagnosticos

2026-07-15T18:21:21Z

Oseias.rodrigues: /* Inspeção */

<div align="justify">
O '''CIGAM Diagnósticos''' é uma ferramenta avançada para análise e monitoramento da infraestrutura do seu ambiente. Com ele, é possível validar a comunicação com o banco de dados, aferir a velocidade da rede, coletar informações detalhadas do sistema operacional, listar versões do .NET e testar requisições e integrações Web.

Abaixo, detalhamos cada uma de suas funcionalidades para guiar a utilização correta da aplicação.
</div>
=== Acesso à Ferramenta ===
<div align="justify">
Ao executar o aplicativo, será exibida a tela de login inicial solicitando suas credenciais de acesso.

[[Image: CGDiagnosticos_01.png|300px|centro]]

Informe o '''Usuário''' e a '''Senha''' válidos e clique em '''OK''' para prosseguir.

:: '''Extrema Importância:''' O uso inadequado de algumas funções de diagnóstico (como testes de estresse e sobrecarga de submissões no banco de dados) pode impactar a performance do ambiente do cliente. Utilize a ferramenta com cautela e, preferencialmente, alinhado com a equipe de suporte. 
</div>

=== Tempo de acesso ===
<div align="justify">
A aba principal de tempo de acesso é dividida em dois sub-monitoramentos essenciais: Banco de Dados (DB) e Rede.
</div>
==== DB (Banco de Dados) ====
<div align="justify">
Esta seção é focada em testar a latência, a capacidade de resposta e a saúde geral do banco de dados conectado.

[[Image: CGDiagnosticos_02.png|750px|centro]]

* '''Connection-string:''' A ferramenta permite identificar automaticamente o banco e atualizar o SQL padrão, ou inserir manualmente uma porta/instância diferente após o Data Source. Quando a Connection-string possuir a senha, será aplicada uma criptografia para evitar exposição.
* '''Componentes para conexão:''' Permite escolher o provedor (ex: OleDb Genérica).
* '''SQL:''' Área de script onde a consulta de teste é inserida.
* '''Ações rápidas:''' Estão disponíveis botões auxiliares à direita para '''Carregar Script''', obter a '''Versão do Banco''', o '''Tamanho do Banco''' (necessita de permissão especial no usuário de banco) e listar as '''Consultas mais pesadas'''.

:: Ao clicar em '''Consultas mais pesadas''', o sistema abrirá uma janela com o "Top 50" de instruções, detalhando o Tempo de CPU, Tempo total worker e a quantidade de execuções.

[[Image: CGDiagnosticos_03.png|750px|centro]]

Ainda na guia DB, o envio dos testes pode ser realizado de duas maneiras distintas:

'''1. Submissão Manual'''
Permite configurar o volume de carga, definindo quantas vezes a consulta será submetida e em quantos ciclos.
Ao ativar indicadores de eficiência, o log mostrará na tela se a resposta foi Ruim, Regular, Bom, Ótimo ou Excelente. Ao marcar a opção de "incluir connection-string", a senha será mostrada criptografada caso esteja incluída nela.

[[Image: CGDiagnosticos_05.png|750px|centro]]

'''2. Submissão Automática'''
Ideal para monitoramento contínuo. Define-se um intervalo em milissegundos e aponta-se um arquivo (ex: C:\Temp\Log.txt) para gravar o histórico e rastrear o log da última execução.

[[Image: CGDiagnosticos_04.png|750px|centro]]
</div>

==== Rede ====
<div align="justify">
Responsável por medir a velocidade de transferência e a estabilidade da conexão de rede até o armazenamento ou servidor de destino.

[[Image: CGDiagnosticos_06.png|750px|centro]]

* '''Arquivo:''' Informe o caminho de um arquivo local ou mapeado na rede.
* '''Parâmetros:''' Defina o tamanho máximo da transferência (em MB) e o número de repetições do teste.
* '''Execução:''' Ao clicar no botão '''Transferir''', a área de log inferior começará a exibir a velocidade de leitura (mbits/ps), o tamanho dos bytes trafegados e a latência (ms).

[[Image: CGDiagnosticos_08.png|750px|centro]]

:: Utilize o campo '''Pingar endereço (IP ou nome)''' para validar a conectividade básica com o destino antes de iniciar transferências pesadas.
</div>

=== .NET ===
Página destinada à validação de pré-requisitos lógicos da máquina.

[[Image: CGDiagnosticos_07.png|750px|centro]]

Clicando no botão '''Verificar versões instaladas''', o CIGAM Diagnósticos varre o registro do Windows e lista de forma clara todas as versões do Microsoft .NET Framework presentes, além de detalhar as atualizações de segurança e Hotfixes (KB) aplicados no sistema operacional.

=== Sistema ===
Esta seção extrai um raio-X do servidor ou máquina atual conectando-se diretamente com as APIs WMI (Windows Management Instrumentation).

[[Image: CGDiagnosticos_09.png|750px|centro]]

* Selecione a API correspondente no menu suspenso (por exemplo, <code>Win32_OperatingSystem</code>).
* Clique em '''Buscar informações da API selecionada'''.
* O quadro exibirá propriedades aprofundadas como a versão exata do Windows Server, a quantidade de RAM utilizável e os diretórios de BootDevice.

=== Web ===
Uma área projetada como um cliente HTTP/API integrado, permitindo simular chamadas externas e validar acessos de serviços.

[[Image: CGDiagnosticos_10.png|750px|centro]]

* '''Endpoint:''' Informe a URL completa que será alvo da requisição.
* '''Headers:''' Adicione cabeçalhos necessários para autenticação ou tipo de conteúdo (um por linha).
* '''Parâmetros por POST:''' Envie os parâmetros em formato de lista ou ative a opção para envio direto no Corpo (Body).
* Com a quantidade de requisições definida, clique em '''Invoke Request'''. O retorno do serviço (JSON, XML ou Texto) será apresentado na caixa de Resposta.

=== Timer ===
Esta aba funciona como um cronômetro de precisão, ideal para medir intervalos de execução de tarefas ou tempo de resposta entre ações dentro do sistema.

[[Image: CGDiagnosticos_12.png|750px|centro]]

* '''(Re)Start:''' Inicia ou reinicia a contagem do tempo.
* '''Stop:''' Interrompe a contagem.
* '''Check-point:''' Registra uma marcação de tempo (timestamp) na tela, permitindo comparar lapsos entre diferentes etapas de um processo.

=== Interação ===
<div align="justify">
Utilizada para automatizar ou manipular mensagens do Windows (Win32) enviadas entre janelas.

É necessário estar logado com um usuário com permissão de administrador para visualizar esta guia.

[[Image: CGDiagnosticos_13.png|750px|centro]]

* '''Intervalo:''' Define a frequência (em milissegundos) para os processos de busca.
* '''Handle manual:''' Permite injetar manualmente um identificador de janela (Handle) para interações específicas.
* '''Avisar se receber essa Message:''' Monitora o recebimento de mensagens específicas do sistema.
* '''Configurações de busca:''' Opções como "Buscar paizão" facilitam a localização da hierarquia de formulários (OpenForms) e a extração de metadados como tamanho de borda e informações de ''TopMost''.
* '''user32.SendMessage():''' Ferramenta avançada para forçar o envio de comandos (Handle, Message, WParam, LParam) diretamente a um componente da interface.

:: '''Extrema Importância:''' O uso indevido das funções da aba "Interação" e do "SendMessage" pode causar comportamentos inesperados ou travamentos em formulários ativos. Utilize apenas sob estrita necessidade de diagnóstico.
</div>

=== Inspeção ===
<div align="justify">
Oferece um resumo completo e estruturado das propriedades da janela ou do componente focado no momento.

É necessário estar logado com um usuário com permissão de administrador para visualizar esta guia.

[[Image: CGDiagnosticos_14.png|750px|centro]]

Esta tabela exibe em tempo real o estado de objetos, tais como:
* '''this.Handle:''' Identificador único do componente.
* '''GetActiveWindow / GetForegroundWindow:''' Identificação da janela em foco no sistema operacional.
* '''GetText:''' Texto exibido no componente (ex: título da janela ou rótulo de botão).
* '''Hierarquia:''' Informações sobre a relação pai/filho dos componentes na estrutura da aplicação.

A opção "Sempre Visível" deixará a janela do CGDiagnósticos visível mesmo que estejamos posicionados em outra tela, de modo que possamos visualizar as propriedades do objeto posicionado. Além disto, recomenda-se usar esta opção em conjunto com a opção "Monitoramento parado" desmarcada, assim a janela em foco terá suas propriedades exibidas na tabela. Ao marcar "Monitoramento parado" a tabela é "congelada" com os dados atuais, permitindo uma análise sem que os dados sejam atualizados conforme alteramos o foco entre campos e janelas.
</div>

=== Spy ===
<div align="justify">
Esta funcionalidade atua como um "identificador de objetos", permitindo capturar informações de qualquer controle da interface gráfica do Windows.

[[Image: CGDiagnosticos_15.png|750px|centro]]

* '''Captura via Arraste:''' Clique e segure o retângulo cinza e arraste-o sobre qualquer elemento de qualquer aplicação aberta.
* '''Informações capturadas:''' O sistema preenche automaticamente os campos com o '''Handle''' (em formato decimal e hex), a posição (Rectangle), o '''ClassName''' da classe do objeto e o '''Text''' (conteúdo textual do elemento).
</div>

=== Statistics ===
<div align="justify">
Dedicada ao monitoramento detalhado do consumo de recursos de processos específicos em execução no Windows.

[[Image: CGDiagnosticos_11.png|750px|centro]]

* '''Processo:''' Selecione na lista o processo desejado (ou marque "Somente meu usuário" para filtrar).
* '''Métricas disponíveis:''' É possível monitorar em tempo real:
** Memory Peak e Memory Size64.
** Counters e GUI.
** Processor Timers, CPU Usage, entre outros.
* '''Check Point:''' Permite nomear e sequenciar listas de monitoramento para coletar métricas em momentos distintos.
* '''Log:''' Exibe os dados coletados (DateTime, estado, memória privada, handles, threads, entre outros).

:: Ao finalizar a coleta, utilize o botão '''Salvar''' para exportar os dados do log para análise posterior ou envio à equipe de suporte.
</div>