## 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

1. Abra a área do **Captain** e selecione (ou crie) o **assistente** que receberá os recursos avançados.
2. **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**.
3. **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**.
4. **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.
5. **Habilite** a ferramenta e, se quiser, associe-a a um cenário específico.
6. Faça a **manutenção do conhecimento em massa** (aprovar respostas, sincronizar/excluir documentos) e
  acompanhe o histórico do **copiloto** dos agentes.
7. 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.

## Veja também

- [Bots e Captain (IA de atendimento)](/hc/ajuda/articles/automation-flows-bots-e-captain-pt-br)
- [Flow Builder: fluxos conversacionais visuais](/hc/ajuda/articles/automation-flows-flow-builder-pt-br)
- [Regras de automação: gatilhos, condições e ações](/hc/ajuda/articles/automation-flows-regras-de-automacao-pt-br)