このドキュメントでは、分離されたサンドボックス環境でコード実行を操作する際の一般的な問題とその解決策について説明します。サンドボックス作成エラー、実行タイムアウト、ファイル I/O の問題に関するヘルプが含まれています。
サンドボックスの作成に関する問題
権限エラー: サンドボックスの作成時にエラーが発生した場合は、 Google Cloud プロジェクトに Agent Platform ユーザー(
roles/aiplatform.user)の Identity and Access Management(IAM)ロールがあることを確認します。プロジェクト ID またはロケーションが無効: コードで使用されている
PROJECT_ID変数とLOCATION変数が正しく、サポートされていることを確認します。サポート対象の地域の一覧については、サポート対象の地域をご覧ください。Agent Engine が作成されていない: サンドボックスを作成する前に、Agent Platform インスタンスが正常に作成されていることを確認します。
agent_engine.create()メソッドはエラーなしで完了する必要があります。
コード実行に関する問題
コードエラー:
execute_codeレスポンスのstderr出力を確認して、コード内の構文エラー、ランタイム例外、論理的な欠陥を特定します。ファイル I/O の問題:
ファイルが見つからない:
input_dataのfiles配列で指定された入力ファイルがコード内で正しく参照されていることを確認します。コードはファイルと同じフォルダで実行され、他のフォルダにはアクセスできません。出力ファイルが生成されない: コードが想定される出力ファイル名に書き込まれていること、ファイルの作成や書き込みを妨げるエラーがないことを確認します。
サイズの上限: ファイルサイズの上限は 100 MB です。
状態の永続性: コードが以前の状態に依存している場合は、後続の呼び出しで同じ
sandbox_nameを使用していることを確認します。また、サンドボックスの有効期限が切れていないことを確認します。タイムアウト: コード実行は 300 秒後にタイムアウトします。パフォーマンスを向上させるためにコードを最適化するか、複雑なタスクをより小さく管理しやすいステップに分割することを検討してください。
サンドボックスの管理とクリーンアップ
削除するサンドボックスが見つからない: サンドボックスを削除できない場合は、使用している
sandbox_nameが正しいこと、サンドボックスがまだ存在していることを確認してください。削除対象の Agent Engine が見つからない: サンドボックスと同様に、Agent Platform インスタンスを削除しようとしたときに
agent_engine_nameを確認します。リソースの割り当て: 多数のサンドボックスを作成する場合や、頻繁に実行する場合は、リソースの割り当て上限に達する可能性があります。Agent Platform サービスのプロジェクトの割り当てを確認し、必要に応じて増加をリクエストします。Agent Engine の割り当ての一覧については、割り当てをご覧ください。