Guida al prompting
Scrivi prompt che producono agenti vocali Finn affidabili.
Guida al prompting
Il comportamento di un agente vocale Finn dipende per il 90% dal prompt. Questa guida spiega cosa scrivere, cosa evitare e come fare debug.
La struttura in 4 parti
Ogni prompt Finn affidabile ha quattro sezioni, in quest'ordine:
- Identità — chi è l'agente, per chi lavora, qual è il suo compito.
- Obiettivo — il singolo risultato della chiamata. Una frase.
- Regole — cosa dire, cosa NON dire, su cosa ripiegare.
- Esempi — 2–4 brevi frammenti di turni ideali.
Se ne salti una, l'agente diventa fragile.
Identità (1–3 righe)
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.
Fissa un nome, un ruolo, un datore di lavoro e un tono in 3 righe. Salta il background: aumenta la latenza e confonde l'agente.
Obiettivo (1 riga)
Goal: confirm, reschedule, or cancel the patient's upcoming appointment within 90 seconds.
Un risultato concreto. Se l'obiettivo è in più fasi (qualificare + prenotare + trasferire con presentazione), scomponi l'agente in un workflow con nodi separati: non comprimere tutto in un unico prompt.
Regole
Indica sia i positivi che i 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" contano quanto le regole "sempre".
Esempi
Mostra 2–4 micro-dialoghi. Fissano il 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
Usa la sintassi {variable}. Finn inserisce automaticamente le colonne dell'audience e i dati della chiamata in tempo reale.
| Variabile integrata | A cosa corrisponde |
|---|---|
{customer_name} | La colonna name della riga dell'audience |
{customer_phone} | Il numero chiamato |
{current_time} | Ora locale del chiamante, formattata |
{call_duration} | Secondi dalla risposta |
Qualsiasi colonna del CSV audience caricato diventa una variabile (es. {appointment_date}, {loan_amount}).
Errori comuni
| Errore | Perché causa problemi | Soluzione |
|---|---|---|
| Identità di più paragrafi | Appesantisce il primo token, risposta lenta | Massimo 3 righe |
| Tono vago ("sii utile") | Non significa nulla | Scegli 3 aggettivi di tono: "cordiale, conciso, mai insistente" |
| Obiettivo formulato come "fai quello che vuole l'utente" | L'agente divaga, le chiamate si allungano | Un solo obiettivo per agente |
| Regole solo negative | L'agente non ha un riferimento positivo | Combina positive e negative |
| Nessun esempio | Il tono si sfalda sotto pressione | Includine sempre 2–4 |
| Esempi che rispecchiano le regole | Non aggiunge nulla | Mostra i casi limite — chiamante arrabbiato, richiesta ambigua |
Debug di un prompt
Quando le chiamate escono dal copione:
- Ascolta la registrazione. Non tirare a indovinare.
- Individua il primo turno anomalo. Di solito è una regola mancante, non un errore del modello.
- Aggiungi una regola per quello scenario specifico con un esempio.
- Ripeti il test sullo stesso numero. Se è risolto, vai avanti. Se no, il problema è a monte (workflow, audience, knowledge base).
La maggior parte delle lamentele del tipo "il modello è stupido" sono regole mancanti.
Lunghezza del prompt
| Lunghezza | Latenza | Caso d'uso |
|---|---|---|
| < 300 parole | Minima | Conferme semplici / promemoria / sondaggi |
| 300–800 parole | Normale | La maggior parte degli agenti |
| 800–1500 parole | Accettabile | Vendita complessa / triage |
| > 1500 parole | Lenta e irregolare | Suddividi in un workflow |
Strumenti utili
- AI Copilot — rivedi e riscrivi i prompt sul posto.
- Playbooks — 46 template di voice agent pronti al deploy.
- Knowledge Base — per i dati che il prompt non deve contenere inline.
Was this page helpful?
Still stuck or have feedback?
Email [email protected] or use the chat bubble in the bottom-right corner — it's a Finn that knows the Academy cold.