Premiers pas
D’une invitation à une première exécution de la suite sur votre propre agent, en une dizaine de minutes et sans compte Stripe.
1. Acceptez l’invitation
Pendant la phase pilote, COLVO est accessible uniquement sur invitation. Demandez un accès ; une fois votre demande approuvée, vous recevez un lien d’onboarding, définissez un mot de passe (ou utilisez les liens magiques) et arrivez dans votre organisation avec un premier projet et ses 40 modèles de scénarios déjà en place.
2. Exposez votre agent en HTTP
COLVO appelle votre agent avec une requête JSON décrivant le client, ses abonnements et paiements, la conversation jusqu’ici et la manière de proposer une action. Votre agent répond avec un JSON contenant reply. Si votre agent expose déjà un endpoint (webhook n8n, flow Flowise, votre propre service), il vous suffira peut-être d’indiquer le chemin de la réponse. Détails : Connecter votre agent.
3. Connectez-le depuis la page du projet
Ouvrez Projects → votre projet → Connect your agent. Saisissez l’URL de l’endpoint, un en-tête d’authentification facultatif que COLVO doit envoyer, et le chemin de la réponse si votre JSON ne correspond à aucune des formes détectées automatiquement. Cliquez sur Test connection : COLVO envoie une véritable requête d’exemple et affiche la réponse brute, la réponse qu’il en a extraite et la latence, ou bien une erreur précise. Enregistrez-le comme build (par exemple v0.1).
4. Lancez la suite
Cliquez sur Run suite (ou utilisez la CLI). Chaque scénario est exécuté trois fois dans un monde simulé tout neuf. La page de l’exécution affiche chaque tentative, l’état attendu et l’état observé, les contrôles déterministes et, si vous avez activé une clé IA, les notes sémantiques consultatives. Le coût est indiqué par tentative, comme connu ou estimé, jamais sous la forme d’un 0 € silencieux.
5. Lisez le rapport, corrigez, comparez
Ouvrez un scénario en échec pour voir précisément quel contrôle a échoué et l’état qui en est la cause. Publiez un correctif en v0.2, relancez, puis ouvrez Reports → Version comparison pour voir ce qui a régressé, ce qui a été corrigé et ce qui échoue encore.
6. Passer en production (Guard)
Guard nécessite l’offre Guard ou le droit d’accès correspondant. Connectez une clé Stripe restreinte au projet, faites enregistrer par votre backend un mandat par ticket et faites pointer votre agent de production vers l’endpoint des opérations de COLVO. Passer votre agent sur Guard vous guide pas à pas, code à l’appui.