Egy ügynököknek szóló felderítő fájl nem olvasható

Rövid válasz

Egy /.well-known/ alatti fájl, amelyet az ügynökök keresnek, válaszol, de nem olvasható: agent-card.json (A2A-ügynökkártya), mcp.json (MCP-szerverleíró), api-catalog (RFC 9727) vagy webáruházakban ucp. Nem érvényes JSON, vagy hiányzik belőle egy szükséges mező, például az ügynökkártya name vagy az API-katalógus linkset mezője.

agent.discovery_invalid · Prioritás: P2

Mit jelent

Egy /.well-known/ alatti fájl, amelyet az ügynökök keresnek (az ügynökkártya, az MCP-leíró, az API-katalógus vagy az UCP-profil), válaszol, de nem érvényes JSON-nal, vagy hiányoznak belőle a szükséges mezők. Az ügynökök, amelyek megtalálják, itt megállnak. Javítsa ki vagy távolítsa el a fájlt.

Miért fontos az AI-keresésben

Ezek a fájlok mondják meg az ügynököknek, mit kínál egy webhely: egy ügynököt, amellyel beszélni lehet, egy MCP-szervert, egy API-t, egy vásárlási módot. Az az ügynök, amely talál egyet, de nem tudja feldolgozni, inkább feladja, mint hogy találgasson.

A legtöbb webhelynek egyikre sincs szüksége, ezért a hiányzó fájlt soha nem jelezzük. Egy meglévő, de hibás fájl általában egy tesztből, sablonból vagy bővítményből marad meg, amelyet beállítottak, majd elfelejtettek.

Hogyan javítható

  1. Nyissa meg a bizonyítékban szereplő összes fájlt, és futtassa le őket egy JSON-validátoron.
  2. Javítsa a szintaxist, és adja hozzá a kötelező mezőket a fájl saját specifikációja szerint.
  3. Szolgálja ki Content-Type: application/json fejléccel (az API-katalógusnál application/linkset+json).
  4. Ha a webhely nem kínálja azt, amit a fájl leír, törölje a fájlt. Az oldaljelentésen futtassa az „Újraellenőrzés” funkciót az eredmény megerősítéséhez.

Példa

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

Hogyan győződhet meg a javításról

A módosítás után kattintson a jelentésben az „Újraellenőrzés” gombra: látni fogja, mi javult, és hogyan változott a pontszám.

Ellenőrizze az oldalamat →

Kapcsolódó útmutatók

Minden találat és a pontszám működése