翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
トラブルシューティングと Q&A
トラブルシューティング
アップグレードプロセスからのエラーメッセージは、さまざまな MCP クライアントでさまざまな方法で使用できます。このページでは、Amazon EMR で Apache Spark Upgrade Agent を使用する一般的な問題に関する一般的なガイダンスを一覧表示します。
トピック
エラー: SMUS Managed MCP サーバーのロードに失敗しました
-
MCP 設定が正しく設定されていることを確認します。
-
JSON 構文を検証します。
-
構文エラーなしで JSON が有効であることを確認する
-
カンマ、引用符、または括弧がないかどうかを確認します。
-
-
ローカル AWS 認証情報を確認し、MCP IAM ロールのポリシーが正しく設定されていることを確認します。
-
/mcp を実行して、
Kiro-CLIケースの MCP サーバーの可用性を検証する
観測値: ツールのロードが遅い
-
サーバーを起動しようとすると、ツールがロードされるまでに数秒かかることがあります。
-
ツールが表示されない場合は、チャットを再起動してみてください。
-
/toolsコマンドを実行してツールの可用性を確認します。 -
サーバーがエラーなしで起動
/mcpされた場合は、 を実行します。
エラー: ツール呼び出しがスロットリングエラーで失敗しました
サービスの制限に達した場合は、スロットリング例外が表示されるまで数秒待ってからツール呼び出しを発行してください。
エラー: ユーザーエラーによるツール応答
-
AccessDeniedException - エラーメッセージを確認し、アクセス許可の問題を修正します。
-
InvalidInputException - エラーメッセージを確認し、ツール入力パラメータを修正します。
-
ResourceNotFoundException - エラーメッセージを確認し、リソースリファレンスの入力パラメータを修正します。
エラー: 内部エラーによるツール応答
-
表示された場合は
The service is handling high-volume requests、数秒後にツールの呼び出しを再試行してください。 -
表示される場合は、分析 ID、ツール名、mcp ログまたはツールレスポンスから利用可能なエラーメッセージ、およびオプションのサニタイズされた会話履歴
INTERNAL SERVICE EXCEPTIONを記録し、 AWS サポートにお問い合わせください。
Q&A
1. デフォルトでツールの「信頼」設定を有効にする必要がありますか?
最初にすべてのツール呼び出しでデフォルトで「信頼」設定をオンにせず、git バージョンのビルド環境で動作します。各ツールの実行を確認して、どのような変更が行われているかを理解します。例えば、同意する前にアップグレードプランを確認します。Kiro やエージェントのfs_writeツールを信頼しないでください。このツールはプロジェクトファイルを変更するため、変更を保存/コミットする前に必ず変更を確認する必要があります。一般に、提案されたファイルの変更をすべて調べてから、書き込みを許可します。git を使用してバージョンを変更し、アップグレードプロセス全体でチェックポイントを作成します。徐々に信頼を構築する - 複数のアップグレードのためにシステムを繰り返し使用していて、ツールに自信がある場合は、特定のツールを選択的に信頼できます。
2. アップグレードツールを活用するための一般的なプロンプトの例は何ですか?
アップグレードツールの活用に関するプロンプトの例Spark アップグレードエージェントのプロンプト例については、「」を参照してください。