Guida al prompting

Guida alla prova

Il comportamento di un agente vocale Finn è il 90% del prompt. Questa guida copre cosa scrivere, cosa evitare, e come debug.

La struttura a 4 parti

Ogni richiesta Finn affidabile ha quattro sezioni. In ordine:

1. Identity — chi è l'agente, per chi lavorano, qual è il loro lavoro.
2. Goal — l'esito unico della chiamata. Una frase.
3. Rules — che dire, cosa NON dire, che cosa ricadere su.
4. Examples — 2-4 snippet corti di giri ideali.

Salta qualsiasi parte e l'agente diventa fragile.

Identità (1-3 linee)

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.

Ancora un nome, una birra, un datore di lavoro, e un tono in 3 righe. Skip backstory — mangia latenza e confonde l'agente.

Goal (1 linea)

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

Un risultato concreto. Se l'obiettivo è multi-step (qualifica + libro + trasferimento caldo), rompere l'agente in un flusso di lavoro con nodi separati — non afferrarlo in un solo prompt.

Regole

Dichiara sia positivi che negativi.

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.

Le regole "mai" sono importanti come le regole "sempre".

Esempi

Mostra micro-dialogo 2-4. Ancorano tono meglio di qualsiasi aggettivo.

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?"

Variabili

Utilizzare {variable} sintassi. Finn inietta automaticamente le colonne del pubblico e i dati delle chiamate dal vivo.

| Variabile integrata | Cosa si risolve a | Traduzione: | {customer_name} | La colonna name della riga del pubblico | {customer_phone} | Il numero digitato | | {current_time} | L'ora locale di Caller, formattato | | {call_duration} | Secondi dal ritiro |

Qualsiasi colonna nel tuo pubblico caricato CSV diventa una variabile (ad esempio {appointment_date}, {loan_amount}).

Errori comuni

| Mistake | Perché si rompe | Fix | Traduzione: | Multi-paragrafo identità | Bloats first token, slow risposta | 3 linee max | | Tono vago ("essere utile") | Significa nulla | Pick 3 aggettivi tono: "caldo, breve, mai spinoso" | | Goal ha dichiarato come "fare quello che l'utente vuole" | Agent meanders, chiamate eseguire a lungo | Un risultato per agente | | Regole di sola negativo | L'agente non ha alcun frame positivo | Mix positivo + negativo | | Nessun esempio | Tone deriva sotto pressione | Includere sempre 2–4 | | Esempi che rispecchiano le regole | Non aggiunge nulla | Mostra casi di bordo — chiamante arrabbiato, ambiguo richiesta |

Debugging un prompt

Quando le chiamate sono spente:

1. Ascolta la registrazione. Non indovinare.

2. Find the first strambo turn # Di solito una regola mancante, non un fallimento modello.

3. Aggiungi una regola per quello scenario esatto con un esempio.
4. "Riprova sullo stesso numero". Se fisso, vai avanti. In caso contrario, il problema è a monte (flusso di lavoro, pubblico, base di conoscenza).

La maggior parte dei reclami "il modello è stupido" sono bug mancanti.

Prompt Lunghezza

| Lunghezza | Latency | Use case | Traduzione: | < 300 parole | Più basso | Semplice conferma / promemoria / sondaggio | | 300–800 parole | Normale | La maggior parte degli agenti | | 800–1500 parole | Accettabile | Vendita complessa / triage | | > 1500 parole | Slow + erratic | Split in a workflow |

Strumenti che aiutano

• AI Copilot — la revisione e la riscrittura dei suggerimenti in atto.
• Playbooks — 46 modelli di agente vocale pronti a rivelare.
• Knowledge Base — per fatti il prompt non deve portare in linea.