Configura il prompt

Scrivi il prompt come lo script operativo di una chiamata vocale reale. Deve definire chi è l'agente, cosa deve ottenere la chiamata, come deve parlare, quali dati deve raccogliere e quando deve usare le functions.

Per la voce, mantieni istruzioni brevi e operative: una domanda alla volta, fallback chiari, trigger espliciti per le functions e nessuna regola sovrapposta.

In RocketAiFlow, scrivi il prompt come regole operative per una chiamata reale, non come descrizione del prodotto.

Usa sezioni chiare, step ordinati ed esempi quando devi mostrare un comportamento atteso. Questo è allineato anche alla prompt guidance di OpenAI.

• usa sezioni brevi con titoli espliciti
• scrivi l'obiettivo di business in modo semplice
• definisci lo stile conversazionale con regole concrete, risposte brevi e una domanda alla volta
• elenca le informazioni che l'agente deve raccogliere
• nomina le functions che l'agente può chiamare e quando deve chiamarle
• spiega cosa deve fare l'agente quando manca un'informazione
• evita istruzioni in conflitto e obiettivi generici

Usa questa struttura come punto di partenza per prompt complessi. Mantieni ogni sezione breve. Aggiungi dettagli solo dove cambiano il comportamento.

• Ruolo: chi è l'agente e chi rappresenta.
• Obiettivo chiamata: quale risultato di business deve raggiungere la chiamata.
• Stile conversazionale: come deve parlare, quanto devono essere lunghe le risposte e come deve gestire l'incertezza.
• Informazioni da raccogliere: i campi necessari prima di continuare il workflow.
• Regole functions: nomi esatti delle functions, condizioni di attivazione, campi required e regole negative.
• Regole transfer: quando la chiamata deve essere trasferita a una persona o destinazione.
• Regole di chiusura: come l'agente deve riassumere, chiudere o lasciare la chiamata senza esito.
• Variabili di contesto: valori contatto o campagna che il prompt può usare, come {t.name} o {t.data.birthDate}.

# Ruolo
[chi è l'agente e chi rappresenta]

# Obiettivo chiamata
[risultato di business che la chiamata deve raggiungere]

# Stile conversazionale
- Parla con frasi brevi.
- Fai una domanda alla volta.
- Conferma valori importanti come date, nomi e numeri di telefono.
- Non inventare informazioni.

# Informazioni da raccogliere
- [campo required 1]
- [campo required 2]
- [campo required 3]

# Regole functions
- Usa function_name solo quando [condizione di attivazione].
- Prima di chiamarla, raccogli [campi required].
- Se manca un campo required, fai una breve domanda di follow-up.
- Non chiamare la function quando [condizione negativa].

# Regole transfer
[quando trasferire e quale destinazione è consentita]

# Regole di chiusura
[come riassumere l'esito e chiudere la chiamata]

# Variabili di contesto
[quali valori {t...} possono essere usati e cosa fare se mancano]

Usalo come punto di partenza compatto e adatta ruolo, obiettivo, campi richiesti e nomi delle functions al tuo workflow.

# Ruolo
Sei Rocket Demo Assistant, un agente vocale per RocketAiFlow.

# Obiettivo
Qualifica il chiamante e capisci se vuole una demo, un callback o più informazioni.

# Stile conversazionale
- Parla in modo chiaro e breve.
- Fai una domanda alla volta.
- Non inventare informazioni.
- Se il chiamante chiede qualcosa a cui non puoi rispondere, dillo e proponi un transfer.

# Informazioni da raccogliere
- nome
- azienda
- motivo della chiamata
- livello di interesse
- prossimo step preferito

# Functions
- Usa save_lead_qualification solo dopo aver raccolto i campi richiesti per qualificare il lead.
- Se manca un campo obbligatorio, fai prima una breve domanda di follow-up.
- Usa transfer_call solo quando il chiamante chiede di parlare con una persona o il workflow richiede un handoff.

# Chiusura
Riassumi il prossimo step prima di terminare o trasferire la chiamata.

In RocketAiFlow, le regole sulle functions vanno nel prompt quando l'agente deve decidere se chiamare una function configurata durante una chiamata reale.

La guida del provider resta utile per schema, nomi e comportamento dei tool. Vedi la guida OpenAI sulle function calling.

• cita ogni function con il suo nome esatto e collegala a una condizione di attivazione concreta
• elenca i campi required che devono essere raccolti prima di chiamare la function
• se manca un valore required, indica all'agente di fare una breve domanda di follow-up prima di chiamare la function
• Buono: “Usa transfer_to_service quando il chiamante chiede sales, support o administration. Imposta exten sul servizio supportato corretto.”
• Buono: “Usa rescheduled_contact solo dopo che il chiamante ha chiesto di essere ricontattato e hai confermato data e ora del callback.”
• Evita: “Usa i tool quando serve.” È troppo vago per ottenere un comportamento affidabile.
• Aggiungi una regola negativa per ogni function importante: non chiamarla se mancano i campi required o se l'intenzione del chiamante non è chiara.

Le variabili template possono personalizzare il prompt, ma non devono renderlo difficile da leggere.

Usa variabili come {t.name}, {t.phone} o {t.externalId} solo quando il prompt o la function hanno bisogno di quel contesto.

Per le chiamate outbound, le variabili arrivano dal contatto della campagna. Per le chiamate inbound, le variabili vengono renderizzate solo se l'agente ha il recupero contatto abilitato e Contatti inbound contiene una lista associata a quell'agente con un numero che corrisponde al chiamante.

• usa variabili contatto per dati già salvati sul contatto o sul record campagna
• chiedi al chiamante i valori che non sono già disponibili
• non dare per scontato che una variabile venga renderizzata se il valore non esiste sul contatto attivo; se non c'è corrispondenza, variabili come {t.name} o {t.data.birthDate} non vengono renderizzate
• rivedi il modello completo in Parametri dinamici