Fail penemuan untuk ejen tidak dapat dibaca
Satu fail yang dicari ejen di bawah /.well-known/ menjawab tetapi tidak dapat dibaca: agent-card.json (agent card A2A), mcp.json (deskriptor pelayan MCP), api-catalog (RFC 9727) atau, pada kedai, ucp. Ia bukan JSON yang sah, atau tiada medan yang diperlukannya, seperti name agent card atau linkset katalog API.
Maksudnya
Satu fail di bawah /.well-known/ yang dicari oleh ejen (agent card, deskriptor MCP, katalog API atau profil UCP) menjawab, tetapi bukan JSON yang sah atau tiada medan yang diperlukannya. Ejen yang menemuinya berhenti di situ. Betulkan fail itu atau buangkannya.
Mengapa ini penting untuk carian AI
Fail-fail ini memberitahu ejen apa yang ditawarkan tapak: ejen untuk berbual, pelayan MCP, API, cara untuk membeli. Ejen yang menemui salah satunya dan tidak dapat menghuraikannya akan berhenti dan tidak meneka.
Kebanyakan tapak tidak memerlukan satu pun, jadi fail yang tiada tidak pernah dilaporkan. Fail yang ada tetapi rosak biasanya datang daripada ujian, templat atau pemalam yang dipasang lalu dilupakan.
Cara membetulkannya
- Buka setiap fail daripada bukti dan semaknya dengan pengesah JSON.
- Betulkan sintaks dan tambah medan wajib, mengikut spesifikasi fail itu sendiri.
- Hidangkannya dengan
Content-Type: application/json(application/linkset+jsonuntuk katalog API). - Jika tapak tidak menawarkan apa yang diterangkan oleh fail itu, padamkan fail tersebut. Jalankan "Semak semula" pada laporan halaman untuk mengesahkan hasilnya.
Contoh
{
"name": "Example support agent",
"description": "Answers questions about orders",
"url": "https://example.com/a2a",
"version": "1.0.0",
"skills": []
} Cara mengesahkan pembetulan
Selepas perubahan, tekan "Semak semula" pada laporan: ia menyenaraikan apa yang dibetulkan dan bagaimana skor berubah.