> 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/primi-passi/creazione-del-primo-agente/come-creare-un-agente.md).

# Come creare un Agente

Creare un Agente su AIsuru è il primo passo per avere un assistente virtuale personalizzato. Questo processo ti consente di definire le caratteristiche fondamentali del tuo Agente, dalla sua identità alle sue capacità IA.

### Avvio del processo di creazione

Per iniziare:

1. Vai alla pagina principale di AIsuru;
2. Trova e fai clic sul pulsante "Crea" nella sezione "I tuoi Agenti".

### Configurazione dell'Agente

Una volta avviato il processo, vedrai un pannello suddiviso in quattro sezioni principali.

{% hint style="success" %}
**Tutte queste impostazioni, tranne la lingua, possono essere modificate dopo la creazione dell'Agente**. Non preoccuparti troppo se non sei sicuro di alcune delle tue scelte iniziali.
{% endhint %}

#### Sezione generale

Qui definirai l'identità e le caratteristiche di base del tuo Agente:

* **Nome**: scegli un nome rappresentativo;
* **Descrizione**: fornisci una breve presentazione dell'Agente;
* **Visibilità**:
  * Pubblico: accessibile a tutti, non richiede password;
  * Privato: richiede una password;
* **Lingua**: scegli la lingua principale;
* **Tipo di voce**: scegli tra una voce maschile o femminile.
* **Categorie:** puoi etichettare il tuo Agente in base all'argomento o allo scopo;
* **NSFW**: abilitalo solo se il tuo Agente gestisce contenuti per adulti. Una volta attivato, non può essere rimosso. Contattaci se è stato impostato per errore;
* **Risposta contestuale: r**endi il tuo agente capace di adattare le risposte in base al contesto:
  * **Posizione**: le risposte possono variare a seconda di dove si trova l'utente;
  * **Data e ora**: le risposte possono variare a seconda del giorno o dell'ora corrente;
  * **Accessibile solo agli utenti autenticati**: solo gli utenti che hanno effettuato l'accesso riceveranno risposte.
* **Impostazioni avanzate:**
  * **Chiedi feedback sulle risposte basate sui contenuti**: il tuo agente aggiungerà automaticamente una richiesta, ossia *"Ti è stato utile?"*, per raccogliere feedback e migliorare la corrispondenza dei contenuti;
  * **Disabilita la raccolta di contenuti IA**: impedisce all'agente di accumulare bozze e domande senza risposta;
  * **Suggerisci domande se l'utente è inattivo**: l'agente suggerisce proattivamente domande quando un utente smette di interagire;
  * **Consenti agli utenti di segnalare risposte errate**: gli utenti possono segnalare risposte non corrispondenti;
* **Soglia di confidenza:** controlla quanto l'agente deve essere sicuro prima di rispondere. Ciò garantisce risposte più accurate, ma aumenta il numero di volte in cui l'agente dice di non conoscere la risposta;
* **Badge: integrazione DCM:** collega il tuo agente alle integrazioni dei badge DCM.

**Nota**: se selezioni "Pubblico" durante la creazione, l'Agente apparirà automaticamente nella homepage. Puoi rimuoverlo dalla homepage disabilitando l'opzione pertinente nella sezione "Condividimi" del tuo Agente dopo averlo creato.

#### Sezione IA

Questa sezione ti consente di personalizzare le capacità dell'IA:

* **Meccanismo di risposta**:
  * **Prima i contenuti, poi l'IA** *(NLP + GenAI)*: l'Agente cerca prima una corrispondenza nei tuoi contenuti, poi usa l'IA se non trova nulla;
  * **Solo IA** *(GenAI)*: l'Agente usa sempre l'IA per generare risposte;
  * **Solo contenuti** *(NLP)*: l'Agente risponde solo utilizzando i contenuti che hai caricato, senza IA;
* **Scegli modello: s**eleziona quale modello IA alimenta il tuo Agente;
* **Istruzioni IA:** scrivi un prompt personalizzato per guidare il comportamento e le risposte del tuo Agente. Usalo per dare al tuo Agente una personalità, un ruolo o un contesto specifico;
* **Pensiero Profondo**: abilita questa funzionalità per una migliore comprensione del contesto;
* **Istruzioni per il Pensiero Profondo**: indica all'IA quali informazioni deve tenere traccia durante la conversazione;
* **Impostazioni avanzate**:
  * Configurazione per importazione/esportazione;
  * Configurazione del Pensiero Profondo *(disponibile solo se la funzionalità Pensiero Profondo è attiva);*
  * Numero massimo di token.
  * Temperatura.

{% hint style="warning" %}
La modifica di questi parametri può influire significativamente sulla qualità delle risposte.
{% endhint %}

#### Sezione Aspetto

In questa sezione puoi personalizzare l'aspetto visivo del tuo Agente caricando un'immagine di copertina e un avatar. Per farlo:

1. Vai alla sezione "Aspetto" del pannello di creazione dell'Agente;
2. Per l'immagine di copertina:
   * Fai clic su "Carica nuova copertina" e scegli l'immagine che desideri caricare;
3. Per l'avatar:
   * Fai clic su "Carica avatar" e seleziona la tua immagine;
4. Dopo aver caricato le immagini, assicurati di salvare le modifiche.

{% hint style="info" %}
I formati supportati sono.png,.jpg,.jpeg,.gif, con una dimensione massima del file di 2 MB.
{% endhint %}

### Sezione Estensioni

In questa sezione puoi scegliere quali estensioni abilitare per l'Agente che stai modificando. Non preoccuparti: potrai modificare queste impostazioni in seguito nelle sezioni Funzioni e MCP.

* **Fetch URL**: consente all'Agente di visitare pagine web ed estrarre informazioni rilevanti da esse;
* **Artifact**: gli Agenti possono creare contenuti interattivi e multimediali durante le conversazioni;
* **Analisi dei dati**: l'Agente è in grado di analizzare i dati e generare approfondimenti.
* **Ricerca Perplexity**: utilizza l'IA per fornire risultati di ricerca accurati e pertinenti;
* **Generatore di immagini**: consente all'Agente di generare immagini;
* **Invia email**: consente all'Agente di inviare email automaticamente.

### Conclusione

Dopo aver configurato tutte le sezioni:

1. Rivedi le impostazioni selezionate;
2. Fai clic su "Crea Agente" per creare il tuo Agente.

La creazione di un Agente è il primo passo verso un'esperienza di assistenza virtuale personalizzata. Prova diverse configurazioni per trovare quella più adatta alle tue esigenze. 🚀