> 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/contenuti/creazione-manuale-dei-contenuti.md).

# Creazione manuale di contenuti

Ora che hai visto cosa sono i contenuti e perché sono utili, puoi dare un'occhiata a come crearli. Prima di tutto, è importante esaminare **la struttura di un contenuto,** quali campi contiene e a cosa servono.

### Struttura di un contenuto

Un contenuto in AIsuru è organizzato in sezioni chiaramente etichettate nell'interfaccia:

* **Domanda** (testo, obbligatorio): la domanda principale che attiverà questo contenuto;
* **Varianti di domanda** (testo multiplo): altri modi di formulare la stessa domanda per migliorare il riconoscimento;
* **Risposte** (testo, obbligatorio): la risposta principale e tutte le risposte alternative;
* **Assegnato a** (menu a tendina): controlla chi può visualizzare il contenuto ("Pubblico" o ruoli specifici);
* **Non casuale** (casella di controllo): esclude la domanda dall'essere suggerita durante l'inattività dell'utente;
* **Luogo e data** (pulsanti): limita la visibilità in base all'area geografica o al periodo di tempo;
* **Media** (area di caricamento): spazio per allegare immagini, video o PDF;
* **Link** (area di inserimento): aggiunge URL esterni alla risposta;
* **Avanzate** (sezioni espandibili): suggerimenti, tag, variabili di contesto, snippet eseguibili, timeout e integrazione DCM.

### Come creare un contenuto semplice

1. Vai al pannello di gestione del tuo Agente;
2. Fai clic su **Contenuti** nella barra laterale;
3. Fai clic sul pulsante "**Nuovo contenuto**";
4. Compila i campi richiesti:
   1. **Domanda**: inserisci la domanda a cui il tuo Agente dovrà rispondere;
   2. **Risposta**: inserisci la risposta che il tuo Agente dovrà dare (includi tutte le informazioni necessarie).

Ecco fatto! Fai clic su "Conferma" in basso a destra per salvare il tuo contenuto.

### Altre impostazioni

Ci sono altre impostazioni che possono tornare utili in diversi scenari.

#### Varianti di domanda

In questa sezione, che si trova subito sotto la domanda, puoi aggiungere varianti di domanda, ovvero:

* **Altri modi di formulare la stessa domanda:** *"come si chiama il cane?"* come domanda e *"come si chiama il cane?"* come variante;
* **Altre domande che hanno la stessa risposta:** *"Dove devo andare per rinnovare la carta d'identità?"* e *"Dove devo andare per rinnovare la carta d'identità a Roma?"* come variante di domanda.

{% hint style="info" %} <mark style="color:blue;">Le varianti di domanda aiutano</mark> <mark style="color:blue;">**AIsuru a trovare facilmente i contenuti più rilevanti**</mark> <mark style="color:blue;">con cui rispondere.</mark>
{% endhint %}

Non ti vengono in mente varianti di domanda? Lasciati aiutare da AIsuru: fai clic sul pulsante "**Suggerisci varianti**" e AIsuru genererà varianti di domanda in base alla risposta del contenuto, che deve già essere compilata.

#### Risposte aggiuntive

In questa sezione, che si trova subito sotto il campo "Risposta", puoi aggiungere risposte alternative per la stessa domanda.

Questo ti consente di avere "varianti di risposta" per ogni domanda. Ad esempio:

* Domanda: *"Qual è la capitale d'Italia?";*
* Risposta: *"Roma";*
* Risposta aggiuntiva: *"La capitale d'Italia è Roma";*
* Risposta aggiuntiva: *"La capitale è Roma".*

Se un utente chiede al tuo Agente *"Qual è la capitale d'Italia?"*, potrebbe ricevere una qualsiasi di queste risposte: *"Roma"*, *"La capitale d'Italia è Roma"*, oppure *"La capitale è Roma".*

{% hint style="info" %} <mark style="color:blue;">Aggiungi risposte aggiuntive se non fai ampio affidamento sull'IA generativa ma vuoi comunque</mark> <mark style="color:blue;">**ridurre la ripetitività e rendere più naturali le interazioni del tuo Agente**</mark><mark style="color:blue;">.</mark>
{% endhint %}

Proprio come per le varianti di domanda, puoi anche lasciare che l'IA suggerisca risposte aggiuntive: fai clic sul pulsante **Suggerisci risposta** e AIsuru genererà una risposta in base alla domanda, che deve essere già compilata.

#### Media e link

Puoi aggiungere media e link ai tuoi contenuti:

* **Media:** immagini, video e documenti PDF;
* **Link:** aggiungi un URL e personalizza il nome della pagina.

{% hint style="info" %} <mark style="color:blue;">I media e i link arricchiscono le risposte dell'Agente, consentendogli di mostrare immagini o fornire risorse aggiuntive durante la conversazione.</mark>
{% endhint %}

Se un utente chiede *"Qual è la capitale italiana?"*, AIsuru risponderà *"Roma"* (o una variante) e allegherà l'immagine che hai aggiunto alla risposta.

Il modello linguistico può scegliere o meno di mostrare media e link quando risponde agli utenti. Puoi modificare questo comportamento nelle [altre impostazioni dell'IA generativa](/ai-generativa/ia-generativa-sezione-avanzata/altre-impostazioni-dellia-generativa.md).

#### Altri campi

Sotto il campo "Assegnato a", troverai tre opzioni importanti che influenzano il comportamento del contenuto:

1. **Non casuale**: se selezionata, impedisce che la domanda venga suggerita casualmente quando un utente rimane inattivo troppo a lungo. Utile per contenuti che non avrebbero senso come suggerimenti casuali.

{% hint style="info" %}
Se vuoi che il tuo Agente ponga agli utenti domande "casuali", puoi attivare l'interruttore "Suggerisci domande se l'utente è inattivo" in Impostazioni > Generali > Impostazioni avanzate. Per saperne di più, leggi [come utilizzare il timeout](/istruzione-gestione-contenuti-agenti/istruzione-sezione-avanzata/personalizzazione-dei-contenuti/utilizzo-del-timeout.md).
{% endhint %}

#### Impostazioni avanzate

Per impostazioni più complesse, vai alla pagina dedicata alla [personalizzazione dei contenuti](/istruzione-gestione-contenuti-agenti/istruzione-sezione-avanzata/personalizzazione-dei-contenuti.md): qui scoprirai come personalizzare le risposte in base al ruolo, alla data o alla posizione, come eseguire [snippet](/istruzione-gestione-contenuti-agenti/istruzione-sezione-avanzata/personalizzazione-dei-contenuti/gestione-dei-testi-preformattati-snippet-di-codice.md)[ di](/istruzione-gestione-contenuti-agenti/istruzione-sezione-avanzata/personalizzazione-dei-contenuti/gestione-dei-testi-preformattati-snippet-di-codice.md)[ codice eseguibili](/istruzione-gestione-contenuti-agenti/istruzione-sezione-avanzata/personalizzazione-dei-contenuti/gestione-dei-testi-preformattati-snippet-di-codice.md) e molto altro!