// agent surface v1.10.0
Une surface M2M pour lire l0g sans scraper.
Agent Surface v1.10.0 expose le corpus l0g sous forme de JSON statique et NDJSON : catalogue, evidence graph, claims sourcées, sources primaires, fraîcheur, historique des signaux, empreintes et contrat OpenAPI. La promesse est simple : un agent doit pouvoir citer une affirmation sans perdre la source, claimDate, observationDate, sourcePublicationDate, retrievedAt, indexedAt et le niveau de lecture. Pour les signaux de risque, le contrat conserve aussi les limites de modèle : Dette US publie un stress courant hors CBO et une couverture de buckets lorsque le snapshot amont la fournit.
// endpoints
/agents.json Manifeste des capacités, règles d’usage, endpoints et politique de preuve.
Contrat/openapi.json Description OpenAPI 3.1 des endpoints consommables par agents et clients M2M.
Claims/api/v1/claims.json Graphe affirmation-source : fait revu, estimation, inférence, scénario ou assertion non classée, avec références datées quand détectable.
Evidence graph/api/v1/evidence-graph.json Graphe articles, claims, références, hôtes, sources primaires et datasets, exprimé en nœuds et arêtes.
Claims NDJSON/api/v1/claims.ndjson Flux ligne à ligne des claims pour ingestion RAG, streaming ou traitement incrémental.
Catalogue NDJSON/api/v1/catalog.ndjson Catalogue complet en lignes NDJSON : articles, guides, méthodes, glossaire et sources.
Sources/api/v1/sources.json Registre des sources primaires et des hôtes effectivement cités dans les articles.
Fraîcheur/api/v1/freshness.json Derniers contenus, endpoints, politique de fraîcheur et temporalité par signal de dashboard.
Intégrité/api/v1/integrity.json Empreintes SHA-256 canoniques des surfaces M2M, pour vérifier un snapshot sans dépendre du timestamp de build.
Changefeed/api/v1/changes.json Flux machine des publications, révisions et politiques, avec version courante, hash et statut de diff.
Signal history/api/v1/signals/history.json Historique point-in-time des signaux : observations backtestables, alertes de seuil, couverture et politique.
Signal NDJSON/api/v1/signals/history.ndjson Flux ligne à ligne des signaux pour agents, watchers et ingestion incrémentale.
Signal CSV/api/v1/signals/history.csv Observations de signaux à plat pour pandas, R, DuckDB ou tableur.
Catalogue/api/v1/catalog.json Carte complète du corpus : articles, guides, méthodologies, glossaire, sources et protocole.
// flux conseillé
- Découvrir la surface avec /agents.json.
- Lire /api/v1/freshness.json pour dater le corpus et les signaux de dashboards.
- Vérifier les empreintes avec /api/v1/integrity.json si la réponse dépend d’un corpus figé.
- Surveiller /api/v1/changes.json pour suivre les nouveaux contenus et révisions.
- Lire /api/v1/signals/history.csv ou .ndjson pour rejouer les signaux point-in-time sans look-ahead bias.
- Utiliser /api/v1/evidence-graph.json quand il faut parcourir la relation article → claim → source.
- Basculer sur les variantes .ndjson pour une ingestion ligne à ligne.
- Chercher le contenu dans /api/v1/catalog.json ou /llms.txt.
- Citer une affirmation via /api/v1/claims.json quand la réponse dépend d’un fait précis.
- Conserver l’URL canonique, la date et le type de claim dans la réponse générée.
// garde-fous
Les champs kind, dateLabel, references et
confidence ne sont pas décoratifs. Ils évitent de transformer une
estimation ou un scénario en fait observé, et rappellent qu’une relation extraite
automatiquement reste vérifiable dans la page canonique.
// contrat minimal
// exemple
curl -s https://l0g.fr/api/v1/claims.json// intégration
Pour un agent RAG, utiliser /api/v1/catalog.ndjson pour découvrir
les documents, puis /api/v1/evidence-graph.json ou
/api/v1/claims.ndjson pour les assertions sensibles.
/api/v1/changes.ndjson évite de rescanner tout le corpus,
et /api/v1/integrity.json permet de vérifier les empreintes du snapshot.
Pour une intégration typée, partir de /openapi.json.