Scrivere un buon prompt

Come costruire saluto e prompt perché il tuo agente conosca la tua azienda, risponda in breve e usi gli strumenti al momento giusto.

Il prompt è l'istruzione di lavoro del tuo agente. Stabilisce chi è l'agente, cosa sa della tua azienda e come conduce una conversazione. Più il prompt è chiaro, più la conversazione è affidabile.

Entrambi si impostano nell'agente, nella scheda Personalità: il Saluto è la prima frase della chiamata, il Prompt è tutto ciò che vale dopo.

Il saluto

Il tuo agente pronuncia il saluto subito dopo aver risposto, senza pause per pensare. Tienilo breve e nomina la tua azienda.

BuonoMeno buono
«Studio del Dott. Sommer, buongiorno. Come posso aiutarla?»«Salve e benvenuti nello studio del Dott. Sommer, il vostro medico di famiglia nel cuore di Amburgo. Il mio nome è …»
«Sommer Idraulica e Riscaldamento, sta parlando con l'assistente digitale. Di cosa si tratta?»«Salve, sono il vostro agente.»

Al telefono, i saluti lunghi sembrano un messaggio registrato. Chi chiama interrompe o riaggancia.

Come è fatto un prompt

Un prompt che funziona al telefono ha di solito sette parti. I titoli aiutano il modello a distinguerle.

ParteContenutoEsempio
RuoloChi è l'agente e per conto di chi parlaSei l'assistente telefonico di Sommer Idraulica e Riscaldamento.
AziendaI fatti che chi chiama domandaIndirizzo, orari, servizi, zona servita
ObiettivoCosa deve essere raggiunto alla fine della chiamataUn appuntamento è prenotato o una richiamata è concordata.
SvolgimentoI passi nell'ordine giustoChiarire la richiesta, annotare l'indirizzo, proporre un appuntamento
StrumentiQuando entrano in gioco calendario, conoscenze o trasferimentoPer domande sui prezzi, cerca nella knowledge base.
RegoleTono, lunghezza, forma di cortesiaDai del lei e rispondi in massimo due frasi.
LimitiCosa l'agente non faNessun impegno sui prezzi per lavori su misura.

bhomy completa il tuo prompt con istruzioni tecniche, per esempio sulla lingua, sugli strumenti attivi e sulla chiusura della chiamata. Non devi occupartene.

Un esempio

# Ruolo
Sei l'assistente telefonico di Sommer Idraulica e Riscaldamento ad Amburgo.
Rispondi alle chiamate quando la squadra è nei cantieri.

# Azienda
- Servizi: riscaldamento, idraulica, manutenzione di caldaie a gas. Niente lavori elettrici.
- Zona servita: Amburgo e 20 km di raggio.
- Orari dell'ufficio: dal lunedì al venerdì, dalle 7 alle 16.
- Pronto intervento: solo per danni da acqua o guasto del riscaldamento in inverno.

# Obiettivo
Alla fine, ogni chiamante ha un appuntamento o la promessa di una richiamata.

# Svolgimento
1. Chiedi il motivo della chiamata.
2. In caso di emergenza: trasferisci al pronto intervento.
3. Altrimenti: annota nome, indirizzo e problema.
4. Proponi un orario libero dal calendario.
5. Alla fine, riassumi in breve cosa è stato concordato.

# Regole
- Dai del lei e rispondi in massimo due frasi.
- Fai sempre una sola domanda alla volta.
- Non indicare prezzi. Di' che la squadra invierà un preventivo.
- Se non sai qualcosa, dillo apertamente e offri una richiamata.

Variabili nel saluto e nel prompt

Con le doppie parentesi graffe inserisci valori noti solo al momento della chiamata, per esempio {{customer_name}} o {{appointment}}.

Da dove arriva il valoreQuando
Incoming Webhooknelle chiamate in entrata, il tuo sistema risponde mentre squilla
context dell'API in uscitanelle chiamate in uscita
Elenco contatti di una campagnaogni colonna tranne il numero di telefono diventa una variabile

Se per un segnaposto non arriva alcun valore, bhomy lo rimuove prima della chiamata. L'agente quindi non legge mai {{customer_name}} ad alta voce. Scrivi le frasi in modo che funzionino anche senza il valore, oppure imposta un Valore di riserva nell'Incoming Webhook.

Campi non compilati dei modelli

I modelli contengono parti tra parentesi quadre da compilare, come il nome dell'azienda o gli orari. La dashboard le conta in Campi non compilati nel prompt. Puoi comunque attivare l'agente. Su quei punti dirà apertamente che gli manca l'informazione, invece di inventare.

Citare gli strumenti nel prompt

Gli strumenti come calendario, knowledge base, ricerca web o trasferimento si attivano nella scheda Strumenti. Il prompt dice all'agente quando usarli:

  • «Se chi chiama vuole un appuntamento, controlla gli orari liberi nel calendario e proponi due appuntamenti.»
  • «Rispondi alle domande su servizi e prezzi con la knowledge base.»
  • «Trasferisci all'ufficio se chi chiama vuole espressamente parlare con una persona.»

L'agente non può usare uno strumento non attivo, anche se il prompt lo cita. Controlla entrambe le cose se uno strumento non interviene.

Impostazioni della chiamata

In Impostazioni chiamata, nella scheda Personalità, imposti come parla il tuo agente e quanto può durare al massimo una chiamata.

ImpostazioneEffettoConsiglio
Durata max. chiamata (min)Dopo, l'agente chiude la chiamata con cortesia. Da 1 a 30 minuti20 minuti bastano per quasi tutte le richieste
Timeout silenzio (sec)Quanto può tacere chi chiama prima che l'agente riagganci. Da 15 a 300 secondi30 secondi
CreativitàDa Preciso a Creativopiuttosto preciso per appuntamenti, assistenza e informazioni
Velocità del parlatoDa Più lento a Più velocenormale, più lenta per un pubblico anziano
Tempo di rispostaPaziente aspetta di più prima di rispondere, Veloce risponde primapaziente se chi chiama riflette molto o detta

Se chi chiama resta in silenzio per 15 secondi, l'agente chiede se è ancora in linea.

Provare e migliorare

  1. Salva il prompt e avvia Testa agente.
  2. Prova tre chiamate tipiche: una richiesta semplice, una difficile e una che l'agente deve rifiutare.
  3. Leggi nello Storico chiamate la trascrizione e i Main Logs. Lì vedi quale strumento ha usato l'agente e quando.
  4. Cambia una sola cosa alla volta e prova di nuovo.

Errori frequenti