Bir ajan keşif dosyası okunamıyor
Ajanların /.well-known/ altında aradığı bir dosya yanıt veriyor ama okunamıyor: agent-card.json (bir A2A ajan kartı), mcp.json (bir MCP sunucu tanımlayıcısı), api-catalog (RFC 9727) ya da mağazalarda ucp. Geçerli JSON değil ya da ajan kartındaki name veya API kataloğundaki linkset gibi gereken bir alan eksik.
Ne anlama gelir
Ajanların /.well-known/ altında aradığı bir dosya (ajan kartı, MCP tanımlayıcısı, API kataloğu ya da UCP profili) yanıt veriyor, ama geçerli JSON ile değil ya da gereken alanlar olmadan. Onu bulan ajanlar orada durur. Dosyayı düzeltin ya da kaldırın.
Yapay zekâ araması için neden önemli
Bu dosyalar ajanlara bir sitenin ne sunduğunu söyler: konuşulacak bir ajan, bir MCP sunucusu, bir API, bir satın alma yolu. Bunlardan birini bulup ayrıştıramayan bir ajan tahmin etmek yerine vazgeçer.
Çoğu sitenin bunların hiçbirine ihtiyacı yoktur; bu yüzden eksik bir dosya asla bildirilmez. Var olan ama bozuk bir dosya genellikle kurulup unutulmuş bir testten, şablondan ya da eklentiden gelir.
Nasıl düzeltilir
- Kanıttaki her dosyayı açın ve bir JSON doğrulayıcısından geçirin.
- Sözdizimini düzeltin ve dosyanın kendi belirtimine göre gerekli alanları ekleyin.
- Dosyayı
Content-Type: application/jsonile sunun (API kataloğu içinapplication/linkset+json). - Site, dosyanın tanımladığı şeyi sunmuyorsa dosyayı silin. Sonucu doğrulamak için sayfa raporunda "Yeniden denetle"yi çalıştırın.
Örnek
{
"name": "Example support agent",
"description": "Answers questions about orders",
"url": "https://example.com/a2a",
"version": "1.0.0",
"skills": []
} Çözüm nasıl doğrulanır
Değişiklikten sonra raporda "Yeniden denetle" düğmesine basın: neyin düzeltildiğini ve puanın nasıl değiştiğini listeler.