Docs

Apps hechas con Lovable, Bolt, v0 o Replit

Agrega Sypnia a una app hecha con un constructor de apps con IA, con el prompt para darle al constructor, el código que debería producir y cómo revisar que lo hizo bien.

Aplica a MotorNube Al lanzar

Ver como Markdown
En esta página
  1. El prompt
  2. En tu constructor
  3. Revisa que el constructor lo hizo bien
  4. La app sigue funcionando
  5. Sypnia lo recibe
  6. Pídele al constructor que confirme
  7. Cuando Sypnia reporta un problema

Esta guía es para quien construyó su app describiéndola. No necesitas leer código para seguirla. Funciona con Sypnia Cloud y con un motor con alojamiento propio; los ejemplos usan Sypnia Cloud, y cambia una línea para tu propio motor.

Al final tendrás: Sypnia vigilando la app que hizo tu constructor, de modo que cuando un botón deje de funcionar después de «un cambio pequeño», te lo digan en una frase, con un prompt que puedes pegar de vuelta en el constructor.

Necesitas: un proyecto en Sypnia y su llave de ingesta, que empieza por spk_. El inicio rápido de Sypnia Cloud crea ambos en su primer paso.

El prompt

Pega esto en el chat de tu constructor, con tu propia llave en lugar de la del ejemplo. Está escrito para que el constructor no pueda equivocarse en lo importante. Va en inglés porque así lo entienden mejor estas herramientas.

Text
Add Sypnia monitoring to this app.

1. Install the npm package @sypnia/browser. (If this is a Next.js app, install
   @sypnia/next instead and follow https://docs.sypnia.com/sdks/nextjs.md.)
2. In the file where the app starts, before it renders, add:

   import { init } from '@sypnia/browser';

   init({
     project: 'spk_7d1f0c9e4b8a2f6d3c5e1a9b0f4d8c2e',
     environment: location.hostname === 'MY-REAL-DOMAIN.com' ? 'production' : 'development',
   });

   Replace MY-REAL-DOMAIN.com with the domain where my customers use the app.
3. Call init exactly once. Do not wrap it in a component or an effect.
4. Where the app knows who signed in, call
   identify({ person: { id: user.id } }) from '@sypnia/browser',
   and identify(null) on sign-out. Send the id only, no name or e-mail.
5. Do not add any other Sypnia call. Do not try to record what people type.
   The key above is public and belongs in the code; never add a key that starts with sps_.
6. Show me the files you changed.

Reference: https://docs.sypnia.com/llms.txt

Con un motor con alojamiento propio, agrega una línea a la llamada init del prompt: endpoint: 'https://sypnia.example.com', con la dirección de tu motor.

Por qué importa la línea environment: los constructores muestran tu app en una vista previa mientras trabajas. Sin esa línea, cada prueba que hagas en la vista previa contaría como un cliente real y te enviaría alertas.

En tu constructor

Lo que sigue es lo que sabemos que es estable de cada herramienta: qué clase de app hace y dónde va el código. Los menús y los nombres de estas herramientas cambian seguido. Donde un paso depende de funciones propias de la herramienta, lo dice: revisa la documentación actual de la herramienta en vez de confiar en un nombre de menú escrito aquí.

Lovable

Lovable hace apps React construidas con Vite.

  • Dale el prompt de arriba. La llamada init va en src/main.tsx, antes de la línea que pinta la app.
  • Si pregunta dónde guardar la llave: en el código está bien. La llave de ingesta es pública.
  • Si tu app usa Supabase (Lovable se conecta con él), lee también Apps con Supabase: una opción más registra las llamadas a tu base de datos.
  • Revisa el resultado en la app publicada, no solo en la vista previa. Si puedes abrir y editar el código tú mismo, o sincronizarlo con GitHub, depende de tu plan: revisa la documentación actual de Lovable.

Revisa que el constructor lo hizo bien

No tienes que leer el código. Revisa tres cosas:

  1. La app sigue funcionando

    Abre la app publicada y úsala como lo haría un cliente.

    Deberías ver
    Todo se comporta como antes. Sypnia no muestra nada en tus páginas.
  2. Sypnia lo recibe

    En Sypnia, abre Sesiones. Elige el entorno production si usaste tu dominio real, development si usaste la vista previa.

    Deberías ver
    En menos de 10 minutos, tu propia visita, con las páginas que abriste y en qué hiciste clic.
  3. Pídele al constructor que confirme

    Pega: «List every place where Sypnia is called in this app, and confirm that init is called once and that no key starting with sps_ is in the code.»

    Deberías ver
    Un init, máximo un identify y un identify(null), y ninguna llave sps_.

Si no aparece ninguna sesión, las causas más comunes con constructores son un init puesto dentro de un componente (corre tarde o dos veces) y una dirección de vista previa que no coincide con la línea environment. Solución de problemas tiene la lista completa.

Cuando Sypnia reporta un problema

Esta es la parte que estas herramientas hacen fácil. Cada problema viene con un prompt escrito para un agente de código: qué pasa, dónde, por qué, qué cambiar y cómo revisarlo. Cópialo del problema y pégalo en el chat de tu constructor. Mira El prompt.

Dos límites, dichos con honestidad:

  • Nombres de archivo en los problemas. Sypnia muestra el archivo y la línea de tu propio código solo si tu compilación sube sus source maps. Si puedes agregar un paso de compilación depende del constructor; con una app Next.js en Vercel son dos variables de entorno (Next.js en Vercel). Sin source maps el problema igual dice qué pasó, a quién y desde cuándo.
  • Los pull requests Nube necesitan tu código en GitHub y la GitHub App de Sypnia. Si tu constructor sincroniza con GitHub, funciona; si no, usa el prompt.

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