无法读取智能体发现文件
简短回答
智能体会在 /.well-known/ 下查找的某个文件有响应,但无法读取:agent-card.json(A2A 智能体卡片)、mcp.json(MCP 服务器描述文件)、api-catalog(RFC 9727),或者商店的 ucp。它不是有效的 JSON,或缺少必需字段,例如智能体卡片的 name 或 API 目录的 linkset。
含义
智能体会查找的 /.well-known/ 下的某个文件(智能体卡片、MCP 描述文件、API 目录或 UCP 配置文件)有响应,但不是有效的 JSON,或缺少必需字段。找到它的智能体会就此停下。请修复该文件或将其删除。
为什么这对 AI 搜索很重要
这些文件告诉智能体网站提供什么:可以对话的智能体、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": []
} 如何确认修复
修改后,在报告上点击“再次检测”:它会列出已修复的内容以及评分的变化。