Docs

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 MotorNube Al lanzar

Ver como Markdown
En esta página
  1. 1. Arreglar lo que está fallando
  2. 2. Saber por qué una página está lenta
  3. 3. Ver qué vio un cliente

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.

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

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.

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