Acceso anticipadoSolo por invitación, y los SDK aún no están publicados.Pedir una invitación
Ir al contenido
Docs

Uso con agentes de IA

Dale estos docs a Claude Code, Cursor o cualquier agente de programación, junto con un prompt que añade Lyrelog a tu proyecto.

Cada página de estos docs también existe en Markdown sin más, así que un agente de programación puede leer la documentación en vez de tirar de memoria, que con un servicio nuevo como Lyrelog suele fallar.

Archivos para agentes

DirecciónQué contiene
/llms.txtUn índice de todas las páginas con su descripción, cada una enlazada a su Markdown. Es el formato llms.txt que buscan los agentes.
/llms-full.txtTodas las páginas en un solo archivo, para meter la documentación entera en el contexto de un agente de una vez.
/<page>.mdUna sola página, por ejemplo /sdks/go.md.

Debajo del título de cada página también tienes Copy Markdown y Open, para enviarla a ChatGPT, Claude o Cursor.

Un prompt para añadir Lyrelog a tu proyecto

Pégalo en tu agente, con tu clave de ingesta en lugar de lyr_ing_... (está en la página API keys del proyecto, consulta Claves; solo escribe, así que es seguro incluirla en una app). Si lo prefieres, deja la clave fuera del repositorio: ponla en una variable de entorno y dile al agente cómo se llama.

Add Lyrelog logging to this project. Read https://docs.lyrelog.com/llms.txt first, then the
page of the SDK for this project's language (or the HTTP API page if there's no SDK for it).
Don't rely on what you remember about Lyrelog: follow the docs.

1. Install the SDK and start it once, where the app or service starts, with the ingest key
   lyr_ing_... (or from the environment variable LYRELOG_KEY). Keep the default endpoint.
2. Make sure queued events are sent before the process ends: flush or close the client as the
   SDK page says for this kind of program (server, CLI, serverless function, app).
3. Capture errors: unhandled ones the way the SDK page shows, and the places in this code that
   catch an error and carry on.
4. Log a few events where something happens to a person: sign in, a payment, a sync, a failed
   request. Use a stable snake_case name as the message (payment_declined), a level, an area
   (category) and attributes with the details to filter by.
5. Identify the person with our own user id (setUser or the SDK's equivalent), never an email
   address, and clear it on sign-out.
6. Never put passwords, tokens, keys, cookies, full request bodies or personal data in messages,
   attributes or payloads.
7. Tell me which environment the events will arrive under, so I can pick it in the dashboard.

Los SDK aún no están publicados, así que hoy un agente no puede instalarlos: el prompt funcionará cuando lo estén. Mientras tanto, puede enviar eventos por la API HTTP.

Deja que un agente lea tus eventos

La herramienta de línea de comandos permite que un agente de programación busque eventos, lea errores y siga a una persona a lo largo de una sesión, con tu sesión iniciada. Cuando la ejecuta un agente, escribe JSON. Inicias sesión una vez con lyrelog login; el agente no puede iniciar sesión por su cuenta. Consulta Para agentes y scripts, donde hay un prompt para investigar un error.

Consejos

  • Indica la página. "Read https://docs.lyrelog.com/sdks/python.md and add Lyrelog to the FastAPI app" es más rápido y preciso que una búsqueda.
  • Pide un evento de prueba. Haz que el agente registre un evento al arrancar la app, que la ejecute y que compruebe que llega (consulta Inicio rápido): es la forma más rápida de detectar una clave o un entorno equivocados.
  • Revisa lo que registra. Los agentes tienden a registrar demasiado. Un evento por cada cosa que ha pasado, con un nombre estable, es más fácil de buscar, graficar y pagar que una línea por cada llamada a una función.