ai-catalog.json : rôle et passage à ARD

Auteur : Rédaction Domeny.ForSale Publié le 03.10.2026 Mis à jour le 03.10.2026

En bref : /.well-known/ai-catalog.json est l’ancien chemin de publication d’un manifeste de ressources pour les agents AI. La spécification Agentic Resource Discovery (ARD) le présente comme le prédécesseur de /.well-known/ard.json. Ce manifeste décrit les outils et agents disponibles, ou leurs instructions d’utilisation, dans un format JSON structuré. Pour un nouveau déploiement, il faut utiliser le chemin ard.json et le lien HTML rel="ard".

Cet article s’appuie sur la spécification ARD v0.91 du 26 août 2026, marquée Proposal, c’est-à-dire une proposition. L’état de la documentation a été vérifié le 3 octobre 2026.

À quoi sert un catalogue de ressources pour agents ?

Un assistant qui a besoin d’un outil externe doit d’abord déterminer ce que cet outil fait et où trouver sa description. Le manifeste permet à l’éditeur de présenter ces informations dans une structure commune. Chaque entrée peut notamment renvoyer à la description d’un serveur MCP, à une carte d’agent A2A ou à un fichier d’instructions pour accomplir une tâche, appelé skill.

Dans ARD, la publication du manifeste constitue la partie statique de la découverte des ressources. Le registre remplit un rôle distinct : il récupère les entrées, les indexe et propose une fonction de recherche. Le client peut ainsi formuler un besoin précis et recevoir les ressources correspondantes. Le fichier JSON lui-même n’exécute pas les outils ; leur mode d’exécution est défini par le protocole ou les instructions concernés. Ces différentes couches sont décrites dans les chapitres 3 et 5 de la spécification .

Pourquoi utilise-t-on désormais ard.json ?

Au chapitre 5.1 , la spécification définit des règles précises pour trouver les manifestes :

Mécanisme	Nom actuel	Ancien nom
Fichier sur le domaine	`/.well-known/ard.json`	`/.well-known/ai-catalog.json`
Lien dans le HTML	`rel="ard"`	`rel="ai-catalog"`
Prise en charge par le client ARD	Obligatoire pour découvrir les entrées du domaine	Rétrocompatibilité facultative

Un client conforme à la spécification qui découvre les ressources d’un domaine doit récupérer /.well-known/ard.json et prendre en compte le lien rel="ard". Il peut également vérifier l’ancien chemin et la relation ai-catalog ; dans ce cas, il les traite comme des sources d’entrées équivalentes.

Un site qui ne propose que ai-catalog.json peut donc ne pas être découvert par un client ARD fonctionnant correctement. La spécification recommande de passer à ard.json. Conserver l’ancienne adresse en parallèle de la nouvelle reste une possibilité pour les intégrations anciennes, et non une exigence pour un nouveau déploiement.

À quoi ressemble un manifeste valide ?

Le document contient un tableau entries regroupant les descriptions des ressources. L’exemple ci-dessous est une version abrégée du manifeste de Domeny.ForSale :

{
  "entries": [
    {
      "identifier": "urn:air:domeny.forsale:skill:domain-catalog-search",
      "displayName": "Moteur de recherche du catalogue Domeny.ForSale",
      "type": "text/markdown; profile=\"urn:air:agent-skills\"",
      "url": "https://domeny.forsale/.well-known/agent-skills/domain-catalog-search/SKILL.md",
      "capabilities": ["searchDomainCatalog"],
      "representativeQueries": [
        "trouve un nom de domaine à vendre pour une boutique en ligne",
        "montre des articles sur le choix et l’achat d’un nom de domaine"
      ]
    }
  ]
}

Cette entrée renvoie aux instructions de recherche dans le catalogue . Elles décrivent l’utilisation de l’outil WebMCP searchDomainCatalog ou, si celui-ci n’est pas disponible, la recherche dans l’index JSON du site. L’adresse du champ url mène donc à un document qui décrit la marche à suivre.

Selon les chapitres 4.2 et 4.3 :

identifier, displayName et type sont obligatoires. Ils définissent l’identifiant, le nom lisible et le type de la ressource.
L’entrée doit contenir exactement l’un de ces deux champs : url, qui renvoie au document, ou data, qui le contient directement.
representativeQueries devrait contenir 2–5 exemples de requêtes. Ils aident à indexer la ressource en fonction des besoins de l’utilisateur. L’absence de ce champ ou un nombre différent d’exemples déclenche un avertissement de l’outil de conformité, et non une erreur de validation du schéma.
capabilities est une liste facultative de noms courts de fonctions, utile pour le filtrage.

Le manifeste peut aussi contenir des champs supplémentaires au niveau racine, tels que host ou specVersion. ARD ne leur attribue pas de signification dans son modèle de manifeste. Ainsi, la présence de "specVersion": "1.0" dans notre fichier ne signifie pas que la spécification ARD actuelle est en version 1.0. La structure est formellement définie par le schéma de l’entrée et du manifeste .

Comment passer de ai-catalog.json à ard.json ?

La migration d’un catalogue existant peut se faire en quatre étapes :

Vérifiez les entrées par rapport au schéma ARD actuel, notamment les identifiants, les adresses des ressources et les exemples de requêtes.
Publiez le manifeste à l’adresse /.well-known/ard.json sur votre propre domaine.
Ajoutez un lien vers ce document dans la section <head> des pages.
Vérifiez la récupération du manifeste et des ressources indiquées, puis effectuez la validation. Si vous conservez l’ancien chemin pour les clients existants, veillez à la cohérence des deux versions.

Le lien peut prendre cette forme :

<link rel="ard" href="/.well-known/ard.json" type="application/json">

La spécification fournit un outil de test de conformité . Il permet de vérifier le manifeste ainsi que sa découverte sur le domaine.

Que permet la publication de ce fichier ?

Le manifeste aide les logiciels compatibles avec ARD à identifier les possibilités offertes par le site. Dans notre exemple, il décrit comment rechercher des domaines et des articles. Pour qu’une ressource apparaisse dans les résultats d’un registre donné, ce registre doit trouver la source et l’indexer.

La publication du fichier ne garantit à elle seule ni sa prise en charge par n’importe quel assistant ni un meilleur classement du site dans Google. Il faut vérifier son effet concret dans une intégration qui utilise réellement ARD : récupère-t-elle le manifeste, reconnaît-elle l’entrée et peut-elle utiliser la ressource indiquée ?

À lire aussi : Qu’est-ce que ARD ?