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

# Glossario Mattone: tutti i termini chiave della piattaforma

> Tutti i termini tecnici e operativi usati in Mattone Docs: dal PMS al Vault, dal listing_id al guardrail, spiegati in modo chiaro.

Questi termini compaiono in ogni sezione di Mattone Docs. Conoscerli evita confusione durante l'onboarding e accelera il debug quando qualcosa non funziona. Se incontri una parola che non riconosci leggendo una procedura, torna qui prima di andare avanti.

| Termine                    | Significato                                                                                                                                                                                                                                                                                                            |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **PMS**                    | Il gestionale delle prenotazioni. Gli studenti usano **KrossBooking**; i clienti Dubai usano **Hostaway**. È la fonte di verità per soggiorni, ospiti e disponibilità.                                                                                                                                                 |
| **Conduit**                | L'assistente AI che risponde agli ospiti via WhatsApp (o altri canali). Ogni studente ha il proprio workspace Conduit dedicato.                                                                                                                                                                                        |
| **Workspace**              | Lo spazio Conduit di uno studente: contiene la Knowledge Base, l'agente configurato e i tool attivi. Un workspace = uno studente.                                                                                                                                                                                      |
| **KB (Knowledge Base)**    | I documenti che l'AI legge per rispondere agli ospiti. È sempre organizzata **per appartamento**: ogni listing ha la propria KB per evitare che informazioni di una proprietà "fuoriescano" verso ospiti di un'altra.                                                                                                  |
| **listing\_id**            | L'ID univoco di un singolo appartamento. Lega la KB al posto giusto e impedisce il leak di informazioni tra proprietà diverse dello stesso studente.                                                                                                                                                                   |
| **Custom tool**            | Un'azione che l'agente AI può eseguire su richiesta dell'ospite: aprire una porta, generare un link di pagamento, verificare la disponibilità. Deve sempre essere accompagnato dalla sua skill.                                                                                                                        |
| **Skill**                  | Le istruzioni che dicono all'agente quando e come usare un tool. Senza skill il tool viene ignorato dall'agente o innesca un comportamento nativo inaffidabile.                                                                                                                                                        |
| **Guardrail**              | Una regola "non fare mai X" imposta sull'agente. Limita i comportamenti indesiderati indipendentemente da ciò che chiede l'ospite.                                                                                                                                                                                     |
| **Hub Mini**               | La scatoletta SwitchBot che collega fisicamente la serratura al cloud tramite WiFi. Senza Hub Mini online la porta non risponde ai comandi remoti.                                                                                                                                                                     |
| **WABA**                   | WhatsApp Business Account, il numero ufficiale da cui l'agente Conduit scrive agli ospiti. Un numero dedicato per studente.                                                                                                                                                                                            |
| **MCP**                    | Il ponte (Model Context Protocol) con cui Conduit chiama i tool Mattone. Consente all'agente di invocare azioni esterne in modo strutturato.                                                                                                                                                                           |
| **Gateway**                | `mcp.mattone.co`, il punto di ingresso unico che smista le chiamate degli agenti studenti verso i servizi corretti (KrossBooking, Shelly, Stripe, ecc.).                                                                                                                                                               |
| **Vault**                  | Il magazzino cifrato dove sono conservate tutte le credenziali dei clienti. Le chiavi API non vanno mai nei repo né nelle chat: sempre e solo nel Vault.                                                                                                                                                               |
| **Repo**                   | Abbreviazione di *repository*: una cartella di codice e documenti su **GitHub** dove il team tiene e aggiorna le cose, es. `mattone-docs` (questi docs), la piattaforma, il gateway. Le modifiche vanno online con un `git push`.                                                                                      |
| **Le 3 credenziali Kross** | I 3 dati per leggere i dati Kross di un cliente: **hotel\_id** (quale struttura/account), **username** (`api…`, l'utente tecnico), **password** (la sua password). Vanno sempre insieme alla **api\_key** (la chiave che autorizza a parlare con Kross: nostra **generica** per i partner, **propria** per gli "own"). |
| **Provision**              | Il bottone/azione della Piattaforma che monta gli **strumenti dell'assistente** (+ le loro istruzioni/skill) nello spazio Conduit di uno studente.                                                                                                                                                                     |
| **Restricted Key**         | Chiave Stripe **a permessi minimi**: può creare prodotti/prezzi/link di pagamento, ma **non** fare rimborsi né leggere i dati dei clienti. Si usa questa, mai la Secret Key.                                                                                                                                           |
| **PIT**                    | La chiave della "location" (account CRM) di uno studente su GoHighLevel (GHL). Serve a **leggere lead, valori e spesa**.                                                                                                                                                                                               |
| **OAuth**                  | Un collegamento con **accesso autorizzato**: lo studente approva l'accesso una volta (login sul servizio) e **non si incolla nessuna chiave**. Usato per **Notion** e **PriceLabs**.                                                                                                                                   |
| **Token Conduit coach**    | L'accesso Conduit che vede **tutti** gli spazi degli studenti (gestione a scala). Il valore vive solo nel Vault (`CONDUIT_COACH_TOKEN`), mai nei docs.                                                                                                                                                                 |
| **Studente**               | Il property manager cliente di Mattone: la persona (o azienda) che gestisce gli appartamenti e per cui viene configurata l'intera piattaforma.                                                                                                                                                                         |

<Note>
  Salva questa pagina nei segnalibri del browser. È il riferimento più veloce quando incontri un termine sconosciuto durante un onboarding o una sessione di debug.
</Note>
