Docs

Tu primer problema

Rompe algo a propósito y síguelo por Sypnia, desde la falla hasta la sesión, la grabación, la frase y el arreglo.

Aplica a MotorNube Al lanzar

Ver como Markdown
En esta página
  1. Agrega un botón que falla
  2. Hazle clic tres veces, rápido
  3. Espera dos minutos
  4. Abre el problema
  5. Mira lo que pasó
  6. Entrégaselo a tu agente de código
  7. Quita el botón y resuelve el problema
  8. Lo que acabas de ver, con un problema real
  9. Sigue con

Esta página es para quien ya terminó un inicio rápido y quiere ver el ciclo completo una vez, con una falla que controla. Sirve en Sypnia Cloud y en un motor en alojamiento propio; los pasos que cambian están marcados.

Al final tendrás: un problema en Sypnia que causaste tú, la sesión donde pasó, su grabación y el prompt que le entrega el arreglo a tu agente de código.

Antes de empezar: Sypnia ya debe recibir eventos de tu aplicación. Si no, haz primero uno de los inicios rápidos: Sypnia Cloud o alojamiento propio.

  1. Agrega un botón que falla

    Agrega un botón a cualquier página de tu aplicación. Al hacerle clic lanza un error, como lo haría la página de pago de la tienda si faltara el total del carrito.

    HTML

    any-page.html
    <button id="sypnia-test">Test Sypnia</button>
    <script>
      document.getElementById('sypnia-test').addEventListener('click', () => {
        throw new Error('Sypnia test: the cart total is missing');
      });
    </script>

    No necesitas llamar a Sypnia en este código. El SDK del navegador reporta por su cuenta los errores que nadie atrapó.

    Deberías ver
    Un botón «Test Sypnia» en la página. Al hacerle clic no se ve nada en pantalla, y aparece un error en la consola del navegador.
  2. Hazle clic tres veces, rápido

    Abre la página y haz clic en el botón tres veces en menos de un segundo. Después quédate en la página unos 15 segundos, para que el SDK del navegador alcance a enviar lo que registró.

    Pasaron tres cosas, y Sypnia vio cada una:

    • Un error. Lo causaste tres veces, pero el SDK cuenta el mismo error una sola vez dentro de 5 segundos, así que Sypnia registra una ocurrencia.
    • Un clic de rabia: tres clics o más en el mismo punto dentro de un segundo.
    • Un clic muerto: un clic en un botón después del cual nada cambió en la página.

    Como la sesión tuvo un error, el SDK también empezó a subir su grabación, desde 30 a 60 segundos antes del primer error, o desde el inicio de la sesión si es más corta que eso.

    Deberías ver
    En la pestaña Network de las herramientas de desarrollo del navegador, solicitudes a tu dirección de ingesta que reciben una respuesta exitosa.
  3. Espera dos minutos

    Un problema nuevo aparece dentro de los 2 minutos siguientes a su primer evento. La lista de sesiones está completa dentro de 10 minutos, y una grabación se puede ver cuando su sesión lleva 2 minutos sin actividad o ya terminó. Así que deja la página quieta un momento.

    Deberías ver
    Después de 2 minutos, un problema nuevo en el entorno development. Un poco después, tu sesión en la lista de sesiones, marcada con un error, un clic de rabia y una grabación.
  4. Abre el problema

    Abre la lista de problemas y elige el entorno development. En Sypnia Cloud es la aplicación en app.sypnia.com. En un motor en alojamiento propio es la Consola, o la API, la CLI o tu agente de código por MCP.

    Hay un problema nuevo. Antes de que el agente lo analice, o si el agente está apagado, su título es el técnico:

    Text
    Error: Sypnia test: the cart total is missing

    Cuando el agente ya corrió, el título es una frase en palabras claras, como «Hacer clic en Test Sypnia falla siempre: la página lanza un error de prueba.» Debajo encuentras:

    • A quién afectó: 1 persona, 1 sesión.
    • Desde cuándo: la hora de tu primer clic, y la versión si tu aplicación reporta una.
    • Dónde: el archivo y la línea del throw, en tu propio código fuente si subiste source maps. Sin ellos ves el archivo compilado y su línea. Mira Versiones y source maps.
    • Las sesiones donde pasó.

    Haz clic otra vez mañana y el conteo del problema sube; no aparece un segundo problema. Problemas explica qué hace que dos fallas sean el mismo problema.

    Deberías ver
    Un problema, marcado «nuevo», con 1 persona y 1 ocurrencia.
  5. Mira lo que pasó

    Abre la sesión desde el problema. La línea de tiempo lista lo que hiciste: la página que abriste, los tres clics, el clic de rabia, el clic muerto y el error. La grabación empieza poco antes del primer error y muestra la página como la viste.

    Deberías ver
    La grabación reproduce tus tres clics, con el momento del error marcado.
  6. Entrégaselo a tu agente de código

    Cada problema llega listo para tu agente de código.

    • El prompt. Cópialo desde el problema y pégalo en tu agente de código. Dice qué pasa, dónde, por qué, qué hacer y cómo comprobar el arreglo. Mira El prompt.
    • MCP. Si tu agente de código está conectado a Sypnia, pregúntale «¿qué está fallando en mi entorno de desarrollo?». Mira Conectar.
    • Un pull request. Nube Si instalaste la GitHub App de Sypnia, Sypnia puede abrir un pull request con el cambio y una prueba. Mira Pull requests.

    Para esta prueba, el arreglo es borrar el botón.

    Deberías ver
    Tu agente de código propone quitar el throw, o el botón de prueba.
  7. Quita el botón y resuelve el problema

    Borra el botón de prueba de tu aplicación. Después marca el problema como resuelto.

    Si el mismo error vuelve a pasar algún día, Sypnia abre el problema otra vez y lo marca «volvió».

    Deberías ver
    El problema sale de la lista de abiertos y aparece como resuelto.

Lo que acabas de ver, con un problema real

En la historia de la tienda el camino es el mismo, con clientes reales. Tres personas hacen clic en Pagar, el pago se rechaza porque la página de pago sigue leyendo cart.total, y Sypnia te dice:

3 personas intentaron pagar hoy y no pudieron. El botón Pagar no hace nada desde el cambio de ayer.

La diferencia es que no tuviste que estar ahí, y que en producción Sypnia te envía una alerta.

Sigue con

Secciones

Empieza aquíQué es Sypnia, cómo funciona, qué es código abierto y qué es la nube de pago, y las dos maneras de recibir tu primer problema en palabras claras.ConceptosLas diez ideas de las que está hecho Sypnia, cada una definida con precisión, desde un proyecto y sus llaves hasta los problemas, las trazas y las alertas.SDKCómo envía tu app los datos a Sypnia. Un SDK para el navegador, uno para Node, uno para Next.js, y la entrada de OpenTelemetry para cualquier otro backend.El agenteCómo analiza Sypnia un problema, qué escribe, qué le envía a un modelo y qué nunca hace.MCP y skillsConecta tu agente de código a Sypnia para que pregunte qué está fallando en producción, lea lo que necesita para arreglarlo y configure Sypnia por ti.Referencia de la APILa API HTTP de Sypnia: una sola API para el motor de código abierto y para Sypnia Cloud, con cada endpoint, parámetro, respuesta y error.Referencia de la CLIEl comando sypnia: cómo instalarlo, qué variables lee, qué significan sus códigos de salida y dónde está documentado cada comando.Alojamiento propioQué corres cuando alojas tú mismo el motor de Sypnia, qué necesitas, cuánto cuesta y qué no tienes frente a Sypnia Cloud.Cómo está construido el motorTodo el motor de Sypnia en una página, desde un clic en tu app hasta la frase que lee tu agente de código, con las reglas de diseño y el código que las sostiene.Sypnia CloudCómo funciona el servicio pago, desde las organizaciones y los roles hasta los planes, los límites, la facturación, dónde viven tus datos, la GitHub App y el soporte.Privacidad y seguridadQué recoge Sypnia de tu app y de sus usuarios, qué no recoge nunca, cómo funciona el enmascarado, cómo eliminar datos y cómo se protege el servicio.LicenciasQué licencia cubre cada parte de Sypnia, qué puedes hacer con ella, cómo se puede usar el nombre, y los términos de una contribución.GuíasRecetas paso a paso para las formas comunes de usar Sypnia, desde apps hechas con constructores de IA y Next.js en Vercel hasta Supabase, source maps en CI, correos de alerta desde tu propio motor, y venir desde Sentry.ReferenciaLas páginas donde se consulta, desde el esquema de eventos y el glosario hasta lo planeado, el registro de cambios y las preguntas frecuentes.
↑↓ para moverte↵ para abrirEsc para cerrar