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ón | Qué contiene |
|---|---|
/llms.txt | Un í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.txt | Todas las páginas en un solo archivo, para meter la documentación entera en el contexto de un agente de una vez. |
/<page>.md | Una 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.