Primeros pasos

De una invitación a la primera ejecución de la suite contra tu propio agente, en unos diez minutos y sin cuenta de Stripe.

Escrito a partir del código · actualizado el 26 sept 2026 · ¿Falta algo o hay un error? Escríbenos

1. Acepta la invitación

Durante el piloto, COLVO funciona solo por invitación. Solicita acceso; cuando te aprueben recibirás un enlace de onboarding, definirás una contraseña (o usarás enlaces mágicos) y llegarás a tu organización con un primer proyecto y sus 40 plantillas de escenario ya listas.

2. Expón tu agente por HTTP

COLVO llama a tu agente con una petición JSON que describe al cliente, sus suscripciones y pagos, la conversación hasta el momento y cómo proponer una acción. Tu agente responde con un JSON que contiene reply. Si tu agente ya expone un endpoint (webhook de n8n, flujo de Flowise, tu propio servicio), puede que solo tengas que mapear la ruta de la respuesta. Detalles: Conecta tu agente.

3. Conéctalo desde la página del proyecto

Abre Projects → tu proyecto → Connect your agent. Introduce la URL del endpoint, un header de autenticación opcional que COLVO deba enviar y la ruta de la respuesta si tu JSON no tiene una de las formas que se detectan automáticamente. Pulsa Test connection: COLVO envía una petición de ejemplo real y te muestra la respuesta en bruto, la respuesta que ha extraído y la latencia, o un error concreto. Guárdalo como build (por ejemplo v0.1).

4. Ejecuta la suite

Pulsa Run suite (o usa la CLI). Cada escenario se ejecuta tres veces sobre un mundo simulado nuevo. La página de la ejecución muestra cada intento, el estado esperado y el observado, los checks deterministas y, si activaste una clave de IA, las notas semánticas orientativas. El coste se muestra por intento como conocido o estimado, nunca como un €0 silencioso.

5. Lee el informe, corrige y compara

Abre un escenario fallido para ver exactamente qué check falló y el estado que lo provocó. Publica una corrección como v0.2, vuelve a ejecutar y luego abre Reports → Version comparison para ver qué se rompió, qué se arregló y qué sigue fallando.

6. Pasar a producción (Guard)

Guard requiere el plan Guard o el permiso correspondiente. Conecta una clave restringida de Stripe al proyecto, haz que tu backend registre un mandato por ticket y apunta tu agente de producción al endpoint de operaciones de COLVO. Lleva tu agente a Guard te guía paso a paso, con código.