# Ejemplos

> Tres sesiones completas con un agente de código conectado a Sypnia: arreglar un problema de principio a fin, encontrar por qué una página está lenta y ver qué vio un cliente.

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/mcp/examples/

Para agentes: Sesiones MCP completas con las llamadas y resultados exactos: (1) qué falla -> problems -> problem -> arreglo -> resolve_problem, (2) rendimiento de una página lenta, (3) buscar a una persona -> sessions -> línea de tiempo de la sesión.

**\[Motor]** **\[Nube]** Tres sesiones, escritas completas. Cada una muestra lo que escribes, qué herramienta llama el agente, qué vuelve y qué hace el agente con eso. Los datos son los de la tienda del resto de esta documentación. Los resultados están recortados; los completos están en la [referencia de herramientas](https://docs.sypnia.com/es/mcp/tools-reference).

Tu cliente muestra una llamada bajo el nombre del servidor. Esta página escribe `sypnia.problems({ … })`; el tuyo puede mostrar `sypnia:problems` o `mcp__sypnia__problems`.

## 1. Arreglar lo que está fallando

La sesión de la página de inicio de Sypnia, completa.

**Tú**

```text
¿qué está fallando en producción?
```

**El agente** llama a `sypnia.problems({ status: "open" })`

```json
{
  "problems": [
    {
      "slug": "pay-button-does-nothing",
      "status": "open",
      "sentence": "3 people tried to pay today and could not. The Pay button does nothing since yesterday's change.",
      "confidence": "high",
      "where": { "file": "src/checkout/checkout.tsx", "line": 142, "function": "confirmPayment" },
      "people": 3,
      "first_seen": "2026-03-12T09:12:04Z",
      "first_release": "4f2a91c"
    }
  ],
  "counts": { "open": 1, "resolved": 4, "ignored": 1 }
}
```

**El agente**

> 1 problema abierto desde el despliegue de ayer: 3 personas intentaron pagar y no pudieron. El checkout envía el pago sin monto. Tengo la traza y la sesión. ¿Lo arreglo?

**Tú**

```text
sí, y agrega una prueba
```

**El agente** llama a `sypnia.problem({ id: "pay-button-does-nothing" })`

```json
{
  "analysis": {
    "cause": {
      "text": "Release 4f2a91c renamed the cart's total from cart.total to cart.totalCents. The checkout still reads cart.total, so the payment goes out without an amount and the API answers 400.",
      "evidence": [
        { "kind": "release_change", "ref": "4f2a91c:src/cart/cart.ts", "text": "The release renames `total` to `totalCents` in the Cart type." },
        { "kind": "stack_frame", "ref": "src/checkout/checkout.tsx:142", "text": "confirmPayment() still passes `cart.total` to createPayment()." }
      ]
    },
    "what_to_do": "Read cart.totalCents in confirmPayment(), and show the customer a message when a payment is rejected.",
    "confidence": "high"
  },
  "stack": {
    "frames": [
      {
        "function": "confirmPayment", "file": "src/checkout/checkout.tsx", "line": 142,
        "source": { "start_line": 140, "lines": [
          "async function confirmPayment(cart: Cart) {",
          "  setPaying(true);",
          "  const payment = await createPayment({ amount: cart.total, currency: cart.currency });"
        ] }
      }
    ]
  },
  "release": { "version": "4f2a91c", "changes": { "commits": [{ "sha": "4f2a91c", "message": "Rename cart.total to cart.totalCents" }] } }
}
```

El agente abre `src/checkout/checkout.tsx`, ve que la línea 142 todavía lee `cart.total` y confirma en `src/cart/cart.ts` que el campo ahora es `totalCents`. Escribe una prueba que falla cuando falta el monto y luego edita el archivo:

`src/checkout/checkout.tsx`

```diff
 async function confirmPayment(cart: Cart) {
   setPaying(true);
-  const payment = await createPayment({ amount: cart.total, currency: cart.currency });
-  router.push(`/orders/${payment.orderId}`);
+  try {
+    const payment = await createPayment({ amount: cart.totalCents, currency: cart.currency });
+    router.push(`/orders/${payment.orderId}`);
+  } catch (error) {
+    setError('We could not take the payment. Nothing was charged. Please try again.');
+  } finally {
+    setPaying(false);
+  }
 }
```

**El agente**

> Arreglado: `confirmPayment()` ahora lee `cart.totalCents`, y el cliente ve un mensaje cuando un pago es rechazado. Agregué `checkout.test.tsx` con una prueba que falla cuando falta el monto; ahora pasa, junto con las otras 41. No hice ningún commit.

Tú revisas, haces merge y despliegas. Después:

**Tú**

```text
ya está desplegado como 5b3c8d2, márcalo como resuelto
```

**El agente** llama a `sypnia.resolve_problem({ id: "pay-button-does-nothing", release: "5b3c8d2", note: "confirmPayment reads cart.totalCents. Pull request 128." })`

```json
{
  "slug": "pay-button-does-nothing",
  "status": "resolved",
  "resolved_at": "2026-03-12T16:30:12Z",
  "resolved_by": "mcp:Cursor",
  "resolved_in_release": "5b3c8d2"
}
```

**El agente**

> Marcado como resuelto en la versión 5b3c8d2. Si vuelve a pasar en esa versión o en una posterior, Sypnia lo reabre y te avisa.

> **Nota: Tres llamadas**
>
> Todo el arreglo tomó tres llamadas: una para listar, una para leer, una para marcar. Esta vez el agente no necesitó la sesión ni la traza porque el análisis estaba seguro. Cuando `confidence` es `low`, o el análisis es `not_enough_evidence`, espera que llame a `session` y lea los cambios de la versión antes de tocar código.

## 2. Saber por qué una página está lenta

**Tú**

```text
el resumen diario dice que la búsqueda se puso más lenta. ¿por qué?
```

**El agente** llama a `sypnia.performance({ route: "/search", since: "24h" })`

```json
{
  "route": "/search",
  "page": { "views": 1840, "lcp_p75_ms": 3100, "previous_lcp_p75_ms": 1900, "inp_p75_ms": 180, "cls_p75": 0.04, "poor_share": 0.21 },
  "elements": {
    "lcp": [
      { "selector": "main ul.results > li:nth-child(1) img", "kind": "image", "samples": 1310, "p75_ms": 3200, "poor_share": 0.24 }
    ]
  },
  "suggestions": [{ "id": "sug_3h7j1k5l9p2o", "title": "The search page's first product image loads slowly" }]
}
```

**El agente**

> La página de búsqueda ahora tarda 3,1 segundos en mostrar su contenido principal en tres de cada cuatro visitas; antes eran 1,9. El elemento lento es la primera imagen de producto de los resultados (`main ul.results > li:nth-child(1) img`), en 1.310 de 1.612 cargas medidas. La interacción y el diseño están bien. Voy a ver cómo se pinta esa imagen.

El agente encuentra el componente de resultados, ve que la versión de ayer cambió la URL de la miniatura por la imagen completa, y propone volver a servir la miniatura y cargar la primera imagen con prioridad alta.

Aquí nada es un problema: nadie vio un error. El agente pasó de «más lenta» a un elemento y una línea de código con una sola llamada.

## 3. Ver qué vio un cliente

Una clienta le escribió a soporte: «Intenté pagar tres veces y no pasó nada».

**Tú**

```text
ada@example.com dice que no pudo pagar esta mañana. ¿qué pasó?
```

**El agente** llama a `sypnia.search({ q: "ada@example.com" })`

```json
{
  "people": [
    {
      "id": "u_1042", "name": "Ada Park", "email": "ada@example.com",
      "last_seen": "2026-03-12T10:31:58Z",
      "latest_sessions": [{ "id": "8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0", "started_at": "2026-03-12T10:31:16Z", "trouble": true }]
    }
  ]
}
```

**El agente** llama a `sypnia.session({ id: "8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0" })`

```json
{
  "events": [
    { "offset_ms": 12412, "type": "page_view", "text": "Opened /checkout (from /cart)" },
    { "offset_ms": 27090, "type": "click", "text": "Clicked button «Pay $64.00» in «Your order»" },
    { "offset_ms": 29310, "type": "rage_click", "text": "Clicked button «Pay $64.00» 4 more times" },
    { "offset_ms": 31000, "type": "request", "text": "POST /api/checkout answered 400 amount_required after 3,870 ms" },
    { "offset_ms": 31004, "type": "error", "text": "ApiError: POST /api/checkout failed with 400 (amount_required)", "problem": "pay-button-does-nothing" },
    { "offset_ms": 42230, "type": "page_leave", "text": "Left /checkout after 30 s" }
  ]
}
```

**El agente**

> Ada abrió el checkout a las 10:31, tocó «Pay $64.00» y luego cuatro veces más porque no pasaba nada. El pago fue rechazado porque salió sin monto, y la página no le mostró nada. Se fue 11 segundos después. No se le cobró. Es el problema conocido «pay-button-does-nothing», que hoy afectó a 3 personas. La grabación de su sesión está en <https://app.sypnia.com/shop/sessions/8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0>.

La búsqueda por correo funciona porque la tienda envía nombres y correos con `identify()`. Un proyecto que solo envía ids se busca por id. La línea de tiempo tiene lo que ella tocó, por la etiqueta del botón, y nunca nada de lo que escribió. El agente te da el enlace a la grabación; no puede verla.
