System prompt e istruzioni
Il system prompt è l'insieme di istruzioni in linguaggio naturale che definisce come un agente si comporta: tono di voce, competenze, limiti, formato delle risposte. È l'unico campo obbligatorio per poter attivare un agente.
Prerequisiti
- Un agente in stato Bozza o Attivo su cui intervenire.
- Se si vogliono riutilizzare istruzioni predefinite, uno o più Template Prompt già creati (vedere Template Prompt).
Scrivere il system prompt
Il system prompt si scrive nell'editor dedicato del dettaglio agente. È possibile inserire segnaposto {{nome_variabile}}: verranno proposti come campi da compilare all'utente prima dell'inizio della conversazione (vedere Variabili template nelle conversazioni).
Inserire {{detected_language}} nel system prompt fa sì che l'agente risponda nella lingua rilevata automaticamente nel messaggio dell'utente, anche quando la Knowledge Base collegata è in un'altra lingua.
Inserire Template Prompt con «@»
Mentre si scrive il system prompt, digitando @ si apre un menu con i Template Prompt disponibili sul tenant: selezionandone uno, il relativo contenuto viene inserito nel punto del cursore. È un meccanismo utile per riutilizzare blocchi di istruzioni comuni (policy aziendali, formati di risposta) senza doverli riscrivere per ogni agente.
I placeholder {variabile} dei Template Prompt e i placeholder {{variabile}} compilati in chat sono due meccanismi indipendenti, non intercambiabili: il primo viene risolto al momento dell'inserimento del template nel prompt, il secondo all'avvio della conversazione. Vedere Variabili template nelle conversazioni.
Ereditare il prompt dall'agente padre
Se l'agente ha un agente padre (impostato nelle informazioni generali, vedere Creare un agente), il system prompt effettivo che l'agente utilizza in conversazione è la concatenazione dei prompt non vuoti dell'intera catena, dalla radice fino all'agente stesso, separati da una riga vuota. Non è necessario ripetere nel figlio le istruzioni già presenti nel padre.
Il dettaglio dell'agente indica sempre Eredita da con il nome del padre, quando presente.
Buone pratiche
- Strutturare il prompt in sezioni (ruolo, tono, cosa fare, cosa evitare, formato della risposta) rende le istruzioni più facili da mantenere.
- Includere esempi concreti di domande e risposte attese quando il comportamento desiderato è specifico.
- Evitare istruzioni contraddittorie tra un padre e i suoi agenti figli: la concatenazione non risolve automaticamente i conflitti, l'ultima istruzione in ordine di lettura tende a prevalere nella pratica ma il comportamento non è garantito.
- Non duplicare nel prompt ciò che la Knowledge Base già copre: usare il prompt per il comportamento, la KB per i contenuti.
Problemi comuni
| Problema | Causa probabile | Soluzione |
|---|---|---|
| L'agente ignora parte delle istruzioni | Prompt troppo lungo o con istruzioni ridondanti tra padre e figlio | Semplificare, spostare le istruzioni comuni solo nel padre |
| Il menu «@» non propone template | Nessun Template Prompt attivo sul tenant | Creare un template in Template Prompt |
| L'agente non passa allo stato Attivo | System prompt vuoto | Compilare almeno un'istruzione minima prima di attivare |