Solução de problemas de execução de código

Este documento descreve problemas comuns e as soluções deles ao trabalhar com a execução de código em um ambiente de sandbox isolado. Ele inclui ajuda para falhas na criação de sandbox, tempos limite de execução e problemas de E/S de arquivos.

Problemas na criação de sandbox

  • Erro de permissões: se você encontrar erros ao criar um sandbox, verifique se o projeto do Google Cloud tem o papel do Identity and Access Management (IAM) de Usuário da plataforma de agente (roles/aiplatform.user).

  • ID do projeto ou local inválido: verifique se as variáveis PROJECT_ID e LOCATION usadas no código estão corretas e são compatíveis. Para uma lista de regiões com disponibilidade, consulte Regiões com disponibilidade.

  • O Agent Engine não foi criado: antes de criar um sandbox, confirme se a instância da plataforma de agentes foi criada. O método agent_engine.create() precisa ser concluído sem erros.

Problemas de execução de código

  • Erros de código: revise a saída stderr da resposta execute_code para identificar erros de sintaxe, exceções de ambiente de execução ou falhas lógicas no código.

  • Problemas de E/S de arquivos:

    • Arquivo não encontrado: verifique se todos os arquivos de entrada especificados na matriz files do input_data estão referenciados corretamente no código. O código é executado na mesma pasta que os arquivos e não pode acessar outras pastas.

    • Arquivo de saída não gerado: verifique se o código está gravando no nome de arquivo de saída esperado e se não há erros que impeçam a criação ou gravação do arquivo.

    • Limites de tamanho: há um limite de 100 MB para arquivos.

  • Persistência de estado: se o código depende do estado anterior, verifique se você está usando o mesmo sandbox_name para as chamadas seguintes. Além disso, verifique se o sandbox não expirou.

  • Tempo limite: a execução de código expira após 300 segundos. Otimize o código para melhorar o desempenho ou divida tarefas complexas em etapas menores e mais fáceis de gerenciar.

Gerenciamento e limpeza de sandbox

  • Sandbox não encontrado para exclusão: se não for possível excluir um sandbox, verifique se o sandbox_name que você está usando está correto e se o sandbox ainda existe.

  • Mecanismo de agente não encontrado para exclusão: assim como nos sandboxes, verifique o agent_engine_name ao tentar excluir a instância da Agent Platform.

  • Cotas de recursos: se você estiver criando muitos sandboxes ou realizando execuções frequentes, talvez encontre limites de cota de recursos. Verifique as cotas do seu projeto para os serviços da Agent Platform e solicite aumentos, se necessário. Para uma lista de cotas do Agent Engine, consulte Cotas.