无法读取智能体发现文件

简短回答

智能体会在 /.well-known/ 下查找的某个文件有响应,但无法读取:agent-card.json(A2A 智能体卡片)、mcp.json(MCP 服务器描述文件)、api-catalog(RFC 9727),或者商店的 ucp。它不是有效的 JSON,或缺少必需字段,例如智能体卡片的 name 或 API 目录的 linkset。

agent.discovery_invalid · 优先级: P2

含义

智能体会查找的 /.well-known/ 下的某个文件(智能体卡片、MCP 描述文件、API 目录或 UCP 配置文件)有响应,但不是有效的 JSON,或缺少必需字段。找到它的智能体会就此停下。请修复该文件或将其删除。

为什么这对 AI 搜索很重要

这些文件告诉智能体网站提供什么:可以对话的智能体、MCP 服务器、API、购买方式。找到文件却无法解析的智能体会直接放弃,而不是去猜。

大多数网站一个都不需要,所以文件缺失从不报告。文件存在却已损坏,通常来自某个设置后被遗忘的测试、模板或插件。

如何修复

  1. 打开证据中的每个文件,用 JSON 校验工具检查。
  2. 按照该文件自身的规范修正语法并补上必需字段。
  3. 以 Content-Type: application/json 提供它(API 目录使用 application/linkset+json)。
  4. 如果网站并不提供文件中描述的内容,就删除该文件。在页面报告中点击“再次检测”确认结果。

示例

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

如何确认修复

修改后,在报告上点击“再次检测”:它会列出已修复的内容以及评分的变化。

检测我的页面 →

相关指南

所有发现及评分计算方式