Gemini Enterprise Agent Platform のトラブルシューティング

このページは、Gemini Enterprise Agent Platform のトラブルシューティングの出発点です。エラーの診断、特定のエラーの検索、タスクのガイドの検索、サポートの利用に使用します。

エラーを診断する

特定の修正方法を探す前に、次の情報を収集します。

エラーを読み取る

ステータス コード（400 や 429 など）と正確なメッセージ テキストをメモします。どちらもエラーカタログで確認できます。

エラー メッセージに機械で読み取り可能な理由、ドキュメント リンク、または事前フィルタされたログビューが含まれている場合は、それらから特定の障害を特定することもできます。

ログの表示

エージェントのエラーログを検索してフィルタするには、ログ エクスプローラを使用し、[リソースタイプ] を [Vertex AI 推論エンジン] に設定して、対応する [リソース コンテナ] 値（プロジェクト番号）と [Reasoning Engine ID] 値を選択します。

割り当てと Service Health を確認する

断続的に発生するエラーや、ユーザー側で変更を加えていないのに発生したエラーは、多くの場合、割り当てまたは進行中のインシデントが原因です。

エラーカタログ

発生したエラーを次の表で探します。エラーがリストにない場合は、完了しようとしていたタスクのトラブルシューティング ガイドを使用してください。

ステータス コードまたはメッセージ 解決策
ImportError: cannot import name 'reasoning_engines'、ImportError: cannot import name 'agent_engines' 旧バージョンの Agent Platform SDK for Python
401 Context-Aware Access requirements are not met、 401 Request had invalid authentication credentials 401 承認エラー
ValueError: Cannot get the Candidate text コンテンツ生成エラー
failed to start and cannot serve traffic: リージョンでの最初のカスタム コンテナ（BYOC）デプロイ BYOC の初回作成エラー
failed to start and cannot serve traffic または Request is prohibited by organization's policy（VPC Service Controls の境界内） VPC-SC 違反エラー
429、RESOURCE_EXHAUSTED リソース不足またはレート制限エラー
429, RESOURCE_EXHAUSTED, at capacity リージョンが一時的に容量不足
429, RESOURCE_EXHAUSTED, max_instances 最大インスタンス数がリージョン上限を超えている
500 事前構築テンプレートからの内部サーバーエラー 事前構築テンプレートのエラー
エージェントのシリアル化時に cloudpickle または pydantic のバージョン競合が発生する シリアル化エラー
NotFound: 404 Can not copy from "gs://..." Cloud Storage バケットのサブディレクトリが作成されない
iam.serviceAccounts.actAs が拒否されました。メタデータ サーバーが利用できません カスタム サービス アカウントのエラー
400、INVALID_ARGUMENT、REASONING_ENGINE_SECRET_ACCESS_DENIED、referenced by spec.deployment_spec.secret_env Secret Manager のアクセスエラー
504、DEADLINE_EXCEEDED、REASONING_ENGINE_BUILD_TIMEOUT コンテナ イメージのビルドがタイムアウトした
504、DEADLINE_EXCEEDED、REASONING_ENGINE_CONTAINER_START_TIMEOUT コンテナが時間内に起動しなかった
InvalidArgument: 400 Provided filter is not valid エージェントのリストをフィルタする際にエラーが発生する
google.api_core.exceptions.Unknown: None、Failed to convert project number to project ID、起動中 Agent Runtime の起動中のエラー
送信リクエストの 403 Forbidden 403 Forbidden エラー
自己署名またはプライベート CA の宛先に到達した証明書の検証エラー 自己署名またはプライベート CA の宛先が接続できない
カスタム コンテナ（BYOC）エージェントからの TLS handshake の失敗 カスタム コンテナ（BYOC）でデプロイされたエージェントが接続できない
サンドボックスの作成に失敗する サンドボックスの作成に関する問題
コード実行がタイムアウトする、サンドボックスでのファイル I/O エラー コード実行に関する問題
RuntimeError: Failed to generate memory、またはセッション後にメモリが返されない 思い出が生成されませんでした

トラブルシューティング ガイド

特定のエラー メッセージがない場合や、エラーがエラー カタログにない場合は、次の表でタスクに対応するガイドをご覧ください。

タスク ガイド
Agent Platform SDK のインストールと環境の設定 Agent Runtime 環境の設定
エージェントの作成 エージェントを作成する
エージェントを Agent Runtime にデプロイする エージェントのデプロイ
エージェントから外部サービスを呼び出す Agent Gateway の接続
デプロイされたエージェントの一覧表示、更新、削除 デプロイされたエージェントを管理する
サンドボックスでコードを実行する コード実行
メモリーの生成または取得 Agent Platform Memory Bank
モデルのサービングまたはモデルの割り当ての上限に達する 機械学習サービスのトラブルシューティング

サポートを受ける

このページのガイドで問題が解決しない場合は、エージェントのヘルプでサポート パッケージ、コミュニティ フォーラム、バグレポートをご覧ください。課金に関する質問については、課金に関する質問をご覧ください。

バグを報告する場合は、次の情報を提供してください。

  • ステータス コード
  • エラー メッセージ
  • （省略可）エラー メッセージが間違っている、誤解を招く、または対応できない場合のフィードバック。