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

Esta secção apresenta problemas comuns e respetivas soluções quando trabalha com a execução do código do motor do agente.

Problemas de criação da sandbox

  • Erro de autorizações: se encontrar erros ao criar uma sandbox, certifique-se de que o seu Google Cloud projeto tem a função de gestão de identidade e de acesso (IAM) de utilizador do Vertex AI (roles/aiplatform.user).

  • ID do projeto ou localização inválido: verifique se as variáveis PROJECT_ID e LOCATION usadas no seu código estão corretas e são suportadas. Para ver uma lista das regiões suportadas, consulte o artigo Regiões suportadas.

  • O Agent Engine não foi criado: antes de criar uma sandbox, confirme que a instância do Agent Engine foi criada com êxito. O método agent_engine.create() tem de ser concluído sem erros.

Problemas de execução de código

  • Erros de código: reveja o resultado stderr da resposta execute_code para identificar erros de sintaxe, exceções de tempo de execução ou falhas lógicas no seu código.

  • Problemas de E/S de ficheiros:

    • Ficheiro não encontrado: certifique-se de que todos os ficheiros de entrada especificados na matriz do seu input_data são corretamente referenciados no seu código.files O seu código é executado na mesma pasta que os ficheiros e não pode aceder a outras pastas.

    • Ficheiro de saída não gerado: verifique se o seu código está a escrever no nome do ficheiro de saída esperado e se não existem erros que impeçam a criação ou a escrita do ficheiro.

    • Limites de tamanho: existe um limite de tamanho de 100 MB para ficheiros.

  • Persistência do estado: se o seu código depender do estado anterior, verifique se está a usar o mesmo sandbox_name para chamadas subsequentes. Além disso, certifique-se de que a sandbox não expirou.

  • Limite de tempo: a execução do código atinge o limite de tempo após 300 segundos. Pondere otimizar o código para melhorar o desempenho ou dividir tarefas complexas em passos mais pequenos e mais fáceis de gerir.

Gestão e limpeza da sandbox

  • Sandbox não encontrado para eliminação: se não conseguir eliminar um sandbox, certifique-se de que o sandbox_name que está a usar está correto e que o sandbox ainda existe.

  • Agent Engine not found for deletion: tal como nas caixas de areia, verifique o agent_engine_name quando tentar eliminar o Agent Engine.

  • Quotas de recursos: se estiver a criar muitas caixas de areia ou a executar ações com frequência, pode deparar-se com limites de quotas de recursos. Verifique as quotas do seu projeto para os serviços da Vertex AI e peça aumentos, se necessário. Para ver uma lista de quotas do Agent Engine, consulte o artigo Quotas.