تتعذّر قراءة ملف اكتشاف مخصّص للوكلاء

إجابة موجزة

ملف يبحث عنه الوكلاء تحت /.well-known/ يستجيب، لكن تتعذّر قراءته: agent-card.json (بطاقة وكيل A2A)، أو mcp.json (واصف خادم MCP)، أو api-catalog (RFC 9727)، أو ucp في المتاجر. فهو ليس JSON صالحًا، أو تنقصه حقول لازمة، مثل name في بطاقة الوكيل أو linkset في فهرس API.

agent.discovery_invalid · الأولوية: P2

ماذا يعني

ملف تحت /.well-known/ يبحث عنه الوكلاء (بطاقة الوكيل أو واصف MCP أو فهرس API أو ملف تعريف UCP) يستجيب، لكن ليس بـ JSON صالح، أو تنقصه الحقول اللازمة. والوكلاء الذين يجدونه يتوقفون عنده. أصلِح الملف أو احذفه.

لماذا يهم ذلك في البحث بالذكاء الاصطناعي

تخبر هذه الملفات الوكلاء بما يقدّمه الموقع: وكيلًا يمكن التحدث إليه، أو خادم 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": []
}

كيف تتأكد من الإصلاح

بعد التغيير، اضغط «افحص مجددًا» في التقرير: سيعرض ما تم إصلاحه وكيف تغيّرت الدرجة.

افحص صفحتي ←

أدلة ذات صلة

كل الملاحظات وكيف تُحسب الدرجة