Codice del widget chat con istruzioni private: come scrivere un prompt di sistema efficace

Due widget chat possono condividere la stessa riga di codice e comportarsi in modo completamente diverso. A fare la differenza sono le istruzioni private, spesso chiamate prompt di sistema. Sono salvate sul server insieme al widget, inviate con ogni conversazione e mai mostrate ai visitatori.

Dove si trovano le istruzioni

Apri un widget chat in Widget e scorri fino a Comportamento. Il campo delle istruzioni accetta fino a 4.000 caratteri. Poiché resta sul server, un visitatore che ispeziona la tua pagina vede solo l'id del widget nel tag script:

<script src="https://api14.com/widget.js" data-widget="YOUR_WIDGET_ID" async></script>

Le modifiche alle istruzioni valgono dal messaggio successivo. Non devi mai aggiornare il codice sul tuo sito.

Una struttura che funziona

Delle buone istruzioni rispondono a quattro domande per il modello.

1. Chi sei? "Sei l'assistente di Northwind, un negozio online di attrezzatura outdoor."
2. Che cosa sai? Incolla le informazioni che contano: tempi di spedizione, regole per i resi, orari di apertura, linee di prodotto. Il modello può essere preciso solo quanto le informazioni che gli fornisci.
3. Che cosa devi evitare? "Non promettere sconti. Non dare consigli medici o legali. Se non sei sicuro, dillo e rimanda alla pagina dei contatti."
4. Che tono devi avere? "Rispondi con due o tre frasi brevi. Usa la lingua del visitatore."

Mantieni ogni regola breve e concreta. Per un modello, paragrafi lunghi e vaghi sono più difficili da seguire di un elenco breve.

Mettile alla prova come un visitatore

L'anteprima dell'editor invia richieste reali con le istruzioni non ancora salvate, così puoi fare prove rapide:

• Fai le cinque domande che arrivano più spesso alla tua casella di supporto.
• Chiedi qualcosa che le istruzioni non coprono e controlla che il widget ammetta di non saperlo.
• Prova a fargli infrangere una regola, per esempio chiedendo un codice sconto.

Modifica le istruzioni dopo ogni giro. Piccoli cambiamenti di formulazione risolvono spesso la maggior parte dei problemi.

Mantieni coerente il brand

Il widget chat è white label: niente logo e nessuna riga "powered by". Imposta con parole tue il titolo, il messaggio di benvenuto, il testo segnaposto, il testo del pulsante e il messaggio di errore, poi adatta colore di accento, raggio degli angoli e tema al tuo sito. I testi lasciati vuoti usano i valori predefiniti nella lingua del tuo account.

Abbina le istruzioni ai limiti

Le istruzioni modellano le risposte, ma non sono un budget. Imposta un limite alla lunghezza delle risposte (numero massimo di token) perché restino brevi, e scegli la chiave API con cui funziona il widget. Il limite di spesa giornaliero e i modelli consentiti di quella chiave valgono per ogni richiesta dei visitatori, e ti danno una seconda rete di sicurezza indipendente.

Inizia con una bozza nella pagina dei widget, poi perfezionala nella tua dashboard.