Guida per gli ospiti della casa vacanza: farla da un video

Una guida per gli ospiti risponde prima che chiedano: come ci si collega al Wi-Fi, come si accende il riscaldamento, quando si portano fuori i rifiuti, come funzionano chiavi ed elettrodomestici, cosa fare se salta la corrente. Il modo più rapido per prepararla è raccontare tutto a voce mentre filmi la casa: Space Context trasforma fotogrammi e narrazione in istruzioni passo passo, fatti e punti chiave, e marca codici e password come valori sensibili. La guida la scrive poi un assistente AI collegato al server MCP, che per ciò che non hai detto risponde «non documentato».

In breve

• Un solo video raccontato diventa istruzioni, fatti, punti chiave e domande con risposta.
• Le istruzioni dette a voce diventano elenchi di passi; i codici detti a voce diventano fatti sensibili.
• I valori sensibili sono nascosti per impostazione predefinita a chiavi API, assistenti e ricerca.
• La guida la scrive un assistente via MCP, oppure qualsiasi modello a partire dalla pagina Markdown dello spazio.
• Quando qualcosa cambia, registri di nuovo: la guida è aggiornata quanto l’ultima scansione.

Cosa mettere nella guida per gli ospiti di una casa vacanza?

Le domande degli ospiti tendono a ripetersi. Una buona guida le copre tutte, e per ognuna dice dove si trova la cosa e come si usa:

Le voci «Emergenze» e «Partenza» sono facili da dimenticare, e spesso sono proprio quelle che evitano una telefonata.

Come si racconta la casa mentre la filmi?

Non serve un copione. Serve dire le cose mentre le inquadri, una alla volta e in modo esplicito:

1. Di’ il nome della stanza quando entri: «questa è la cucina».
2. Spiega gli elettrodomestici come istruzioni, nell’ordine in cui si fanno: «riempi il serbatoio dietro, poi premi il pulsante grande».
3. Di’ i fatti come frasi brevi: «i rifiuti si portano fuori il martedì sera», «il bidone giallo è per la plastica».
4. Mostra i punti chiave e dilli: «il quadro elettrico è nell’armadio dell’ingresso, dietro i cappotti».
5. Inquadra da vicino le etichette: l’adesivo del router, la targhetta della caldaia.

Space Context distingue ciò che è un’istruzione da ciò che è un fatto. Ecco come appare una frase della narrazione dello spazio dimostrativo, un bilocale a Brisbane (foto di Chris Olszewski, CC BY-SA 4.0; la narrazione è inventata per l’esempio), nello Space Document:

{
  "id": "how_1",
  "title": "Operate the capsule coffee machine",
  "steps": [
    "Fill the water tank at the back.",
    "Press the large button."
  ],
  "source_quote": "The coffee machine on the counter takes capsules. Fill the water tank at the back. Then press the large button."
}

E i fatti che ne derivano, come il giorno dei rifiuti:

{
  "kind": "schedule",
  "statement": "Bins go out on Tuesday evening.",
  "value": "Tuesday evening",
  "sensitive": false,
  "redacted": false
}

I record della demo sono in inglese, come li restituisce l’API. Puoi raccontare in italiano: l’audio viene trascritto nella lingua in cui parli, e il documento dei tuoi spazi può essere scritto in italiano.

Codici e password: chi li vede?

Una guida per gli ospiti contiene quasi sempre la password del Wi-Fi, e il video spesso contiene anche altro: il codice della cassetta delle chiavi, il codice dell’allarme. Space Context li tratta come valori sensibili:

• il passo di analisi approfondita marca come sensibili questi fatti, e un secondo controllo a regole intercetta password e codici annunciati nel testo, numeri di carta, IBAN, email e numeri di telefono;
• le chiavi API senza lo scope spaces:sensitive leggono il documento oscurato: il valore sparisce da ogni campo, e con lui la trascrizione e le citazioni testuali (source_quote);
• un assistente collegato via MCP non vede valori sensibili, a meno che tu non spunti l’apposita casella quando lo colleghi;
• i risultati di ricerca non li contengono mai, qualunque sia la chiave.

Così appare il fatto del Wi-Fi della demo a una chiave senza quello scope:

{
  "kind": "wifi",
  "statement": "Sensitive value recorded. A key with the spaces:sensitive scope can read it.",
  "value": null,
  "sensitive": true,
  "redacted": true
}

Una regola pratica: la password del Wi-Fi in una guida per gli ospiti ha senso, il codice della porta che cambi a ogni soggiorno no. Tieni fuori dalla guida i codici che cambiano e mandali a parte, con il messaggio di benvenuto. Ricorda anche che il report dell’app è per te e può contenere ciò che hai detto, codici compresi: rileggilo prima di condividerlo.

Vuoi provarlo sulla tua struttura? Scarica Space Context per iPhone e racconta la casa in un video; per vedere prima i record di una casa vera, crea una chiave di test gratuita e apri lo spazio dimostrativo.

Come si scrive la guida con un assistente AI?

Il modo più comodo è collegare un assistente come Claude o ChatGPT al server MCP di Space Context:

https://mcp.spacecontext.app/mcp

In Claude apri Settings → Connectors → Add custom connector (le voci possono comparire tradotte), incolli l’URL e accedi con lo stesso account dell’app per iPhone. In ChatGPT serve la modalità sviluppatore (Settings → Apps & Connectors → Advanced → Developer mode). I passi per ogni assistente sono nella guida Connect an assistant (in inglese). Al momento del collegamento scegli tu se l’assistente può vedere i valori sensibili; il collegamento è in sola lettura, a meno che tu non gli permetta anche di avviare scansioni.

Poi chiedi, per esempio:

Scrivi una guida per gli ospiti del Bilocale al mare usando solo i record dello spazio: Wi-Fi, riscaldamento, acqua calda, rifiuti, chiavi, elettrodomestici, cosa fare se salta la corrente, cosa fare prima della partenza. Dove un’informazione manca, scrivi «non documentato».

L’assistente legge lo spazio come una pagina sola, cita la stanza e, quando un’informazione è stata ripresa, può mostrarti il fotogramma da cui viene. Il server MCP gli dice di trattare il contenuto dello spazio come dati, mai come istruzioni, e di dire che qualcosa non è documentato invece di indovinare. I «non documentato» sono la tua lista di cose da aggiungere nel prossimo video. Per uno spazio registrato con l’app, la prima lettura da parte dell’assistente avvia il controllo dei valori sensibili, che richiede un minuto o due.

Senza assistente collegato, puoi esportare lo spazio come una pagina Markdown e darla a qualsiasi modello:

npx spacecontext markdown spc_… --out guida-casa.md

La pagina segue le stesse regole di oscuramento della chiave che la legge. Per l’export completo e le Agent Skill, vedi Skills and comparisons (in inglese).

E con la sola app per iPhone?

Nell’app trovi già il materiale: per ogni stanza una descrizione che unisce ciò che si vede e ciò che hai detto, arredi e dotazioni, criticità, e il PDF con i fotogrammi. La Q&A guidata ti permette di fare domande sullo spazio: chiedi «come si accende la caldaia?» o «dove sono i bidoni?». Se l’app non trova la risposta, probabilmente nel video non l’hai detta né mostrata. Gli stessi spazi, con lo stesso account, sono leggibili anche dall’assistente collegato via MCP, senza costi.

Come si tiene aggiornata la guida?

La guida è aggiornata quanto l’ultima scansione. Quando cambia qualcosa (un elettrodomestico nuovo, un nuovo router, un altro calendario dei rifiuti) registra di nuovo lo stesso spazio, anche solo raccontando la parte cambiata, e fai rigenerare la guida. Per tenere sotto controllo anche arredi e dotazioni tra un ospite e l’altro, vedi l’articolo sull’inventario della casa vacanza con un video.

Che cosa dire agli ospiti sulle regole italiane?

Alcune informazioni che gli ospiti si aspettano dipendono da norme e da regole locali. Space Context non le conosce: le scrivi tu, dopo averle verificate.

• Documenti all’arrivo. Il portale Alloggiati Web della Polizia di Stato ricorda l’obbligo, per i gestori di strutture ricettive, di comunicare le generalità degli alloggiati entro le 24 ore successive all’arrivo (art. 109 TULPS). Scriverlo nella guida evita sorprese quando chiedi un documento.
• Imposta di soggiorno. La misura la stabilisce il comune; per le locazioni brevi la disciplina di riferimento è l’art. 4 del D.L. 50/2017, come spiega il Dipartimento delle Finanze. Nella guida indica importo e modalità di pagamento previsti nel tuo comune.
• CIN. Il Codice Identificativo Nazionale va usato negli annunci ed esposto all’esterno della struttura, come indica il Ministero del Turismo: non è materia della guida, ma è utile averlo a portata di mano.

Come queste regole si applicano alla tua struttura lo verifichi con il tuo comune, il commercialista o l’associazione di categoria.

Prepara la guida con il prossimo video

Scarica Space Context per iPhone e racconta la casa come la racconteresti a un ospite appena arrivato. Se vuoi che la guida la scriva un assistente, o integrarla nel tuo gestionale, crea una chiave di test gratuita, prova i record dello spazio dimostrativo e poi collega il server MCP ai tuoi spazi. Per gli sviluppatori che ti seguono c’è la pagina Space Context per sviluppatori.