> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/unigetui/it/riferimento/settings.md).

# Tutte le impostazioni

Tutte le impostazioni di UniGetUI in un unico posto, raggruppate per pagina delle impostazioni, con la loro funzione e le piattaforme in cui sono disponibili.

Questa pagina elenca ogni impostazione di ***Impostazioni***, raggruppata per pagina delle impostazioni nell'ordine in cui compaiono nell'applicazione. Per raggiungere un'impostazione in UniGetUI, digiti parte del nome nella casella ***Search settings*** della barra del titolo.

* **Piattaforma**: ***All*** significa Windows, macOS e Linux. Un'impostazione non disponibile sulla piattaforma è nascosta.
* **Riavvio necessario**: alcune impostazioni si applicano solo dopo un riavvio. UniGetUI mostra allora ***Riavvia UniGetUI per applicare completamente le modifiche*** con un pulsante ***Riavvia UniGetUI***.
* Gli interruttori il cui nome contiene "Do not…" o "Disable…" funzionano come scritto: attivarli disattiva la funzione.

{% hint style="info" %}
Può anche leggere e modificare la maggior parte delle impostazioni da uno script con l'[interfaccia della riga di comando](/unigetui/it/riferimento/cli.md#settings): `unigetui settings list` mostra le chiavi interne.
{% endhint %}

## Preferenze generali

Lingua, aggiornamenti di UniGetUI, telemetria, privacy e importazione, esportazione o reimpostazione delle impostazioni.

### Lingua

<table><thead><tr><th width="250">IMPOSTAZIONE</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Lingua di visualizzazione di UniGetUI:</strong></em></td><td>Lingua dell'interfaccia. <em><strong>Lingua di sistema</strong></em> segue il sistema operativo. La percentuale di completamento di ogni traduzione è mostrata accanto al nome. Riavvio necessario.</td><td>Tutte</td></tr></tbody></table>

### Programma di aggiornamento di UniGetUI

<table><thead><tr><th width="250">IMPOSTAZIONE</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Aggiorna UniGetUI automaticamente</strong></em></td><td>Scarica e installa le nuove versioni di UniGetUI. <em><strong>Controlla aggiornamenti</strong></em> cerca subito una nuova versione. Veda <a href="/unigetui/it/riferimento/installation.md#update-unigetui">Aggiornare UniGetUI</a>.</td><td>Tutte</td></tr><tr><td><em><strong>Installa le versioni di sviluppo di UniGetUI</strong></em></td><td>Include le versioni beta e le altre versioni di anteprima quando UniGetUI si aggiorna.</td><td>Tutte</td></tr><tr><td><em><strong>Mostra le note sulla versione dopo l'aggiornamento di UniGetUI</strong></em></td><td>Mostra le note di versione la prima volta che UniGetUI si avvia dopo un aggiornamento.</td><td>Tutte</td></tr></tbody></table>

### Telemetria

<table><thead><tr><th width="250">IMPOSTAZIONE</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Gestisci le impostazioni di telemetria</strong></em></td><td><em><strong>Gestisci</strong></em> apre la scelta di condividere o no dati di utilizzo anonimi.</td><td>Tutte</td></tr></tbody></table>

### Privacy

<table><thead><tr><th width="250">IMPOSTAZIONE</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Nascondi il mio nome utente dai log</strong></em></td><td>Sostituisce il nome utente con <code>****</code> nei registri. Riavvii UniGetUI per nasconderlo anche nelle voci già registrate.</td><td>Tutte</td></tr></tbody></table>

### Gestisci le impostazioni di UniGetUI

<table><thead><tr><th width="250">IMPOSTAZIONE</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Importa impostazioni da un file locale</strong></em></td><td><em><strong>Importa</strong></em> carica un file JSON di impostazioni esportato in precedenza. Riavvio necessario.</td><td>Tutte</td></tr><tr><td><em><strong>Esporta impostazioni in un file locale</strong></em></td><td><em><strong>Esporta</strong></em> salva le impostazioni correnti in un file JSON, per esempio per copiarle su un altro computer.</td><td>Tutte</td></tr><tr><td><em><strong>Reimposta UniGetUI</strong></em></td><td>Ripristina ogni impostazione al valore predefinito, dopo la conferma. Riavvio necessario.</td><td>Tutte</td></tr></tbody></table>

{% hint style="info" %}
Le restrizioni della pagina ***Diritti di amministratore e altre impostazioni pericolose*** sono archiviate separatamente e non sono incluse in un file di impostazioni esportato.
{% endhint %}

## Preferenze dell'interfaccia utente

Tema, pagina di avvio, menu di spostamento, area di notifica e contenuto degli elenchi di pacchetti.

### Aspetto

<table><thead><tr><th width="250">IMPOSTAZIONE</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Tema applicazione:</strong></em></td><td><em><strong>Chiaro</strong></em>, <em><strong>Scuro</strong></em> o <em><strong>Segui schema dei colori di sistema</strong></em>.</td><td>Tutte</td></tr><tr><td><em><strong>Usa il carattere configurato in Windows invece del carattere predefinito dell'interfaccia</strong></em></td><td>Mostra l'interfaccia con il carattere di sistema di Windows. Riavvio necessario.</td><td>Windows</td></tr><tr><td><em><strong>Pagina di avvio di UniGetUI:</strong></em></td><td>Pagina mostrata all'apertura di UniGetUI: <em><strong>Predefinito</strong></em>, <em><strong>Esplora pacchetti</strong></em>, <em><strong>Aggiorna pacchetti</strong></em>, <em><strong>Pacchetti installati</strong></em>, <em><strong>Raccolte pacchetti</strong></em> o <em><strong>Impostazioni</strong></em>.</td><td>Tutte</td></tr><tr><td><em><strong>Menu di navigazione:</strong></em></td><td>Modo di visualizzare il menu a sinistra: <em><strong>Automatico</strong></em>, <em><strong>Ancorato aperto</strong></em> o <em><strong>Overlay scorrevole</strong></em>.</td><td>Tutte</td></tr></tbody></table>

### Rendering

<table><thead><tr><th width="250">IMPOSTAZIONE</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Passa automaticamente al rendering software quando Windows non dispone di una GPU hardware</strong></em></td><td>Usa il rendering software sui computer senza scheda grafica, come alcune macchine virtuali. Riavvio necessario.</td><td>Windows</td></tr></tbody></table>

### UniGetUI in background e nell'area di notifica

<table><thead><tr><th width="250">IMPOSTAZIONE</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Chiudi UniGetUI nell'area di notifica</strong></em></td><td>Mantiene UniGetUI in esecuzione nell'area di notifica quando chiude la finestra. Le notifiche e le attività pianificate richiedono che UniGetUI resti in esecuzione.</td><td>Tutte</td></tr><tr><td><em><strong>Gestisci il comportamento di avvio automatico di UniGetUI</strong></em></td><td><em><strong>Apri</strong></em> apre le impostazioni delle app di avvio di Windows, dove sceglie se UniGetUI si avvia con Windows.</td><td>Windows</td></tr></tbody></table>

### Elenchi pacchetti

<table><thead><tr><th width="250">IMPOSTAZIONE</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Mostra icone dei pacchetti negli elenchi dei pacchetti</strong></em></td><td>Mostra l'icona di ogni pacchetto.</td><td>Tutte</td></tr><tr><td><em><strong>Mostra illustrazioni negli elenchi dei pacchetti</strong></em></td><td>Mostra illustrazioni nelle pagine dei pacchetti. Riavvio necessario.</td><td>Tutte</td></tr><tr><td><em><strong>Mostra l'host del programma di installazione negli elenchi dei pacchetti</strong></em></td><td>Aggiunge una colonna <em><strong>Host del programma di installazione</strong></em> con il nome host dell'URL di download del programma di installazione. Riavvio necessario.</td><td>Tutte</td></tr><tr><td><em><strong>Show the download size on package lists</strong></em></td><td>Aggiunge una colonna <em><strong>Download size</strong></em>. Riavvio necessario.</td><td>Tutte</td></tr><tr><td><em><strong>The local icon cache currently takes … MB</strong></em></td><td>Dimensione delle icone dei pacchetti memorizzate. <em><strong>Svuota cache</strong></em> le elimina; vengono scaricate di nuovo quando servono.</td><td>Tutte</td></tr><tr><td><em><strong>Seleziona pacchetti aggiornabili per impostazione predefinita</strong></em></td><td>Seleziona ogni pacchetto in <em><strong>Aggiorna pacchetti</strong></em> al caricamento dell'elenco.</td><td>Tutte</td></tr></tbody></table>

## Preferenze di notifica

Quali notifiche mostra UniGetUI.

{% hint style="warning" %}
Le notifiche richiedono l'icona dell'area di notifica. Se ***Chiudi UniGetUI nell'area di notifica*** è disattivato, la pagina mostra ***L'icona nell'area di notifica deve essere abilitata affinché le notifiche funzionino*** e ***Abilita notifiche di UniGetUI*** è bloccato.
{% endhint %}

<table><thead><tr><th width="250">IMPOSTAZIONE</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Abilita notifiche di UniGetUI</strong></em></td><td>Attiva o disattiva tutte le notifiche di sistema di UniGetUI.</td><td>Tutte</td></tr><tr><td><em><strong>Mostra una notifica di riepilogo nell'app al termine di un blocco di operazioni</strong></em></td><td>Mostra un riepilogo nella finestra di UniGetUI quando un gruppo di operazioni è terminato.</td><td>Tutte</td></tr></tbody></table>

### Tipi di notifica

Non disponibile mentre ***Abilita notifiche di UniGetUI*** è disattivato.

<table><thead><tr><th width="250">IMPOSTAZIONE</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Mostra una notifica quando ci sono aggiornamenti disponibili</strong></em></td><td>La avvisa quando vengono trovate nuove versioni dei pacchetti installati.</td><td>Windows, macOS</td></tr><tr><td><em><strong>Mostra una notifica silenziosa quando un'operazione è in esecuzione</strong></em></td><td>Mostra una notifica senza audio mentre un'operazione è in corso.</td><td>Windows, macOS</td></tr><tr><td><em><strong>Mostra una notifica quando un'operazione non riesce</strong></em></td><td>La avvisa quando un'installazione, un aggiornamento o una disinstallazione non riesce.</td><td>Windows, macOS</td></tr><tr><td><em><strong>Mostra una notifica quando un'operazione viene completata correttamente</strong></em></td><td>La avvisa quando un'operazione viene completata.</td><td>Windows, macOS</td></tr></tbody></table>

Per disattivare l'audio delle notifiche di aggiornamento di un solo gestore di pacchetti, veda ***Ignore packages from {package manager} when showing a notification about updates*** in [Preferenze del gestore pacchetti](#package-manager-preferences).

## Diritti di amministratore e altre impostazioni pericolose

Comportamento dell'elevazione, il broker di Devolutions Agent e le restrizioni di sicurezza. La pagina si apre con un avviso: la maggior parte di queste impostazioni è disattivata per impostazione predefinita perché possono indebolire la sicurezza del computer.

{% hint style="danger" %}
Modifichi queste impostazioni solo se comprende le conseguenze. Per imporle sui computer gestiti, veda [Bloccare le impostazioni rischiose](/unigetui/it/per-i-team-it/organization/restrict-settings.md).
{% endhint %}

### Modifica il modo in cui le operazioni richiedono i diritti di amministratore

<table><thead><tr><th width="250">IMPOSTAZIONE</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Richiedi i privilegi di amministratore una sola volta per ogni blocco di operazioni</strong></em></td><td>Chiede l'elevazione una sola volta per un gruppo di operazioni avviate insieme, invece di una volta per operazione.</td><td>Windows</td></tr><tr><td><em><strong>Richiedi solo una volta i privilegi di amministratore</strong></em></td><td>Chiede l'elevazione una sola volta e la riusa per le operazioni successive.</td><td>Windows</td></tr><tr><td><em><strong>Vieta qualsiasi tipo di elevazione tramite UniGetUI Elevator o GSudo</strong></em></td><td>Non eleva mai. Qualsiasi operazione che non può elevarsi da sola non riesce, e installare, aggiornare o disinstallare come amministratore non funziona. Le due opzioni sopra sono bloccate mentre questa è attiva.</td><td>Windows</td></tr><tr><td><em><strong>Delega le operazioni sui pacchetti al broker Devolutions Agent</strong></em></td><td>Invia le operazioni di installazione, aggiornamento e disinstallazione dei gestori di pacchetti supportati al servizio Devolutions Agent invece di mostrare una richiesta UAC. Le operazioni non riescono se l'agent non è installato e in esecuzione. Veda <a href="/unigetui/it/per-i-team-it/organization/devolutions-agent.md">Consentire agli utenti di installare applicazioni approvate senza diritti di amministratore</a>.</td><td>Windows</td></tr><tr><td><em><strong>Inspect active package broker policy</strong></em></td><td>Apre la pagina <em><strong>Active package broker policy</strong></em>, che verifica se Devolutions Agent è raggiungibile e mostra il criterio applicato alle operazioni dei pacchetti. Da lì, <em><strong>Edit the active policy</strong></em>, <em><strong>Create a new policy</strong></em> o <em><strong>Replace the active policy identity</strong></em>, quando è consentito.</td><td>Windows</td></tr></tbody></table>

{% hint style="warning" %}
Con il broker di Devolutions Agent non c'è un ripiego su UAC: se l'agent non è disponibile o il suo criterio rifiuta la richiesta, l'operazione non riesce.
{% endhint %}

### Restrizioni sulle operazioni dei pacchetti

<table><thead><tr><th width="250">IMPOSTAZIONE</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Consenti argomenti personalizzati della riga di comando</strong></em></td><td>Consente di aggiungere argomenti personalizzati di installazione, aggiornamento e disinstallazione nelle opzioni di installazione di un pacchetto. Gli argomenti personalizzati cambiano il modo in cui i programmi vengono installati in una maniera che UniGetUI non può controllare, e possono danneggiare i pacchetti.</td><td>Tutte</td></tr><tr><td><em><strong>Ignora i comandi di pre-installazione e post-installazione personalizzati quando importi pacchetti da una raccolta</strong></em></td><td>Nonostante il nome, questo interruttore <strong>consente</strong> comandi personalizzati prima e dopo l'operazione. Quando è attivo, i comandi definiti nelle opzioni di installazione di un pacchetto vengono eseguiti prima e dopo l'installazione, l'aggiornamento o la disinstallazione del pacchetto. Quando è disattivato, vengono scartati.</td><td>Tutte</td></tr></tbody></table>

### Restrizioni sui gestori di pacchetti

<table><thead><tr><th width="250">IMPOSTAZIONE</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Consenti la modifica dei percorsi per gli eseguibili del gestore pacchetti</strong></em></td><td>Consente di scegliere un eseguibile diverso per ogni gestore di pacchetti in <a href="#package-manager-preferences">Preferenze del gestore pacchetti</a>. Riavvio necessario.</td><td>Tutte</td></tr></tbody></table>

### Restrizioni durante l'importazione delle raccolte pacchetti

<table><thead><tr><th width="250">IMPOSTAZIONE</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Consenti l'importazione di argomenti personalizzati dalla riga di comando durante l'importazione di pacchetti da una raccolta</strong></em></td><td>Conserva gli argomenti personalizzati archiviati in una raccolta quando la apre. Argomenti malformati possono danneggiare i pacchetti o consentire a un attore malevolo di ottenere un'esecuzione con privilegi. Disponibile solo quando <em><strong>Consenti argomenti personalizzati della riga di comando</strong></em> è attivo.</td><td>Tutte</td></tr><tr><td><em><strong>Consenti l'importazione di comandi pre-installazione e post-installazione personalizzati durante l'importazione di pacchetti da una raccolta</strong></em></td><td>Conserva i comandi pre-installazione e post-installazione archiviati in una raccolta quando la apre. Importi comandi solo da raccolte di cui si fida. Disponibile solo quando i comandi pre-installazione e post-installazione sono consentiti (veda l'interruttore sopra).</td><td>Tutte</td></tr></tbody></table>

## Preferenze per le operazioni sui pacchetti

Come vengono eseguite le operazioni di installazione, aggiornamento e disinstallazione.

### Concorrenza ed esecuzione

<table><thead><tr><th width="250">IMPOSTAZIONE</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Scegli quante operazioni devono essere eseguite in parallelo</strong></em></td><td>Numero massimo di operazioni eseguite contemporaneamente, da 1 a 100.</td><td>Tutte</td></tr><tr><td><em><strong>Cancella le operazioni riuscite dall'elenco delle operazioni dopo un ritardo di 5 secondi</strong></em></td><td>Rimuove automaticamente le operazioni riuscite dal pannello delle operazioni. Le operazioni di download non sono interessate.</td><td>Tutte</td></tr><tr><td><em><strong>Prova a fermare i processi che rifiutano di chiudersi quando richiesto</strong></em></td><td>Forza la chiusura delle app quando un programma di installazione lo chiede e non rispondono. Può perdere dati non salvati.</td><td>Tutte</td></tr></tbody></table>

### Download dei programmi di installazione

<table><thead><tr><th width="250">IMPOSTAZIONE</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Default location for downloaded installers</strong></em></td><td><em><strong>Seleziona</strong></em> sceglie la cartella in cui vengono salvati i programmi di installazione. <em><strong>Reimposta</strong></em> rimuove la cartella personalizzata e <em><strong>Apri</strong></em> la apre.</td><td>Tutte</td></tr><tr><td><em><strong>Nome dei file di installazione scaricati</strong></em></td><td><em><strong>Nome assegnato dall'editore</strong></em>, <em><strong>Nome e versione del pacchetto</strong></em>, <em><strong>Identificatore e versione del pacchetto</strong></em> o <em><strong>Nome assegnato dall'editore, seguito dalla versione</strong></em>. Aggiungere la versione impedisce che un nuovo download sovrascriva un programma di installazione più vecchio.</td><td>Tutte</td></tr></tbody></table>

### Variabili d'ambiente nelle opzioni di installazione personalizzate

<table><thead><tr><th width="250">IMPOSTAZIONE</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Use %VARIABLE% syntax for environment variables in custom install arguments and locations</strong></em></td><td>Per impostazione predefinita, UniGetUI espande le variabili scritte come <code>&#x3C;VARIABLE></code> negli argomenti personalizzati e nei percorsi di installazione. Attivi questa opzione per usare invece la sintassi di Windows <code>%VARIABLE%</code>. I nomi di cartella che contengono un nome di variabile, come <code>%TEMP%</code>, possono allora essere espansi in modo imprevisto.</td><td>Tutte</td></tr></tbody></table>

### Gestione dei collegamenti

<table><thead><tr><th width="250">IMPOSTAZIONE</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Richiedi di eliminare i collegamenti sul desktop creati durante un'installazione o un aggiornamento.</strong></em></td><td>Dopo che un'operazione crea nuovi collegamenti sul desktop, chiede se eliminarli. <em><strong>Gestisci collegamenti</strong></em> apre l'elenco dei collegamenti sul desktop noti.</td><td>Tutte</td></tr><tr><td><em><strong>Chiedi conferma per i collegamenti del menu Start creati durante un'installazione o un aggiornamento.</strong></em></td><td>Dopo che un'operazione crea nuovi collegamenti del menu Start, chiede che cosa farne. <em><strong>Gestisci i collegamenti del menu Start</strong></em> apre l'elenco dei collegamenti del menu Start noti.</td><td>Windows</td></tr></tbody></table>

## Preferenze di aggiornamento dei pacchetti

Condizioni degli aggiornamenti automatici e controlli di sicurezza delle nuove versioni. Il collegamento ***Manutenzione pianificata*** in cima alla pagina apre le pianificazioni degli aggiornamenti.

### Restrizioni degli aggiornamenti automatici

Si applicano solo agli aggiornamenti installati dall'attività ***Installa gli aggiornamenti disponibili*** della [Manutenzione pianificata](#scheduled-maintenance) e sono bloccate mentre quell'attività è disattivata.

<table><thead><tr><th width="250">IMPOSTAZIONE</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Non installare automaticamente gli aggiornamenti quando la connessione di rete è a consumo</strong></em></td><td>Rimanda gli aggiornamenti automatici su una connessione a consumo, come un hotspot mobile.</td><td>Windows</td></tr><tr><td><em><strong>Non installare automaticamente gli aggiornamenti quando il dispositivo funziona a batteria</strong></em></td><td>Rimanda gli aggiornamenti automatici mentre il dispositivo non è collegato alla rete elettrica.</td><td>Windows</td></tr><tr><td><em><strong>Non installare automaticamente gli aggiornamenti quando il risparmio batteria è attivo</strong></em></td><td>Rimanda gli aggiornamenti automatici mentre il risparmio batteria è attivo.</td><td>Windows</td></tr></tbody></table>

### Sicurezza degli aggiornamenti

<table><thead><tr><th width="250">IMPOSTAZIONE</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Età minima degli aggiornamenti</strong></em></td><td>Mostra solo gli aggiornamenti pubblicati da almeno questo tempo: <em><strong>Nessuna età minima</strong></em>, <em><strong>1 giorno</strong></em>, <em><strong>3 days</strong></em>, <em><strong>7 days</strong></em>, <em><strong>14 days</strong></em>, <em><strong>30 days</strong></em> o <em><strong>Personalizzato...</strong></em>. Può essere sostituito per ogni gestore di pacchetti.</td><td>Tutte</td></tr><tr><td><em><strong>Età minima personalizzata (giorni)</strong></em></td><td>Numero di giorni, quando è selezionato <em><strong>Personalizzato...</strong></em>.</td><td>Tutte</td></tr><tr><td><em><strong>Avvisami quando l'host dell'URL del programma di installazione cambia tra la versione installata e la nuova versione (solo WinGet)</strong></em></td><td>In <em><strong>Aggiorna pacchetti</strong></em>, segnala gli aggiornamenti WinGet il cui programma di installazione proviene da un host completamente diverso da quello della versione installata. Questo può rivelare un download reindirizzato o compromesso.</td><td>Tutte</td></tr></tbody></table>

L'età minima si basa sulle date di pubblicazione. La tabella ***Supporto delle date di rilascio per ogni gestore di pacchetti*** della pagina mostra quali gestori le forniscono (***Sì***, ***Parziale*** o ***No***). Per i gestori senza date di pubblicazione non ha effetto. Veda [Evitare le versioni appena uscite](/unigetui/it/guide/updates/update-safely.md).

## Manutenzione pianificata

Quando UniGetUI controlla gli aggiornamenti, li installa ed esegue il backup dell'elenco delle applicazioni da solo.

{% hint style="warning" %}
Le attività vengono eseguite mentre UniGetUI è in esecuzione, anche dall'area di notifica.
{% endhint %}

### Attività di manutenzione

Attivi l'interruttore di un'attività per abilitarla e mostrare la pianificazione. Un'attività compressa mostra la pianificazione corrente accanto al nome.

<table><thead><tr><th width="250">ATTIVITÀ</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Controlla gli aggiornamenti dei pacchetti</strong></em></td><td>Cerca nuove versioni dei pacchetti installati.</td><td>Tutte</td></tr><tr><td><em><strong>Installa gli aggiornamenti disponibili</strong></em></td><td>Aggiorna i pacchetti aggiornabili, rispettando le <a href="#automatic-update-restrictions">restrizioni degli aggiornamenti automatici</a>.</td><td>Tutte</td></tr><tr><td><em><strong>Backup locale dei pacchetti</strong></em></td><td>Salva l'elenco delle applicazioni nella cartella del backup locale.</td><td>Tutte</td></tr><tr><td><em><strong>Backup dei pacchetti sul cloud</strong></em></td><td>Salva l'elenco delle applicazioni nel backup nel cloud.</td><td>Tutte</td></tr></tbody></table>

### Opzioni di pianificazione

<table><thead><tr><th width="250">IMPOSTAZIONE</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Ripetizione</strong></em></td><td>Con quale frequenza viene eseguita l'attività. <em><strong>Controlla gli aggiornamenti dei pacchetti</strong></em>: <em><strong>A intervalli fissi</strong></em>, <em><strong>Ogni giorno</strong></em> o <em><strong>In giorni specifici</strong></em>. <em><strong>Installa gli aggiornamenti disponibili</strong></em>: <em><strong>Dopo ogni controllo degli aggiornamenti</strong></em>, <em><strong>Ogni giorno</strong></em> o <em><strong>In giorni specifici</strong></em>. Backup: <em><strong>All'avvio di UniGetUI</strong></em>, <em><strong>Ogni giorno</strong></em> o <em><strong>In giorni specifici</strong></em>.</td><td>Tutte</td></tr><tr><td><em><strong>Controlla ogni</strong></em></td><td>Intervallo tra due controlli degli aggiornamenti, con <em><strong>A intervalli fissi</strong></em>.</td><td>Tutte</td></tr><tr><td><em><strong>Giorni</strong></em></td><td>Giorni della settimana, con <em><strong>In giorni specifici</strong></em>.</td><td>Tutte</td></tr><tr><td><em><strong>Ora di inizio</strong></em></td><td>Ora del giorno in cui viene eseguita l'attività.</td><td>Tutte</td></tr><tr><td><em><strong>Se l'orario pianificato viene perso</strong></em></td><td>Che cosa fare se UniGetUI non era in esecuzione in quel momento: <em><strong>Run within</strong></em> un ritardo, <em><strong>Esegui al successivo avvio di UniGetUI</strong></em> o <em><strong>Salta fino alla prossima occorrenza</strong></em>.</td><td>Tutte</td></tr><tr><td><em><strong>Installa</strong></em></td><td>Per <em><strong>Installa gli aggiornamenti disponibili</strong></em>: <em><strong>Tutti gli aggiornamenti disponibili</strong></em> o <em><strong>Solo i pacchetti contrassegnati per gli aggiornamenti automatici</strong></em>.</td><td>Tutte</td></tr><tr><td><em><strong>Gestisci l'elenco</strong></em></td><td>Apre l'elenco dei pacchetti contrassegnati per gli aggiornamenti automatici, con il loro numero. Solo con <em><strong>Solo i pacchetti contrassegnati per gli aggiornamenti automatici</strong></em>. Se non ce n'è nessuno, la pagina mostra <em><strong>Nessun pacchetto è ancora contrassegnato, quindi non verrà installato nulla</strong></em>.</td><td>Tutte</td></tr><tr><td><em><strong>Esegui subito questa attività</strong></em></td><td><em><strong>Esegui adesso</strong></em> esegue l'attività immediatamente. Gli orari dell'ultima e della prossima esecuzione sono mostrati accanto, con l'errore dell'ultima esecuzione se non è riuscita.</td><td>Tutte</td></tr></tbody></table>

Veda [Eseguire gli aggiornamenti in base a una pianificazione](/unigetui/it/guide/updates/schedule.md) e [Scegliere quali applicazioni si aggiornano automaticamente](/unigetui/it/guide/updates/automatic-updates.md).

## Backup dei pacchetti

Salva l'elenco dei pacchetti installati così può ripristinarli in seguito. Un backup contiene l'elenco dei pacchetti e le opzioni di installazione, più gli aggiornamenti ignorati e le versioni saltate. Non contiene file di programma né dati delle app.

### Backup dei pacchetti sul cloud

I backup nel cloud sono archiviati in un Gist privato di GitHub del suo account. ***Accedi con GitHub*** connette l'account; ***Disconnessione da GitHub*** lo disconnette.

<table><thead><tr><th width="250">IMPOSTAZIONE</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Esegui periodicamente un backup sul cloud dei pacchetti installati</strong></em></td><td>Esegue il backup nel cloud secondo la pianificazione <em><strong>Backup dei pacchetti sul cloud</strong></em> della <a href="#scheduled-maintenance">Manutenzione pianificata</a>.</td><td>Tutte</td></tr><tr><td><em><strong>Esegui subito un backup sul cloud</strong></em></td><td><em><strong>Esegui backup</strong></em> carica subito un backup.</td><td>Tutte</td></tr><tr><td><em><strong>Ripristina un backup dal cloud</strong></em></td><td><em><strong>Seleziona backup</strong></em> consente di scegliere un backup nel cloud e rivedere quali pacchetti ripristinare.</td><td>Tutte</td></tr></tbody></table>

### Backup locale dei pacchetti

<table><thead><tr><th width="250">IMPOSTAZIONE</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Esegui periodicamente un backup locale dei pacchetti installati</strong></em></td><td>Salva un file di backup secondo la pianificazione <em><strong>Backup locale dei pacchetti</strong></em> della <a href="#scheduled-maintenance">Manutenzione pianificata</a>.</td><td>Tutte</td></tr><tr><td><em><strong>Esegui subito un backup locale</strong></em></td><td><em><strong>Esegui backup</strong></em> salva subito un backup.</td><td>Tutte</td></tr><tr><td><em><strong>Modifica cartella di destinazione del backup</strong></em></td><td><em><strong>Seleziona</strong></em> sceglie la cartella dei backup locali. La cartella corrente è mostrata sotto.</td><td>Tutte</td></tr></tbody></table>

### Opzioni avanzate del backup locale

Disponibile solo quando i backup locali sono attivi.

<table><thead><tr><th width="250">IMPOSTAZIONE</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Personalizza nome del file di backup</strong></em></td><td>Nome del file di backup. Lo lasci vuoto per il nome predefinito.</td><td>Tutte</td></tr><tr><td><em><strong>Mantieni un file separato per ogni backup</strong></em></td><td>Aggiunge data e ora al nome del file, così ogni backup ha un file proprio.</td><td>Tutte</td></tr><tr><td><em><strong>Numero massimo di backup locali da conservare</strong></em></td><td>Elimina i backup più vecchi oltre questo limite: <em><strong>Conserva tutti i backup</strong></em>, <em><strong>Keep the last 5 backups</strong></em>, <em><strong>Keep the last 10 backups</strong></em>, <em><strong>Keep the last 25 backups</strong></em>, <em><strong>Keep the last 50 backups</strong></em> o <em><strong>Personalizzato...</strong></em>. Solo con <em><strong>Mantieni un file separato per ogni backup</strong></em>.</td><td>Tutte</td></tr><tr><td><em><strong>Numero massimo di backup personalizzato</strong></em></td><td>Numero di backup da conservare, quando è selezionato <em><strong>Personalizzato...</strong></em>.</td><td>Tutte</td></tr></tbody></table>

Veda [Eseguire automaticamente il backup dell'elenco delle applicazioni](/unigetui/it/guide/new-computer/backup.md).

## Preferenze del gestore pacchetti

Raggiungibile anche da ***Gestori pacchetti*** nel menu a sinistra. La pagina elenca i gestori di pacchetti supportati sulla piattaforma (veda [Gestori di pacchetti supportati](/unigetui/it/riferimento/package-managers.md)), ognuno con un interruttore e uno stato: ***Pronto***, ***Disabilitato***, ***Non riuscito*** (trovato ma non avviato; controlli il registro di UniGetUI) o ***Non trovato***. Faccia clic su un gestore per aprire le impostazioni.

### Stato ed eseguibile

<table><thead><tr><th width="250">IMPOSTAZIONE</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Enable {package manager}</strong></em></td><td>Attiva o disattiva il gestore di pacchetti.</td><td>Tutte</td></tr><tr><td><em><strong>{package manager} status</strong></em></td><td>Indica se il gestore è pronto, disabilitato, non è stato caricato o non è stato trovato. <em><strong>Espandi versione</strong></em> mostra la versione.</td><td>Tutte</td></tr><tr><td><em><strong>Seleziona l'eseguibile da utilizzare. L'elenco seguente mostra gli eseguibili trovati da UniGetUI</strong></em></td><td>Eseguibile usato per avviare il gestore. <em><strong>Sfoglia...</strong></em> sceglie un altro file. Bloccato per impostazione predefinita; <em><strong>Modifica questo</strong></em> apre le impostazioni di amministratore, dove <em><strong>Consenti la modifica dei percorsi per gli eseguibili del gestore pacchetti</strong></em> lo sblocca.</td><td>Tutte</td></tr><tr><td><em><strong>File eseguibile attuale:</strong></em></td><td>Percorso dell'eseguibile in uso, con un pulsante di copia.</td><td>Tutte</td></tr></tbody></table>

### Opzioni di installazione predefinite

La sezione ***Default installation options for {package manager} packages*** si applica a ogni installazione, aggiornamento e disinstallazione fatti con questo gestore. Le opzioni che il gestore non supporta sono bloccate. ***Applica*** salva; ***Reimposta*** ripristina i valori predefiniti.

<table><thead><tr><th width="250">IMPOSTAZIONE</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Esegui come amministratore</strong></em></td><td>Esegue le operazioni con diritti di amministratore.</td><td>Windows</td></tr><tr><td><em><strong>Installazione interattiva</strong></em></td><td>Mostra il programma di installazione così può rispondere alle richieste.</td><td>Tutte</td></tr><tr><td><em><strong>Salta controllo hash</strong></em></td><td>Non verifica l'hash del programma di installazione.</td><td>Tutte</td></tr><tr><td><em><strong>Consenti le versioni di sviluppo</strong></em></td><td>Include le versioni di anteprima durante l'installazione e l'aggiornamento.</td><td>Tutte</td></tr><tr><td><em><strong>Disinstalla le versioni precedenti quando aggiorni</strong></em></td><td>Rimuove la versione precedente dopo un aggiornamento.</td><td>Tutte</td></tr><tr><td><em><strong>Architettura da installare:</strong></em></td><td>Architettura del processore da installare, o <em><strong>Predefinito</strong></em>.</td><td>Tutte</td></tr><tr><td><em><strong>Modalità di installazione:</strong></em></td><td><em><strong>Predefinito</strong></em>, <em><strong>Utente | Locale</strong></em> (utente corrente) o <em><strong>Computer | Globale</strong></em> (tutti gli utenti).</td><td>Tutte</td></tr><tr><td><em><strong>Percorso di installazione:</strong></em></td><td>Cartella di installazione. <em><strong>Seleziona</strong></em> ne sceglie una; <em><strong>Reimposta</strong></em> torna al valore predefinito del pacchetto. <code>%PACKAGE%</code> viene sostituito dall'ID del pacchetto e <code>%NAME%</code> dal nome del pacchetto.</td><td>Tutte</td></tr><tr><td><em><strong>Sottocartella per ogni pacchetto:</strong></em></td><td>Crea una sottocartella denominata in base al <em><strong>ID pacchetto</strong></em> o al <em><strong>Nome del pacchetto</strong></em> nel percorso di installazione, o <em><strong>Nessuna sottocartella</strong></em>.</td><td>Tutte</td></tr><tr><td><em><strong>Argomenti di installazione personalizzati:</strong></em>, <em><strong>Argomenti di aggiornamento personalizzati:</strong></em>, <em><strong>Argomenti di disinstallazione personalizzati:</strong></em></td><td>Argomenti aggiunti alla riga di comando di ogni operazione. <em><strong>Copia gli argomenti di installazione in aggiornamento e disinstallazione</strong></em> copia il primo campo negli altri due. Solo quando <em><strong>Consenti argomenti personalizzati della riga di comando</strong></em> è attivo.</td><td>Tutte</td></tr></tbody></table>

### Origini e opzioni avanzate

<table><thead><tr><th width="250">IMPOSTAZIONE</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Manage {package manager} sources</strong></em></td><td>Elenca le origini del gestore. <em><strong>Aggiungi sorgente</strong></em> aggiunge un'origine nota o personalizzata (<em><strong>Nome sorgente</strong></em>, <em><strong>URL sorgente</strong></em>); il pulsante di eliminazione ne rimuove una; <em><strong>Ricarica sorgenti</strong></em> aggiorna l'elenco. Solo per i gestori che supportano le origini.</td><td>Tutte</td></tr><tr><td><em><strong>Ignore packages from {package manager} when showing a notification about updates</strong></em></td><td>Esclude i pacchetti di questo gestore dalle notifiche di aggiornamento.</td><td>Tutte</td></tr><tr><td><em><strong>Età minima degli aggiornamenti</strong></em></td><td>Sostituisce l'età minima globale degli aggiornamenti per questo gestore, o <em><strong>Usa l'impostazione globale</strong></em>. Effetto limitato o nullo se il gestore fornisce date di pubblicazione solo per alcuni pacchetti, o per nessuno.</td><td>Tutte</td></tr><tr><td><em><strong>Età minima personalizzata (giorni)</strong></em></td><td>Numero di giorni, quando è selezionato <em><strong>Personalizzato...</strong></em>.</td><td>Tutte</td></tr><tr><td><em><strong>View {package manager} logs</strong></em></td><td>Apre il registro dei comandi eseguiti da questo gestore.</td><td>Tutte</td></tr></tbody></table>

### Opzioni specifiche di un gestore di pacchetti

<table><thead><tr><th width="250">IMPOSTAZIONE</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Strumento da riga di comando WinGet</strong></em></td><td><strong>WinGet.</strong> Strumento usato per le operazioni WinGet quando non si usa l'API COM: <em><strong>Predefinito</strong></em>, <em><strong>WinGet</strong></em> o <em><strong>Pinget</strong></em>.</td><td>Windows</td></tr><tr><td><em><strong>API COM di WinGet</strong></em></td><td><strong>WinGet.</strong> Se UniGetUI può usare l'API COM di WinGet prima di tornare allo strumento della riga di comando: <em><strong>Predefinito</strong></em>, <em><strong>Abilitato</strong></em> o <em><strong>Disabilitato</strong></em>.</td><td>Windows</td></tr><tr><td><em><strong>Reimposta WinGet</strong></em></td><td><strong>WinGet.</strong> Reimposta WinGet. Può aiutare se non viene elencato alcun pacchetto.</td><td>Windows</td></tr><tr><td><em><strong>Forza il parametro di posizione di installazione quando aggiorni pacchetti con posizioni personalizzate</strong></em></td><td><strong>WinGet.</strong> Passa di nuovo il percorso di installazione personalizzato quando aggiorna un pacchetto installato in un percorso personalizzato.</td><td>Windows</td></tr><tr><td><em><strong>Scarica il manifesto completo del pacchetto insieme al programma di installazione</strong></em></td><td><strong>WinGet.</strong> Salva il manifesto del pacchetto accanto ai programmi di installazione scaricati.</td><td>Windows</td></tr><tr><td><em><strong>Smetti di proporre un aggiornamento che non viene mai applicato dopo questo numero di tentativi</strong></em></td><td><strong>WinGet.</strong> Quando un aggiornamento segnala un esito positivo ma non cambia mai la versione installata, smette di offrirlo dopo questo numero di tentativi, finché non compare una versione più recente (predefinito: 3).</td><td>Windows</td></tr><tr><td><em><strong>Installa Scoop</strong></em> / <em><strong>Disinstalla Scoop (e i suoi pacchetti)</strong></em></td><td><strong>Scoop.</strong> Installa Scoop, oppure rimuove Scoop e ogni pacchetto che ha installato.</td><td>Windows</td></tr><tr><td><em><strong>Esegui pulizia e svuota cache</strong></em></td><td><strong>Scoop.</strong> Rimuove ora le versioni precedenti e i download memorizzati nella cache.</td><td>Windows</td></tr><tr><td><em><strong>Svuota la cache di download di Scoop all'avvio</strong></em></td><td><strong>Scoop.</strong> Svuota la cache dei download a ogni avvio di UniGetUI.</td><td>Windows</td></tr><tr><td><em><strong>Rimuovi le versioni precedenti delle app Scoop all'avvio</strong></em></td><td><strong>Scoop.</strong> Rimuove le versioni precedenti delle app a ogni avvio di UniGetUI.</td><td>Windows</td></tr><tr><td><em><strong>Preferisci le versioni più recenti (potrebbero includere modifiche incompatibili) invece degli aggiornamenti sicuri consigliati</strong></em></td><td><strong>Bun.</strong> Offre le versioni più recenti invece degli aggiornamenti sicuri consigliati.</td><td>Tutte</td></tr><tr><td><em><strong>Triplet predefinito di vcpkg</strong></em></td><td><strong>vcpkg.</strong> Triplet (piattaforma di destinazione) usato per impostazione predefinita per installare i pacchetti vcpkg.</td><td>Tutte</td></tr><tr><td><em><strong>Cambia il percorso radice di vcpkg</strong></em></td><td><strong>vcpkg.</strong> <em><strong>Seleziona</strong></em> sceglie la cartella radice di vcpkg; <em><strong>Reimposta</strong></em> ripristina il valore predefinito; <em><strong>Apri</strong></em> la apre.</td><td>Tutte</td></tr></tbody></table>

{% hint style="info" %}
Pip in Windows: se Python non viene trovato, o non elenca alcun pacchetto pur essendo installato, disattivi l'alias di esecuzione dell'app `python.exe` nelle impostazioni di Windows.
{% endhint %}

## Impostazioni connessione Internet

Proxy e connettività.

### Impostazioni proxy

<table><thead><tr><th width="250">IMPOSTAZIONE</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Connettiti a Internet utilizzando un proxy personalizzato</strong></em></td><td>Invia il traffico di UniGetUI e dei gestori di pacchetti compatibili attraverso un proxy.</td><td>Tutte</td></tr><tr><td><em><strong>URL proxy</strong></em></td><td>Indirizzo del server proxy. Solo quando il proxy è attivo.</td><td>Tutte</td></tr><tr><td><em><strong>Autentica il proxy con un nome utente e una password</strong></em></td><td>Invia le credenziali al proxy.</td><td>Tutte</td></tr><tr><td><em><strong>Credenziali</strong></em></td><td><em><strong>Nome utente</strong></em> e <em><strong>Password di accesso</strong></em> del proxy. Solo quando l'autenticazione del proxy è attiva.</td><td>Tutte</td></tr></tbody></table>

Non tutti i gestori di pacchetti supportano completamente un proxy. La ***Tabella di compatibilità dei proxy*** della pagina mostra, per gestore, ***Compatibile con proxy*** e ***Compatibile con autenticazione*** (***Sì***, ***Parzialmente*** o ***No***).

{% hint style="danger" %}
UniGetUI non garantisce che le credenziali del proxy siano archiviate in modo sicuro. Usi un account dedicato con diritti limitati.
{% endhint %}

### Altre impostazioni

<table><thead><tr><th width="250">IMPOSTAZIONE</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Attendi che il dispositivo sia connesso a Internet prima di provare a svolgere attività che richiedono la connettività Internet.</strong></em></td><td>Ritarda le attività che hanno bisogno di Internet, come il caricamento dei pacchetti, finché non è disponibile una connessione. Riavvio necessario.</td><td>Tutte</td></tr></tbody></table>

## Impostazioni sperimentali e opzioni sviluppatore

Opzioni ancora in sviluppo o pensate per la risoluzione dei problemi. Le modifichi solo se sa perché, per esempio quando il supporto glielo chiede.

<table><thead><tr><th width="250">IMPOSTAZIONE</th><th>CHE COSA FA</th><th>PIATTAFORMA</th></tr></thead><tbody><tr><td><em><strong>Mostra la versione e il numero di build di UniGetUI sulla barra del titolo.</strong></em></td><td>Mostra la versione esatta nella barra del titolo. Riavvio necessario.</td><td>Tutte</td></tr><tr><td><em><strong>Abilita API in background (widget e condivisione UniGetUI, porta 7058)</strong></em></td><td>Esegue l'API locale usata da UniGetUI Widgets, dalla condivisione dei pacchetti e dall'<a href="/unigetui/it/riferimento/cli.md">interfaccia della riga di comando</a> in una sessione desktop.</td><td>Tutte</td></tr><tr><td><em><strong>Attendi che il dispositivo sia connesso a Internet prima di provare a svolgere attività che richiedono la connettività Internet.</strong></em></td><td>La stessa impostazione di <a href="#other-settings">Impostazioni della connessione Internet</a>.</td><td>Tutte</td></tr><tr><td><em><strong>Disabilita il timeout di 1 minuto per le operazioni relative ai pacchetti</strong></em></td><td>Consente alle attività di enumerazione dei pacchetti di durare più di un minuto, per esempio con gestori o reti lenti.</td><td>Tutte</td></tr><tr><td><em><strong>Usa GSudo installato invece di UniGetUI Elevator</strong></em></td><td>Eleva le operazioni con un GSudo installato sul computer invece dell'elevator incluso in UniGetUI.</td><td>Windows</td></tr><tr><td><em><strong>Usa un URL personalizzato per il database di icone e screenshot</strong></em></td><td>Indirizzo del database delle icone e delle schermate dei pacchetti. Lo lasci vuoto per il valore predefinito.</td><td>Tutte</td></tr><tr><td><em><strong>Abilita le ottimizzazioni dell'utilizzo della CPU in background (vedi Pull Request #3278)</strong></em></td><td>Riduce l'uso della CPU mentre UniGetUI lavora in background.</td><td>Tutte</td></tr><tr><td><em><strong>Esegui controlli di integrità all'avvio</strong></em></td><td>Verifica l'integrità dell'installazione di UniGetUI a ogni avvio.</td><td>Tutte</td></tr><tr><td><em><strong>Quando si installano in blocco i pacchetti da una raccolta, installa anche i pacchetti già installati</strong></em></td><td>In <em><strong>Raccolte pacchetti</strong></em>, include i pacchetti già installati quando installa la selezione. Per impostazione predefinita vengono saltati.</td><td>Tutte</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/unigetui/it/riferimento/settings.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.