یک فایل کشف عامل قابل خواندن نیست
فایلی که عاملها زیر /.well-known/ دنبالش میگردند پاسخ میدهد، اما قابل خواندن نیست: agent-card.json (کارت عامل A2A)، mcp.json (توصیفگر سرور MCP)، api-catalog (RFC 9727) یا در فروشگاهها ucp. JSON معتبر نیست، یا فیلدی لازم را ندارد، مثل name در کارت عامل یا linkset در کاتالوگ API.
یعنی چه
فایلی زیر /.well-known/ که عاملها دنبالش میگردند (کارت عامل، توصیفگر MCP، کاتالوگ API یا پروفایل UCP) پاسخ میدهد، اما نه با JSON معتبر، یا بدون فیلدهایی که لازم دارد. عاملهایی که آن را پیدا میکنند همانجا متوقف میشوند. فایل را اصلاح یا حذف کنید.
چرا برای جستجوی هوش مصنوعی مهم است
این فایلها به عاملها میگویند سایت چه چیزی ارائه میکند: عاملی برای گفتگو، یک سرور MCP، یک API، راهی برای خرید. عاملی که یکی از آنها را پیدا کند و نتواند تجزیهاش کند، بهجای حدس زدن کنار میکشد.
بیشتر سایتها به هیچکدام از آنها نیاز ندارند، برای همین نبودِ فایل هرگز گزارش نمیشود. فایلی که هست ولی خراب است معمولاً از یک آزمایش، یک قالب یا افزونهای میآید که راهاندازی و فراموش شده.
چطور آن را اصلاح کنید
- هر فایل موجود در شواهد را باز کنید و با یک اعتبارسنج JSON بررسی کنید.
- نحو را اصلاح کنید و فیلدهای الزامی را طبق مشخصات خود آن فایل اضافه کنید.
- آن را با
Content-Type: application/jsonارائه کنید (برای کاتالوگ API باapplication/linkset+json). - اگر سایت آنچه فایل توصیف میکند را ارائه نمیدهد، فایل را حذف کنید. در گزارش صفحه «بررسی دوباره» را اجرا کنید تا نتیجه را تأیید کنید.
نمونه
{
"name": "Example support agent",
"description": "Answers questions about orders",
"url": "https://example.com/a2a",
"version": "1.0.0",
"skills": []
} چطور از رفع مشکل مطمئن شویم
پس از اعمال تغییر، در گزارش «بررسی دوباره» را بزنید: فهرست میکند چه چیزی رفع شده و امتیاز چطور تغییر کرده است.