Een discovery-bestand voor agents is onleesbaar
Een bestand onder /.well-known/ waar agents naar zoeken, antwoordt, maar is onleesbaar: agent-card.json (een A2A-agent card), mcp.json (een descriptor van een MCP-server), api-catalog (RFC 9727) of, bij webwinkels, ucp. Het is geen geldige JSON, of er ontbreekt een verplicht veld, zoals name in de agent card of linkset in de API-catalogus.
Wat het betekent
Een bestand onder /.well-known/ waar agents naar zoeken (de agent card, de MCP-descriptor, de API-catalogus of het UCP-profiel) antwoordt, maar niet met geldige JSON, of zonder de velden die het nodig heeft. Agents die het vinden, stoppen daar. Herstel het bestand of verwijder het.
Waarom het ertoe doet voor AI-zoeken
Deze bestanden vertellen agents wat een site aanbiedt: een agent om mee te praten, een MCP-server, een API, een manier om te kopen. Een agent die er een vindt en het niet kan lezen, geeft het op in plaats van te gokken.
De meeste sites hebben er geen enkele nodig, dus een ontbrekend bestand wordt nooit gemeld. Een bestand dat er wel is maar kapot is, komt meestal van een test, een template of een plugin die ooit is ingesteld en daarna vergeten.
Zo los je het op
- Open elk bestand uit het bewijs en haal het door een JSON-validator.
- Herstel de syntax en voeg de verplichte velden toe volgens de specificatie van het bestand.
- Lever het uit met
Content-Type: application/json(application/linkset+jsonvoor de API-catalogus). - Biedt de site niet aan wat het bestand beschrijft, verwijder het bestand dan. Voer "Opnieuw controleren" uit in het paginarapport om het resultaat te bevestigen.
Voorbeeld
{
"name": "Example support agent",
"description": "Answers questions about orders",
"url": "https://example.com/a2a",
"version": "1.0.0",
"skills": []
} Hoe je de oplossing bevestigt
Klik na de wijziging op "Opnieuw controleren" in het rapport: het toont wat is opgelost en hoe de score is veranderd.