Commit b34b0b
2026-11-05 19:34:16 Felipe Madril: -/-| /dev/null .. 12_4_2 - ia gemini (google).md | |
| @@ 0,0 1,89 @@ | |
| + | # 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*. |