O Captain é um assistente de IA que ajuda você a responder mais rápido e com maior 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 qual modelo é utilizado. Em uma instalação auto-hospedada, o Captain só envia dados para o modelo de IA que você escolher.

Este guia vai 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 que você possui:

* **RockZap® Enterprise Edition** com um plano pago.

* Acesso de administrador ao **Super Admin Console**.

* Uma **chave de API OpenAI** válida.

* (Opcional) Um **endpoint de API compatível com OpenAI auto-hospedado**.

* (Opcional) Uma [**chave de API Firecrawl**](https://www.firecrawl.dev/) para uma melhor varredura de documentação.

## **Habilitando o Captain no Super Admin Console**

Para habilitar o Captain no nível da instalação:

Faça login no **Super Admin Console**. Navegue até **Configurações → Captain**.

![](https://app.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBMGFtRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--bfc0ac40a211844069bce371a4a19f5ff42a3bf8/Screenshot-202025-08-15-20at-2011.51.50-E2-80-AFAM.png)

![](https://app.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBMGVtRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--59c162c239e7b512785ddcc7e5bb772e85da4d6a/Screenshot-202025-08-15-20at-2011.50.26-E2-80-AFAM.png)

Preencha os campos de configuração:

1. **Chave de API OpenAI** *(Obrigatório)* – A chave para autenticar solicitações para a OpenAI ou serviço compatível.

2. **Modelo OpenAI** *(Obrigatório)* – O padrão é **`gpt-4o-mini`**. Você pode escolher outro modelo suportado como **`gpt-5`**.

3. **Endpoint de API OpenAI** *(Opcional)* – Insira seu endpoint de API personalizado caso esteja usando um modelo auto-hospedado.

4. **Chave de API Firecrawl** *(Opcional)* – Recomendado para melhor varredura de sites e documentação.

   Clique em **Enviar** para salvar sua configuração.

## **Habilitando o Captain para uma Conta**

Depois de habilitar o Captain globalmente, ative-o para contas individuais:

1. No **Super Admin Console**, acesse **Contas**.

2. Selecione a conta para a qual deseja habilitar o Captain e clique em **Editar**.

3. Na seção **Recursos Premium**, ative o **Captain**.

4. Salve as alterações.

![](https://app.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBMGltRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--02eda0b02f59e7a0059ba20902b2e86a0b6acb8a/Screenshot-202025-08-15-20at-2011.52.31-E2-80-AFAM.png)

## **Solução de problemas**

Se o Captain não estiver respondendo conforme o esperado:

* Verifique se a **chave de API OpenAI** está correta e ativa.

* Confira se o **nome do modelo** corresponde a um modelo suportado.

* Certifique-se de que sua **chave de API Firecrawl** é válida caso esteja utilizando a varredura.

* Confirme que o Captain está ativado tanto no nível da instalação quanto da conta.

Se o Captain ainda não estiver respondendo, revise os logs do servidor RockZap® tanto dos processos web quanto do worker para identificar quaisquer erros e compartilhe esses detalhes de erro com a equipe de suporte para uma assistência adicional.