Istruzioni dell'agente
Le istruzioni, o prompt di sistema, sono il testo in linguaggio naturale che definisce come un agente si comporta: tono di voce, competenze, limiti e formato delle risposte. Sono obbligatorie per pubblicare l'agente: solo un agente in Bozza può averle vuote.
Prerequisiti
- Un agente esistente e il permesso di modificarlo.
- Per riutilizzare testi comuni, uno o più template in stato Attivo nella Libreria prompt (vedere Template Prompt).
Scrivere le istruzioni
Le istruzioni si scrivono nella sezione Istruzioni della pagina dell'agente, che è già espansa all'apertura. L'editor offre una formattazione di base (grassetto, corsivo, stile del testo con i titoli, elenchi numerati e puntati, link e blocchi di codice) utile a rendere le istruzioni più leggibili e facili da mantenere. Come per il resto della configurazione, il testo si salva automaticamente.
Sotto l'editor, il collegamento Variabili disponibili mostra i segnaposto utilizzabili tra doppie graffe, come {{nome_cliente}}, che vengono sostituiti a ogni conversazione con i valori forniti dal canale (vedere Variabili del prompt).
La variabile {{detected_language}} riporta la lingua rilevata nella conversazione e consente di chiedere all'agente di rispondere nella lingua dell'utente. Viene valorizzata automaticamente nel canale voce; negli altri canali va fornita dal canale che avvia la conversazione.
Inserire un template con «@»
I template della Libreria prompt si inseriscono nelle istruzioni senza doverli riscrivere:
- Nel testo delle istruzioni, digitare
@all'inizio di una riga o dopo uno spazio. - Nel menu che si apre compaiono i template in stato Attivo, con nome e descrizione. Continuando a digitare dopo
@, l'elenco si restringe ai template il cui nome o la cui descrizione contiene il testo scritto. - Selezionare il template: il suo contenuto prende il posto di
@e del testo digitato. Il tastoEscchiude il menu senza inserire nulla.
Se nessun template attivo corrisponde, il menu mostra Nessun prompt template trovato.
L'inserimento copia il contenuto del template nel punto del cursore: le modifiche successive al template nella Libreria prompt non aggiornano le istruzioni degli agenti in cui è già stato inserito. Anche i segnaposto a graffa singola del template, come {settore}, vengono copiati così come sono e non sono sostituiti durante la conversazione: vanno sostituiti a mano con il testo definitivo, oppure trasformati in variabili a doppia graffa se il valore deve arrivare dal canale (vedere Variabili del prompt).
Buone pratiche
Strutturare le istruzioni in blocchi riconoscibili (ruolo, tono, cose da fare, cose da evitare, formato della risposta) rende il testo più facile da rivedere nel tempo, anche confrontando versioni diverse. Quando il comportamento desiderato è specifico, conviene includere esempi concreti di domande e risposte attese.
È bene evitare istruzioni ridondanti o in contraddizione tra loro, perché il modello non risolve i conflitti in modo prevedibile. Infine, le istruzioni servono a definire il comportamento, mentre i contenuti su cui rispondere vanno nelle basi di conoscenza collegate all'agente.
Problemi comuni
| Problema | Causa probabile | Soluzione |
|---|---|---|
| Il passaggio ad Attivo viene rifiutato | Istruzioni vuote | Compilare le istruzioni prima di cambiare stato |
| Il menu «@» non propone template | Nessun template in stato Attivo | Attivare o creare un template in Template Prompt |
Nelle risposte compare un segnaposto come {settore} | Segnaposto di un template inserito e non sostituito | Sostituirlo a mano nelle istruzioni |
| Le modifiche a un template non si riflettono sull'agente | Il contenuto è stato copiato al momento dell'inserimento | Reinserire il template aggiornato |
| L'agente ignora parte delle istruzioni | Testo troppo lungo o con indicazioni in conflitto | Semplificare ed eliminare le ripetizioni |