Skip to main content
Le singole pagine spiegano ogni pezzo. Questa mostra il pacchetto completo che rende un agente Conduit “come Cosmica”: tutti i pezzi montati nell’ordine giusto, ognuno con la sua verifica.
Passo 0, accesso Admin Mattone (obbligatorio). Appena creato il workspace, aggiungi francesco@mattone.co come Admin (dashboard Conduit → membri/team → invita come Admin). Non c’è API: si fa a mano. Se te ne dimentichi, il team perde l’accesso UI al workspace. Verifica che sia presente come Admin prima di considerare il workspace “pronto”. (È in corso una richiesta a Conduit per aggiungerlo in automatico a ogni nuovo workspace; finché non è attiva, resta manuale.)

​
I pezzi, nell’ordine

1

Costruisci la KB con il bridge Notion → Conduit (OBBLIGATORIO)

Passo obbligatorio, non opzionale: colleghi il registro appartamenti su Notion → il bridge genera la KB per-appartamento nel workspace Conduit (cartella scoped per listing_id) → l’agente risponde coi dati giusti. Senza KB, l’agente non ha le info degli appartamenti. Mai globale (leak). Come funziona: Notion → Bridge Conduit. Verifica: apri una prenotazione reale → l’AI usa solo i dati di quel listing.
2

Custom tool + skill

I tool Kross/Shelly/Stripe, ognuno con la sua prompting skill attaccata. Verifica: trace di simulate_conversation mostra load_skill → tool → risposta.
3

Guardrail

Editati in-place (mai duplicati). Eccezione-listino per la vendita upsell. Verifica: conteggio guardrail invariato, comportamento sicuro (escala senza listino).
4

Workflow

Automazioni deterministiche (late/early check, notifica cleaner). Verifica: list_workflow_execution_events + get_automation_rate.
5

Telefonia + WABA

1 voice agent, lingua specifica, escalation a umano, numero WhatsApp Registered. Verifica: chiamata + messaggio reali.

​
Regole d’oro trasversali

  • Tool SEMPRE con skill (senza, l’agente ripiega sul nativo).
  • KB per-listing (scope sulla directory, non sull’articolo).
  • Prima la credenziale valida nel Vault, poi il tool (una key fasulla rompe l’agente).
  • Guardrail: modifica l’esistente, non aggiungere (la PATCH sostituisce l’intero array).
  • Nativo + custom insieme: il custom potenzia il nativo, non lo sostituisce.

​
Come si differenzia dall’AI nativa del PMS

Conduit deve battere l’AI nativa del PMS, non pareggiarla. La differenza non è “rispondere” (lo fa anche Hostaway) ma chiudere il loop: verifica disponibilità → incassa (Stripe) → avvisa il cleaning → conferma. Se sulla stessa inbox è attiva anche l’AI nativa del PMS → spegnila (due AI in conflitto).

​
Provisioning a volumi

Tutto il pacchetto è iniettabile per ogni studente dal catalogo (catalog.json) + i workflow via create_workflow + la KB via bridge. Un solo catalogo, una sola procedura, propagata a tutti al prossimo run.
Approfondimenti: KB · Custom tools · Workflow · Guardrail · Telefonia & WABA · Troubleshooting.
▷ Prompt Claude Code: Monta il pacchetto Conduit completo · incolla in Claude Code:

Onboarding · Conduit

Lo step nel flusso

Provisioning verification

Checklist finale
Fonti: PROVISIONING.md, conduit-custom-tool/catalog.json, conduit-reasoning/*, team-runbook/provisioning-verification-checklist.md, memoria reference_conduit_late_checkout_automation + reference_conduit_stripe_payments.