# Come scrivere istruzioni efficaci

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

### Cosa insegnare al tuo Agente

Quando scrivi le istruzioni, pensa di dover spiegare a una persona appena assunta questi aspetti:

* **Chi è**: qual è il suo ruolo? È un assistente clienti, un esperto di marketing, un tutor?
* **Con chi parla**: chi sono i suoi utenti? Cosa vogliono ottenere?
* **Cosa sa fare**: quali sono le sue competenze? Di cosa può parlare?
* **Come parlare**: deve essere formale o informale? Tecnico o semplice?
* **Cosa non deve 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 condividere mai informazioni riservate all'interno delle istruzioni IA. Piuttosto, inserisci queste informazioni all'interno di specifici contenuti</mark> [assegnati ad 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 necessario](/istruzione-gestione-contenuti-agenti/istruzione-sezione-avanzata/personalizzazione-dei-contenuti/contesto-argomenti-ed-etichette.md#argomenti-necessari)<mark style="color:red;">.</mark>
{% endhint %}

### Come scrivere istruzioni efficaci

**Struttura logicamente le tue istruzioni**

* Crea sezioni logiche e ben definite (es. ruolo, competenze, limiti);
* Usa una gerarchia chiara delle informazioni;
* Inserisci esempi concreti per i concetti chiave;
* Mantieni coerenza nella formattazione.

**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 contesto.

#### Domande e risposte

* Definisci il formato atteso delle richieste degli utenti -> domande brevi, pezzi 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 generici;
* Definisci chiaramente i 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 nella scrittura delle istruzioni, utilizza il nostro [**Meta Prompt Engineer**](https://www.aisuru.com/it/memoridev/Meta%20Prompt%20Engineer): ti aiuterà a generare istruzioni appropriate basate sulle tue esigenze specifiche.&#x20;

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

#### **Ottimizzazione e aggiornamento**

* Aggiorna le istruzioni in base ai feedback;
* Migliora la gestione dei casi limite identificati;
* Documenta le modifiche eseguite.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aisuru.com/ai-generativa/prompt-engineering/come-scrivere-istruzioni-efficaci.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.