Ativar o Captain em hospedagem própria

Descobrir

Você pode rodar 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 de acesso ao console de Super Admin. A edição Community 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, caso você hospede seu próprio modelo.

• Opcional: uma chave de API da Firecrawl para uma melhor varredura de sites. Sem ela, o Chatwoot usa um rastreador incorporado mais simples.

1. Configure o Captain para a instalação

1. Abra o console de Super Admin e vá para 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 Copilot e recursos do editor. Deixe em branco para usar gpt-4.1-mini. O assistente usa gpt-5.2 por padrão. Para alterar, 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 sirva 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. Ative o Captain em uma conta

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

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

2. Abra a conta e clique em Editar.

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

   

4. Salve.

Teste

Faça login nessa conta. O Captain aparecerá na barra lateral. Crie um assistente e envie uma mensagem no Playground. Veja Configure um assistente Captain e conecte suas caixas de entrada.

Obtenha valor

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

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

• Todo o resto funciona igual ao Cloud. Continue em Adicionar documentos ao conhecimento do Captain.

Solução de problemas