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

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

エラーを診断する

具体的な修正方法を探す前に、次の情報を収集してください。

エラーを読む

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

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

ログの表示

エージェントのエラーログを検索してフィルタするには、[Logs Explorer] を使用し、 [リソースタイプ] を [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 の初回作成エラー
failed to start and cannot serve traffic または Request is prohibited by organization's policy, VPC Service Controls の境界内 VPC-SC 違反エラー
429、 RESOURCE_EXHAUSTED リソースの枯渇またはレート制限エラー
事前構築テンプレートからの 500 内部サーバーエラー 事前構築テンプレートのエラー
エージェントのシリアル化時の cloudpickle または pydantic のバージョンの競合 シリアル化エラー
NotFound: 404 Can not copy from "gs://..." Cloud Storage バケットのサブディレクトリが作成されない
iam.serviceAccounts.actAs が拒否され、メタデータ サーバーが利用できない カスタム サービス アカウントのエラー
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
モデルの提供またはモデルの割り当てに達する 機械学習サービスのトラブルシューティング

サポートを受ける

このページのガイドで問題が解決しない場合は、エージェントのサポートを受ける でサポート パッケージ、コミュニティ フォーラム、バグ報告についてご確認ください。課金についてご不明な点がございましたら、課金 に関する質問をご覧ください。

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

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