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.
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ú
¿qué está fallando en producción?El agente llama a sypnia.problems({ status: "open" })
{
"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ú
sí, y agrega una pruebaEl agente llama a sypnia.problem({ id: "pay-button-does-nothing" })
{
"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:
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 leecart.totalCents, y el cliente ve un mensaje cuando un pago es rechazado. Agreguécheckout.test.tsxcon 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ú
ya está desplegado como 5b3c8d2, márcalo como resueltoEl agente llama a sypnia.resolve_problem({ id: "pay-button-does-nothing", release: "5b3c8d2", note: "confirmPayment reads cart.totalCents. Pull request 128." })
{
"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ú
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" })
{
"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ú
ada@example.com dice que no pudo pagar esta mañana. ¿qué pasó?El agente llama a sypnia.search({ q: "ada@example.com" })
{
"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" })
{
"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.