Egy ügynököknek szóló felderítő fájl nem olvasható
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.
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ó
- Nyissa meg a bizonyítékban szereplő összes fájlt, és futtassa le őket egy JSON-validátoron.
- Javítsa a szintaxist, és adja hozzá a kötelező mezőket a fájl saját specifikációja szerint.
- Szolgálja ki
Content-Type: application/jsonfejléccel (az API-katalógusnálapplication/linkset+json). - 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.