En discovery-fil for agenter kan ikke leses

Kort svar

En fil som agenter ser etter under /.well-known/, svarer, men kan ikke leses: agent-card.json (et A2A-agent card), mcp.json (en beskrivelse av en MCP-server), api-catalog (RFC 9727) eller, i nettbutikker, ucp. Den er ikke gyldig JSON, eller den mangler et obligatorisk felt, som name i agent card eller linkset i API-katalogen.

agent.discovery_invalid · Prioritet: P2

Hva det betyr

En fil under /.well-known/ som agenter ser etter (agent card, MCP-beskrivelsen, API-katalogen eller UCP-profilen), svarer, men ikke med gyldig JSON, eller uten feltene den trenger. Agenter som finner den, stopper der. Rett filen eller fjern den.

Hvorfor det betyr noe for AI-søk

Disse filene forteller agenter hva et nettsted tilbyr: en agent å snakke med, en MCP-server, et API, en måte å kjøpe på. En agent som finner en av dem og ikke kan tolke den, gir opp i stedet for å gjette.

De fleste nettsteder trenger ingen av dem, så en manglende fil blir aldri rapportert. En fil som finnes, men er ødelagt, kommer som regel fra en test, en mal eller en plugin som ble satt opp og glemt.

Slik retter du det

  1. Åpne hver fil fra bevisene og kjør den gjennom en JSON-validator.
  2. Rett syntaksen og legg til de obligatoriske feltene etter filens egen spesifikasjon.
  3. Lever den med Content-Type: application/json (application/linkset+json for API-katalogen).
  4. Hvis nettstedet ikke tilbyr det filen beskriver, sletter du filen. Kjør «Sjekk på nytt» i siderapporten for å bekrefte resultatet.

Eksempel

{
  "name": "Example support agent",
  "description": "Answers questions about orders",
  "url": "https://example.com/a2a",
  "version": "1.0.0",
  "skills": []
}

Slik bekrefter du rettelsen

Trykk på "Sjekk på nytt" i rapporten etter endringen: den viser hva som er rettet og hvordan scoren har endret seg.

Sjekk siden min →

Relaterte veiledninger

Alle funn og hvordan scoren fungerer