Agent kəşf faylını oxumaq mümkün deyil
Agentlərin /.well-known/ altında axtardığı fayl cavab verir, lakin oxuna bilmir: agent-card.json (A2A agent kartı), mcp.json (MCP server deskriptoru), api-catalog (RFC 9727) və ya mağazalarda ucp. O, etibarlı JSON deyil və ya ona lazım olan sahə yoxdur, məsələn agent kartının name sahəsi və ya API kataloqunun linkset sahəsi.
Nə deməkdir
Agentlərin axtardığı /.well-known/ altındakı fayl (agent kartı, MCP deskriptoru, API kataloqu və ya UCP profili) cavab verir, lakin etibarlı JSON ilə deyil və ya lazımi sahələr olmadan. Onu tapan agentlər orada dayanır. Faylı düzəldin və ya silin.
AI axtarışı üçün niyə vacibdir
Bu fayllar agentlərə saytın nə təklif etdiyini deyir: danışmaq üçün agent, MCP server, API, alış yolu. Faylı tapan, lakin onu təhlil edə bilməyən agent təxmin etmək əvəzinə dayanır.
Saytların çoxuna bunların heç biri lazım deyil, ona görə də olmayan fayl heç vaxt bildirilmir. Mövcud olan, lakin pozulmuş fayl adətən qurulub unudulmuş testdən, şablondan və ya plagindən qalır.
Necə düzəltmək olar
- Sübutdakı hər faylı açın və JSON validatorundan keçirin.
- Faylın öz spesifikasiyasına uyğun olaraq sintaksisi düzəldin və məcburi sahələri əlavə edin.
- Onu
Content-Type: application/jsonilə verin (API kataloqu üçünapplication/linkset+json). - Sayt faylda təsvir olunanı təklif etmirsə, faylı silin. Nəticəni təsdiqləmək üçün səhifə hesabatında "Yenidən yoxla" düyməsini basın.
Nümunə
{
"name": "Example support agent",
"description": "Answers questions about orders",
"url": "https://example.com/a2a",
"version": "1.0.0",
"skills": []
} Düzəlişi necə təsdiqləmək olar
Dəyişiklikdən sonra hesabatda “Yenidən yoxla” düyməsini basın: o, nəyin düzəldildiyini və balın necə dəyişdiyini göstərir.