# IA Gemini (Google) *(Novo)* Liga as **respostas por IA** da [[06.1 - Base de Conhecimento|06_1 - Base de Conhecimento]]: no quadro **Pergunte à IA**, a dúvida da equipe é respondida com um resumo dos artigos cadastrados, citando as fontes. A IA usada é o **Gemini**, do Google. A integração está em **Configurações › Integrações › IA Gemini** e **faz parte do plano** — não há custo adicional na assinatura do EOS. Ela só precisa ser **ativada** por você. > Requer a permissão **"Empresa e parâmetros"**: com *visualizar*, a página abre só para consulta; com *editar*, é possível ligar, cadastrar a chave e testar. --- ## O que você precisa Uma **chave de API do Gemini**, gerada no **Google AI Studio** com a conta Google da sua empresa. A chave é **da sua conta**: o uso da API segue as condições (cota gratuita ou cobrança) que o Google aplica a essa conta. Para gerar a chave: 1. Acesse **aistudio.google.com/apikey** com a conta Google da empresa. 2. Clique em **Criar chave de API** (*Create API key*). 3. Copie a chave gerada. > Use uma conta Google da **empresa**, e não a pessoal de um funcionário: se a pessoa sair, a chave continua com vocês. --- ## Ligando a IA 1. Abra **Configurações › Integrações** e clique no cartão **IA Gemini (Google)**. 2. Ligue a chave **Recurso ativo**. 3. Cole a chave no campo **Chave da API**. 4. Clique em **Salvar**. 5. Clique em **Testar chave** — a resposta *"Chave válida. Modelo em uso: ..."* confirma que está tudo certo. Pronto: o quadro **Pergunte à IA** passa a responder na Base de Conhecimento para todos os usuários do estabelecimento. ### Sobre a chave | Situação | Como funciona | |---|---| | **Guardada cifrada** | A chave é gravada de forma cifrada e **nunca é exibida de volta** — o campo mostra *"(já cadastrada)"* | | **Trocar a chave** | Cole a nova chave e salve. Ela substitui a anterior e fica aguardando um novo teste | | **Manter a chave** | Deixe o campo em branco ao salvar | | **Remover chave** | Apaga a chave gravada. A IA para de responder até uma nova chave ser cadastrada | --- ## Conexão Com a chave cadastrada, o bloco **Conexão** mostra a situação: | Situação | O que significa | |---|---| | **Chave cadastrada, ainda não testada** | Salva, mas ainda sem teste ou uso | | **Chave conferida** | O teste ou a última pergunta funcionou | | **A última chamada falhou** | O motivo aparece em **Última falha** — veja a tabela abaixo | Na vitrine de **Integrações**, o cartão aparece como *Desligada*, *Falta conectar* (ligada, sem chave), *Conectada* ou *Com erro*. ### Mensagens de falha | Mensagem | O que fazer | |---|---| | *Chave da API do Gemini inválida* | Confira se a chave foi copiada inteira; se preciso, gere outra no Google AI Studio | | *A chave da API não tem acesso ao Gemini* | A chave existe, mas a conta não tem a API liberada. Confira no Google AI Studio | | *Limite de uso da sua conta Gemini atingido* | A cota da conta Google acabou por agora. Aguarde ou revise o plano da conta no Google | | *O Gemini está indisponível no momento* / *demorou demais para responder* | Instabilidade do serviço do Google. Tente de novo em instantes | --- ## Desligando Desligue a chave **Recurso ativo** e salve. O quadro **Pergunte à IA** deixa de responder; a busca e os artigos continuam funcionando normalmente, e o aviso de material de apoio no chamado e na OS também. Desligar **não apaga** a chave: religar volta a funcionar sem cadastrar de novo. --- ## Privacidade - Para responder, o EOS envia ao Gemini **a pergunta** e o **texto dos artigos encontrados** na sua base (até 5 por pergunta). Nenhum dado de cliente, OS ou chamado é enviado. - Evite colocar nos artigos informações que não deveriam sair da empresa, como senhas de equipamentos de clientes. - Cada pergunta fica registrada no sistema, com a quantidade de texto processado, para acompanhamento do uso. --- ## Conceitos relacionados - [[06.1 - Base de Conhecimento|06_1 - Base de Conhecimento]] — onde a IA responde. - [[12.4.1 - Integrações|12_4_1 - Integrações]] — a vitrine das integrações. - [[12.2 - Assinatura (Meu Plano)|12_2 - Assinatura (Meu Plano)]] — a Base de Conhecimento aparece em *Incluído no plano*.