อ่านไฟล์สำหรับให้เอเจนต์ค้นพบไม่ได้
ไฟล์ที่เอเจนต์มองหาใต้ /.well-known/ ตอบกลับ แต่อ่านไม่ได้ ได้แก่ agent-card.json (agent card ของ A2A), mcp.json (ตัวอธิบายเซิร์ฟเวอร์ MCP), api-catalog (RFC 9727) หรือ ucp สำหรับร้านค้า ไฟล์ไม่ใช่ JSON ที่ถูกต้อง หรือขาดฟิลด์ที่จำเป็น เช่น name ของ agent card หรือ linkset ของแค็ตตาล็อก API
หมายความว่าอย่างไร
ไฟล์ใต้ /.well-known/ ที่เอเจนต์มองหา (agent card, ตัวอธิบาย MCP, แค็ตตาล็อก API หรือโปรไฟล์ UCP) ตอบกลับ แต่ไม่ใช่ JSON ที่ถูกต้อง หรือขาดฟิลด์ที่จำเป็น เอเจนต์ที่พบไฟล์นี้จะหยุดอยู่ตรงนั้น แก้ไฟล์หรือลบออก
ทำไมจึงสำคัญต่อการค้นหาด้วย AI
ไฟล์เหล่านี้บอกเอเจนต์ว่าไซต์มีอะไรให้บ้าง เช่น เอเจนต์ที่คุยด้วยได้ เซิร์ฟเวอร์ MCP, API หรือช่องทางการซื้อ เอเจนต์ที่เจอไฟล์แต่แยกวิเคราะห์ไม่ได้จะเลิกไปแทนที่จะเดา
ไซต์ส่วนใหญ่ไม่จำเป็นต้องมีไฟล์เหล่านี้เลย การไม่มีไฟล์จึงไม่ถูกรายงาน ไฟล์ที่มีอยู่แต่เสียมักมาจากการทดสอบ เทมเพลต หรือปลั๊กอินที่ตั้งไว้แล้วลืม
วิธีแก้ไข
- เปิดแต่ละไฟล์จากหลักฐาน แล้วตรวจด้วยเครื่องมือตรวจสอบ JSON
- แก้ไวยากรณ์และเพิ่มฟิลด์ที่จำเป็นตามข้อกำหนดของไฟล์นั้น
- ให้บริการด้วย
Content-Type: application/json(ใช้application/linkset+jsonสำหรับแค็ตตาล็อก API) - หากไซต์ไม่ได้มีสิ่งที่ไฟล์อธิบายไว้ ให้ลบไฟล์ทิ้ง กด "ตรวจสอบอีกครั้ง" ในรายงานของหน้าเพื่อยืนยันผล
ตัวอย่าง
{
"name": "Example support agent",
"description": "Answers questions about orders",
"url": "https://example.com/a2a",
"version": "1.0.0",
"skills": []
} วิธียืนยันว่าแก้ได้ผล
หลังจากแก้ไขแล้ว กด "ตรวจสอบอีกครั้ง" ในรายงาน รายงานจะแสดงสิ่งที่แก้แล้วและคะแนนที่เปลี่ยนไป