O Capitão é um assistente de IA que ajuda você a responder com mais rapidez e precisão. Com o Bring Your Own Key (BYOK) , você pode usar sua própria chave de API da OpenAI ou de qualquer serviço de IA compatível. Você controla os dados, os custos e o modelo usado. Em uma configuração auto-hospedada, o Captain envia dados apenas para o modelo de IA que você escolher.
Este guia mostrará como habilitar o Captain na sua Enterprise Edition auto-hospedada , adicionar sua chave de API e configurar um modelo personalizado, se desejar.
Pré-requisitos
Antes de começar, certifique-se de ter:
-
Chatwoot Enterprise Edition com um plano pago.
-
Acesso de administrador ao Super Admin Console .
-
Uma chave de API OpenAI válida .
-
(Opcional) Um ponto de extremidade de API compatível com OpenAI auto-hospedado .
-
(Opcional) Uma chave de API do Firecrawl para um melhor rastreamento da documentação.
Habilitando o Capitão no Super Admin Console
Para habilitar o Captain no nível de instalação:
Efetue login no Super Admin Console . Navegue até Configurações → Capitão .
Preencha os campos de configuração:
-
Chave de API OpenAI (obrigatória) – A chave para autenticação de solicitações ao OpenAI ou a um serviço compatível.
-
Modelo OpenAI (obrigatório) – O padrão é
gpt-4o-mini. Você pode escolher outro modelo compatível, comogpt-5. -
Ponto de extremidade da API OpenAI (opcional) – insira seu ponto de extremidade de API personalizado se estiver usando um modelo auto-hospedado.
-
Chave de API do Firecrawl (opcional) – recomendada para melhor rastreamento de sites e documentação.
Clique em Enviar para salvar sua configuração.
Habilitando o Capitão para uma Conta
Depois de habilitar o Captain globalmente, ative-o para contas individuais:
-
No Super Admin Console , acesse Contas .
-
Selecione a conta para a qual deseja habilitar o Captain e clique em Editar .
-
Na seção Recursos Premium , ative a opção Capitão .
-
Salve as alterações.
Solução de problemas
Se o Capitão não estiver respondendo conforme o esperado:
-
Verifique se a chave da API OpenAI está correta e ativa.
-
Verifique se o nome do modelo corresponde a um modelo suportado.
-
Certifique-se de que sua chave de API do Firecrawl seja válida se estiver usando rastreamento.
-
Confirme se o Captain está habilitado nos níveis de instalação e de conta.
Se o Capitão ainda não estiver respondendo, revise os logs do servidor Chatwoot para os processos da web e do trabalhador para identificar quaisquer erros e compartilhe os detalhes desses erros com a equipe de suporte para obter mais assistência.