En discovery-fil til agenter kan ikke læses
En fil, som agenter leder efter under /.well-known/, svarer, men kan ikke læses: agent-card.json (et A2A-agent card), mcp.json (en beskrivelse af en MCP-server), api-catalog (RFC 9727) eller, i webshops, ucp. Den er ikke gyldig JSON, eller der mangler et obligatorisk felt, som name i agent card eller linkset i API-kataloget.
Hvad det betyder
En fil under /.well-known/, som agenter leder efter (agent card, MCP-beskrivelsen, API-kataloget eller UCP-profilen), svarer, men ikke med gyldig JSON, eller uden de felter, den skal have. Agenter, der finder den, stopper der. Ret filen, eller fjern den.
Hvorfor det har betydning for AI-søgning
Disse filer fortæller agenter, hvad et site tilbyder: en agent at tale med, en MCP-server, et API, en måde at købe på. En agent, der finder en af dem og ikke kan fortolke den, giver op i stedet for at gætte.
De fleste sites har ikke brug for nogen af dem, så en manglende fil bliver aldrig rapporteret. En fil, der findes, men er defekt, stammer som regel fra en test, en skabelon eller et plugin, der blev sat op og glemt.
Sådan retter du det
- Åbn hver fil fra beviserne, og kør den gennem en JSON-validator.
- Ret syntaksen, og tilføj de obligatoriske felter efter filens egen specifikation.
- Lever den med
Content-Type: application/json(application/linkset+jsonfor API-kataloget). - Hvis sitet ikke tilbyder det, filen beskriver, så slet filen. Tryk på "Tjek igen" i siderapporten for at bekræfte resultatet.
Eksempel
{
"name": "Example support agent",
"description": "Answers questions about orders",
"url": "https://example.com/a2a",
"version": "1.0.0",
"skills": []
} Sådan bekræfter du rettelsen
Tryk på "Tjek igen" i rapporten efter ændringen: den viser, hvad der er rettet, og hvordan scoren har ændret sig.