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

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

エラーを診断する

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

エラーを読む

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

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

ログの表示

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

割り当てとサービスの健全性を確認する

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

エラーカタログ

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

ステータス コードまたはメッセージ 解決策
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 コンテンツ生成エラー
リージョン内の最初のカスタム コンテナ（BYOC）デプロイに対する failed to start and cannot serve traffic BYOC の初回作成エラー
VPC Service Controls の境界内の failed to start and cannot serve traffic または Request is prohibited by organization's policy 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 のアクセスエラー
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
モデルのサービングまたはモデルの割り当て超過 機械学習サービスのトラブルシューティング

サポートを受ける

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

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

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