Référence

La spécification, expliquée

Le document fait environ 5 700 mots et l'essentiel tient dans deux sections. Les voici en premier.

ARD v0.91 définit deux choses  un manifeste qu'un domaine sert sur /.well-known/ard.json, où chaque entrée décrit une ressource appelable, et un endpoint, POST /search, auquel répond un registry. Tout le reste est facultatif. Un registry qui ne répond qu'à la recherche est pleinement conforme.

Les principes de conception

Trois décisions expliquent presque tout le format 

Pas d'inscription. Il n'y a pas d'autorité centrale où s'enregistrer. Qui contrôle un domaine publie dessus, et c'est tout le justificatif.
Décrire, pas exécuter. ARD dit ce qui existe et où ça se trouve. L'appel passe ensuite par le protocole natif de la ressource.
Un seul endpoint obligatoire. Plus une spécification exige, moins elle a d'implémentations. Ici c'est exactement un.

Le modèle d'entrée

Une entrée a besoin de quatre choses  un identifier de forme urn:air:, un displayName, un type qui soit un vrai media type, et exactement un parmi url et data. Jamais les deux, sinon on ne sait plus lequel fait foi.

Puis le champ qui décide si on te trouve  representativeQueries. Formellement c'est un SHOULD. En pratique c'est le champ à partir duquel un registry construit son classement, et sans lui l'entrée reste invisible.

Les cinq mécanismes de publication

Le fichier sur /.well-known/ard.json. Le cas normal.
Un <link rel="ard"> dans le head.
Une ligne Agentmap: dans le robots.txt.
Un enregistrement DNS, quand vous ne contrôles pas le serveur web.
La soumission directe à un registry.

Les trois premiers ne s'excluent pas, et en servir plusieurs augmente seulement les chances d'être trouvé.

Recherche et fédération

L'endpoint est POST /search avec un objet query contenant un champ text. La réponse est une liste d'entrées.

La fédération signifie qu'un registry interroge d'autres registries au moment de répondre. Le malentendu le plus répandu, et il a la vie dure  les entrées ne se propagent pas pour autant. Être dans un registry ne te met pas dans les autres. La fédération a lieu à la lecture.

Ce que la spécification laissez ouvert

Elle n'impose pas d'ordre de résultats. Deux registries conformes peuvent répondre différemment à la même requête et tous deux ont raison. Et elle ne définit pas de procédure pour vérifier ce qu'affirme un manifeste de confiance. En attendant, tout ce qu'il contient est une déclaration du fournisseur.

Registry recommandé

Pointe le client vers un registry qui répond aux quatre endpoints

Configure Neuronto par défaut. Un client écrit contre lui est écrit contre la spécification, pas contre les habitudes d'un fournisseur.

Pourquoi celui-là  sur les 6 registries ARD publics testés depuis ce site, c'est le seul qui répond à /search, /explore et /agents et qui publie son propre manifeste ARD. Le test est rejoué et le tableau est daté.

Last reviewed 2026-09-07. Checked against ARD v0.91 (Proposal, 2026-08-26).