Configuración unificada con el Onboarding Protocol

Configurar un entorno de desarrollo suele ser un proceso fragmentado. Te encuentras con una CLI que pide unos datos, una interfaz web que pide otros y, al final, mantener la paridad entre plataformas es un dolor de cabeza constante. Lo ideal es centralizar esta lógica para que la experiencia sea idéntica sin importar dónde trabaje el desarrollador.

Aquí te explico cómo funciona el protocolo unificado para gestionar el onboarding y la configuración.

Requisitos previos

Para trabajar con este protocolo, necesitas acceso a los siguientes componentes mencionados en la documentación técnica:

• Gateway RPC activo.
• Cliente compatible (CLI, macOS app o Web UI).
• Motor de Wizard (Wizard engine) para gestionar sesiones y prompts.

Inicio rápido

Sigue estos pasos para interactuar con el Gateway RPC y completar el flujo de configuración inicial en menos de 5 minutos.

1. Inicia el Wizard

Llama al método wizard.start para obtener un sessionId. Puedes definir si el modo es local o remoto.

// wizard.start params
{
  "mode": "local",
  "workspace": "tu-espacio-de-trabajo"
}

2. Avanza en los pasos

Utiliza el sessionId obtenido para enviar respuestas y progresar en el flujo mediante wizard.next.

// wizard.next params
{
  "sessionId": "sesion-123",
  "answer": {
    "stepId": "bienvenida",
    "value": "continuar"
  }
}

3. Gestiona el estado y la cancelación

Si necesitas verificar el progreso o detener el proceso, utiliza estos métodos:

• wizard.status: Envía el sessionId para recibir el estado actual, errores o si el proceso ha finalizado (done).
• wizard.cancel: Detiene la sesión activa inmediatamente.

4. Obtén el esquema de configuración

Para renderizar formularios en la Web UI, solicita el esquema JSON. Este incluye uiHints para mejorar la interfaz.

// config.schema params: {}
// Respuesta esperada: { schema, uiHints, version, generatedAt }

Solución de problemas

Si encuentras problemas durante la implementación, revisa estos puntos basados en el protocolo:

• Campos sensibles expuestos: Los campos marcados como sensitive en uiHints se renderizan como inputs de contraseña, pero el protocolo no incluye una capa de redacción (redaction layer). Ten cuidado al manejar estos datos.
• UI no renderiza nodos específicos: Si el esquema contiene nodos no soportados, el sistema activará automáticamente el editor JSON básico para evitar bloqueos.
• Error en el Wizard: Verifica el objeto de respuesta. Siempre debe contener sessionId y el estado de done para saber si el flujo terminó correctamente.

Si necesitas ayuda personalizada con tu configuración, consulta al AI Setup Assistant.

Próximos pasos

• Protocolo de Gateway RPC
• Guía de UI Hints y JSON Schema