代码执行问题排查

本部分介绍了使用 Agent Engine 代码执行时遇到的常见问题及其解决方案。

沙盒创建问题

  • 权限错误：如果您在创建沙盒时遇到错误，请确保您的 Google Cloud 项目具有 Vertex AI User (roles/aiplatform.user) Identity and Access Management (IAM) 角色。

  • 项目 ID 或位置无效：验证代码中使用的 PROJECT_ID 和 LOCATION 变量是否正确且受支持。如需查看支持的区域列表，请参阅支持的区域。

  • 未创建代理引擎：在创建沙盒之前，请确认代理引擎实例已成功创建。agent_engine.create() 方法必须顺利完成，不得出现错误。

代码执行问题

  • 代码错误：查看 execute_code 响应中的 stderr 输出，以识别代码中的任何语法错误、运行时异常或逻辑缺陷。

  • 文件 I/O 问题：

    • 找不到文件：确保 input_data 的 files 数组中指定的任何输入文件在您的代码中都得到正确引用。 您的代码在文件所在的文件夹中执行，无法访问其他文件夹。

    • 未生成输出文件：检查您的代码是否正在写入预期的输出文件名，以及是否存在阻止文件创建或写入的错误。

    • 大小限制：文件大小上限为 100MB。

  • 状态持久性：如果您的代码依赖于之前的状态，请验证您是否在后续调用中使用了相同的 sandbox_name。另请确保沙盒未过期。

  • 超时：代码执行在 300 秒后超时。 考虑优化代码以提高性能，或将复杂的任务分解为更易于管理的较小步骤。

沙盒管理和清理

  • 找不到要删除的沙盒：如果您无法删除沙盒，请确保您使用的 sandbox_name 正确无误，并且沙盒仍然存在。

  • 未找到要删除的 Agent Engine：与沙盒类似，尝试删除 Agent Engine 时，请验证 agent_engine_name。

  • 资源配额：如果您要创建许多沙盒或频繁执行，则可能会遇到资源配额限制。检查您的项目针对 Vertex AI 服务的配额，并根据需要申请增加配额。如需查看 Agent Engine 配额列表，请参阅配额。