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

---

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.

---

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.

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

---

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

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

---

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.

---

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

---

- [[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*.