Eine Discovery-Datei für Agenten ist nicht lesbar
Eine Datei, nach der Agenten unter /.well-known/ suchen, antwortet, ist aber nicht lesbar: agent-card.json (eine A2A Agent Card), mcp.json (ein MCP-Server-Deskriptor), api-catalog (RFC 9727) oder bei Shops ucp. Sie ist kein gültiges JSON oder ihr fehlt ein Pflichtfeld, etwa name der Agent Card oder linkset des API-Katalogs.
Was es bedeutet
Eine Datei unter /.well-known/, nach der Agenten suchen (die Agent Card, der MCP-Deskriptor, der API-Katalog oder das UCP-Profil), antwortet, aber nicht mit gültigem JSON oder ohne die nötigen Felder. Agenten, die sie finden, brechen dort ab. Korrigieren Sie die Datei oder entfernen Sie sie.
Warum das für die KI-Suche wichtig ist
Diese Dateien sagen Agenten, was eine Website anbietet: einen Agenten zum Ansprechen, einen MCP-Server, eine API, eine Möglichkeit zu kaufen. Ein Agent, der eine davon findet und nicht parsen kann, gibt auf, statt zu raten.
Die meisten Websites brauchen keine davon, daher wird eine fehlende Datei nie gemeldet. Eine vorhandene, aber defekte Datei stammt meist aus einem Test, einer Vorlage oder einem Plugin, das eingerichtet und vergessen wurde.
So beheben Sie es
- Öffnen Sie jede Datei aus den Belegen und prüfen Sie sie mit einem JSON-Validator.
- Korrigieren Sie die Syntax und ergänzen Sie die Pflichtfelder gemäß der Spezifikation der Datei.
- Liefern Sie sie mit
Content-Type: application/jsonaus (application/linkset+jsonfür den API-Katalog). - Bietet die Website nicht an, was die Datei beschreibt, löschen Sie die Datei. Klicken Sie im Seitenbericht auf „Erneut prüfen“, um das Ergebnis zu bestätigen.
Beispiel
{
"name": "Example support agent",
"description": "Answers questions about orders",
"url": "https://example.com/a2a",
"version": "1.0.0",
"skills": []
} So bestätigen Sie den Fix
Klicken Sie nach der Änderung im Bericht auf „Erneut prüfen“: Er zeigt, was behoben wurde und wie sich der Score verändert hat.