翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# トラブルシューティングと Q&A
<a name="spark-troubleshooting-agent-troubleshooting"></a>

## トラブルシューティング
<a name="spark-troubleshooting-common-issues"></a>

Spark トラブルシューティングエージェントからのエラーメッセージは、さまざまな MCP クライアントでさまざまな方法で使用できます。このページでは、Amazon EMR で Apache Spark トラブルシューティングエージェントを使用する一般的な問題に関する一般的なガイダンスを一覧表示します。

トピック
+ [エラー: MCP サーバーのロードに失敗しました](#mcp-server-failed-to-load)
+ [観測: ツールのロードが遅い](#slow-tool-loading)
+ [エラー: ツール呼び出しがスロットリングエラーで失敗しました](#throttling-error)
+ [エラー: ユーザーエラーによるツール応答](#user-error)
+ [エラー: 内部エラーによるツール応答](#internal-error)

### エラー: MCP サーバーのロードに失敗しました
<a name="mcp-server-failed-to-load"></a>
+ MCP 設定が正しく設定されていることを確認します。
+ **JSON 構文を検証**します。
  + 構文エラーなしで JSON が有効であることを確認する
  + 欠落しているカンマ、引用符、または括弧がないか確認します。
+ ローカル AWS 認証情報を確認し、MCP IAM ロールのポリシーが正しく設定されていることを確認します。
+ /mcp を実行して、`Kiro-CLI`ケースの MCP サーバーの可用性を検証する

### 観測: ツールのロードが遅い
<a name="slow-tool-loading"></a>
+ サーバーの初回起動時にツールがロードされるまでに数秒かかる場合があります。
+ ツールが表示されない場合は、チャットを再起動してみてください。
+ `/tools` コマンドを実行してツールの可用性を確認します。
+ サーバーがエラーなしで起動`/mcp`された場合は、 を実行します。

### エラー: ツール呼び出しがスロットリングエラーで失敗しました
<a name="throttling-error"></a>
+ サービスの制限に達した場合は、スロットリング例外が表示されるまで数秒待ってからツール呼び出しを発行してください。

### エラー: ユーザーエラーによるツール応答
<a name="user-error"></a>
+ AccessDeniedException - エラーメッセージを確認し、アクセス許可の問題を修正します。
+ InvalidInputException - エラーメッセージを確認し、ツール入力パラメータを修正します。
+ ResourceNotFoundException - エラーメッセージを確認し、リソースリファレンスの入力パラメータを修正します。

### エラー: 内部エラーによるツール応答
<a name="internal-error"></a>
+ 表示された場合は`The service is handling high-volume requests`、数秒後にツールの呼び出しを再試行してください。
+ 表示される場合は、分析 ID、ツール名、mcp ログまたはツールレスポンスから利用可能なエラーメッセージ、およびオプションのサニタイズされた会話履歴`INTERNAL SERVICE EXCEPTION`を記録し、 AWS サポートにお問い合わせください。

## Q&A
<a name="spark-troubleshooting-qa"></a>

### 1. デフォルトでツールの「信頼」設定を有効にする必要がありますか?
<a name="qa-trust-setting"></a>

最初にすべてのツール呼び出しで「信頼」設定をデフォルトでオンにせず、コードレコメンデーションを受け入れるときに git バージョンのビルド環境で動作します。各ツールの実行を確認して、どのような変更が行われているかを理解します。

### 2. トラブルシューティングツールを活用するための一般的なプロンプトの例は何ですか?
<a name="qa-example-prompts"></a>

トラブルシューティングツールの活用に関するプロンプトの例[プロンプトの例](spark-troubleshooting-agent-prompt-examples.md)については、「」を参照してください。

### 3. LLM に送信されるデータとその処理方法
<a name="qa-data-transmitted-to-llm"></a>

お客様のデータとファイルは、選択した AWS リージョン内にとどまり、リージョン間では送信されません。エージェントが Amazon Bedrock のグローバルクロスリージョン推論を使用するリージョンで運用されている場合、サービスは、需要に応じて利用可能な容量を持つ最寄りのリージョンにリクエストをルーティングすることがあります。このような場合、顧客ログから抽出されたメタデータと処理された推論結果のみが送信され、基盤となる顧客データやファイルは送信されません。すべてのデータは、推論が同じリージョン内で発生するか、別のリージョンにルーティングされるかにかかわらず、処理のために LLM に送信される前に PII マスクされます。クロスリージョン推論の仕組みと影響を受けるリージョンの詳細については、「」を参照してください[Apache Spark トラブルシューティングエージェントのクロスリージョン処理](spark-troubleshooting-cross-region-processing.md)。