Wat is ARD en hoe vinden AI-agenten tools?
Auteur: Redactie Domeny.ForSale Gepubliceerd Bijgewerkt
ARD (Agentic Resource Discovery) is een open specificatie voor het beschrijven en vinden van bronnen die agenten met AI kunnen gebruiken. Ze helpt een applicatie een tool, MCP-server, andere agent of verzameling instructies te vinden die past bij de taak van de gebruiker. De specificatie verbindt bronbeschrijvingen die eigenaren publiceren met registers die deze indexeren en doorzoekbaar maken. Dit artikel is gebaseerd op de specificatie van ARD .
Welk probleem lost ARD op?
Stel dat je een assistent vraagt: ‘Zoek een korte domeinnaam voor een fietsenwinkel.’ Om die taak uit te voeren, heeft de assistent toegang tot een domeincatalogus nodig en moet hij weten hoe hij die kan doorzoeken. In een kleine applicatie kan een ontwikkelaar de juiste tool vooraf aansluiten. Maar met duizenden beschikbare diensten wordt het lastig om elke integratie handmatig te configureren en alle beschrijvingen in de context van het model op te nemen.
ARD stelt voor om bronnen te zoeken op basis van de behoefte. De applicatie stuurt een zoekopdracht naar een register, ontvangt passende beschrijvingen en kiest welke bron ze wil gebruiken. Zo kan informatie over de geselecteerde bronnen in de modelcontext terechtkomen, in plaats van de hele catalogus.
Dit mechanisme maakt beschikbare mogelijkheden vindbaar. Nadat een bron is gevonden, moet de applicatie nog steeds de juiste communicatiemethode en de vereiste toegangsrechten ondersteunen. De specificatie scheidt het zoeken van het latere gebruik van de tool. Ontwerpprincipes van ARD
Hoe werkt ARD stap voor stap?
Bij dit proces zijn een aanbieder van de bron, een register en een applicatie die een agent met AI gebruikt betrokken.
- De aanbieder beschrijft de bron. Hij vermeldt de naam, identificatiecode, het type en een document dat de mogelijkheden of gebruiksinstructies beschrijft.
- De beschrijving wordt online beschikbaar. De standaardlocatie voor het manifest is
/.well-known/ard.json. De specificatie voorziet daarnaast onder meer in ingebedde JSON-LD-gegevens, een HTML-link metrel="ard", de instructieAgentmapinrobots.txten DNS-records. - Het register haalt de vermeldingen op en indexeert ze. Het gebruikt de gegevens om geschikte bronnen te vinden.
- De applicatie beschrijft de behoefte. Ze stuurt een zoekopdracht in natuurlijke taal naar het register, eventueel met filters.
- De applicatie kiest een resultaat en leest de bronbeschrijving. Daarna kan ze de bron gebruiken volgens het bijbehorende protocol en haar eigen toegangsregels.
Een manifest publiceren is dus iets anders dan een register beheren. Een website-eigenaar kan een statisch bestand beschikbaar stellen zonder een eigen zoekdienst te draaien. De verplichting om een REST-zoekinterface aan te bieden geldt voor registers. Bronnen ontdekken en indexeren
Wat bevat een ARD-vermelding?
Een vermelding is een bronbeschrijving volgens het JSON-LD-model. Het manifest ard.json groepeert zulke vermeldingen in de array entries. De belangrijkste velden zijn:
| Veld | Betekenis | Vereiste |
|---|---|---|
identifier | Unieke identificatiecode in de vorm urn:air:<publisher>:<namespace>:<agent-name> | Verplicht |
displayName | Leesbare naam van de bron | Verplicht |
type | Type van het beschreven document, opgegeven als mediatype | Verplicht |
url of data | Adres van het document of de inhoud ervan binnen de vermelding | Precies één van deze velden |
representativeQueries | Voorbeeldvragen of opdrachten waarvoor de bron geschikt is | 2–5 voorbeelden aanbevolen |
capabilities | Korte functieaanduidingen om op te filteren | Optioneel |
Het veld url verwijst naar het beschreven document, bijvoorbeeld een serverkaart of instructiebestand. Dat adres is niet noodzakelijk het adres waarnaar je een opdracht stuurt om een taak uit te voeren. De identificatiecode urn:air:… maakt het mogelijk de identiteit van de bron te onderscheiden van de opslaglocatie van de beschrijving.
representativeQueries speelt een bijzondere rol: het register gebruikt de voorbeeldzoekopdrachten voor semantische indexering. Zonder dit veld kan een vermelding structureel geldig blijven, maar ontbreekt de basis om haar via zo’n zoekmethode te vinden. Een tool die de naleving van de specificatie controleert, meldt dan een waarschuwing in plaats van een schemafout.
Vermeldingsmodel en veldvereisten
Hoe zoekt een applicatie een tool?
Het register biedt het endpoint POST /search aan. Een voorbeeld van de aanvraaginhoud voor een domeinzoekmachine zou er zo uit kunnen zien:
{
"query": {
"text": "zoek een domeinnaam te koop voor een fietsenwinkel",
"filter": {
"capabilities": ["searchDomainCatalog"]
}
},
"federation": "none",
"pageSize": 5
}
Dit is een voorbeeldzoekopdracht voor een register dat de betreffende bron heeft geïndexeerd. query.text beschrijft de behoefte, terwijl het filter de resultaten beperkt tot vermeldingen die aangeven de genoemde functie te bieden. pageSize beperkt het aantal resultaten per pagina.
Registers kunnen ook samenwerken. De parameter federation accepteert drie waarden: none betekent zoeken in de eigen index, auto laat het register andere registers bevragen en de resultaten samenvoegen, en referrals levert daarnaast verwijzingen naar registers die de client zelf kan doorzoeken. De standaardmodus is auto.
Zoekinterface
en
federatie van registers
Hoe verhoudt ARD zich tot MCP en agent skills?
Deze oplossingen vervullen verschillende rollen binnen hetzelfde proces:
| Onderdeel | Rol |
|---|---|
| ARD | Helpt een bron te vinden die aansluit bij de behoefte |
| MCP | Biedt een manier waarop een applicatie met AI communiceert met beschikbaar gestelde tools en gegevens |
| A2A | Dient voor communicatie tussen agenten |
| Agent skills | Leveren instructies en materialen voor een specifieke taak |
ARD kan bronnen beschrijven die in verschillende formaten worden weergegeven. Een vermelding van een MCP-server vinden betekent niet dat er automatisch een verbinding met die server wordt gemaakt. De applicatie moet de betreffende integratie ondersteunen. Brontypen en scheiding van functies
Voorbeeld van Domeny.ForSale
Op deze website is een
manifest voor ARD
beschikbaar. Het beschrijft de vaardigheid om de catalogus met domeinen en artikelen te doorzoeken. Het veld url verwijst naar de
gebruiksinstructie voor de zoekmachine
, en representativeQueries bevat onder meer een zoekopdracht naar een domeinnaam voor een webwinkel.
Met deze beschrijving kan een client die ARD ondersteunt, ontdekken dat de website een bruikbare bron aanbiedt en waar de gebruiksinstructies te vinden zijn. Het bestand zelf voert geen zoekopdrachten uit en bewijst niet dat een bepaalde assistent de website al heeft geïndexeerd.
Kun je een gevonden bron vertrouwen?
Aansluiting bij de zoekopdracht en betrouwbaarheid zijn twee verschillende zaken. De score die het register teruggeeft op een schaal van 0–100, geeft de semantische relevantie aan. Het is geen veiligheidsbeoordeling, certificaat of bevestiging van toegangsrechten.
De specificatie voorziet in het optionele veld trustManifest, waarmee informatie voor het verifiëren van identiteit en herkomst kan worden meegegeven. Als dit veld aanwezig is, moet de opgegeven identiteit gekoppeld zijn aan het domein van de aanbieder dat in de identificatiecode staat. ARD definieert geen eigen universele ondertekeningsprocedure; de verificatie hangt af van het aangegeven vertrouwenssysteem.
Identiteit en vertrouwen in ARD
Op het moment waarop dit artikel is bijgewerkt, beschrijft het document versie 0.91 met de status ‘Proposal’. Het is verstandig een implementatie te baseren op de actuele specificatie en de mogelijkheden van de betreffende client. Dat geldt ook voor de oudere manifestnaam ai-catalog.json, die in de huidige versie wordt vervangen door het pad ard.json.
Zie ook: Wat is ai-catalog.json? · Wat is MCP? · Wat zijn agent skills?
Lees ook
