Ativar o Captain em hospedagem própria

Descubra

Você pode executar o Captain na sua própria instalação do Chatwoot com sua própria chave da OpenAI.

Plano e acesso: incluído nos planos Premium e Enterprise auto-hospedados. Veja Enterprise Edition. Você precisa ter acesso ao console de Super Admin. A Community Edition não inclui o Captain.

Premium e Enterprise têm os mesmos recursos e configurações do Captain.

Configurar e testar

Antes de começar

• Uma chave de API da OpenAI.

• Opcional: um endpoint compatível com OpenAI se você hospedar seu próprio modelo.

• Opcional: uma chave de API do Firecrawl para uma melhor varredura de sites. Sem ela, o Chatwoot utiliza um crawler interno mais simples.

1. Configure o Captain para a instalação

1. Abra o console de Super Admin e vá em Configurações.

2. No cartão do Captain, clique no ícone de configurações (engrenagem).

   

3. Preencha:

   • Chave de API da OpenAI.

   • Modelo OpenAI define o modelo para o Copilot e recursos do editor. Deixe em branco para usar gpt-4.1-mini. O assistente utiliza gpt-5.2 por padrão. Para alterá-lo, vá em Super Admin › Contas, edite a conta e abra a guia Modelos do Captain. Se você usar um endpoint personalizado, certifique-se de que ele oferece os modelos escolhidos aqui.

     

   • Endpoint da API OpenAI (opcional), para um modelo auto-hospedado compatível.

   • Modelo de Embedding (opcional).

   • Chave de API FireCrawl (opcional).

     

4. Clique em Enviar.

2. Ativar o Captain para uma conta

Contas criadas enquanto sua instalação está nos planos Premium ou Enterprise já têm o Captain ativado. Para contas criadas antes disso:

1. No console de Super Admin, vá em Contas.

2. Abra a conta e clique em Editar.

3. Nos recursos premium, ative o Captain. Guardrails, diretrizes de resposta e cenários vêm junto. Para ferramentas personalizadas, ative também Ferramentas Personalizadas (Configurar ferramentas personalizadas para o Captain).

   

4. Salve.

Teste

Acesse essa conta. Captain aparece na barra lateral. Crie um assistente e envie uma mensagem no Playground. Veja Configure um assistente do Captain e conecte suas caixas de entrada.

Aproveite

• A OpenAI cobra pelo uso com a sua própria chave. O Chatwoot não contabiliza créditos do Captain em instalações auto-hospedadas.

• Atualizando de uma versão antiga onde assistentes usavam o campo Instruções? Ele não é mais utilizado. Transfira as instruções para guardrails e diretrizes de resposta antes de atualizar (Defina guardrails, diretrizes e cenários do Captain).

• Todo o resto funciona como na nuvem. Continue com Adicione documentos ao conhecimento do Captain.

Solução de problemas