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

Esta seção apresenta problemas comuns e as respectivas soluções ao trabalhar com a execução de código do mecanismo de agente.

Problemas de criação do sandbox

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

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

  • Mecanismo de agente não criado:antes de criar um sandbox, confirme se a instância do mecanismo de agente 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:analise a saída stderr da resposta execute_code para identificar erros de sintaxe, exceções 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 de input_data são referenciados corretamente no código. O código é executado na mesma pasta dos 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 de arquivos.

    • Limites de tamanho:há um limite de tamanho 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 chamadas subsequentes. Além disso, verifique se o sandbox não expirou.

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

Gerenciamento e limpeza do sandbox

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

  • Mecanismo de agente não encontrado para exclusão:semelhante aos sandboxes, verifique o agent_engine_name ao tentar excluir o mecanismo de agente.

  • Cotas de recursos:se você estiver criando muitos sandboxes ou realizando execuções frequentes, poderá encontrar limites de cota de recursos. Verifique as cotas do projeto para os serviços da Vertex AI e solicite aumentos, se necessário. Para conferir uma lista de cotas do mecanismo de agente, consulte Cotas.