Captain avançado: cenários e ferramentas personalizadas

Abrir em

Ver como Markdown

Abrir no ChatGPT Abrir no Claude

Conversa Labs

Última atualização em Jul 16, 2026

Visão geral

O Captain não precisa se limitar a responder dúvidas a partir da base de conhecimento. Com dois recursos avançados, o assistente passa a agir como um agente:

Cenários (scenarios): playbooks guiados, vinculados a um assistente, que descrevem um roteiro (instruções/etapas) a ser seguido em situações específicas — por exemplo, qualificar um lead ou conduzir uma cobrança.
Ferramentas personalizadas (custom tools): chamadas HTTP que o assistente pode invocar durante a conversa para consultar ou registrar dados nos seus sistemas (consultar um pedido, verificar um CPF, abrir um chamado).

Juntos, eles transformam respostas estáticas em atendimento que segue processos e busca informação em tempo real, mantendo sempre a opção de repassar para um humano.

Pré-requisitos

O recurso de Captain habilitado na conta e pelo menos um assistente já criado (é a ele que os cenários e as ferramentas se conectam).
Permissão de administrador para criar, editar e excluir cenários e ferramentas.
Ferramentas personalizadas podem exigir uma flag adicional (custom_tools ou a versão v2 do Captain). Se o menu de ferramentas não aparecer, fale com um administrador para habilitar.
Para ferramentas que chamam seus sistemas: a URL do endpoint, o método HTTP e, quando houver, as credenciais de autenticação.

Passo a passo

Abra a área do Captain e selecione (ou crie) o assistente que receberá os recursos avançados.
Crie um cenário: informe um título, uma descrição e a instrução (o roteiro/etapas que o assistente deve seguir). Opcionalmente, restrinja quais ferramentas o cenário pode usar e deixe-o habilitado.
Crie uma ferramenta personalizada: defina título, descrição, URL do endpoint, método HTTP, os parâmetros que a IA deve preencher e o tipo de autenticação.
Teste a ferramenta com o botão de teste — a plataforma faz uma requisição real e mostra o status e um trecho da resposta, para você validar antes de ativar.
Habilite a ferramenta e, se quiser, associe-a a um cenário específico.
Faça a manutenção do conhecimento em massa (aprovar respostas, sincronizar/excluir documentos) e acompanhe o histórico do copiloto dos agentes.
Teste com perguntas reais no playground do assistente e ajuste instruções, parâmetros e escopo.

Configurações & opções

Cenários (scenarios)

Cada cenário pertence a um assistente e tem:

Título e descrição: identificam o cenário e quando ele se aplica.
Instrução: o roteiro em linguagem natural — os passos que o assistente deve seguir naquele contexto.
Ferramentas: a lista de ferramentas que o cenário tem permissão de usar.
Habilitado: liga/desliga o cenário; apenas cenários habilitados ficam disponíveis para o assistente.

Cenários podem ser criados, editados e excluídos a qualquer momento sem afetar o restante do conhecimento.

Ferramentas personalizadas (custom tools)

Uma ferramenta descreve uma chamada HTTP que o assistente pode acionar:

Campo	Função
Título / Descrição	Nome e explicação; a descrição ajuda a IA a decidir quando usar a ferramenta.
URL do endpoint	O endereço que será chamado.
Método HTTP	`GET`, `POST` etc.
Parâmetros	Cada parâmetro tem `nome`, `tipo`, `descrição` e se é `obrigatório` — é o que a IA preenche.
Modelo de requisição / resposta	Como montar o corpo enviado e como interpretar o retorno.
Tipo e configuração de autenticação	Por exemplo, token/chave; as credenciais ficam protegidas.
Habilitado	Ativa ou desativa a ferramenta para o assistente.

A plataforma pode limitar a quantidade de ferramentas por conta; ao atingir o limite, a criação é bloqueada com uma mensagem clara.

Conhecimento em massa

Respostas (assistant responses): ações em massa para aprovar respostas pendentes ou excluir várias de uma vez, agilizando a curadoria do conhecimento.
Documentos (assistant documents): ações em massa para excluir ou sincronizar novamente os documentos (apenas os que podem ser sincronizados são reprocessados).
Threads do copiloto: o histórico do copiloto é por usuário e vinculado a um assistente. Cada consulta consome a cota de respostas do Captain da conta; ao esgotar, o copiloto avisa em vez de responder.

Casos de uso

Consulta de pedido por ferramenta: o cliente pergunta "cadê meu pedido?"; o assistente chama uma ferramenta personalizada que consulta seu sistema e responde com o status real.
Cobrança guiada por cenário: um cenário descreve o roteiro de cobrança (saudação, confirmação de dados, envio do link de pagamento) e o assistente o segue passo a passo.
Agendamento guiado: cenário que conduz a marcação e usa uma ferramenta para verificar horários.
Curadoria rápida: a equipe usa as ações em massa para aprovar dezenas de respostas e ressincronizar documentos após uma atualização de conteúdo.

Dicas, limites e boas práticas

Comece com escopo reduzido: poucos cenários e uma ou duas ferramentas; amplie conforme ganhar confiança nos resultados.
Descrições claras nas ferramentas e parâmetros ajudam a IA a escolher e preencher corretamente.
Sempre teste a ferramenta antes de ativar e revise execuções reais periodicamente.
Mantenha o handoff: ofereça sempre uma saída clara para falar com um humano quando a IA não resolver.
Cenário vs. ferramenta: o cenário define o que fazer (roteiro); a ferramenta define como buscar ou registrar dados (chamada HTTP).

Solução de problemas

A ferramenta não aparece: o recurso de ferramentas personalizadas pode não estar habilitado para a conta (flag). Fale com um administrador.
O cenário não dispara: confirme se ele está habilitado e vinculado ao assistente correto, e se a instrução descreve com clareza quando aplicá-lo.
A ferramenta retornou erro: use o teste para ver o status e a resposta; revise URL, método, parâmetros e autenticação. Endpoints fora do ar ou credenciais inválidas geram falha.
Não consigo criar mais ferramentas: você pode ter atingido o limite de ferramentas da conta.
O copiloto parou de responder: a cota de respostas do Captain pode ter se esgotado no período.