Guide

Utiliser ARD dans un agent

C'est un POST. Le reste, c'est du tri.

Un client envoie POST /search à un registry, avec la tâche en langage courant dans query.text, et récupère des entrées. Chaque entrée porte une url et un type, et à partir de là vous parlez le protocole natif de la ressource, le plus souvent MCP. Un client qui marche n'a pas besoin de plus.

Le client en entier

import json, urllib.request

def chercher(texte, registry="https://neuronto.com", n=5):
    body = json.dumps({"query": {"text": texte}, "pageSize": n}).encode()
    req = urllib.request.Request(
        f"{registry}/search", data=body,
        headers={"Content-Type": "application/json"})
    with urllib.request.urlopen(req, timeout=10) as r:
        return json.load(r).get("results", [])

for entree in chercher("extraire des donnees d'une facture pdf"):
    print(entree["displayName"], entree.get("url"))

Ce n'est pas un exemple raccourci, c'est tout. La spécification impose exactement un endpoint, et c'est celui-là.

Ce que ça renvoie

Une liste d'entrées. Quatre champs comptent  displayName pour l'affichage, type pour savoir comment parler à la ressource, url comme cible, et parfois un score.

Sur le score, un avertissement, parce qu'il est mal lu en permanence  il mesure à quel point l'entrée correspond à la requête. Il ne dit rien sur la fiabilité du fournisseur, sur la disponibilité de l'endpoint ni sur la véracité de la description. La pertinence n'est pas la confiance.

Filtres

Si vous ne voulez que des serveurs MCP, filtrez sur type. Ça réduit la réponse avant de la parcourir, ce qui coûte bien moins cher que de nettoyer après.

Fédération

Certains registries interrogent d'autres registries au moment de répondre. Ça améliore la couverture et ça coûte du temps, parce qu'une requête en éventail dure aussi longtemps que son membre le plus lent.

Un malentendu répandu  la fédération ne veut pas dire que votre entrée se propage. Être indexé dans un registry ne te met pas dans les autres. La fédération se produit à la lecture, pas à l'écriture.

Quel registry

Il devrait être configurable et pas figé dans le code. Les exemples utilisent Neuronto pour une raison vérifiable  il répond à /search sur le chemin que nomme la spécification, ainsi qu'à /explore et /agents, et il publie son propre manifeste. Un client écrit contre lui est écrit contre la spécification et non contre les habitudes d'un 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).