อ่านไฟล์สำหรับให้เอเจนต์ค้นพบไม่ได้

คำตอบสั้น

ไฟล์ที่เอเจนต์มองหาใต้ /.well-known/ ตอบกลับ แต่อ่านไม่ได้ ได้แก่ agent-card.json (agent card ของ A2A), mcp.json (ตัวอธิบายเซิร์ฟเวอร์ MCP), api-catalog (RFC 9727) หรือ ucp สำหรับร้านค้า ไฟล์ไม่ใช่ JSON ที่ถูกต้อง หรือขาดฟิลด์ที่จำเป็น เช่น name ของ agent card หรือ linkset ของแค็ตตาล็อก API

agent.discovery_invalid · ลำดับความสำคัญ: P2

หมายความว่าอย่างไร

ไฟล์ใต้ /.well-known/ ที่เอเจนต์มองหา (agent card, ตัวอธิบาย MCP, แค็ตตาล็อก API หรือโปรไฟล์ UCP) ตอบกลับ แต่ไม่ใช่ JSON ที่ถูกต้อง หรือขาดฟิลด์ที่จำเป็น เอเจนต์ที่พบไฟล์นี้จะหยุดอยู่ตรงนั้น แก้ไฟล์หรือลบออก

ทำไมจึงสำคัญต่อการค้นหาด้วย AI

ไฟล์เหล่านี้บอกเอเจนต์ว่าไซต์มีอะไรให้บ้าง เช่น เอเจนต์ที่คุยด้วยได้ เซิร์ฟเวอร์ MCP, API หรือช่องทางการซื้อ เอเจนต์ที่เจอไฟล์แต่แยกวิเคราะห์ไม่ได้จะเลิกไปแทนที่จะเดา

ไซต์ส่วนใหญ่ไม่จำเป็นต้องมีไฟล์เหล่านี้เลย การไม่มีไฟล์จึงไม่ถูกรายงาน ไฟล์ที่มีอยู่แต่เสียมักมาจากการทดสอบ เทมเพลต หรือปลั๊กอินที่ตั้งไว้แล้วลืม

วิธีแก้ไข

  1. เปิดแต่ละไฟล์จากหลักฐาน แล้วตรวจด้วยเครื่องมือตรวจสอบ JSON
  2. แก้ไวยากรณ์และเพิ่มฟิลด์ที่จำเป็นตามข้อกำหนดของไฟล์นั้น
  3. ให้บริการด้วย Content-Type: application/json (ใช้ application/linkset+json สำหรับแค็ตตาล็อก API)
  4. หากไซต์ไม่ได้มีสิ่งที่ไฟล์อธิบายไว้ ให้ลบไฟล์ทิ้ง กด "ตรวจสอบอีกครั้ง" ในรายงานของหน้าเพื่อยืนยันผล

ตัวอย่าง

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

วิธียืนยันว่าแก้ได้ผล

หลังจากแก้ไขแล้ว กด "ตรวจสอบอีกครั้ง" ในรายงาน รายงานจะแสดงสิ่งที่แก้แล้วและคะแนนที่เปลี่ยนไป

ตรวจสอบหน้าของฉัน →

คู่มือที่เกี่ยวข้อง

ข้อค้นพบทั้งหมดและวิธีคิดคะแนน