View a markdown version of this page

トラブルシューティング - Amazon Bedrock AgentCore
スキーマ検証エラーレコード同期エラー

トラブルシューティング

今後の名前空間の移行

AWS エージェントレジストリは現在、bedrock-agentcore 名前空間のパブリックプレビュー中です。2026 年 8 月 6 日以降、サービスはエージェントレジストリ名前空間に移動します。 AWS エージェントレジストリを使用する場合は、エンドポイント、IAM ポリシー、SDK クライアント、CLI スクリプト、レジストリデータを更新する必要があります。パブリックプレビューからの移行の詳細については、「包括的なレジストリ移行ガイド」を参照してください。

スキーマ検証エラー

異なるタイプのレコードを作成すると、記述子の検証例外が表示される場合があります。有効なスキーマについては、「サポートされているレコードタイプ」セクションを参照してください。

一般的なエラー。

  • 「スキーマバージョン '0.3.0' は、記述子タイプ 'a2a' ではサポートされていません。」 — schemaVersion フィールドの値は 0.3ではなく 0.3.0 である必要があります。これは、公式の A2A プロトコルバージョンの説明「メジャーバージョンごとにサポートされている最新のマイナーバージョンを使用する」と一致します。

  • 「スキーマの検証に失敗しました: コンテンツが記述子タイプ「a2a」のスキーマバージョン「0.3」に準拠していません。」 — スキーマは、サポートされているレコードタイプ にあります。コンテンツは JSON スキーマの #/definitions/AgentCard に対して検証されることに注意してください。

レコード同期エラー

同期機能を使用してレコードを作成または更新すると、レコードは CREATE_FAILED または UPDATE_FAILED ステータスに移行し、何が起こったかstatusReasonを説明する が表示されます。

大まかに言うと、エラーはアクセス許可エラー、接続エラー、検証エラー、サーバー側のエラーに分類できます。

アクセス許可エラー

同期設定が間違っているか、有効期限切れです。

  • 「発信者の認証情報の有効期限が切れているため、MCP サーバーに接続できません。」 — API の作成または更新の呼び出し元に期限切れの認証情報があります。UpdateRegistryRecord API を使用して再試行できます。

  • GetWorkloadAccessToken API から受信した例外: <detailed message>」 — レジストリは呼び出し元on-behalf-of GetWorkloadAccessToken API を呼び出します。エラーの詳細については、詳細なメッセージを参照してください。アクセス拒否例外が表示された場合は、「外部ソースからのレコードの同期」を参照してください。

  • 「認証情報プロバイダー ARN を解析できません: <arn>」 — 不正な形式の認証情報プロバイダー ARN。これは、AgentCore Identity から作成された有効な認証情報プロバイダー ARN である必要があります。

  • GetResourceOauth2Token API から例外を受信しました: <detailed message>」 — レジストリは呼び出し元on-behalf-of GetResourceOauth2Token API を呼び出します。エラーの詳細については、詳細なメッセージを参照してください。アクセス拒否例外が表示された場合は、「外部ソースからのレコードの同期」を参照してください。

  • 「提供された MCP サーバー認可用の IAM ロールを引き受けることができません。」 — レジストリは、発信者on-behalf-of AssumeRole API を呼び出します。予想される IAM アクセス許可については、外部ソースからのレコードの同期を参照してください。例えば、発信者には iam:PassRole アクセス許可が必要です。

接続エラー

サーバーに到達できません。

  • 「URL: %s からエージェントカードを取得できませんでした」 — A2A IOException

  • 「MCP サーバーが HTTP <code>」を返しました — MCP サーバーから 200/202 以外の HTTP レスポンス。URL が正しく、MCP サーバーに接続できることを確認してください。

  • 「提供された URL は非パブリック IP アドレスに解決されます」 — レジストリはパブリック IP アドレスサーバーへの接続のみをサポートします。

  • 「MCP サーバーへの接続に失敗しました」 — IOException/接続失敗

  • 「無効な MCP サーバー URL」 — 不正な形式の URL

  • 「MCP 接続の初期化に失敗しました」 — リクエスト例外の初期化

  • 「初期化された通知の送信に失敗しました」 — 通知例外

  • 「MCP サーバーからツールを一覧表示できませんでした」 — ツール/リスト例外

  • 「MCP サーバーツール/リストのページ分割がタイムアウトしました」 — MCP サーバーからツールをページ分割する場合、レジストリは最大 30 秒のみをサポートします。MCP サーバーで同期にさらに時間が必要な場合は、 AWS サポートにお問い合わせください。

検証エラー

サーバーは応答しましたが、コンテンツはサポートされていません。

  • 「エージェントカード JSON の解析に失敗しました」 — A2A コンテンツが空または不正な形式 JSON

  • 「エージェントカードが最大サイズ制限を超えています」 — A2A レスポンスが大きすぎます

  • "Failed to parse MCP server response JSON" — MCP content empty or malformed

  • 「MCP サーバーが無効なレスポンスを返しました: 結果がありません」 — MCP JSON-RPC 結果がありません

  • 「MCP サーバーレスポンスが最大許容サイズを超えています」 — MCP レスポンスが大きすぎます

  • 「記述子タイプ %s は URL 同期をサポートしていません」 — サポートされていない記述子タイプ

サーバー側のエラー

  • 「不明なエラー」 — これはサーバー側のエラーです。後で再試行するか、 AWS サポートにお問い合わせください。