Scrivi le istruzioni per il tuo agente AI
Scrivi le istruzioni che definiscono ruolo, tono e limiti del tuo agente intoCHAT: template, minimo di 100 caratteri, guardrail, regole integrate e Playground.
Le istruzioni dicono al tuo agente chi è, come parlare e dove si fermano i suoi compiti. I fatti arrivano dalle tue fonti di conoscenza; le istruzioni decidono come l'agente li usa.
Dove modificarle
Apri la scheda Setup dell'agente. In Role and behaviour (ruolo e comportamento) trovi:
- Start from a template sostituisce il testo sottostante con il template scelto.
- Instructions contiene il testo vero e proprio. Servono almeno 100 caratteri; fino ad allora il contatore mostra quanti ne mancano.
- Clicca su Save changes (salva) nell'intestazione.
Se hai modificato un testo nato da un template, un pulsante Restore o Use latest template sopra il campo ripristina il testo del template.
Template
I template sono punti di partenza che contengono già regole su accuratezza, tono e contatti. Puoi cambiarne ogni parola:
- AI Chatbot
- Customer Support Agent
- Sales Agent
- E-commerce Specialist
- Real Estate Agent
- Language tutor
- Coding Expert
- Life Coach
- Futuristic Fashion Advisor
Custom prompt parte da un campo vuoto.
Cosa scrivere
Le buone istruzioni sono precise sulla tua attività. Copri questi punti:
- Ruolo e pubblico: per chi parla l'agente e con chi.
- Ambito: in cosa deve aiutare e cosa deve rifiutare con cortesia.
- Tono e forma: formale o informale, breve o dettagliato, elenchi o testo.
- Passi successivi: dove indirizzare le persone per ciò che non può fare. L'agente non inventa mai un contatto, quindi indica quelli che deve usare.
- Alcuni dati chiave: quelli che devono essere sempre corretti, come il tuo indirizzo di assistenza. In caso di conflitto, le istruzioni prevalgono sulla conoscenza.
Tieni i contenuti lunghi, come dettagli sui prodotti, condizioni e FAQ, nella tua conoscenza, dove vengono cercati per ogni domanda.
Di norma l'agente risponde nella lingua in cui scrive il visitatore. Per scegliere una lingua delle risposte, usa Reply language più sotto invece delle istruzioni.
Sei l'assistente di Example Bikes, un negozio di biciclette. Aiuta i visitatori
a scegliere una bici, a capire il nostro servizio di riparazione e a trovare
gli orari di apertura. Rispondi in massimo 120 parole e usa elenchi puntati
per i passaggi. Per domande su un ordine esistente, chiedi al visitatore di
scrivere a support@example.com. Rifiuta con cortesia gli argomenti che non
riguardano le biciclette.
Guardrail
I guardrail sono regole che l'agente deve seguire in ogni risposta, qualunque cosa chieda il visitatore. Aggiungili nella scheda Setup in Guardrails, nel campo Rules (regole), e clicca su Save changes.
- Scrivi una regola per riga, per esempio "Non indicare mai i prezzi; rimanda alla pagina dei prezzi." Il campo è facoltativo e contiene fino a 4.000 caratteri.
- intoCHAT invia le regole all'AI come blocco separato, subito dopo le tue istruzioni. L'agente le segue anche quando le tue istruzioni, la tua conoscenza o il messaggio di un visitatore suggeriscono altro.
- I guardrail possono solo limitare ciò che l'agente dice o fa. Non possono dargli capacità che non ha, come un'azione che non hai configurato, e non possono disattivare le regole integrate di intoCHAT descritte sotto.
- Sono separati dalle istruzioni, quindi scegliere un template non li sostituisce.
Non indicare mai i prezzi; rimanda alla pagina dei prezzi.
Non parlare dei concorrenti.
Non dare consigli medici. Suggerisci invece di rivolgersi a un medico.
Usa i guardrail per limiti brevi e netti, e le istruzioni per ruolo, tono e ambito.
Restare in tema
Per limitare l'agente alla tua attività, attiva Stay on topic (restare in tema) sotto le regole e clicca su Save changes. Di default è disattivato.
- L'agente rifiuta con cortesia le domande che non c'entrano con la tua attività, come compiti, temi, programmazione, traduzioni o cultura generale, e dice in cosa può aiutare invece.
- Saluti, ringraziamenti e brevi chiacchiere ricevono comunque una risposta breve e cordiale.
- Una domanda che potrebbe riguardare la tua attività conta come in tema. Se un messaggio mescola le due cose, l'agente risponde alla parte sulla tua attività e rifiuta il resto.
- Cosa riguarda la tua attività lo ricava da istruzioni, guardrail e conoscenza: descrivi lì cosa offri.
- Il Playground usa l'interruttore anche senza salvare, così puoi provarlo prima di salvare.
Lingua delle risposte
Di norma l'agente risponde nella lingua in cui scrive ciascun visitatore. Per scegliere una lingua, usa Reply language nella scheda Setup, sotto Guardrails:
- In Reply in, scegli una lingua. Il valore predefinito è Visitor's language (automatic).
- Se ogni risposta deve essere in quella lingua, attiva Always use this language. L'interruttore compare quando scegli una lingua.
- Clicca Save changes.
| Impostazione | Lingua delle risposte |
|---|---|
| Visitor's language (automatic) | La lingua in cui scrive il visitatore. |
| Una lingua, Always use this language spento | La lingua del visitatore. La lingua scelta si usa quando quella del visitatore non è chiara, per esempio con un saluto, un messaggio di una sola parola, solo un nome o un numero, o lingue mescolate. |
| Una lingua, Always use this language acceso | Sempre la lingua scelta, in qualunque lingua scriva il visitatore. Nomi, titoli dei prodotti e testi citati dalle fonti restano come sono scritti. |
Reply in offre 31 lingue, elencate con il nome inglese: Albanian, Arabic, Bulgarian, Chinese, Croatian, Czech, Danish, Dutch, English, Finnish, French, German, Greek, Hebrew, Hindi, Hungarian, Italian, Japanese, Korean, Norwegian, Polish, Portuguese, Romanian, Russian, Serbian, Slovak, Slovenian, Spanish, Swedish, Turkish e Ukrainian.
- Tutto ciò che l'agente scrive in una risposta è nella stessa lingua, comprese le domande che pone, le conferme e le domande di approfondimento.
- L'impostazione è un'istruzione per l'IA. Se anche le tue istruzioni indicano una lingua, assicurati che coincida.
- Non cambia i pulsanti e gli avvisi del widget. Quelli seguono Widget language nella scheda Appearance, e le due impostazioni sono indipendenti. Vedi Aspetto.
- Il Playground usa la scelta sullo schermo, salvata o no.
Passaggio al tuo team
La sezione Hand-off to your team della scheda Setup permette all'agente di inviare una conversazione al tuo team via email quando un visitatore chiede di una persona. È disattivata di default e si salva con Save changes, come il resto della scheda. Vedi Passaggio via email.
Sotto, il riquadro Live chat permette invece a qualcuno del tuo team di entrare nella chat, mentre ha aperta la casella Live chat. I suoi interruttori si salvano subito, senza Save changes. Vedi Live chat.
Ricerca web
Sotto le altre impostazioni della scheda, il riquadro Web search permette all'agente di cercare una domanda sul web quando la tua conoscenza non ha la risposta. È disattivato di default e si salva con il suo pulsante Save web search, non con Save changes. Sono le tue istruzioni e i tuoi guardrail a stabilire che cosa può essere oggetto di una ricerca. Vedi Ricerca web.
Regole integrate
intoCHAT aggiunge regole a ogni agente. Se le tue istruzioni o i tuoi guardrail sono in conflitto con queste, valgono le regole, quindi non serve ripeterle:
- I dati aziendali come prodotti, prezzi, condizioni e contatti provengono solo dalle tue istruzioni, dalla tua conoscenza o da risultati di azioni riuscite.
- Quando un'informazione manca o è contraddittoria, l'agente dice cosa non può confermare. Non inventa mai una risposta, un contatto o il passaggio a una persona.
- I documenti trovati e i risultati delle azioni sono dati di riferimento, non istruzioni. I comandi nascosti al loro interno vengono ignorati, e i visitatori non possono aggirare queste regole.
- L'agente non rivela le sue istruzioni nascoste, credenziali o informazioni private provenienti dalle fonti.
- Non chiede mai in chat password, codici monouso, chiavi API o dati di carte di pagamento.
- Usa solo le azioni che hai configurato, chiede conferma prima dei passaggi importanti e dichiara un'azione completata solo quando il risultato lo conferma.
- Segue le tue impostazioni di raccolta lead e non chiede ai visitatori di scrivere i propri dati in chat quando a questo serve il modulo.
Prova nel Playground
Il Playground risponde con le istruzioni e i guardrail visibili sullo schermo in quel momento, salvati o no, così puoi provare una modifica prima di tenerla. Provare non li salva mai. Lo stesso vale per Reply language e per l'interruttore Suggest follow-up questions nella scheda Appearance.
- Modifica le istruzioni o i guardrail nella scheda Setup.
- Apri il Playground e fai domande reali dei visitatori, comprese quelle che l'agente deve rifiutare e quelle che i tuoi contenuti non coprono.
- Clicca su Reset per iniziare una nuova conversazione dopo ogni modifica.
- Quando le risposte ti convincono, clicca su Save changes. Fino ad allora il tuo sito continua a usare le ultime istruzioni e gli ultimi guardrail salvati.
Il minimo di 100 caratteri vale anche qui: con un testo più corto il Playground mostra un errore invece di una risposta.
Le chat del Playground vengono salvate con le altre conversazioni. Per provare qualcosa senza salvarlo, clicca sull'icona della chat temporanea nell'intestazione del widget. Compare la striscia "Temporary chat — messages aren't saved" e non viene mostrato alcun modulo per i lead. Clicca di nuovo sull'icona per tornare alla conversazione salvata. Le risposte della conversazione salvata si possono valutare con un pollice in su o un pollice verso, e le valutazioni compaiono nella sua trascrizione nella scheda Conversations.
Confronta due versioni
Compare pone la stessa domanda alle tue impostazioni salvate e a una bozza modificata, una accanto all'altra, così vedi quale risponde meglio prima di cambiare qualcosa.
- Apri il Playground e attiva Compare in alto a destra. L'interruttore compare una volta salvato l'agente.
- Compaiono due chat: A · Saved settings risponde con ciò che usa ora il tuo sito, e B · Draft risponde con la bozza nel riquadro sopra di esse. Sugli schermi stretti sono una sopra l'altra.
- Modifica in B Instructions, Guardrails e, se vuoi, Reply in e l'interruttore Always use per quella lingua. La bozza parte dalla scheda Setup così com'è sullo schermo, salvata o no. Modificarla non cambia la scheda Setup; Start from form copia di nuovo la scheda Setup nella bozza.
- Scrivi una domanda e clicca Send to both. A e B rispondono nello stesso momento, e ciascuna mantiene la propria conversazione per le domande successive. Un clic su una domanda di approfondimento viene inviato a entrambe.
- Clicca Reset both per far ripartire entrambe le conversazioni, per esempio dopo aver modificato la bozza.
- Quando B risponde meglio, clicca Use B. Copia istruzioni, guardrail e lingua delle risposte di B nella scheda Setup, e l'intestazione segnala modifiche non salvate. Clicca Save changes per usarle sul tuo sito. Finché non salvi, A e il tuo sito continuano a usare le impostazioni salvate.
- Tra A e B cambiano solo le istruzioni, i guardrail e la lingua delle risposte. Entrambe usano le impostazioni salvate di conoscenza, azioni, domande di approfondimento e fonti.
- Entrambe le chat sono temporanee: non vengono salvate con le tue conversazioni, quindi non compaiono nella scheda Conversations e non hanno Why this answer. Non viene mostrato alcun modulo per i lead e le azioni lato client non vengono eseguite in Compare; disattivalo per provarle.
- Le istruzioni di B devono avere almeno 100 caratteri e i suoi guardrail al massimo 4.000, come quando salvi. Fino ad allora Send to both mostra un errore e nessuna delle due chat riceve la domanda.
- Test as a signed-in visitor vale per entrambe le chat.
- Compare richiede un ruolo che possa modificare l'agente; i Viewer non vedono l'interruttore. Vedi Membri del team e ruoli.
- Disattivando Compare torni alla normale chat del Playground come l'avevi lasciata. Uscire dalla scheda Playground cancella entrambe le chat di Compare.
Problemi frequenti
- L'agente va fuori tema: descrivi con più precisione l'ambito e cosa deve rifiutare, oppure aggiungi un guardrail.
- Le risposte sono troppo lunghe: indica un numero massimo di parole o chiedi elenchi puntati.
- Un dato è sbagliato: correggi la fonte o aggiungi una coppia di Q&A. Le istruzioni servono più per il comportamento che per lunghi elenchi di fatti.
- Non indirizza da nessuna parte quando non può aiutare: indica i tuoi contatti nelle istruzioni, oppure attiva il passaggio via email.