Guia de Prompts

Guia de prompts

O comportamento de um agente de voz Finn é 90% prompt. Este guia cobre o que escrever, o que evitar e como depurar.

A estrutura em 4 partes

Todo prompt confiável do Finn tem quatro seções. Nesta ordem:

1. Identidade — quem é o agente, para quem ele trabalha, qual é a função dele.
2. Objetivo — o único resultado da chamada. Uma frase.
3. Regras — o que dizer, o que NÃO dizer, a que recorrer.
4. Exemplos — 2 a 4 trechos curtos de turnos ideais.

Pule qualquer parte e o agente fica frágil.

Identidade (1 a 3 linhas)

You are Aria, a friendly appointment coordinator at Smile Dental Clinic.
You speak with patients calling to confirm, reschedule, or cancel an upcoming visit.
You are warm, brief, and never push extra services.

Defina um nome, uma função, um empregador e um tom em 3 linhas. Deixe a história de fundo de lado — ela aumenta a latência e confunde o agente.

Objetivo (1 linha)

Goal: confirm, reschedule, or cancel the patient's upcoming appointment within 90 seconds.

Um resultado concreto. Se o objetivo tiver várias etapas (qualificar + agendar + transferir com contexto), divida o agente em um fluxo de trabalho com nós separados — não espreme tudo em um único prompt.

Regras

Declare tanto os pontos positivos quanto os negativos.

Rules:
- Always ask "Am I speaking with {customer_name}?" before sharing any appointment details.
- If the caller says "remove me" or "stop calling", honor immediately and end the call politely.
- If asked if you're a real person, say honestly: "I'm Aria, a voice assistant for Smile Dental."
- Never quote a price — transfer to the front desk if asked.
- Never schedule a Sunday appointment — the clinic is closed.
- If the caller's intent is unclear after two clarifying questions, offer human transfer.

As regras de "nunca" são tão importantes quanto as de "sempre".

Exemplos

Mostre de 2 a 4 microdiálogos. Eles definem o tom melhor do que qualquer adjetivo.

Example 1 — Smooth confirm
Aria: "Hi, is this Priya? It's Aria from Smile Dental, calling about your visit on Thursday."
Caller: "Yes."
Aria: "Great. We have you booked for 4 PM Thursday with Dr. Mehta for a cleaning. Still works?"
Caller: "Yes, that works."
Aria: "Confirmed. See you Thursday. Have a great day."

Example 2 — Reschedule
Caller: "I need to move it."
Aria: "No problem. We have openings Friday at 11 AM or 3 PM, or Monday at 10. What works best?"

Variáveis

Use a sintaxe {variable}. O Finn injeta automaticamente as colunas do público e os dados da chamada em tempo real.

Qualquer coluna do CSV de público enviado vira uma variável (ex.: {appointment_date}, {loan_amount}).

Erros comuns

Depuração de um prompt

Quando as chamadas saem do roteiro:

1. Ouça a gravação. Não suponha.
2. Encontre o primeiro turno estranho. Em geral é uma regra faltando, não falha do modelo.
3. Adicione uma regra para esse cenário exato com um exemplo.
4. Teste de novo no mesmo número. Se resolveu, siga em frente. Se não, o problema está antes (workflow, público, base de conhecimento).

A maioria das reclamações de "o modelo é burro" são bugs de regra faltando.

Tamanho do prompt

Ferramentas que ajudam

• AI Copilot — revise e reescreva prompts no local.
• Playbooks — 46 modelos de agentes de voz prontos para implantar.
• Knowledge Base — para fatos que o prompt não deve carregar inline.