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

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

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

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

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

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

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

### エラー: ツール呼び出しがスロットリングエラーで失敗しました
<a name="spark-upgrade-agent-throttling-error"></a>

サービスの制限に達した場合は、スロットリング例外が表示されるまで数秒待ってからツール呼び出しを発行してください。

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

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

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

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

最初にすべてのツール呼び出しで「信頼」設定をデフォルトでオンにせず、git バージョンのビルド環境で動作します。各ツールの実行を確認して、どのような変更が行われているかを理解します。例えば、同意する前にアップグレードプランを確認します。Kiro やエージェントの`fs_write`ツールを信頼しないでください。このツールはプロジェクトファイルを変更するため、変更を保存/コミットする前に必ず変更を確認する必要があります。一般に、提案されたファイルの変更をすべて調べてから、書き込みを許可します。git を使用してバージョン変更を行い、アップグレードプロセス全体でチェックポイントを作成します。徐々に信頼を構築する - 複数のアップグレードのためにシステムを繰り返し使用していて、ツールに自信がある場合は、特定のツールを選択的に信頼できます。

### 2. アップグレードツールを活用するための一般的なプロンプトの例は何ですか?
<a name="spark-upgrade-agent-qa-prompt-examples"></a>

アップグレードツールの活用に関するプロンプトの例[Spark アップグレードエージェントのプロンプト例](emr-spark-upgrade-agent-prompt-examples.md)については、「」を参照してください。