Primi passi
Da un invito alla prima esecuzione della suite contro il tuo agente, in circa dieci minuti e senza un account Stripe.
1. Accetta l’invito
Durante il pilota COLVO è solo su invito. Richiedi l’accesso; quando vieni approvato ricevi un link di onboarding, imposti una password (o usi i magic link) e arrivi nella tua organizzazione con un primo progetto e i suoi 40 modelli di scenario già pronti.
2. Esponi il tuo agente via HTTP
COLVO chiama il tuo agente con una richiesta JSON che descrive il cliente, i suoi abbonamenti e pagamenti, la conversazione fin qui e come proporre un’azione. Il tuo agente risponde con un JSON che contiene reply. Se il tuo agente espone già un endpoint (webhook n8n, flow Flowise, un tuo servizio), potrebbe bastarti mappare il percorso della risposta. Dettagli: Collega il tuo agente.
3. Collegalo dalla pagina del progetto
Apri Projects → il tuo progetto → Connect your agent. Inserisci l’URL dell’endpoint, un header di autenticazione opzionale che COLVO deve inviare e il percorso della risposta se il tuo JSON non ha una delle forme riconosciute in automatico. Premi Test connection: COLVO invia una vera richiesta di esempio e mostra la risposta grezza, la risposta che ha estratto e la latenza, oppure un errore preciso. Salvalo come build (per esempio v0.1).
4. Esegui la suite
Premi Run suite (o usa la CLI). Ogni scenario viene eseguito tre volte su un mondo simulato nuovo. La pagina dell’esecuzione mostra ogni tentativo, lo stato atteso e quello osservato, i controlli deterministici e, se hai attivato una chiave AI, le note semantiche consultive. Il costo è mostrato per tentativo come noto o stimato, mai come un €0 silenzioso.
5. Leggi il report, correggi, confronta
Apri uno scenario fallito per vedere esattamente quale controllo è fallito e lo stato che l’ha causato. Rilascia una correzione come v0.2, esegui di nuovo, poi apri Reports → Version comparison per vedere cosa si è rotto, cosa è stato corretto e cosa fallisce ancora.
6. Andare in produzione (Guard)
Guard richiede il piano Guard o l’abilitazione corrispondente. Collega al progetto una chiave Stripe limitata, fai registrare al tuo backend un mandato per ticket e punta il tuo agente di produzione all’endpoint delle operazioni di COLVO. Porta il tuo agente su Guard ti guida passo per passo, con il codice.