OmnichannelCentral de conhecimento
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.

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

CampoComo preencher
Chave da APICredencial do fornecedor. Em branco mantém a chave já cadastrada; não é a senha de acesso ao site.
Identificador do modeloNome técnico aceito pela API. Não é o nome dado à chave.
Ativo e PrioridadeIncluem o provedor na sequência de texto e definem Principal/Backups.
Habilitar sequência de IAControle geral da sequência de respostas de texto.
Tempo máximo / Limite totalPrazo por provedor e prazo total das tentativas, conforme limites do formulário.
Remover chave ao salvarRemove a credencial do cartão quando permitido. Não use esse comando para apenas trocar a prioridade.

Passo a passo

  1. Confira quais provedores aparecem na instalação. A lista depende dos recursos liberados pela licença.
  2. 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.
  3. 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.
  4. Marque Ativo nos provedores de texto que deseja usar e organize a prioridade como Principal, Backup 1 e seguintes.
  5. 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.
  6. Salve novamente e use Testar sequência. Confira o provedor que concluiu o teste e os resultados das tentativas anteriores.
  7. 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.