For the complete documentation index, see llms.txt. This page is also available as Markdown.

Come scrivere istruzioni efficaci

Le istruzioni sono come una "guida al comportamento" per il tuo Agente: spieghi chi è, cosa dovrebbe fare e come dovrebbe interagire con gli utenti. Scrivere buone istruzioni è essenziale per avere un Agente che risponda in modo preciso e pertinente.

Cosa insegnare al tuo Agente

Quando scrivi le istruzioni, pensa di dover inserire un nuovo dipendente: devi coprire questi aspetti:

  • Chi è: qual è il suo ruolo? È un Agente del supporto clienti, un esperto di marketing, un tutor;

  • Con chi parla: chi sono i suoi utenti? Cosa cercano di ottenere;

  • Cosa sa: quali sono le sue aree di competenza? Di quali argomenti può parlare;

  • Come comunicare: dovrebbe essere formale o informale? Tecnico o semplice;

  • Cosa non dovrebbe fare: ci sono argomenti da evitare o informazioni da non condividere.

Come scrivere istruzioni efficaci

Struttura logicamente le tue istruzioni

  • Crea sezioni chiare e ben definite (ad es. ruolo, competenze, limiti);

  • Usa una chiara gerarchia delle informazioni;

  • Includi esempi concreti per i concetti chiave;

  • Mantieni una formattazione coerente.

Fornisci un contesto

  • Specifica chiaramente l'ambito operativo e i confini dell'Agente;

  • Definisci il background necessario per comprendere le richieste;

  • Indica quando e come utilizzare informazioni specifiche;

  • Includi regole per filtrare contenuti inappropriati;

  • Specifica come gestire richieste ambigue o fuori ambito.

Domande e risposte

  • Definisci il formato atteso delle richieste degli utenti → domande brevi, estratti di articoli o altro;

  • Specifica la struttura desiderata delle risposte;

  • Indica come gestire input incompleti o non chiari;

  • Stabilisci regole per la formattazione delle risposte.

Chiarezza e concisione

  • Usa un linguaggio diretto e preciso;

  • Evita informazioni superflue o ambigue;

  • Concentrati sugli elementi essenziali;

  • Utilizza termini specifici invece di termini generici;

  • Definisci chiaramente gli eventuali termini tecnici.

Le istruzioni funzionano meglio se scritte in inglese. Se il tuo Agente non segue precisamente le istruzioni, prova a tradurle!

Supporto

Se hai bisogno di aiuto per scrivere le istruzioni, puoi sempre chiedere Manuela: raccontale la tua idea e lascia che l'Agente ti guidi.

Come ottimizzare e mantenere le istruzioni

Monitoraggio e analisi

  • Verifica regolarmente l'aderenza alle istruzioni;

  • Identifica modelli di risposte non ottimali;

  • Analizza i casi di escalation o errore;

  • Raccogli le metriche sulle prestazioni.

Ottimizzazione e aggiornamenti

  • Aggiorna le istruzioni in base ai feedback;

  • Migliora la gestione dei casi limite che hai identificato;

  • Documenta le modifiche che apporti.

Ultimo aggiornamento