ai-catalog.json: Zweck und Umstieg auf ARD
Autor: Redaktion Domeny.ForSale Veröffentlicht Aktualisiert
Kurz erklärt: /.well-known/ai-catalog.json ist ein früherer Pfad zur Veröffentlichung eines Ressourcenmanifests für AI-Agenten. Die Spezifikation Agentic Resource Discovery (ARD) beschreibt ihn als Vorgänger von /.well-known/ard.json. Ein solches Manifest stellt verfügbare Werkzeuge, Agenten oder Anleitungen zu ihrer Nutzung im strukturierten Format JSON vor. Bei einer neuen Implementierung sollten der Pfad ard.json und ein HTML-Link mit rel="ard" verwendet werden.
Dieser Artikel basiert auf der Spezifikation ARD v0.91 vom 26. August 2026, die als Proposal, also als Vorschlag, gekennzeichnet ist. Der Stand der Dokumentation wurde am 3. Oktober 2026 geprüft.
Wozu dient ein Ressourcenkatalog für Agenten?
Ein Assistent, der ein externes Werkzeug benötigt, muss zunächst herausfinden, was es tut und wo seine Beschreibung zu finden ist. Mit einem Manifest kann der Herausgeber diese Informationen in einer einheitlichen Struktur bereitstellen. Einzelne Einträge können beispielsweise auf die Beschreibung eines MCP-Servers, eine A2A-Agentenkarte oder eine Datei mit Anweisungen zur Ausführung einer Aufgabe verweisen, die als Skill bezeichnet wird.
Bei ARD bildet die Veröffentlichung des Manifests den statischen Teil der Ressourcenerkennung. Eine andere Aufgabe übernimmt das Register: Es ruft Einträge ab, indexiert sie und stellt eine Suchfunktion bereit. Dadurch kann ein Client eine konkrete Anforderung als Suchanfrage stellen und passende Ressourcen erhalten. Die JSON-Datei selbst führt keine Werkzeuge aus; wie diese aufgerufen werden, legt das jeweilige Protokoll oder die Anleitung fest. Diese Ebenen beschreiben die Kapitel 3 und 5 der Spezifikation .
Warum wird heute ard.json verwendet?
In Kapitel 5.1 legt die Spezifikation eindeutige Regeln zum Auffinden von Manifesten fest:
| Mechanismus | Aktuelle Bezeichnung | Frühere Bezeichnung |
|---|---|---|
| Datei unter der Domain | /.well-known/ard.json | /.well-known/ai-catalog.json |
| Link in HTML | rel="ard" | rel="ai-catalog" |
| Unterstützung durch einen ARD-Client | Verpflichtend beim Auffinden von Einträgen einer Domain | Optionale Abwärtskompatibilität |
Ein spezifikationskonformer Client, der die Ressourcen einer Domain ermittelt, muss /.well-known/ard.json abrufen und den Link rel="ard" berücksichtigen. Zusätzlich darf er den früheren Pfad und die Link-Relation ai-catalog prüfen. Tut er dies, behandelt er sie als gleichwertige Quellen für Einträge.
Das bedeutet, dass ein korrekt arbeitender ARD-Client einen Webdienst übergehen kann, der ausschließlich ai-catalog.json bereitstellt. Die Spezifikation empfiehlt den Umstieg auf ard.json. Die alte Adresse neben der neuen beizubehalten, ist eine Option für ältere Integrationen, aber keine Anforderung an eine neue Implementierung.
Wie sieht ein gültiges Manifest aus?
Das Dokument enthält das Array entries mit Beschreibungen der einzelnen Ressourcen. Das folgende Beispiel ist eine gekürzte Fassung des
Manifests von Domeny.ForSale
:
{
"entries": [
{
"identifier": "urn:air:domeny.forsale:skill:domain-catalog-search",
"displayName": "Katalogsuche von 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": [
"finde eine Domain zum Verkauf für einen Onlineshop",
"zeige Artikel zur Auswahl und zum Kauf einer Domain"
]
}
]
}
Der Eintrag verweist auf die
Anleitung zur Katalogsuche
. Diese beschreibt die Nutzung des WebMCP-Werkzeugs searchDomainCatalog und, falls es nicht verfügbar ist, die Suche im JSON-Index des Webdienstes. Die Adresse in url führt somit zu einem Dokument, das die Vorgehensweise erläutert.
Gemäß den Kapiteln 4.2 und 4.3 gilt:
identifier,displayNameundtypesind Pflichtfelder. Sie legen die Kennung, einen lesbaren Namen und den Typ der Ressource fest.- Ein Eintrag muss genau eines der beiden Felder enthalten:
url, das auf ein Dokument verweist, oderdata, das dieses direkt enthält. representativeQueriessollte 2–5 Beispielanfragen enthalten. Sie helfen dabei, die Ressource entsprechend den Bedürfnissen der Nutzer zu indexieren. Fehlt das Feld oder enthält es eine andere Anzahl von Beispielen, gibt das Konformitätsprüfwerkzeug eine Warnung aus; es handelt sich nicht um einen Fehler bei der Schemavalidierung.capabilitiesist eine optionale Liste kurzer Funktionsnamen, die beim Filtern hilfreich ist.
Ein Manifest kann außerdem zusätzliche Felder auf oberster Ebene enthalten, etwa host oder specVersion. ARD weist ihnen in seinem Manifestmodell keine Bedeutung zu. Daher bedeutet "specVersion": "1.0" in unserer Datei nicht, dass die aktuelle ARD-Spezifikation die Version 1.0 hat. Die Struktur wird formal durch das
Schema für Einträge und Manifeste
festgelegt.
Wie gelingt der Umstieg von ai-catalog.json auf ard.json?
Ein bestehender Katalog lässt sich in vier Schritten migrieren:
- Prüfen Sie die Einträge anhand des aktuellen ARD-Schemas, einschließlich der Kennungen, Ressourcenadressen und Beispielanfragen.
- Stellen Sie das Manifest unter
/.well-known/ard.jsonauf Ihrer eigenen Domain bereit. - Fügen Sie im Bereich
<head>der Seiten einen Link zu diesem Dokument hinzu. - Prüfen Sie den Abruf des Manifests und der referenzierten Ressourcen und führen Sie eine Validierung durch. Wenn Sie den alten Pfad für bestehende Clients beibehalten, halten Sie beide Versionen konsistent.
Der Link kann so aussehen:
<link rel="ard" href="/.well-known/ard.json" type="application/json">
Die Spezifikation stellt ein Werkzeug zum Testen der Konformität bereit. Damit lassen sich das Manifest und seine Auffindbarkeit unter der Domain prüfen.
Was bringt die Veröffentlichung einer solchen Datei?
Das Manifest erleichtert Software, die ARD unterstützt, die Erkennung der Funktionen eines Webdienstes. In unserem Beispiel beschreibt es, wie sich Domains und Artikel suchen lassen. Damit eine Ressource in den Ergebnissen eines bestimmten Registers erscheint, muss dieses Register die Quelle finden und indexieren.
Die bloße Veröffentlichung der Datei garantiert weder die Unterstützung durch jeden beliebigen Assistenten noch eine bessere Platzierung der Website bei Google. Die praktische Wirkung sollte in einer Integration geprüft werden, die tatsächlich ARD nutzt: Ruft sie das Manifest ab, erkennt sie den Eintrag und kann sie die referenzierte Ressource nutzen?
Siehe auch: Was ist ARD?
Lesen Sie auch
