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

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

Problemas na criação do sandbox

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

  • 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 conferir uma lista de regiões compatíveis, consulte Regiões compatíveis.

  • Mecanismo de agente não criado:antes de criar uma 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 tempo 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 seu código. O código é executado na mesma pasta dos arquivos e não pode acessar outras pastas.

    • O arquivo de saída não foi 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 tamanho de 100 MB para arquivos.

  • Persistência de estado:se o código depender 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 seu código para melhorar a performance ou dividir 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 do agente não encontrado para exclusão:assim como nos sandboxes, verifique o agent_engine_name ao tentar excluir o mecanismo do agente.

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