# Snapshot

## Panoramica

Gli snapshot ti consentono di impacchettare i tuoi migliori agenti AI — insieme a tutto ciò che sanno e a ogni strumento che utilizzano — in un modello riutilizzabile e di installare tale modello su uno qualsiasi dei tuoi sub-account con un solo clic.

Perfeziona la tua configurazione una volta sola sul tuo account, salvala come snapshot e ogni nuovo cliente inizierà da quella configurazione collaudata invece che da una pagina bianca. Puoi anche condividere uno snapshot con un link, così chiunque abbia un account potrà installarlo.

::: walkthrough snapshots
:::

Uno snapshot include, per ogni agente:

- La configurazione completa dell'agente: istruzioni, playbook, personalità, impostazioni di comportamento e risposta, orari di attività.
- **Conoscenza** (opzionale): le FAQ dell'agente e le fonti della knowledge base, inclusi i file caricati.
- **Strumenti** (opzionale): le funzioni personalizzate dell'agente e i server MCP collegati.
- **Libreria multimediale** (opzionale): le immagini, i video e i documenti che l'agente può inviare, con le relative istruzioni di invio.

Gli snapshot sono **bloccati al momento dell'acquisizione**. Se continui a modificare l'agente in seguito, lo snapshot non cambia: acquisiscine uno nuovo quando desideri un modello aggiornato.

> **Account di agenzia nel nuovo spazio di lavoro Agenti.** Gli snapshot esistono per distribuire le configurazioni degli agenti da un'agenzia ai suoi sub-account, quindi la pagina apparirà una volta che il tuo account di agenzia sarà operativo nel nuovo spazio di lavoro Agenti (gli account vengono spostati automaticamente: non devi fare nulla). Anche i sub-account possono ricevere uno snapshot una volta che si trovano nello spazio di lavoro Agenti; il selettore di applicazione mostra quali sono pronti. Qualsiasi **nuovo** cliente creato una volta che la tua agenzia si trova nello spazio di lavoro inizierà automaticamente da lì, quindi sarà pronto a ricevere uno snapshot immediatamente: nessuna attesa e nulla da attivare.

---

## Dove trovare gli snapshot

Fai clic su **Snapshot** nella barra laterale principale: si trova proprio sotto **Sub-account**, vicino alla parte inferiore del menu.

::: master-only
<figure><img src="../.gitbook/assets/v2-snapshots-empty.png" alt="La pagina Snapshot prima che esista qualsiasi snapshot, con il pulsante Nuovo snapshot e la spiegazione dello stato vuoto"><figcaption><p>La pagina Snapshot. Prima della tua prima acquisizione, lo stato vuoto spiega il concetto e offre <strong>Crea il tuo primo snapshot</strong>.</p></figcaption></figure>
:::

---

## Acquisizione di uno snapshot

1. Apri **Snapshot** e fai clic su **Nuovo snapshot**.
2. Assegna un nome riconoscibile, ad esempio "Kit iniziale immobiliare".
3. Seleziona gli agenti da includere. Puoi raggruppare diversi agenti in un unico snapshot.
4. Scegli cosa includere:
   - **Includi conoscenza**: FAQ e fonti della knowledge base (con i relativi file).
   - **Includi strumenti**: funzioni personalizzate e server MCP.
   - **Includi libreria multimediale**: immagini, video e documenti inviabili dall'agente.

::: master-only
<figure><img src="../.gitbook/assets/v2-snapshots-create.png" alt="La finestra Nuovo snapshot con un nome inserito, due agenti selezionati e gli interruttori Includi conoscenza e Includi strumenti attivi"><figcaption><p>La finestra Nuovo snapshot: assegna un nome, seleziona gli agenti e scegli se includere conoscenza e strumenti. Gli agenti vengono congelati esattamente come sono in questo momento.</p></figcaption></figure>
:::

5. Fai clic su **Acquisisci snapshot**. L'acquisizione può richiedere un po' di tempo quando è inclusa molta knowledge.

Il nuovo snapshot appare nell'elenco con un riepilogo del suo contenuto:

::: master-only
<figure><img src="../.gitbook/assets/v2-snapshots-list.png" alt="L'elenco Snapshot che mostra la riga dello snapshot acquisito con i relativi agenti, il riepilogo dei contenuti, l'ora di creazione e le azioni Applica, rinomina ed elimina"><figcaption><p>Ogni riga mostra gli agenti all'interno, un riepilogo dei contenuti e le azioni: la stella <strong>Nuovi client</strong> (vedi sotto), <strong>Applica</strong>, rinomina (matita) ed elimina (cestino).</p></figcaption></figure>
:::

---

## Applicazione di uno snapshot

1. Fai clic su **Applica** su uno snapshot.
2. Seleziona gli account in cui eseguire l'installazione: uno qualsiasi dei tuoi sub-account o il tuo account di agenzia (che ti fornisce una copia nuova di tutto).

::: master-only
<figure><img src="../.gitbook/assets/v2-snapshots-apply.png" alt="La finestra Applica snapshot con l'elenco Installa in che mostra l'account di agenzia e un account cliente entrambi selezionati, l'interruttore Salta gli account che hanno già questo snapshot attivo e un pulsante Applica a 2 account"><figcaption><p>La finestra Applica. Seleziona uno o più account e tieni presente il promemoria: gli agenti installati vengono avviati in pausa e i calendari/OAuth devono essere riconnessi sulla destinazione.</p></figcaption></figure>
:::

3. Fai clic su **Applica a N account**.

Nell'account di destinazione viene creata una copia nuova di ogni agente presente nello snapshot, insieme alla sua conoscenza e ai suoi strumenti. L'applicazione dello stesso snapshot due volte crea una seconda copia; nulla viene sovrascritto.

### Gli agenti installati vengono avviati in pausa

Gli agenti arrivano nell'account di destinazione **spenti**, di proposito: alcune impostazioni sono specifiche dell'account e devono essere configurate sulla destinazione prima che l'agente diventi operativo:

- **Canali** — collega i canali WhatsApp / Instagram / altri canali dell'account di destinazione e puntali verso il nuovo agente.
- **Calendario e prenotazioni** — se l'agente originale gestiva appuntamenti, ricollega un calendario sull'account di destinazione e riabilita le prenotazioni.
- **Integrazioni connesse che utilizzano OAuth** (ad esempio un server MCP autorizzato con un pulsante "Connetti") — per motivi di sicurezza queste connessioni non vengono mai copiate, quindi l'account di destinazione deve autorizzare le proprie. Gli strumenti che utilizzano una semplice chiave API continuano a funzionare immediatamente.

Una volta collegati i canali, imposta l'agente come attivo nella pagina **Agenti IA** dell'account di destinazione.

### Applicazione a diversi clienti contemporaneamente

L'elenco **Installa in** ti consente di selezionare tutti gli account che desideri. Usa **Seleziona tutti i sub-account** per riapplicare il modello all'intera base clienti in una sola volta, quindi fai clic su **Applica a N account**. Ogni account viene elaborato a turno e la finestra mostra il risultato per account — installato, saltato o non riuscito con la relativa motivazione — in modo che un account che non è stato possibile configurare non blocchi mai gli altri.

**Salta gli account che hanno già questo snapshot** è attivo per impostazione predefinita: un account che ha già ricevuto esattamente questo snapshot viene saltato invece di riceverne una seconda copia. Disattivalo se desideri deliberatamente un'altra copia. Le copie installate prima di settembre 2026 non vengono riconosciute da questo controllo, quindi gli account modellati prima di tale data vengono trattati come nuovi.

---

## Installazione automatica di uno snapshot su ogni nuovo cliente

Se avvii sempre i client con la stessa configurazione, non devi applicare lo snapshot manualmente ogni volta. Contrassegna uno snapshot come **predefinito** e ogni nuovo account cliente che creerai lo avrà già installato.

1. Apri **Snapshot**.
2. Fai clic sulla stella nella colonna **Nuovi clienti** in corrispondenza dello snapshot desiderato.

La riga contrassegnata mostra un badge **Predefinito**. Può esserci un solo snapshot predefinito: contrassegnarne un altro sposterà l'impostazione. Fai di nuovo clic sulla stella per disattivarla; i nuovi account torneranno a essere creati vuoti.

Questo si applica a ogni modalità di creazione di un account cliente:

- Lo crei tu stesso nella pagina **Sub Accounts**.
- La tua integrazione lo crea tramite API.
- Un cliente acquista tramite il tuo link di pagamento e il suo account viene creato automaticamente.

Quest'ultimo punto è il fulcro della funzionalità: un cliente può pagare sul tuo sito web e ritrovarsi nella tua dashboard personalizzata con il tuo agente, la base di conoscenza, gli strumenti e i file multimediali già presenti, senza che tu debba fare nulla.

Alcune cose utili da sapere:

- Gli agenti installati **si avviano in pausa**, esattamente come avviene con l'applicazione manuale: dovrai prima collegare i canali del cliente e poi attivare l'agente.
- L'installazione viene eseguita subito dopo la creazione dell'account. Se per qualsiasi motivo non dovesse completarsi, l'account del cliente verrà comunque creato e sarà utilizzabile; arriverà semplicemente vuoto e potrai applicare lo snapshot manualmente.
- L'eliminazione dello snapshot contrassegnato rimuove automaticamente l'impostazione predefinita.

---

## Condivisione di uno snapshot con un link

Puoi fornire uno snapshot a chiunque abbia un account sulla piattaforma — un'agenzia partner, un cliente che gestisce il proprio account o la community — senza che debbano essere tuoi sub-account. Nulla di specifico dell'account viene trasferito con esso e puoi interrompere la condivisione in qualsiasi momento.

1. Fai clic su **Condividi** su uno snapshot.
2. Scegli chi può installarlo:
   - **Chiunque abbia il link**.
   - **Solo i membri del Champions Circle** — il link funziona solo per gli account che sono membri della community.
3. Fai clic su **Crea link** e copialo.

Prima di inviare il link, leggi la checklist **Prima di condividere** nella stessa finestra. Elenca:

- **Campi da compilare** che verranno richiesti a chi esegue l'installazione (vedi sotto).
- **Funzioni personalizzate da revisionare** — viene mostrato l'indirizzo web di ogni funzione, poiché punta ai tuoi sistemi. Tutti i valori di intestazione inviati dalla funzione (chiavi API, token) vengono cancellati nella copia installata; i nomi delle intestazioni rimangono in modo che chi esegue l'installazione sappia cosa inserire. Chi esegue l'installazione vede lo stesso elenco e riceve l'invito a revisionare tali funzioni prima di attivare l'agente.
- **Server MCP che richiedono nuovamente la propria chiave** — le chiavi API per i tuoi server MCP connessi non sono mai incluse in un'installazione condivisa. Arrivano disattivate sull'account di chi esegue l'installazione, che dovrà inserire la propria chiave.

::: master-only
<figure><img src="../.gitbook/assets/v2-snapshots-share.png" alt="La finestra Condividi questo snapshot con il link di installazione e il pulsante Copia, la scelta Chi può installarlo impostata su Chiunque abbia il link, la checklist Prima di condividere e le azioni Nuovo link e Interrompi condivisione"><figcaption><p>La finestra Condividi dopo <strong>Crea link</strong>: copia il link, scegli chi può installarlo, leggi la checklist e usa <strong>Nuovo link</strong> o <strong>Interrompi condivisione</strong> quando devi revocare l'accesso.</p></figcaption></figure>
:::

La riga mostra quante volte lo snapshot è stato installato. **Nuovo link** ti fornisce un link nuovo e rende quello vecchio non più funzionante; **Interrompi condivisione** disattiva completamente il link. Entrambi lasciano intatta ogni copia già installata.

### Campi da compilare

Scrivi `{{company_name}}`, `{{support_email}}`, `{{website}}`, `{{booking_link}}` o qualsiasi altro `{{word}}` nelle istruzioni dell'agente, nelle FAQ o nelle descrizioni dei media e diventerà un campo che l'installatore dovrà compilare prima dell'installazione. I valori dell'installatore sostituiscono i campi ovunque nel testo; la tua istantanea originale rimane invariata.

`{{first_name}}` e `{{personal_context}}` sono variabili di messaggio proprie dell'IA, quindi vengono lasciate invariate e non trasformate mai in campi da compilare.

---

## Installazione di un'istantanea condivisa con te

Apri il link che ti è stato inviato mentre hai effettuato l'accesso (o accedi quando richiesto; verrai reindirizzato alla pagina di installazione in seguito). Vedrai il nome dell'istantanea, chi l'ha condivisa, gli agenti che contiene e cosa c'è all'interno, quindi:

::: master-only
<figure><img src="../.gitbook/assets/v2-snapshots-install.png" alt="La pagina di installazione per un'istantanea condivisa che mostra il nome dell'istantanea, chi l'ha condivisa, i due agenti all'interno, il selettore 'Installa in' con l'account dell'installatore selezionato e il pulsante Installa"><figcaption><p>La pagina di installazione. Vedi cosa c'è all'interno e chi l'ha condivisa, scegli dove inserirla e fai clic su <strong>Installa</strong>.</p></figcaption></figure>
:::

1. Compila tutti i campi lasciati dall'autore, come il nome della tua azienda o il sito web. Sono tutti facoltativi.
2. Scegli dove installarla: nel tuo account o in uno dei tuoi sotto-account se gestisci un'agenzia.
3. Fai clic su **Installa**.

Gli agenti vengono copiati nell'account scelto e **iniziano in pausa**, esattamente come un'istantanea applicata dalla pagina Istantanee. Prima di attivarli:

- Collega i tuoi canali e puntali verso i nuovi agenti.
- Esamina eventuali funzioni personalizzate elencate nella schermata di conferma: richiamano gli indirizzi web dell'autore.
- Inserisci la tua chiave su qualsiasi server MCP ivi elencato, quindi attivalo.
- Ricollega un calendario se l'agente prenota appuntamenti.

L'installazione conta ai fini del limite di agenti del tuo account, come qualsiasi altro agente creato.

---

## Gestione degli snapshot

- **Rinomina** — l'icona della matita su una riga.
- **Elimina** — rimuove lo snapshot e i file archiviati. Gli account a cui è stato applicato non subiscono modifiche: tutto ciò che è stato installato rimane installato.

---

## Cosa non è incluso

- Connessioni ai canali e numeri di telefono (sempre specifici dell'account).
- Calendari e connessioni per appuntamenti.
- Login OAuth per le integrazioni collegate.
- Contatti, chat e cronologia delle conversazioni: le istantanee trasportano la tua *configurazione*, mai i dati dei clienti.
- Modelli di messaggi WhatsApp (sono approvati per account e devono essere ricreati sulla destinazione).
- Chiavi API dei server MCP e valori di intestazione delle funzioni personalizzate, quando un'istantanea viene installata da un link di condivisione (all'interno della tua agenzia vengono copiati).

## Correlati

- [Gestione dei sub-account dei clienti](sub-accounts.md)
- [Agenti IA](../ai-agents/ai-agents.md)