無法讀取 AI 代理的探索檔案

簡短回答

AI 代理會在 /.well-known/ 底下尋找的某個檔案有回應,但無法讀取:agent-card.json(A2A 代理卡片)、mcp.json(MCP 伺服器描述檔)、api-catalog(RFC 9727),或商店的 ucp。它不是有效的 JSON,或缺少必要欄位,例如代理卡片的 name 或 API 目錄的 linkset。

agent.discovery_invalid · 優先順序: P2

代表什麼

AI 代理會尋找的 /.well-known/ 底下某個檔案(代理卡片、MCP 描述檔、API 目錄或 UCP 設定檔)有回應,但不是有效的 JSON,或缺少必要欄位。找到它的代理會就此停下。請修正或移除該檔案。

為什麼這對 AI 搜尋很重要

這些檔案告訴 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": []
}

如何確認修正

修改後,在報告上按下「再次檢查」:它會列出已修正的項目以及分數的變化。

檢查我的頁面 →

相關指南

所有發現與分數計算方式