エージェント向けの検出ファイルを読み取れません

短い答え

エージェントが /.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": []
}

修正の確認方法

変更後、レポートで「もう一度チェック」を押してください。修正されたものとスコアの変化が表示されます。

ページをチェック →

関連ガイド

すべての指摘とスコアの仕組み