En discovery-fil för agenter går inte att läsa
En fil som agenter letar efter under /.well-known/ svarar men går inte att läsa: agent-card.json (ett A2A-agent card), mcp.json (en beskrivning av en MCP-server), api-catalog (RFC 9727) eller, i butiker, ucp. Den är inte giltig JSON, eller så saknas ett obligatoriskt fält, som name i agent card eller linkset i API-katalogen.
Vad det betyder
En fil under /.well-known/ som agenter letar efter (agent card, MCP-beskrivningen, API-katalogen eller UCP-profilen) svarar, men inte med giltig JSON, eller utan de fält den behöver. Agenter som hittar den stannar där. Rätta filen eller ta bort den.
Därför spelar det roll för AI-sök
De här filerna talar om för agenter vad en webbplats erbjuder: en agent att prata med, en MCP-server, ett API, ett sätt att köpa. En agent som hittar en sådan fil och inte kan tolka den ger upp i stället för att gissa.
De flesta webbplatser behöver ingen av dem, så en saknad fil rapporteras aldrig. En fil som finns men är trasig kommer oftast från ett test, en mall eller ett tillägg som sattes upp och glömdes bort.
Så åtgärdar du det
- Öppna varje fil från underlaget och kör den genom en JSON-validator.
- Rätta syntaxen och lägg till de obligatoriska fälten enligt filens egen specifikation.
- Leverera den med
Content-Type: application/json(application/linkset+jsonför API-katalogen). - Om webbplatsen inte erbjuder det filen beskriver, ta bort filen. Kör "Kontrollera igen" i sidrapporten för att bekräfta resultatet.
Exempel
{
"name": "Example support agent",
"description": "Answers questions about orders",
"url": "https://example.com/a2a",
"version": "1.0.0",
"skills": []
} Så bekräftar du åtgärden
Klicka på "Kontrollera igen" i rapporten efter ändringen: den visar vad som har åtgärdats och hur poängen har ändrats.