Zum Inhalt springen
Industrie · Dogfooding

Wie diese Seite gebaut ist

Diese Site erklärt, wie man von Agenten gefunden, verstanden und ausgewählt wird. Also setzt sie es selbst um. Hier sind die Artefakte zum Anfassen.

Zuletzt aktualisiert:

Die Artefakte

Jeder Eintrag ist ein echter Link auf diese Domain. Öffnen Sie ihn, oder holen Sie ihn mit curl. Nichts davon ist eine Abbildung.

ArtefaktWas es istWozu
/.well-known/agent-card.json A2A Agent Card nach Spec v1.0 Der maschinenlesbare Steckbrief. Ein fremder Agent liest hier, welche Fähigkeiten es gibt und an welchem Endpunkt er sie abrufen kann.
/.well-known/agent.json Dieselbe Card unter dem alten Pfad Bis Spec v0.x lag die Card hier. Clients, die noch danach suchen, bekommen dasselbe Objekt aus derselben Quelle.
/api/a2a A2A-Endpunkt, JSON-RPC 2.0 Der Dienst hinter der Card. Beantwortet message/send. Ein GET liefert eine kurze Selbstauskunft.
/llms.txt Strukturierte Übersicht für Sprachmodelle Wird aus derselben Registry erzeugt wie die Seiten. Eine neue Seite steht hier automatisch drin und kann nicht mehr driften.
/sitemap-index.xml XML-Sitemap Alle indexierbaren URLs. Impressum und Datenschutz sind bewusst ausgenommen.
/robots.txt Crawler-Regeln KI-Crawler sind ausdrücklich erlaubt statt reflexhaft gesperrt. Wer für Agenten sichtbar sein will, muss sie hereinlassen.

Den Endpunkt selbst ausprobieren

Der Dienst hinter der Agent Card beantwortet die Methode message/send nach JSON-RPC 2.0. Diese Anfrage können Sie unverändert kopieren.

Anfrage
curl -s https://www.agent-to-agent-commerce.de/api/a2a \
  -H 'content-type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "message/send",
    "params": {
      "message": {
        "kind": "message",
        "messageId": "probe-1",
        "role": "user",
        "parts": [{ "kind": "text", "text": "Was ist der ERP-Fallback?" }]
      }
    }
  }'

Die Antwort ist eine Message mit der Rolle agent. Die Spezifikation erlaubt es ausdrücklich, auf message/send direkt mit einer Nachricht zu antworten statt einen Task zu eröffnen, und genau das passiert hier, weil jede Anfrage synchron beantwortet wird.

Was der Endpunkt kann, und was nicht

Ehrlichkeit gehört zum Dogfooding, deshalb die Grenzen zuerst. Der Dienst ruft kein Sprachmodell auf. Er beantwortet Anfragen deterministisch aus denselben Datenquellen, aus denen auch die Seiten gebaut werden. Was nicht in diesen Quellen steht, beantwortet er nicht, sondern sagt das und liefert stattdessen den Seitenindex.

Das ist eine bewusste Entscheidung. Ein generativer Endpunkt würde laufende Kosten erzeugen und Aussagen produzieren können, die auf dieser Site nirgends stehen. Für den Zweck, den die Agent Card beschreibt, nämlich Auskunft über Begriffe, Reifegrade und Inhalte dieser Domain, ist die deterministische Variante die belastbarere.

SkillWas er zurückgibt
glossar
Begriffsauskunft Agentic Commerce
Gibt die Definition eines Begriffs aus dem Glossar zurück, etwa Agentic Commerce, A2A, MCP, ACP, AP2, Agent Card oder ERP-Fallback. Deterministische Auskunft aus einer gepflegten Begriffsliste, keine generative Antwort.
agent-readiness
Reifegradmodell Agent-Readiness
Gibt das fünfstufige Reifegradmodell zurück, mit dem sich einordnen lässt, wie weit ein Hersteller oder Zulieferer von Beschaffungsagenten gefunden, verstanden und ausgewählt werden kann. Stufe 0 nicht auflösbar bis Stufe 4 direkt abfragbar.
inhaltsindex
Seitenindex dieser Domain
Gibt den Index aller öffentlichen Seiten dieser Domain mit Titel, Kurzbeschreibung und URL zurück, gruppiert nach Themenbereich.

Was auf jeder Seite passiert

  • JSON-LD im @graph. Organization und WebSite auf jeder Seite, dazu Article und BreadcrumbList, FAQPage wo Fragen existieren, ItemList für das Reifegradmodell. Ein einziger Block, keine verstreuten Schnipsel.
  • Alles im HTML. Kein Inhalt entsteht erst durch JavaScript. Auch die Diagramme sind Inline-SVG mit role="img" und einer vollständigen Textalternative, damit sie für Agenten und für Screenreader gleichermaßen lesbar sind.
  • Eine Quelle je Aussage. Navigation, Seitentitel, interne Verlinkung, llms.txt und die Agent Card stammen aus derselben Registry im Code. Damit kann die maschinenlesbare Ausgabe nicht von der sichtbaren Seite abweichen, was genau der Fehler ist, den die Konsistenz-Falle beschreibt.
  • Kennzeichnung, wo KI im Spiel war. Seiten, die unter Einsatz von KI entstanden sind, tragen am Ende einen entsprechenden Hinweis.

Wie Zugriffe gemessen werden

Stufe 4 des Reifegradmodells verlangt nicht nur einen abfragbaren Endpunkt, sondern auch, dass die Zugriffe fremder Agenten erfasst und ausgewertet werden. Diese Domain löst das so: Jeder Abruf der Agent Card und jeder Aufruf des Endpunkts erzeugt eine strukturierte Logzeile mit dem Präfix AGENT_ACCESS, die das angefragte Artefakt und den erkannten Crawler enthält. Weder IP-Adressen noch Anfrageinhalte werden protokolliert.

Das ist bewusst genau die Log-Segmentierung, die Agent Share of Voice als zweite Messebene empfiehlt, angewandt auf die eigene Seite. Aus demselben Grund liegen Agent Card und Kompatibilitätspfad als abrufbare Route statt als statische Datei vor: Eine statische Datei lässt sich aus dem Code heraus nicht zählen. Die beiden Pfade werden getrennt geführt, damit sichtbar wird, wie viele Clients noch die alte Adresse verwenden.

Wo diese Site selbst steht

Gemessen am eigenen Reifegradmodell erfüllt diese Domain die Merkmale von Stufe 4, allerdings für einen schmalen Gegenstand: Sie liefert Auskunft über ihre eigenen Inhalte, nicht über ein Produktsortiment mit Preisen und Verfügbarkeiten. Ein Hersteller auf Stufe 4 beantwortet ungleich schwierigere Fragen. Die Artefakte sind dieselben, der Aufwand dahinter ist es nicht.

Was hier noch fehlt, gehört ebenfalls zur Ehrlichkeit: Die Zugriffe werden protokolliert, aber noch nicht regelmäßig ausgewertet. Ein Verlauf über die Zeit, wie ihn die Methode für die eigene Messung verlangt, entsteht erst mit der ersten Auswertungsreihe.

Wenn Sie einen Teil davon in Ihrem Haus nachbauen wollen, ist die Einordnung in das Stufenmodell der sinnvolle erste Schritt, nicht die Agent Card. Ein Endpunkt liefert exakt die Datenqualität aus, die darunter liegt.

Häufige Fragen

Warum gibt es diese Seite?
Weil eine Site, die anderen erklärt, wie man für Agenten auffindbar wird, das selbst umsetzen und prüfbar machen sollte. Alle Artefakte sind hier direkt verlinkt und lassen sich im Browser oder per curl abrufen.
Wo liegt die Agent Card und warum an zwei Pfaden?
Kanonisch unter /.well-known/agent-card.json, so schreibt es die A2A-Spezifikation seit Version 1.0 vor. Der Pfad /.well-known/agent.json stammt aus den Versionen 0.x und wird weiterhin ausgeliefert, damit ältere Clients die Card finden. Beide Routen erzeugen dasselbe Objekt aus einer einzigen Quelle im Code.
Antwortet hinter der Agent Card wirklich etwas?
Ja. Die Card verweist auf /api/a2a, und dort läuft ein JSON-RPC-Endpunkt, der message/send beantwortet. Eine Card ohne laufenden Dienst wäre genau die Nennung ohne Substanz, die diese Site kritisiert.
Verwendet der Endpunkt ein Sprachmodell?
Nein. Die Antworten stammen deterministisch aus denselben Datenquellen, aus denen die Seiten gebaut werden: Glossar, Reifegradmodell und Seitenregistry. Damit entstehen keine laufenden Kosten und keine Aussage, die nicht auch auf der Site steht. Fragen außerhalb dieses Bestands werden ausdrücklich als nicht beantwortbar zurückgemeldet.
Funktioniert die Seite ohne JavaScript?
Ja. Sämtliche Inhalte inklusive der Diagramme stehen im ausgelieferten HTML. Die Diagramme sind Inline-SVG mit Textalternative, kein Canvas und keine Bibliothek. Client-JavaScript existiert nur für das mobile Menü und den Readiness-Check.
Nächster Schritt

Wie agent-ready ist Ihr Unternehmen?

Beantworten Sie 8 kurze Fragen und erhalten Sie sofort eine ehrliche Einordnung plus die nächsten konkreten Schritte – in unter 2 Minuten.

Quellen

Quellen & weiterführende Belege (2)
  1. Agent2Agent (A2A) Protocol — Google / Linux Foundation
  2. Model Context Protocol – Spezifikation — Anthropic, 2024-11