agent.json: Was hinter der Datei steckt und ob du sie brauchst

Was die agent.json sein soll

KI-Agenten sind Programme, die im Auftrag eines Nutzers selbst handeln: Angebote vergleichen, Termine suchen, Anfragen vorbereiten. Die Idee hinter einer agent.json ist eine Datei unter /agent.json, in der ein solcher Agent die wichtigsten Fakten zu deiner Firma findet, ohne die ganze Website zu durchsuchen.

Jetzt die ehrliche Einordnung. Für diese Datei gibt es keinen etablierten Standard. Der Name taucht in mehreren Vorschlägen auf, unter anderem im Agent2Agent-Protokoll, das ursprünglich von Google stammt. Dort beschreibt die Datei einen KI-Agenten und dessen Fähigkeiten. Mit Firmendaten für Kunden hat das wenig zu tun. Kein großer KI-Anbieter hat angekündigt, eine agent.json auf Firmenwebsites auszuwerten.

Warum das wichtig ist

Wichtig ist sie im Moment kaum, und das sagen wir auch so. checkfrei schaut trotzdem danach, weil sich in diesem Bereich gerade viel bewegt. Wer früh eine saubere, maschinenlesbare Zusammenfassung seiner Firma bereitstellt, verliert nichts. Setzt sich ein Format durch, ist der Inhalt schon gesammelt. Deshalb zeigt der Check nur an, ob eine /agent.json gefunden wurde. In die Punktzahl fließt das nicht ein.

Meine Reihenfolge wäre: zuerst die Firmenangaben als Schema, dann die llms.txt, dann maschinenlesbare Kontaktdaten. Die agent.json kommt danach, wenn überhaupt.

So prüfst du es selbst

Ruf https://deine-domain.de/agent.json im Browser auf. Steht dort eine Fehlermeldung oder deine Startseite, gibt es die Datei nicht. Ob das JSON formal korrekt ist, prüfst du mit einem JSON-Validator, von denen es im Netz viele kostenlose gibt.

Im kostenlosen Check siehst du als Hinweis, ob checkfrei eine /agent.json gefunden hat.

So legst du sie an

Weil es kein vorgeschriebenes Format gibt, halt die Datei schlicht. Englische Feldnamen sind verbreiteter, die Inhalte schreibst du auf Deutsch. Übernimm die Fakten aus deinem Schema und deiner llms.txt, damit alle Dateien dasselbe sagen. Ein Feld mit dem Stand hilft, veraltete Angaben zu erkennen.

{
  "name": "Schreinerei Huber",
  "description": "Schreinerei in Traunstein für Einbaumöbel, Küchen und Innentüren.",
  "url": "https://www.example.com",
  "contact": {
    "telephone": "+49 861 1234567",
    "email": "info@example.com",
    "address": "Musterstraße 12, 83278 Traunstein, Deutschland"
  },
  "openingHours": "Mo-Fr 07:30-17:00",
  "areaServed": "Landkreis Traunstein, etwa 40 Kilometer Umkreis",
  "services": [
    { "name": "Einbauschränke", "url": "https://www.example.com/einbauschraenke" },
    { "name": "Küchen", "url": "https://www.example.com/kuechen" }
  ],
  "faq": [
    {
      "question": "Wie lange dauert ein Einbauschrank?",
      "answer": "Meist sechs bis acht Wochen vom Aufmaß bis zur Montage."
    }
  ],
  "updated": "2026-10-03"
}

Typische Fehler

• ·Ungültiges JSON, meist wegen eines Kommas zu viel nach dem letzten Eintrag.
• ·Andere Angaben als im Schema oder Impressum, weil die Datei einmal angelegt und dann vergessen wurde.
• ·Viel Zeit in die Datei stecken, während Grundlagen wie der Zugang für KI-Crawler noch fehlen.