> ## Documentation Index
> Fetch the complete documentation index at: https://manus.im/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Cache dei dati

> Aggiungi alla tua web app una cache di backend gestita, così il server esegue le operazioni lente una sola volta e serve ogni visitatore in modo rapido.

## Che cos'è

La **cache dei dati** (**Data cache**) permette alla tua web app di ricordare i risultati delle operazioni lente e di riutilizzarli per ogni visitatore. Il server della tua app esegue l'operazione lenta una sola volta, salva la risposta e fornisce la risposta salvata a chiunque la richieda dopo.

Un'operazione lenta può essere una chiamata a un'API esterna, un recupero di dati da Google Sheets o Notion, oppure una query pesante sul database. Senza una cache dei dati, il server ripete quel lavoro per ogni visitatore. Con una cache dei dati, la maggior parte dei visitatori riceve subito la risposta salvata.

La cache dei dati è un'istanza Redis gestita che viene eseguita accanto al server della tua app. Non ti servono un account separato, chiavi o configurazioni. Manus la attiva e scrive il codice che la utilizza.

> [!NOTE]
>
> Una cache dei dati non serve a tutte le app. Conviene quando molti visitatori richiedono gli stessi dati lenti. Se il tuo sito ha poco traffico, o le pagine sono già veloci, probabilmente non ti serve. Non sei sicuro? [Chiedi a Manus](#ask-manus-whether-your-app-will-benefit) di controllare prima il tuo progetto.

### Quando una cache dei dati è utile

#### Dati in tempo reale senza superare il limite dell'API

Il tuo sito mostra prezzi, meteo o risultati sportivi in tempo reale provenienti da un'API esterna. Ogni visitatore attiva una nuova chiamata API, quindi le pagine rallentano man mano che il traffico cresce. La maggior parte delle API limita inoltre le chiamate al minuto e può bloccare il tuo sito.

Con una cache dei dati, il server chiama l'API al massimo una volta al minuto e serve ogni visitatore dalla cache. L'API riceve circa una chiamata al minuto, indipendentemente da quanti visitatori arrivano.

> "La mia homepage mostra prezzi in tempo reale da \[API]. Usa la cache dei dati integrata di Manus per recuperarli al massimo una volta al minuto e servire ogni visitatore dalla cache."

#### Pagine veloci quando i contenuti si trovano in Google Sheets o Notion

Gestisci un menu, un elenco di prodotti, un calendario di eventi o articoli del blog in un foglio di calcolo o in un database Notion. Ogni visualizzazione di pagina chiama quel servizio, il che aggiunge un'attesa e può far raggiungere i suoi limiti.

Con una cache dei dati, il server recupera i contenuti a intervalli di pochi minuti e fornisce ai visitatori la copia salvata. Le tue modifiche compaiono comunque sul sito entro pochi minuti.

> "Il mio sito carica il menu da Google Sheets. Usa la cache dei dati integrata di Manus per recuperarlo al massimo una volta ogni 5 minuti e servire ogni visitatore dalla cache."

#### Classifiche ed elenchi "di tendenza" sempre veloci

La tua community, il tuo quiz o il tuo gioco mostra una classifica dei primi 100, un elenco dei "più popolari della settimana" o statistiche dell'intero sito. Creare quell'elenco richiede una query pesante sul database, che diventa più lenta man mano che i dati crescono.

Con una cache dei dati, il server crea l'elenco una volta al minuto e fornisce la copia salvata. I punteggi restano al sicuro nel tuo database.

> "La pagina della mia classifica sta diventando lenta. Usa la cache dei dati integrata di Manus per creare la top 100 una volta al minuto e fornire l'elenco salvato."

#### Altri modi in cui le app usano una cache dei dati

* **Totali delle dashboard.** Calcola le "vendite di oggi" una volta al minuto invece che a ogni visualizzazione di pagina.
* **Limiti su finestre brevi.** Consenti al massimo 20 tentativi di accesso al minuto da un singolo indirizzo IP.
* **Codici con scadenza.** Memorizza codici di verifica email che smettono di funzionare dopo 10 minuti.
* **Sessioni per un accesso personalizzato.** Mantieni gli utenti connessi quando la tua app ha un proprio sistema di accesso. L'accesso predefinito di Manus non ne ha bisogno.

### Quando probabilmente non ti serve

* **Il tuo sito ha poco traffico.** Se arrivano pochi visitatori, c'è poco lavoro ripetuto da risparmiare.
* **Il tuo sito non ha codice server.** Siti statici, landing page e portfolio non possono usare una cache dei dati. L'hosting di Manus memorizza già nella cache i loro file.
* **Le tue pagine sono già veloci.** Le query di piccole dimensioni sul database non richiedono una cache.
* **I dati non devono mai andare persi.** Ordini, account, pagamenti e contenuti degli utenti vanno nel tuo database.

## Come usarla

### Chiedi a Manus se la tua app ne trarrà vantaggio

**1. Apri le impostazioni della cache dei dati**

Apri il tuo progetto web e vai su **Impostazioni → Hosting** (**Settings → Hosting**). Trova la sezione **Cache dei dati** (**Data cache**). Prima di aggiungere una cache dei dati, la sezione riporta **Aggiungi una cache dei dati** (**Add a data cache**).

![La sezione Cache dei dati in Impostazioni, Hosting, prima di aggiungere una cache dei dati, con il pulsante Ask Manus.](https://mintcdn.com/docs-manus/uRrLxOT2Ia6qhFvR/images/website-builder/data-cache-card-add.png?fit=max\&auto=format\&n=uRrLxOT2Ia6qhFvR\&q=85\&s=334cb36c96bbad66c8cdbce4fce00ceb)

**2. Chiedi a Manus**

Seleziona **Chiedi a Manus** (**Ask Manus**). Manus prepara un prompt nella chat. Invia il prompt. Manus esamina il tuo progetto e ti indica quali pagine diventerebbero più veloci, quanto costerebbe e quali sono i compromessi.

**3. Approva la cache dei dati**

Se sei d'accordo, Manus attiva la cache dei dati e scrive il codice che la utilizza.

**4. Testa e pubblica**

Testa la tua app nell'Anteprima, poi pubblicala. Per i dettagli, leggi [Pubblicazione](https://manus.im/docs/it/website-builder/publishing.md).

Puoi anche iniziare dalla chat. Descrivi la pagina lenta e chiedi a Manus di usare "la cache dei dati integrata di Manus".

### Gestisci la cache dei dati

Dopo aver aggiunto una cache dei dati, la sezione **Cache dei dati** ne mostra lo stato e lo spazio di archiviazione utilizzato.

![La sezione Cache dei dati dopo l'aggiunta di una cache dei dati, con lo stato di Redis, lo spazio di archiviazione utilizzato e il pulsante Clear cache.](https://mintcdn.com/docs-manus/uRrLxOT2Ia6qhFvR/images/website-builder/data-cache-card-active.png?fit=max\&auto=format\&n=uRrLxOT2Ia6qhFvR\&q=85\&s=6d01a190f35496ad979d64ab6f5c34a2)

* **Per cancellare tutti i dati nella cache:** Seleziona **Svuota cache** (**Clear cache**) e conferma. In questo modo vengono cancellati i dati sia dell'Anteprima sia del sito pubblicato. Ti serve l'autorizzazione di scrittura sul database.
* **Per disattivare la cache dei dati:** Chiedi a Manus di disattivarla. Manus rimuove prima il codice che dipende da essa, poi elimina la cache dei dati e i suoi dati.

## Cosa devi sapere

> [!WARNING]
>
> I dati nella cache sono temporanei. Possono essere eliminati in qualsiasi momento, quindi la tua app deve essere in grado di ricostruirli. Conserva i dati importanti nel tuo database.

* **È disattivata per impostazione predefinita.** Aggiungi una cache dei dati per ogni progetto, e accelera solo le parti della tua app che la utilizzano.
* **È pensata per web app con un server.** Non è disponibile per i progetti di tipo Gioco o Mobile. Se il tuo progetto web non ha ancora un server, Manus ne aggiunge uno. Per i dettagli, leggi [Infrastruttura cloud](https://manus.im/docs/it/website-builder/cloud-infrastructure.md).
* **Non è una cache delle pagine.** Non memorizza nella cache del browser le pagine HTML, le immagini o gli script. Accelera il lavoro svolto dal tuo server.
* **L'Anteprima e il sito pubblicato condividono un'unica cache dei dati.** I dati scritti durante i test nell'Anteprima sono visibili sul sito live.
* **La pubblicazione non svuota la cache dei dati.** Chiedi a Manus di impostare un tempo di scadenza per i dati nella cache, così si aggiornano da soli.
* **I tuoi dati vengono eliminati se il saldo Cloud si esaurisce.** Dopo la ricarica, la tua app riparte con una cache dei dati vuota.
* **Le copie di un progetto partono vuote.** Una copia di un progetto ottiene una propria nuova cache dei dati, fatturata separatamente. Per i dettagli, leggi [Crea una copia](https://manus.im/docs/it/website-builder/make-a-copy.md).
* **Viene addebitata sul saldo Cloud, non sui crediti dell'Agent.** Gli addebiti utilizzano prima la quota Cloud gratuita, poi il saldo Cloud a pagamento. Per i dettagli, leggi [Utilizzo e prezzi](https://manus.im/docs/it/website-builder/getting-started/usage-and-pricing.md).

| Voce | Prezzo |
| - | - |
| Canone mensile | \$0.75 per ogni mese UTC alla cui fine la cache dei dati è attiva |
| Comandi | \$0.30 ogni 100.000 comandi |
| Larghezza di banda | \$0.045 per GB |
| Archiviazione | \$0.375 per GB al mese |

## Suggerimenti

* **Informa Manus sul tuo traffico.** Indica quanti visitatori prevedi e quali pagine sembrano lente. Manus potrà così valutare se una cache dei dati vale la pena.
* **Nomina la funzionalità nel prompt.** Scrivi "la cache dei dati integrata di Manus". Nelle sessioni di chat meno recenti, Manus potrebbe altrimenti suggerire un provider Redis esterno.
* **Imposta un tempo di scadenza.** Un minuto è adatto ai dati in tempo reale. Qualche minuto è adatto ai contenuti di un foglio di calcolo.
* **Non interrogare troppo spesso.** Ogni comando viene fatturato. Un controllo al secondo costa circa \$8.53 al mese senza alcun vantaggio reale.

## Domande frequenti

> [accordion] Come faccio a sapere se la mia app ha bisogno di una cache dei dati?
>
> Chiedi a Manus. Seleziona **Chiedi a Manus** (**Ask Manus**) in **Impostazioni → Hosting → Cache dei dati**, e Manus esaminerà il tuo progetto. In generale, una cache dei dati è utile quando molti visitatori caricano gli stessi dati lenti.

> [accordion] Una cache dei dati renderà il mio sito più veloce?
>
> Accelera le richieste ripetute gestite dal tuo server, come le chiamate ad API esterne e le query pesanti. Non cambia il modo in cui i file statici o le pagine raggiungono il browser.

> [accordion] Quanto costa?
>
> Il costo dipende da quanti comandi invia la tua app. Queste stime si basano sui prezzi di listino e non sono valori misurati:
>
> | Esempio | Comandi al mese | Costo stimato al mese |
> | - | - | - |
> | App piccola: 20.000 visite, 2 comandi ciascuna | 40.000 | Circa \$0.88 |
> | App molto frequentata: 1.000.000 di richieste, 3 comandi ciascuna | 3.000.000 | Circa \$10.06 |

> [accordion] Come smetto di pagare?
>
> Chiedi a Manus di disattivare la cache dei dati. Se la disattivi prima della fine del mese UTC, non paghi il canone di \$0.75 di quel mese.

> [accordion] Perché il mio sito live mostra dati vecchi dopo la pubblicazione?
>
> La pubblicazione non svuota la cache dei dati. Chiedi a Manus di impostare un tempo di scadenza per i dati nella cache, oppure seleziona **Svuota cache** (**Clear cache**).

> [accordion] Perché i miei utenti sono stati disconnessi dopo che ho svuotato la cache dei dati?
>
> La tua app potrebbe memorizzare le sessioni di accesso nella cache dei dati. Svuotandola, quelle sessioni vengono eliminate. L'accesso predefinito di Manus non usa la cache dei dati, quindi lo svuotamento non lo influenza.

> [accordion] Manus ha suggerito un provider Redis esterno. Cosa devo fare?
>
> Seleziona **Chiedi a Manus** (**Ask Manus**) in **Impostazioni → Hosting → Cache dei dati**, oppure scrivi "la cache dei dati integrata di Manus" nel tuo prompt.

> [!TIP]
>
> **Non sei sicuro che la cache sia adatta alla tua app?** Vai su **Impostazioni → Hosting → Cache dei dati** e seleziona **Chiedi a Manus** (**Ask Manus**). Manus controlla il tuo progetto e ti dice se una cache dei dati sarà utile prima che tu paghi qualsiasi cosa.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.