> 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/istruzione-gestione-contenuti-agenti/istruzione-sezione-avanzata/personalizzazione-dei-contenuti/contesto-argomenti-ed-etichette.md).

# Contesto: argomenti ed etichette

AIsuru ti consente di creare conversazioni dinamiche e consapevoli del contesto tramite l'uso del contesto. Questa funzionalità ti permette di controllare quando determinate domande sono appropriate e come l'Agente deve interpretare e rispondere alle richieste degli utenti in base al contesto della conversazione.

### Contesto: cos'è e a cosa serve

La gestione del contesto ti consente di definire in quali situazioni specifiche una domanda o una risposta hanno senso.

Il contesto comunica ad AIsuru di cosa si sta parlando in un dato momento, il che è necessario per guidare efficacemente la conversazione, consentendo l'accesso a determinati [contenuti](/istruzione-gestione-contenuti-agenti/contenuti.md) e limitando la visibilità di altri.

#### Argomenti ed etichette

Il contesto in AIsuru viene gestito tramite due tipi di elementi:

* **Argomenti:** coppie nome-valore che definiscono un contesto specifico;

  * Il nome identifica il tipo di contesto (ANIMAL, OBJECT, ecc.);
  * Il valore specifica il contesto attuale (DOG, SMARTPHONE, ecc.).

  Esempio: ANIMAL:DOG
* **Etichette:** contesti semplici:
  * Il nome identifica l'argomento di cui si sta parlando (ad es., GENERAL\_QUESTIONS);
  * Le etichette sono in realtà argomenti con "✔️" come valore nascosto.

### Contesto impostato e contesto richiesto

Gli argomenti e le etichette possono essere utilizzati in due modi diversi che influenzano il modo in cui l'Agente gestisce i contenuti:

* **Imposta contesto** ("Imposta argomenti" nella piattaforma):
  * Indica all'Agente di cosa si sta parlando in questo momento;
  * Aiuta l'Agente a dare priorità ai contenuti più rilevanti per il contesto attuale;
  * NON limita l'accesso ai contenuti, ma li organizza in base alla rilevanza;
  * Esempio:
    * Domanda: "Parliamo di cani";
    * Risposta: "Certo, parliamo di cani" \[imposta argomento:`ANIMAL:DOG`]
    * Dopo questo, l'Agente saprà che la conversazione riguarda i cani e potrà fornire risposte più rilevanti.
* **Contesto richiesto** ("Argomenti richiesti" nella piattaforma):
  * Agisce come un vero filtro che blocca l'accesso dell'Agente a determinati contenuti finché non viene impostato un contesto specifico;
  * L'IA può accedere a questi contenuti solo QUANDO quel contesto specifico è attivo;
  * Se non imposti alcun argomento richiesto, l'Agente avrà sempre accesso ai tuoi contenuti indipendentemente dal contesto attuale;
  * Esempi:
    * `ANIMAL:DOG`: la domanda è rilevante solo quando si parla di cani;
    * `OBJECT:WAND`: la domanda è appropriata solo nel contesto di una bacchetta.

La differenza fondamentale tra i due tipi di contesto è:

* **Il contesto impostato aiuta l'Agente a comprendere meglio la conversazione** e a dare priorità ai contenuti più rilevanti;
* **Il contesto obbligatorio blocca completamente l'accesso ai contenuti** finché non viene impostato quel contesto specifico;

{% hint style="info" %} <mark style="color:blue;">Una volta impostato un contesto specifico, i contenuti con quel contesto obbligatorio possono essere passati anche all'IA generativa per rispondere alle domande degli utenti.</mark>
{% endhint %}

### Come gestire il contesto nei tuoi contenuti

#### Aggiungi un contesto

Per aggiungere un contesto ai tuoi contenuti:

1. Vai a **Contenuti** e creane uno o modificane uno esistente;
2. Vai alla sezione "Avanzate: gestione del contesto";
3. Scegli se aggiungere un argomento impostato (in "Argomenti impostati") o uno obbligatorio (in "Argomenti obbligatori");
4. Scegli tra "Nuovo argomento" e "Nuova etichetta" in base alle tue esigenze;
5. Compila il nome e il valore (se applicabile) nel pannello che si apre;
6. Conferma e salva il contenuto.

{% hint style="info" %} <mark style="color:blue;">Puoi anche utilizzare "Suggerisci etichette" per ricevere suggerimenti basati sul contenuto.</mark>
{% endhint %}

#### Annulla un contesto

Per annullare un contesto, aggiungi un argomento con lo stesso nome e **inserisci "-" come valore**.

Esempio: `ANIMAL:-` annullerà il contesto "ANIMAL", che non sarà più impostato e non avrà alcun valore.

### Esempi pratici

#### Scenario: assistente per un negozio di animali

1. L'Agente chiede all'utente: "A quale tipo di animale sei interessato?";
2. Utente: "Cani", argomento impostato:`ANIMAL:DOG`
3. Argomento obbligatorio: domanda: "Quali sono le esigenze alimentari specifiche?", argomento obbligatorio:`ANIMAL:DOG`
4. Annullamento di un contesto: domanda: "Vorrei parlare di un animale diverso", argomento impostato:.`ANIMAL:-`

#### Flusso della conversazione

1. Utente: "Vorrei informazioni sugli animali domestici";
2. Agente: "Certo! Che tipo di animale ti interessa?";
3. Utente: "Cani";
4. Agente: (imposta `ANIMAL:DOG`) "Ottimo! I cani sono animali meravigliosi. Cosa vorresti sapere sui cani?";
5. Utente: "Quali sono le loro esigenze alimentari?";
6. Agente: (verifica `ANIMAL:DOG`, domanda pertinente) "I cani hanno bisogno di una dieta equilibrata. In generale, necessitano di proteine di alta qualità, carboidrati, grassi, vitamine e minerali. La quantità e il tipo di cibo dipendono dall'età, dalla taglia e dal livello di attività del cane...";
7. Utente: "Vorrei parlare di un altro animale";
8. Agente: (imposta `ANIMAL:-`) "Certo! Di quale altro animale vorresti parlare?".

{% hint style="info" %} <mark style="color:blue;">Per ragioni di sicurezza,</mark> <mark style="color:blue;">**l'**</mark> [<mark style="color:blue;">**IA generativa**</mark>](/ai-generativa.md) <mark style="color:blue;">**non può leggere né applicare i contesti in autonomia**</mark><mark style="color:blue;">. Questo compito viene svolto da AIsuru.</mark>
{% endhint %}

### Vantaggi dell'uso dei contesti

* Conversazioni più naturali e coerenti;
* Risposte più pertinenti e precise;
* La possibilità di creare percorsi di dialogo complessi e ramificati;
* Migliore gestione di più argomenti all'interno della stessa conversazione.

L'utilizzo efficace di contesti e variabili di contesto può trasformare il tuo Agente in un assistente davvero intelligente e consapevole del contesto. Sperimenta queste funzionalità per creare esperienze conversazionali ricche e dinamiche che si adattano alle esigenze e agli interessi specifici dei tuoi utenti.