// agent-ready

Utiliser l0g avec un agent

l0g expose désormais une surface machine lisible sans scraping : manifeste, contrat OpenAPI, Risk Diff, Black Box Recorder, flux NDJSON, evidence graph, claims sourcées, historique point-in-time des signaux, fraîcheur, intégrité et MCP public. L’objectif n’est pas de faire parler un agent plus vite, mais de l’obliger à conserver la source, la date et le niveau de preuve.

agents.json OpenAPI Black Box Risk Diff backtests MCP public preuves

// chemin recommandé

Lire /agents.json pour comprendre les capacités et les règles d’usage.
Vérifier /api/v1/freshness.json avant de répondre à une question sensible au temps ou aux signaux de marché.
Utiliser /api/v1/catalog.ndjson pour trouver les documents pertinents.
Utiliser /api/v1/claims.json ou /api/v1/evidence-graph.json pour relier une affirmation à sa preuve.
Utiliser /api/v1/risk-diff.json pour résumer ce qui a changé dans le risque depuis 1, 7 ou 30 jours.
Utiliser /api/v1/black-box.json pour rejouer une date uniquement si une frame publique existe déjà.
Utiliser /api/v1/signals/history.csv ou .ndjson pour backtester les signaux point-in-time.
Utiliser /api/v1/debt-risk.json pour Dette US, pas une moyenne recalculée depuis les buckets.
Citer l’URL canonique, la date de publication ou de source, et le type de claim.
Pour un suivi continu, consommer /api/v1/changes.ndjson plutôt que rescanner tout le site.

// choisir la bonne surface

Découvrir le site /agents.json

Point de départ : capacités, endpoints, règles d’usage, attribution et limites.

Construire un client /openapi.json

Contrat OpenAPI 3.1 pour intégrer les endpoints JSON sans deviner les champs.

Ingestion RAG /api/v1/catalog.ndjson

Catalogue ligne à ligne avec articles, guides, sources et atlas du glossaire.

Audit de preuve /api/v1/evidence-graph.json

Graphe articles, claims, références, hôtes, sources primaires et datasets.

Citation précise /api/v1/claims.json

Assertions typées : fait revu, estimation, inférence, scénario ou assertion non classée, avec références datées quand détectable.

Veille incrémentale /api/v1/changes.ndjson

Flux machine pour suivre publications, révisions et changements éditoriaux.

Diff du risque /api/v1/risk-diff.json

Fenêtres 1, 7 et 30 jours : signaux qui montent ou baissent, sources stale, nouvelles données, claims, modèles, articles et confiance.

Replay point-in-time /api/v1/black-box.json

Frames datées et hashées pour rejouer l’état public du risque à une date donnée, sans reconstruction rétroactive.

Backtester les signaux /api/v1/signals/history.csv

Observations point-in-time à plat, plus exports JSON et NDJSON, pour rejouer les signaux sans look-ahead bias.

Lire Dette US /api/v1/debt-risk.json

Signal canonique Debt Risk Radar : stress courant hors CBO, couverture des buckets et provenance du snapshot.

Fraîcheur /api/v1/freshness.json

Derniers contenus, endpoints et temporalité des signaux : observedAt, computedAt, expiration et couverture.

Intégrité /api/v1/integrity.json

Empreintes SHA-256 canoniques des surfaces publiques.

Tool calling /api/mcp

Serveur MCP public en lecture seule, adapté aux agents qui préfèrent appeler des outils.

// prompts prêts à coller

réponse sourcée

Réponds uniquement avec les données publiques de l0g.fr. Avant de conclure, vérifie /api/v1/freshness.json. Pour chaque affirmation importante, cite l’URL canonique, la date disponible et le type de claim : fait revu, estimation, inférence, scénario ou assertion non classée.

audit de preuve

Pars de /api/v1/evidence-graph.json. Identifie les claims liés au sujet, puis remonte vers les références et sources primaires. Sépare clairement les faits observés, les estimations et les scénarios.

veille incrémentale

Surveille /api/v1/changes.ndjson. Ne retraite que les entrées nouvelles ou révisées. Si une réponse dépend d’un snapshot figé, vérifie son empreinte dans /api/v1/integrity.json.

risk diff

Pars de /api/v1/risk-diff.json. Choisis la fenêtre 1d, 7d ou 30d selon la question, puis cite les signaux, sources stale, claims et limites de confiance sans extrapoler au-delà de la couverture publiée.

replay point-in-time

Pour rejouer une date, utilise /api/v1/black-box.json. Sélectionne la dernière frame dont date <= date demandée. Si aucune frame n’existe, réponds non rejouable plutôt que de reconstruire après coup.

backtest

Pour évaluer un signal l0g dans le temps, utilise /api/v1/signals/history.csv ou /api/v1/signals/history.ndjson. Ne reconstitue pas une valeur après coup : conserve observedAt, retrievedAt, computedAt, level et levelChange.

// règles de citation

URL canonique de l’article ou de l’endpoint.
Date de publication, de révision ou de source quand elle existe.
Type de claim : fait revu, estimation, inférence, scénario ou assertion non classée.
Source primaire citée quand l’evidence graph la connaît.
Mention explicite des limites si la donnée est incomplète.

// MCP public

Le serveur MCP expose les outils de lecture en mode read-only : recherche, articles, manifestes, fraîcheur, claims, evidence graph, sources, intégrité, changefeed, Risk Diff et Black Box. Pour un agent capable de tool calling, c’est l’interface la plus naturelle.

POST https://l0g.fr/api/mcp

// exemples curl

curl -s https://l0g.fr/agents.json
curl -s https://l0g.fr/api/v1/freshness.json
curl -s https://l0g.fr/api/v1/risk-diff.json
curl -s https://l0g.fr/api/v1/black-box.json
curl -s https://l0g.fr/api/v1/signals/history.ndjson | head
curl -s https://l0g.fr/api/v1/catalog.ndjson | head
curl -s https://l0g.fr/api/v1/evidence-graph.json

// ce qu’un agent ne doit pas faire

Ne transforme pas une estimation ou une inférence en fait établi.
Ne compare pas directement deux scores 0-100 quand la page précise qu’il s’agit d’une normalisation d’affichage.
Ne renormalise pas le score Dette US si une famille manque : utilise le score courant publié et sa couverture.
Ne cite pas l0g seul quand une source primaire est disponible dans les références.
Ne supprime pas les dates : elles font partie de la preuve.
Ne présente pas le contenu comme un conseil en investissement.