エージェント向けの検出ファイルを読み取れません
短い答え
エージェントが /.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": []
} 修正の確認方法
変更後、レポートで「もう一度チェック」を押してください。修正されたものとスコアの変化が表示されます。