Public contract · 2.0

Une interface publique stable pour les agents.

Le contrat expose uniquement les informations approuvées. Les champs internes, prompts, réponses brutes, scores et secrets sont exclus par construction.

Points d’entrée

URLTYPERÔLE
/knowledge-index.jsonapplication/jsonCatalogue compact et URL des fiches
/catalog.jsonldapplication/ld+jsonDataCatalog Schema.org
/.well-known/verifllm.jsonapplication/jsonManifeste de découverte
/public-publication.schema.jsonapplication/schema+jsonValidation du contrat v2
/llms.txttext/plainRésumé non normatif pour LLM
/feed.xmlapplication/atom+xmlSuivi des mises à jour

PublicPublication

Une publication représente une version approuvée d’un ensemble de faits concernant une seule entité. schema_version vaut 2.0 et record_kind vaut entity_facts.

Les dates utilisent ISO 8601, les URL sont absolues en HTTPS et les identifiants restent stables entre les versions.

entity

CHAMPOBLIGATOIRESÉMANTIQUE
entity_idOuiIdentifiant stable, lisible dans une URL
entity_typeOuiType compatible Schema.org
nameOuiNom public contrôlé
alternate_namesNonAlias publics vérifiés
url, same_asNonURL appartenant aux preuves publiables
locationNonLocalisation structurée sans précision superflue

facts[]

Chaque fait contient fact_id, subject_id, predicate, value, status, observed_at et ses evidence_links. Un fait supported sans preuve est invalide.

Exemple synthétique minimal

{
  "schema_version": "2.0",
  "record_kind": "entity_facts",
  "entity": {
    "entity_id": "example-entity",
    "entity_type": "ProfessionalService",
    "name": "Example Entity"
  },
  "facts": [{
    "fact_id": "example-entity.locality",
    "subject_id": "example-entity",
    "predicate": "addressLocality",
    "value": "Example City",
    "status": "supported",
    "observed_at": "2026-10-06T00:00:00Z",
    "evidence_links": [{
      "url": "https://source.example/fact",
      "collected_at": "2026-10-06T00:00:00Z"
    }]
  }]
}

L’exemple utilise le domaine réservé .example et ne décrit aucune personne réelle.

Compatibilité et changement

Les consommateurs doivent refuser un numéro majeur inconnu, ignorer l’ordre des tableaux lorsqu’il n’est pas sémantique et préférer les URL canoniques. Une nouvelle version d’une fiche conserve son URL canonique et incrémente version.

Le JSON Schema publié est la référence exécutable. Cette page en est une explication, pas un second contrat.