> For the complete documentation index, see [llms.txt](https://docs.aisuru.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aisuru.com/ai-generativa/prompt-engineering/come-scrivere-istruzioni-efficaci.md).

# 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.

{% hint style="danger" %} <mark style="color:red;">**ATTENZIONE**</mark><mark style="color:red;">: non includere mai informazioni riservate nelle Istruzioni IA. Inserisci invece tali informazioni all'interno di contenuti specifici</mark> [assegnati a un Ruolo](/istruzione-gestione-contenuti-agenti/istruzione-sezione-avanzata/personalizzazione-dei-contenuti/come-attribuire-contenuti-a-ruoli-specifici.md) <mark style="color:red;">o con un</mark> [contesto richiesto](/istruzione-gestione-contenuti-agenti/istruzione-sezione-avanzata/personalizzazione-dei-contenuti/contesto-argomenti-ed-etichette.md#required-topics)<mark style="color:red;">.</mark>
{% endhint %}

### 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](https://www.aisuru.com/it/memoridev/Manuela/54ac7607-6905-4a0d-9f50-5ec178e846a3): 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 pattern di risposte non ottimali;
* Analizza i casi di escalation o errore;
* Raccogli 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.