Avec des agents IA
Donnez cette documentation à Claude Code, Cursor ou tout autre agent de code, avec un prompt qui ajoute Lyrelog à votre projet.
Chaque page de cette documentation existe aussi en Markdown brut : un agent de code peut donc lire la documentation au lieu de s'appuyer sur sa mémoire, qui se trompe pour un service aussi récent que Lyrelog.
Fichiers pour les agents
| Adresse | Contenu |
|---|---|
/llms.txt | Un index de toutes les pages avec leur description, chacune liée à son Markdown. Le format llms.txt que cherchent les agents. |
/llms-full.txt | Toutes les pages dans un seul fichier, pour mettre toute la documentation d'un coup dans le contexte d'un agent. |
/<page>.md | Une page, par exemple /sdks/go.md. |
Sous son titre, chaque page propose aussi Copy Markdown, et Open pour l'envoyer à ChatGPT, Claude ou Cursor.
Un prompt pour ajouter Lyrelog à votre projet
Collez-le dans votre agent, avec votre clé d'ingestion à la place de lyr_ing_... (page
API keys du projet, voir Clés ; elle ne fait qu'écrire, elle peut donc
être embarquée sans risque dans une app). Si vous préférez garder la clé hors du dépôt,
mettez-la dans une variable d'environnement et donnez son nom à l'agent.
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.Les SDK ne sont pas encore publiés, un agent ne peut donc pas les installer aujourd'hui : le prompt fonctionnera dès qu'ils le seront. En attendant, l'agent peut envoyer les événements par l'API HTTP.
Laissez un agent lire vos événements
L'outil en ligne de commande permet à un agent de code de rechercher des événements,
de lire les erreurs et de suivre une personne au fil d'une session, connecté en votre nom. Il
écrit du JSON quand c'est un agent qui le lance. Vous vous connectez une fois avec
lyrelog login ; l'agent ne peut pas se connecter tout seul. Voir
Pour les agents et les scripts, avec un prompt pour enquêter sur une erreur.
Conseils
- Nommez la page. « Read https://docs.lyrelog.com/sdks/python.md and add Lyrelog to the FastAPI app » est plus rapide et plus précis qu'une recherche.
- Demandez un événement de test. Faites logger un événement par l'agent au démarrage de l'app, lancez-la et vérifiez qu'il arrive (voir Démarrage rapide) : c'est le moyen le plus rapide de repérer une mauvaise clé ou un mauvais environnement.
- Relisez ce qu'il logge. Les agents ont tendance à trop logger. Un événement par chose qui s'est passée, avec un nom stable, est plus facile à rechercher, à tracer et à payer qu'une ligne par appel de fonction.