Ottimizzazione dei prompt con 3CX: Parte 2

Scoprite come scrivere prompt efficaci, evitare gli errori comuni e ottimizzare il vostro Agente IA per conversazioni reali.

Nella Parte 1, abbiamo esaminato i fondamenti del prompt engineering: scrivere istruzioni invece di prosa, rimuovere definizioni non necessarie, evitare contraddizioni e mantenere i prompt concisi. In questo blog andremo oltre la struttura del prompt e ci concentreremo su come si comportano effettivamente i modelli di IA.

Capire cosa un modello può e non può fare è altrettanto importante quanto sapere come scrivere un prompt. Tratteremo anche il prompting vocale in tempo reale, tecniche pratiche di test e una serie di abitudini che possono aiutarvi a creare Agenti IA 3CX più affidabili. Continuate a leggere per saperne di più!

Sapere cosa il modello può e non può fare

Molto del superfluo nei prompt degli utenti deriva dal tentativo di correggere cose che il prompting non può risolvere.

Il prompting è efficace per:

• Impostare il tono, la personalità (persona) e la lingua,
• Definire la struttura di conversazione (ad es. “fai una domanda alla volta”),
• Specificare quando richiamare un determinato strumento (tool),
• Elencare le azioni consentite e quelle non consentite,
• Riprendersi da specifiche modalità di errore (ad es. correzione del riconoscimento, ostilità).

Il prompting non è efficace per:

• Forzare un fraseggio esatto in ogni turno di conversazione (il modello farà delle parafrasi),
• Imporre conteggi precisi (“chiedi esattamente due volte, poi passa al livello successivo”) — ci si avvicina, ma non è perfetto,
• Ragionare su lunghi elenchi di logica condizionale in una singola frase,
• Sostituire strumenti mancanti – se l’agente deve cercare qualcosa, fornitegli uno strumento, non descrivere la ricerca in prosa. Tutti gli strumenti vengono visualizzati quando si clicca sul pulsante “Inserisci variabile” nella scheda Prompt IA.

Se vi ritrovate a scrivere la stessa regola in tre modi diversi nel tentativo di costringere il modello a fare “veramente, assolutamente, sempre” qualcosa, la risposta è solitamente una chiamata di strumento (tool call) o un guardrail a livello di codice — non un prompt più perentorio. Quindi lascia perdere, rimuovi i prompt extra che hai aggiunto e contattaci sul Forum 3CX.

La differenza del tempo reale

Quando si crea un prompt per un modello audio in tempo reale, c’è un livello aggiuntivo: il parlato non è testo. OpenAI pubblica una Guida al Prompting in Tempo Reale che è una lettura essenziale. La versione breve:

• Mantieni le frasi brevi. Le frasi parlate lette ad alta voce al ritmo del modello devono concludersi in un solo respiro.
• Digli come deve suonare, non solo cosa dire. “Professionale, composto, calmo, conciso” svolge un lavoro reale. Lo stesso vale per “nessuna spiegazione di instradamento”.
• Gestisci esplicitamente le situazioni confuse. Rumore di fondo, parole parziali, interruzioni, il chiamante che dice “uh, sì, scusa — continua”. Se non dici al modello come reagire, indovinerà, e l’ipotesi di solito è errata.
• Un’istruzione per riga. I modelli vocali seguono le istruzioni separate da interruzioni di riga in modo più affidabile rispetto alle proposizioni subordinate incorporate.

A prompt vocale tollera la prosa ancora meno di un prompt testuale. Ogni parola extra è un token che il modello avrebbe potuto dedicare all’ascolto.

Suggerimenti per i prompt engineer alle prime armi

Se è la prima volta che modificate un prompt di sistema 3CX, alcune abitudini pratiche vi faranno risparmiare ore di lavoro:

Parti dal prompt predefinito. Non iniziare da zero. I valori predefiniti di 3CX sono stati testati e approvati per funzionare con i modelli OpenAI Realtime. Quasi mai vorrete sostituirli: vorrete arricchirli. Aggiungete una sezione. Forzane (override) un comportamento specifico. Lascia il resto.

Modificate una cosa alla volta. Se modificate cinque sezioni e l’agente inizia a comportarsi in modo strano, non avrete idea di quale modifica abbia causato il problema. Apportate una modifica, testatela su chiamate reali o sul link Talk, quindi passate alla successiva.

Effettate i test con chiamate realistiche, non con quelle ideali. Chiunque può seguire un copione. Fare i test con chiamanti che interrompono, cambiano idea a metà frase, bofogliano un nome o chiedono tre cose contemporaneamente. È lì che si vede davvero la qualità del prompt.

Leggete il prompt ad alta voce. Seriamente. Se una sezione è faticosa da leggere ad alta voce, lo sarà anche per il modello. Le sezioni ricche di prosa saltano subito all’orecchio quando devi pronunciarle davvero.

Il budget dei token è reale. I prompt più grandi non solo costano di più, ma riducono lo spazio disponibile per la conversazione stessa. Se il vostro prompt è più lungo di quanto duri solitamente la chiamata, c’è qualcosa che non va.

Non dite al modello di “essere d’aiuto” o “essere educato”. Lo è già. Queste istruzioni non aggiungono altro che lunghezza. Indicategli lo specifico comportamento utile o educato che desideri — “riconosci la frustrazione del chiamante una volta prima di procedere alla risoluzione dei problemi” — e saltate l’aggettivo.

In caso di dubbio, cancellate. Un prompt più breve è quasi sempre un prompt migliore. Se puoi rimuovere una riga e l’agente si comporta comunque correttamente, quella riga vi stava costando contesto per niente.

La checklist pre-salvataggio

Prima di salvare un prompt, verificatelo con questa checklist:

1. Ogni regola si trova in un solo posto? Nessuna ripetizione, nessun quasi-duplicato.
2. Le istruzioni sono positive ove possibile? “Fai X” è meglio di “Non fare Y, Z o W”.
3. Ci sono due regole che potrebbero applicarsi alla stessa situazione ed essere in disaccordo? Risolvete il problema ora, non in produzione.
4. State definendo qualcosa che il modello comprende già? Cancellatelo.
5. Ogni frase cambia ciò che fa il modello? In caso contrario, cancellatela.
6. Lo avete convertito in token? Passatelo nel Tokenizer e controllate la dimensione effettiva.
7. Avete fatto un test con una chiamata confusa? Non solo con una lineare.

Documenti della Knowledge base

Sebbene non siano strettamente un “prompt”, i documenti della knowledge base vanno di pari passo con il vostro prompt per dare a un Agente IA la sua personalità e la sua, per l’appunto, conoscenza.

Assicuratevi che i documenti della vostra knowledge base siano il più chiari e concisi possibile affinché il vostro Agente IA possa lavorarci al meglio. Lo standard di riferimento per questo è il Markdown, e la conversione della base documentale già esistente può essere gestita a livello di codice. Il progetto MarkItDown di Microsoft è uno strumento che puoi utilizzare.

Usare l’IA per correggere la vostra IA

Ecco un trucco che vale la pena conoscere.

Questo post del blog — e la Guida al Prompting in Tempo Reale di OpenAI — sono entrambi scritti in prosa semplice. Ciò significa che potete salvare l’uno o l’altro come file markdown, prompt-engineering.md, e caricarlo nella knowledge base del tuo agente IA come competenza (skill).

Scaricate il file realtime-prompting.skill e installatelo nella vostra IA: di solito si tratta di una semplice procedura di trascinamento della selezione (drag-and-drop).

Una volta inserito, l’agente eredita la guida come competenza. Potete incollare la vostra bozza di prompt di sistema in una chat con quell’agente e chiedere:

“Verifica questo prompt di sistema rispetto alla mia competenza di prompt engineering. Segnala contraddizioni, ripetizioni, istruzioni in stile prosa e definizioni non necessarie. Suggerisci una versione più concisa.”

E l’IA analizzerà criticamente il tuo prompt con l’intelligenza della competenza che ha alle spalle, trovando il tipo di problemi che abbiamo descritto sopra, con esempi specifici per il tuo prompt.

State usando l’IA per correggere il prompt di sistema di un’altra IA. Questo è attualmente uno dei flussi di lavoro a più alto rendimento nel prompt engineering e non costa nulla configurarlo.

La versione breve

Scrivete istruzioni, non prosa. Esprimete ogni regola una sola volta. Preferisci il positivo al negativo. Attenzione alle contraddizioni. Usa il Tokenizer. Effettuate i test con chiamate confuse. Cancellatr più di quanto aggiungi.

Il vostro agente vi ringrazierà, lasciando spazio nella finestra di contesto per svolgere effettivamente il suo lavoro.

State modificando un prompt di un Agente IA 3CX? Partite da quello predefinito, cambiate una cosa alla volta e fate i test con chiamate reali. Se volete approfondire, la Guida al Prompting in Tempo Reale di OpenAI è la migliore risorsa tecnica disponibile in questo momento.

Forum 3CX

Unitevi alla discussione 3CX nei nostri forum dedicati ai Partner o ai Clienti. Seguiteci su X e LinkedIn per rimanere aggiornati sulle ultime novità e sui rilasci di funzionalità.