Scrivi le istruzioni per il tuo agente AI

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:

1. Start from a template sostituisce il testo sottostante con il template scelto.
2. Instructions contiene il testo vero e proprio. Servono almeno 100 caratteri; fino ad allora il contatore mostra quanti ne mancano.
3. 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. Se deve usare sempre una sola lingua, scrivilo.

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.

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.

1. Modifica le istruzioni o i guardrail nella scheda Setup.
2. Apri il Playground e fai domande reali dei visitatori, comprese quelle che l'agente deve rifiutare e quelle che i tuoi contenuti non coprono.
3. Clicca su Reset per iniziare una nuova conversazione dopo ogni modifica.
4. 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.

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.