# 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: el motor de Sypnia (código abierto, en tu propia infraestructura) y Sypnia Cloud (servicio pago). Estado: al lanzar.  
Fuente: https://docs.sypnia.com/es/start/your-first-problem/

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](https://docs.sypnia.com/es/start/quickstart-cloud) o [alojamiento propio](https://docs.sypnia.com/es/start/quickstart-self-host).

> **Nota: Hazlo en desarrollo**
>
> Haz esto en tu entorno de desarrollo, no frente a tus clientes. Sypnia mantiene cada entorno aparte, así que esta prueba no se mezcla con los datos de producción. Las alertas solo se envían para producción, así que esta prueba no envía ninguna.

### 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`

```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>
```

**React**

`AnyPage.tsx`

```tsx
export function SypniaTest() {
  return (
    <button
      onClick={() => {
        throw new Error('Sypnia test: the cart total is missing');
      }}
    >
      Test Sypnia
    </button>
  );
}
```

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](https://docs.sypnia.com/es/concepts/releases-and-source-maps).
- **Las sesiones** donde pasó.

Haz clic otra vez mañana y el conteo del problema sube; no aparece un segundo problema. [Problemas](https://docs.sypnia.com/es/concepts/problems) explica qué hace que dos fallas sean el mismo problema.

> **Nota: ¿Alojamiento propio y no hay frase?**
>
> El análisis del motor está apagado hasta que le das una llave de modelo. El problema, sus sesiones y su grabación funcionan sin él. Mira [Modelos y qué se envía](https://docs.sypnia.com/es/agent/models-and-what-is-sent).

**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](https://docs.sypnia.com/es/agent/the-prompt).
- **MCP.** Si tu agente de código está conectado a Sypnia, pregúntale «¿qué está fallando en mi entorno de desarrollo?». Mira [Conectar](https://docs.sypnia.com/es/mcp/connect).
- **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](https://docs.sypnia.com/es/agent/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
