> 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 consente di creare e gestire le configurazioni di accesso ai modelli linguistici (LLM) che i tuoi Agenti possono usare sulla piattaforma. Questa sezione ti guiderà nel processo di creazione e gestione delle configurazioni dei tuoi modelli personalizzati.

### Accesso alla sezione modelli

Per gestire i tuoi modelli linguistici:

1. Accedi alla piattaforma;
2. Seleziona **Modelli** dalla barra laterale;
3. Vedrai un elenco delle configurazioni che hai impostato.

### Gestione delle configurazioni esistenti

Nella pagina principale, puoi:

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

### Creazione di una nuova configurazione

Per configurare un nuovo modello:

1. Fai clic sul pulsante **Nuova configurazione**;
2. Compila i campi richiesti:
   1. Informazioni di base:
      * **Nome**: assegna alla configurazione un nome univoco e identificativo; non sono consentiti spazi, ma puoi usare ".", "-", "&" e "@";
      * **Descrizione**: fornisci una breve descrizione della configurazione;
   2. Configurazione del provider:
      1. **Provider**: seleziona il provider del modello (OpenAI, Anthropic, Mistral, Azure OpenAI, AWS Anthropic, Vertex Anthropic, Personalizzato per modelli compatibili con OpenAI);
      2. **Endpoint**: per OpenAI, Anthropic e Mistral puoi fare clic sul pulsante "DEFAULT" a destra del campo di testo, altrimenti devi inserire il tuo endpoint personalizzato;
      3. **API Key**: inserisci la tua chiave API per l'autenticazione con il provider (non obbligatoria per il provider Personalizzato); alcuni provider non richiedono una chiave API, ma altre informazioni (ad es. client secret, secret access key ecc.);
      4. **Modello**: specifica il nome del modello da utilizzare; alcuni provider richiedono anche l'ID del modello.
3. Seleziona gli scopi per cui vuoi abilitare il modello:
   * D\&R e [Gruppo di Esperti](/estensioni/gruppo-di-esperti.md): per le conversazioni con gli utenti;
   * Import/Export: per l'[importazione di documenti](/istruzione-gestione-contenuti-agenti/importazione-di-documenti.md) che crea [contenuti](/istruzione-gestione-contenuti-agenti/contenuti.md);
   * [Pensiero Profondo](/estensioni/pensiero-profondo.md): per la memoria delle interazioni passate e il coordinamento tra esperti.
4. Fai clic su "**Conferma**" in basso a destra per salvare la configurazione.

#### Impostazioni di visibilità (solo amministratori)

Se disponi di autorizzazioni di amministratore, durante la creazione o la modifica di una configurazione vedrai anche una sezione **"Impostazioni di visibilità"** con le seguenti opzioni:

* **Visibile agli utenti del tenant**: rendi questa configurazione visibile e utilizzabile dagli utenti del tenant;
* **Usa come predefinito**: rendi questa configurazione predefinita per gli Agenti IA appena creati, ma solo per le categorie che hai selezionato. Ad esempio:
  * Se hai abilitato solo Q\&A, questo modello sarà quello predefinito per le conversazioni degli utenti;
  * Se hai abilitato tutte e tre le categorie (Q\&A e Gruppo di Esperti, Importazione/Esportazione, Pensiero Profondo), questo modello sarà quello predefinito per tutte e tre.

Anche se imposti un modello come predefinito, chi crea l'Agente può comunque selezionare un modello diverso tra quelli disponibili nel tenant durante la creazione e la configurazione dell'Agente.

{% hint style="info" %}
Se disponi di un [tenant AIsuru separato](/paas.md), tieni presente che **un modello che non è visibile agli altri utenti è comunque sempre visibile e utilizzabile dagli altri amministratori del tenant**.
{% endhint %}

#### Duplicare un modello esistente

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

**Per duplicare un modello**:

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

**Nel modulo di duplicazione, puoi**:

* Modifica il **nome** della configurazione;
* Modifica qualsiasi campo prima di salvare;
* Fai clic su **Conferma** per creare il nuovo modello duplicato.

> **💡** La duplicazione è utile quando vuoi creare varianti dello stesso modello con piccole modifiche, ad esempio lo stesso provider ma una posizione diversa, oppure la stessa configurazione ma un modello diverso. Tieni presente che verranno duplicate anche le impostazioni di visibilità. Puoi modificarle prima di salvare la nuova configurazione.

### Applica una configurazione in blocco

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

1. **Prerequisiti**:
   * Il flag "**Usa come predefinito**" deve essere abilitato;
   * Il flag "**Visibile agli utenti del tenant**" deve essere abilitato;
2. **Come utilizzarla**:
   * Dopo aver configurato tutti i parametri del modello, fai clic sul pulsante **"Applica a tutti"**;
   * Seleziona l'ambito: D\&R e Gruppo di Esperti, Importa/Esporta, Pensiero Profondo oppure Abilita per tutti gli scopi.

La configurazione verrà applicata automaticamente 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'uso di un modello specifico su tutti gli Agenti della piattaforma.
{% endhint %}

### Suggerimenti

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

Mantenere le configurazioni ben organizzate aiuta a ottimizzare le prestazioni del tuo Agente, garantendo risposte più precise e pertinenti alle tue esigenze specifiche.