File penemuan untuk agen tidak dapat dibaca

Jawaban singkat

Sebuah file yang dicari agen di /.well-known/ merespons, tetapi tidak dapat dibaca: agent-card.json (agent card A2A), mcp.json (deskriptor server MCP), api-catalog (RFC 9727) atau, pada toko, ucp. File itu bukan JSON yang valid, atau tidak memiliki field yang diperlukan, seperti name pada agent card atau linkset pada katalog API.

agent.discovery_invalid · Prioritas: P2

Artinya

Sebuah file di /.well-known/ yang dicari agen (agent card, deskriptor MCP, katalog API, atau profil UCP) merespons, tetapi bukan JSON yang valid atau tidak memiliki field yang diperlukan. Agen yang menemukannya berhenti di situ. Perbaiki file itu atau hapus.

Mengapa penting untuk pencarian AI

File-file ini memberi tahu agen apa yang ditawarkan situs: agen untuk diajak bicara, server MCP, API, cara untuk membeli. Agen yang menemukan salah satunya dan tidak bisa mem-parsing-nya akan menyerah alih-alih menebak.

Sebagian besar situs tidak memerlukan satu pun, jadi file yang tidak ada tidak pernah dilaporkan. File yang ada tetapi rusak biasanya berasal dari uji coba, template, atau plugin yang dipasang lalu dilupakan.

Cara memperbaikinya

  1. Buka setiap file dari bukti dan periksa dengan validator JSON.
  2. Perbaiki sintaksnya dan tambahkan field wajib, mengikuti spesifikasi file itu sendiri.
  3. Sajikan dengan Content-Type: application/json (application/linkset+json untuk katalog API).
  4. Jika situs tidak menawarkan apa yang dijelaskan file itu, hapus file tersebut. Jalankan "Periksa lagi" pada laporan halaman untuk memastikan hasilnya.

Contoh

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

Cara memastikan perbaikannya

Setelah perubahan, tekan "Periksa lagi" pada laporan: laporan mencantumkan apa yang diperbaiki dan bagaimana skor berubah.

Periksa halaman saya →

Panduan terkait

Semua temuan dan cara kerja skor