Ativar o Captain em ambiente self-hosted

Descubra

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

Plano & acesso: incluído nos planos Premium e Enterprise auto-hospedados. Veja [Link: Editions & licensing]. É necessário ter acesso ao console Super Admin. A Community Edition não inclui o Captain.

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

Configure & teste

Antes de começar

• Uma chave de API da OpenAI.

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

• Opcional: uma chave de API Firecrawl para uma melhor indexação de sites. Sem ela, o Chatwoot usa um indexador interno mais simples.

1. Configure o Captain para a instalação

1. Abra o console 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 OpenAI.

   • Modelo OpenAI define o modelo para os recursos de Copilot e do editor. Deixe em branco para usar gpt-4.1-mini. O assistente usa gpt-5.2 por padrão. Para mudar, vá até Super Admin › Contas, edite a conta e abra a aba Modelos do Captain. Se você usar um endpoint personalizado, confirme se ele disponibiliza os modelos escolhidos aqui.

     [Screenshot: captain-11-c3-captain-models.png]

   • 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. Ative o Captain para uma conta

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

1. No console 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 também são ativados. Para ferramentas personalizadas, ative também Ferramentas Personalizadas (Ferramentas personalizadas).

   

4. Salve.

Teste

Faça login nessa conta. Captain aparece na barra lateral. Crie um assistente e envie uma mensagem no Playground. Veja Criar e conectar um assistente.

Obtenha valor

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

• Fazendo upgrade de uma versão antiga onde assistentes usavam o campo Instruções? Instruções não são mais utilizadas. Mova-as para guardrails e diretrizes de resposta antes de atualizar (Guardrails, guidelines and scenarios).

• Todo o resto funciona como na nuvem. Continue em Adicionar conhecimento: documentos.

Solução de problemas