---
title: "Siti guest"
description: "Un agente prepara un sito prima che il proprietario abbia un account, poi il proprietario lo rivendica."
canonical: "https://atelier201.com/docs/it/platform/guest-sites"
updated: "2026-11-06"
---

# Siti guest

Un sito guest consente a un agente AI di creare un sito per qualcuno che non ha ancora un account Atelier201.
L’agente prepara una bozza e un link demo. La persona guarda la demo,
si registra e rivendica il sito. Nel frattempo non viene pubblicato nulla, non si collega alcun dominio e
non vengono spesi crediti.

## Il flusso

1. L’agente prepara il sito tramite
   [Prepara un sito prima dell’accesso](/docs/api/guest/prepare). La risposta contiene
   `site_id`, un `write_token` valido per 2 hours e un `claim_url` valido
   per 7 days.
2. L’agente invia il progetto come archivio tar
   ([importa](/docs/api/guest/import)) oppure mantiene lo starter di Atelier201, quindi
   [esegue la build](/docs/api/guest/build). Un sito guest dispone di 3 build.
3. L’agente interroga [lo stato del sito](/docs/api/guest/retrieve) finché non compare `demo_url`,
   quindi lo mostra alla persona. La demo è disponibile per 7 days.
4. L’agente invia alla persona il `claim_url` con un messaggio privato.
5. La persona apre il link, si registra o accede e il sito diventa suo.
6. Se l’agente lo ha richiesto, la persona decide se collegarlo.
   Se rifiuta, mantiene comunque il sito.

Dalla CLI, lo stesso flusso si avvia con un solo comando:

```bash
atelier201 site push --guest --name "Maison Dupont"
```

Il comando mostra il link demo e un link privato per il proprietario, e salva il token di scrittura
in `.atelier201/site.json` senza mai stamparlo.

## Operazioni non disponibili per un sito guest

Un sito guest può essere visualizzato in anteprima, ma non pubblicato. La demo viene eseguita in un ambiente isolato, non viene
indicizzata e non contiene moduli. Il token di scrittura dà accesso solo a quel sito
ed è disattivato quando il sito viene rivendicato. Un progetto guest è limitato a 10
MB e 500 file.

Un sito non rivendicato e la relativa demo scadono. Se il link è scaduto,
prepara di nuovo il sito.

## Mantieni privati i dati riservati

`write_token` e `claim_url` sono credenziali di accesso. Non condividerli nelle chat, nei log
né nei commit. Chiunque disponga del `claim_url` può rivendicare il sito.

## Dopo la rivendicazione

Il sito diventa un normale sito dell’area di lavoro della persona. Per pubblicarlo, la persona
(o un agente collegato, con `sites:publish`) verifica la build e
la pubblica. La rivendicazione e il collegamento dell’agente non equivalgono a questa approvazione. Consulta
[Come va online un sito](/docs/platform/drafts-builds-and-publishing).