> 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/ia-generativa-sezione-avanzata/crea-e-gestisci-le-configurazioni-dei-modelli.md).

# Crea e gestisci le configurazioni dei modelli

AIsuru ti permette di creare e gestire le configurazioni di accesso ai modelli di linguaggio (LLM) che i tuoi Agenti potranno utilizzare sulla piattaforma. Questa sezione ti guiderà attraverso il processo di creazione e gestione dei tuoi modelli personalizzati.

### Accesso alla sezione modelli

Per gestire i tuoi modelli linguistici:

1. Accedi alla piattaforma;
2. Seleziona <img src="/files/KYG0GpSrM4a8z2YPbdWJ" alt="" data-size="line"> **Modelli** dalla barra laterale;
3. Visualizzerai la lista dei modelli che hai configurato.

### Gestione delle configurazioni esistenti

Nella pagina principale, puoi:

* Filtrare le configurazioni per scopo (Q\&A, Import/Export, Pensiero Profondo);
* Visualizzare i dettagli di ogni configurazione;
* Modificare le configurazioni esistenti;
* Eliminare le configurazioni non più necessarie.

### Creazione di una nuova configurazione

Per configurare un nuovo modello:

1. Clicca sul pulsante **Nuova configurazione**;
2. Compila i campi richiesti:
   * **Nome**: assegna un nome identificativo (e univoco) alla configurazione; non utilizzare spazi;
   * **Descrizione**: fornisci una breve descrizione della configurazione;
   * **Provider**: seleziona il fornitore del modello (es. OpenAI, Anthropic);
   * **Endpoint**:
     * Per la maggior parte dei provider, puoi utilizzare il pulsante "DEFAULT" a destra del campo di testo;
     * Per Azure, inserisci il tuo endpoint personalizzato.
   * **API Key**: inserisci la tua chiave API;
   * **Modello**: specifica il nome del modello da utilizzare.
3. Seleziona gli scopi per cui vuoi abilitare il modello:
   * Q\&A e [Gruppo di esperti](/estensioni/gruppo-di-esperti.md): per le conversazioni con gli utenti;
   * Import/Export: per l'[import dei documenti](/istruzione-gestione-contenuti-agenti/importazione-di-documenti.md) che crea i [contenuti](/istruzione-gestione-contenuti-agenti/contenuti.md);
   * [Pensiero Profondo](/estensioni/pensiero-profondo.md): per la memoria delle interazioni passate e la coordinazione tra esperti.
4. Clicca su "**Conferma**" in basso a destra per salvare la configurazione.

#### Duplicare un modello esistente

Puoi **duplicare** un modello esistente per crearne rapidamente uno nuovo basato sulla stessa configurazione.

**Per duplicare un modello**:

1. Vai nella scheda **Modelli** delle impostazioni del tuo Agente;
2. Individua il modello che vuoi duplicare nella lista;
3. Clicca sull'icona **Duplica** (quella centrale tra "Modifica" ed "Elimina");
4. Si aprirà un form precompilato con tutti i campi del modello originale.

**Nel form di duplicazione potrai**:

* Modificare il **nome** della configurazione (per default avrà il suffisso `_copy`);
* Modificare qualsiasi campo prima di salvare;
* Clicca su **Conferma** per creare il nuovo modello duplicato.

> **💡 Suggerimento**: \
> La duplicazione è utile quando vuoi creare varianti dello stesso modello con piccole modifiche (es. stesso provider ma location diversa, o stesse credenziali ma funzionalità diverse).

### Impostazioni di visibilità (solo per Admin)

Se hai i permessi di amministratore, nella creazione o modifica di una configurazione troverai anche la sezione **"Impostazioni di visibilità"** con le seguenti opzioni:

* **Visibile agli utenti del tenant**: rendi questa configurazione visibile ed utilizzabile dagli utenti del tenant;
* **Usa come predefinito**: rendi questa configurazione il default per i nuovi Agenti AI creati, ma solo per le categorie che hai selezionato. Esempio:
  * Se hai abilitato solo Q\&A, questo modello sarà il predefinito per le conversazioni con gli utenti;
  * Se hai abilitato tutte e tre le categorie (Q\&A e Gruppo di esperti, Import/Export, Pensiero Profondo), questo modello sarà il predefinito per tutte e tre.

Anche se imposti un modello come predefinito, il creatore dell'Agente potrà comunque selezionare un modello differente tra quelli disponibili sul tenant durante la creazione e la configurazione.

{% hint style="info" %}
Se hai un [tenant AIsuru separato](/paas.md), tieni a mente che **un modello non visibile ad altri utenti è comunque sempre visibile ed utilizzabile dagli admin del tenant**.
{% endhint %}

### Applicazione massiva della configurazione

Se hai i permessi di amministratore e desideri applicare la stessa configurazione di modello a tutti gli Agenti del tenant, puoi utilizzare la funzionalità **"Applica a tutti"**:

1. **Prerequisiti necessari**:
   * Il flag "**Usa come predefinito**" deve essere abilitato;
   * Il flag "**Visibile agli utenti del tenant**" deve essere abilitato;
2. **Come utilizzare la funzione**:
   * Dopo aver configurato tutti i parametri del modello;
   * Clicca sul pulsante **"Applica a tutti"**;
   * La configurazione verrà automaticamente applicata a tutti gli Agenti esistenti nel tenant.

{% hint style="danger" %}
Questa operazione **sovrascriverà le configurazioni di modello esistenti per tutti gli Agenti del tenant**. Utilizza questa funzionalità per standardizzare l'utilizzo di un modello specifico su tutti gli Agenti della piattaforma.
{% endhint %}

### Suggerimenti

* Usa nomi e descrizioni chiari per facilitare la gestione;
* Verifica tutti i dati prima di salvare la configurazione;
* Abilita solo gli scopi necessari per ogni modello;
* Rivedi periodicamente le configurazioni per mantenerle aggiornate.

La gestione accurata delle configurazioni ti permette di ottimizzare le prestazioni del tuo Agente, garantendo risposte più precise e pertinenti in base alle tue esigenze specifiche.