Criando seu primeiro assistente

Esta página explica como criar um assistente do zero no Capitão IA. O assistente é a entidade que efetivamente conversa com o cliente — você pode ter um único assistente para toda a operação ou vários, cada um com sua persona, sua base de conhecimento e suas caixas de entrada vinculadas.

1. Criar o assistente

Acesse Configurações → Capitão IA → Assistentes e clique em Novo assistente. Os campos obrigatórios na criação são:

Nome — aparece como remetente das mensagens automatizadas e nas avaliações de atendimento. Use algo reconhecível pelo cliente, como "Atendimento" ou "Capitã Ana".
Descrição — uma descrição curta da persona e do papel do assistente. Esse texto é usado tanto na interface quanto pelo motor para entender o contexto operacional.

Após criado, você acessa o detalhamento do assistente e edita as configurações avançadas.

2. Configurar comportamento

No painel do assistente, em Configurações, ajuste:

Mensagem de boas-vindas — o que o assistente diz na primeira interação de cada conversa.
Mensagem de handoff — o que o assistente envia ao transferir para um humano.
Mensagem de resolução — o que ele envia ao encerrar uma conversa por conta própria.
Instruções (instructions) — orientações específicas de comportamento. Texto livre.
Temperatura — controla a variabilidade das respostas. Valores menores deixam o assistente mais conservador; valores maiores tornam as respostas mais variadas.
Nome do produto (product_name) — usado nas instruções internas para que o assistente saiba a que produto ou serviço pertence.
Recursos opcionais — você pode habilitar uso de FAQs, memória entre sessões, captura automática de atributos do contato e citação de fonte na resposta.

3. Definir diretrizes e guardrails

Dois campos são particularmente importantes para o comportamento ao vivo:

Diretrizes de resposta (response_guidelines) — lista de frases que orientam o estilo das respostas. Exemplos: "responda sempre em português", "use no máximo três frases por mensagem", "ofereça uma alternativa antes de encerrar a conversa".
Guardrails — lista de proibições absolutas. Exemplos: "nunca prometa prazos de entrega sem consultar o sistema", "não emita opinião sobre concorrentes", "não compartilhe informações de outros clientes".

Os dois campos são aceitos como arrays e podem ser editados a qualquer momento sem reprocessar a base de conhecimento. O artigo Validações e handoff detalha boas práticas para escrevê-los.

4. Vincular caixas de entrada

Em Caixas de entrada, dentro do assistente, clique em Vincular caixa e selecione uma das caixas existentes. Cada caixa pode ter, no máximo, um assistente do Capitão IA ativo por vez. Vincular ativa o assistente para todas as conversas novas daquela caixa. Você pode vincular várias caixas a um mesmo assistente — útil quando uma operação atende WhatsApp, Instagram e e-mail com a mesma persona.

A desvinculação é imediata: novas conversas voltam a ser atribuídas exclusivamente a humanos, mas conversas já em curso com o assistente seguem fluindo até serem resolvidas ou transferidas.

5. Carregar conhecimento e cenários

Antes de pôr o assistente em produção, alimente-o:

Adicione documentos (URLs ou PDFs) — veja Carregar documentos.
Aprove FAQs geradas a partir do conteúdo dos documentos.
Crie cenários para fluxos específicos — veja Receitas de fluxo.
Cadastre ferramentas customizadas se o assistente precisar consultar APIs externas — veja Ferramentas customizadas.

6. Testar no playground

No detalhe do assistente há a aba Playground. Ela é um chat isolado que conversa com o assistente exatamente como ele responderia em produção, mas sem afetar caixas reais nem clientes. Use-a para validar:

Se as diretrizes estão sendo aplicadas no tom e no formato.
Se os guardrails bloqueiam o que precisam bloquear.
Se os cenários ativam nos contextos certos.
Se as ferramentas customizadas são chamadas com os parâmetros esperados.

O playground recebe o histórico de mensagens da sessão atual, então você pode encadear várias trocas para simular conversas mais longas. Cada execução do playground consome respostas da cota normal do assistente.

7. Iterar a partir das conversas reais

Depois que o assistente estiver vinculado a uma caixa e atendendo, o ajuste fino vem das conversas reais: revise o que ele respondeu, aprove novas FAQs sugeridas pelo motor, refine cenários, adicione guardrails para casos que apareceram. Veja Métricas, sessões e teste de fluxos para acompanhar uso e qualidade.