Vai al contenuto principale

​
Panoramica

Il campo Istruzioni (chiamato anche prompt di sistema) è dove definisci la personalità del tuo agente, lo stile conversazionale, gli obiettivi e le regole comportamentali. Questa è la configurazione più importante per il successo del tuo agente. Le istruzioni sono un blocco di testo inviato al modello IA ad ogni turno di conversazione. Dicono al modello:
  • Chi è (ruolo e identità)
  • Come comportarsi (tono, stile, limiti)
  • Cosa ottenere (obiettivi e mete)
  • Quando usare gli strumenti (azioni, conoscenza, trasferimenti)
La piattaforma fornisce automaticamente la cronologia delle conversazioni, i dati di contatto e il contenuto della base di conoscenza. Concentra le tue istruzioni su regole e linee guida che solo tu puoi fornire.

​
L’editor di istruzioni

L’editor di istruzioni include funzionalità utili per facilitare la scrittura delle istruzioni:

Editor di testo ampio

Editor spazioso per scrivere istruzioni dettagliate

Supporto Jinja

Template Jinja2 completi con variabili e condizionali

Template di prompt

Template predefiniti per casi d’uso comuni

Evidenziazione sintassi

Evidenziazione sintassi Jinja e rilevamento errori
Editor istruzioni agente che mostra area di testo con pulsanti Template e Guida alla scrittura, assistente variabili, contatore token e controlli di salvataggio
Editor istruzioni agente che mostra area di testo con pulsanti Template e Guida alla scrittura, assistente variabili, contatore token e controlli di salvataggio

​
Uso dei template di prompt

L’editor di istruzioni include una Libreria di prompt con template pronti all’uso:
  • Qualificazione lead - Vendite B2B con framework BANT
  • Prenotazione appuntamenti - Pianificazione servizi con conferme
  • Feedback clienti - Sondaggi NPS con workflow di recupero
  • Raccolta informazioni - Ricerca e raccolta dati
  • Outreach - Cold calling con approccio value-first
  • Specifici per settore - Sanità, immobiliare, servizi domestici e altro
Per usare un template:
  1. Clicca “Sfoglia template” nell’editor di istruzioni
  2. Seleziona un template che corrisponde al tuo caso d’uso
  3. Personalizza i segnaposto (company_name, service_type, ecc.)
  4. Testa e perfeziona in base alle tue esigenze specifiche
Libreria template di prompt che mostra i template disponibili in modalità chiara
I template seguono una struttura collaudata: Ruolo → Obiettivo → Flusso conversazione → Riferimento rapido. Inizia con un template e adattalo piuttosto che partire da zero.

​
Struttura base delle istruzioni

Ecco un template semplice per iniziare: 
Sei [NOME/RUOLO] per [NOME AZIENDA].

Il tuo ruolo:
- [Responsabilità principale]
- [Responsabilità secondaria]
- [Compiti aggiuntivi]

Tono: [Descrivi lo stile di comunicazione]

Linee guida importanti:
- [Regola chiave 1]
- [Regola chiave 2]
- [Regola chiave 3]

Quando [SITUAZIONE], devi [AZIONE].

​
Esempio: Agente di supporto clienti

Sei Alex, un agente di supporto clienti amichevole per Acme Software.

Il tuo ruolo:
- Rispondere alle domande dei clienti sui nostri prodotti e servizi
- Risolvere problemi tecnici comuni
- Fornire informazioni sull'account quando richiesto
- Escalare problemi complessi al supporto umano

Tono: Professionale ma caloroso, paziente e disponibile. Mantieni le risposte concise e chiare.

Linee guida importanti:
- Saluta sempre i clienti calorosamente e chiedi come puoi aiutare
- Non fare mai promesse su funzionalità o prezzi di cui non sei sicuro
- Se non sai qualcosa, ammettilo onestamente e offri di trasferire
- Conferma la comprensione prima di passare alle soluzioni
- Termina chiedendo se c'è altro con cui puoi aiutare

Quando un cliente menziona problemi di fatturazione, fornisci informazioni di base ma offri sempre di trasferire al reparto fatturazione per assistenza dettagliata.

​
Cosa l’agente già sa

La piattaforma fornisce automaticamente il seguente contesto al tuo agente ad ogni turno di conversazione. Non è necessario includerli nelle tue istruzioni:
La cronologia completa della conversazione tra l’agente e il contatto, inclusi tutti i messaggi e le chiamate agli strumenti.
Dati di contatto come nome, email e numero di telefono. Accessibili tramite variabili come {{ contact.first_name }}.
Quando rilevante, la piattaforma recupera e include automaticamente contenuto dalle tue basi di conoscenza.
La piattaforma dice all’agente quali azioni sono disponibili (trasferire, prenotare appuntamento, azioni API personalizzate). Devi solo spiegare quando usarle.
L’agente conosce automaticamente data, ora e fuso orario correnti.

​
Errori comuni

Mantieni le istruzioni sotto le 3000 parole. Istruzioni lunghe confondono il modello e rallentano i tempi di risposta.Soluzione: Concentrati su regole essenziali e flusso conversazionale. Sposta fatti e policy nelle basi di conoscenza.
“Sii disponibile” non fornisce una guida attuabile.Soluzione: Sii specifico. Invece scrivi: “Rispondi alle domande in meno di 30 secondi, fai una domanda chiarificatrice alla volta e conferma la comprensione prima di fornire soluzioni.”
Istruzioni in conflitto confondono l’agente.Soluzione: Rivedi attentamente per assicurarti che le linee guida non si contraddicano. Testa accuratamente.
Fatti, dettagli prodotti e policy appartengono alle basi di conoscenza, non alle istruzioni.Soluzione: Sposta tutto il contenuto fattuale nelle basi di conoscenza. Le istruzioni dovrebbero contenere solo regole comportamentali e guida conversazionale.
Condizionali profondamente annidati e logica Jinja complessa spesso falliscono.Soluzione: Mantieni la logica semplice e chiara. Usa semplici istruzioni if/then.Alternativa: Costruisci un team di agenti che possono trasferirsi l’un l’altro, ognuno con un compito dedicato e istruzioni più semplici.
Nomi di azioni non corrispondenti impediscono all’agente di usare correttamente le azioni.Soluzione: Fai sempre riferimento ai nomi esatti delle azioni dalla sezione Azioni. Copiali direttamente dall’interfaccia.

​
Prossimi passi

Guida all'ingegneria dei prompt

Tecniche avanzate per scrivere istruzioni efficaci

Messaggi di saluto

Configura come iniziano le conversazioni

Variabili e contenuto dinamico

Padroneggia i template Jinja e le variabili

Testa il tuo agente

Impara a testare il tuo agente efficacemente