Pular para o conteúdo

Roteiro (prompt)

O roteiro é o texto que define o agente: o que ele faz, como fala, o que nunca deve fazer e quando usar cada ferramenta. Fica em <agente> › Cérebro › Roteiro.

Roteiro (prompt): no menu brain da barra de cima, Agentes, abrir um agente do tipo 💬 Conversa, aba Cérebro, sub-aba Roteiro. Na tela, o campo Prompt Template (Liquid) com um roteiro montado nas seções do exemplo abaixo (objetivo, como você fala, o que fazer, o que nunca fazer)

Você é a [nome], atendente da [empresa].
## Seu objetivo
Entender o que a pessoa precisa e [agendar a aula / passar o orçamento / resolver a dúvida].
## Como você fala
Português do Brasil, direto, sem formalidade exagerada. Frases curtas.
Nunca use emoji em excesso. Nunca prometa prazo que não está na base.
## O que fazer
1. Cumprimente e pergunte o que a pessoa precisa.
2. Se perguntarem preço ou condição, SEMPRE chame a ferramenta consultar_planos antes de responder.
3. Quando a pessoa demonstrar interesse, registre nome e telefone com registrar_dados.
4. Se pedir humano, ou se você não souber, chame a ferramenta chamar_atendente.
## O que nunca fazer
- Nunca invente valor, prazo ou disponibilidade.
- Nunca diga que vai "verificar e retornar": você não retorna depois.
  • Instrução por linha. Parágrafo longo o modelo ignora pela metade.
  • Cite a ferramenta pelo nome técnico dentro do roteiro (“chame consultar_planos”). Isso aumenta muito o acerto.
  • Diga o que não fazer, não só o que fazer.
  • Evite roteiro gigante. Se ficar enorme, provavelmente o agente deveria ser dois: um orquestrador e um especialista.

Roteiro (prompt): na mesma sub-aba Roteiro, os painéis ao lado do campo: Contexto Disponível (nome do contato, ID da conversa, data de hoje...), Variáveis do Agente com pelo menos uma variável cadastrada e Tools Registradas com as ferramentas do agente

O roteiro aceita Liquid. Os painéis laterais mostram o que está disponível:

  • Contexto Disponível — dados do contato, da conversa, da caixa, do agente e de data e hora.
  • Variáveis do Agente — pares de chave e valor que você define (por exemplo, o telefone da unidade) e usa no texto.
  • Tools Registradas — a lista das ferramentas do agente; clicar insere o nome no roteiro.

Com o roteiro vazio, o botão Carregar modelo de exemplo traz um modelo pra adaptar.

Na sub-aba Conhecimento você vincula as bases que este agente pode consultar. As bases são globais da conta e ficam em Brain › Conhecimento; aqui você só escolhe quais valem pra ele.

Vincular a base não basta: o agente só consulta se tiver a ferramenta Buscar na base de conhecimento e se o roteiro mandar usá-la. Veja Consulta de base.