Inteligência artificial
Configurar provedores de inteligência artificial
Defina chaves, modelos, prioridade e tempo limite para as APIs de IA autorizadas.
Onde encontrarConfigurações → Integrações → Inteligência artificial
Acessos externos
Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.
- Criar chave OpenAIAbra as chaves da API e selecione a organização e o projeto da empresa.platform.openai.com (abre em nova aba)
- Criar chave GeminiAbra o Google AI Studio e escolha o projeto que será usado pelo Omnichannel.aistudio.google.com (abre em nova aba)
- Criar chave ClaudeAbra o console e crie a chave da organização ou workspace correto.platform.claude.com (abre em nova aba)
Antes de começar
- Entre com uma conta autorizada para esta tela.
- Confira se o módulo está disponível na sua instalação.
Campos e opções
| Campo | Como preencher |
|---|---|
| Chave da API | Credencial do fornecedor. Em branco mantém a chave já cadastrada; não é a senha de acesso ao site. |
| Identificador do modelo | Nome técnico aceito pela API. Não é o nome dado à chave. |
| Ativo e Prioridade | Incluem o provedor na sequência de texto e definem Principal/Backups. |
| Habilitar sequência de IA | Controle geral da sequência de respostas de texto. |
| Tempo máximo / Limite total | Prazo por provedor e prazo total das tentativas, conforme limites do formulário. |
| Remover chave ao salvar | Remove a credencial do cartão quando permitido. Não use esse comando para apenas trocar a prioridade. |
Passo a passo
- Confira quais provedores aparecem na instalação. A lista depende dos recursos liberados pela licença.
- Use os guias relacionados e a seção Acessos externos para obter a chave da empresa. No cartão do provedor, preencha Chave da API e Identificador do modelo. FSNET IA tem modelo definido no servidor; FSNET IA e Hermes também oferecem configuração de URL.
- Use Salvar configuração antes de executar Testar conexão no cartão. Se a chave já estiver cadastrada, deixar seu campo em branco mantém a credencial atual.
- Marque Ativo nos provedores de texto que deseja usar e organize a prioridade como Principal, Backup 1 e seguintes.
- Confira Habilitar sequência de IA, o tempo máximo de cada API e o Limite total de espera. O limite total inclui as tentativas da sequência.
- Salve novamente e use Testar sequência. Confira o provedor que concluiu o teste e os resultados das tentativas anteriores.
- Revise separadamente Transcrição de áudio e Interpretação de imagens. Depois, homologue o agente e o fluxo com dados fictícios antes de depender da configuração no atendimento.
Resultado esperado
A IA usa os provedores habilitados conforme prioridade, disponibilidade e configuração.
Observações importantes
- A lista pode incluir FSNET IA, OpenAI, Gemini, Grok, Claude, DeepSeek, Groq, Mistral, OpenRouter e Hermes; a disponibilidade depende da licença.
- Testes podem gerar consumo no fornecedor.
- Uma credencial de Manus é para integração de tarefas assíncronas; ela não integra automaticamente a sequência de respostas ao cliente.
- Valores de franquia e modelo dependem do contrato e da instalação.
- A prioridade dos provedores de texto não controla automaticamente a transcrição de áudio. Confira a configuração separada de áudio e imagens.
- OpenAI, Gemini e Claude têm guias próprios nesta Wiki com atalhos para chaves e consumo. O fornecedor pode solicitar login, seleção da organização ou do projeto.
- Uma chave cadastrada não significa que o provedor esteja ativo ou definido como principal. Confira os controles e a confirmação do salvamento.
Se precisar de ajuda
- Chave inválida: confira conta, serviço e permissões da credencial.
- Modelo inexistente: use um identificador aceito pelo seu provedor.
- Teste desabilitado: salve as alterações pendentes e confira os campos obrigatórios.