Risoluzione dei problemi relativi all'esecuzione del codice

Questo documento fornisce descrizioni dei problemi comuni e delle relative soluzioni quando si lavora con l'esecuzione del codice in un ambiente sandbox isolato. Include assistenza per gli errori di creazione della sandbox, i timeout di esecuzione e i problemi di I/O dei file.

Problemi di creazione della sandbox

  • Errore di autorizzazione: se riscontri errori durante la creazione di una sandbox, assicurati che il tuo Google Cloud progetto abbia il ruolo di Identity and Access Management (IAM) Utente della piattaforma agenti (roles/aiplatform.user).

  • ID progetto o località non validi: verifica che le variabili PROJECT_ID e LOCATION utilizzate nel codice siano corrette e supportate. Per un elenco delle regioni supportate, consulta Regioni supportate.

  • Motore agenti non creato: prima di creare una sandbox, verifica che l'istanza di Agent Platform sia stata creata correttamente. Il metodo agent_engine.create() deve essere completato senza errori.

Problemi di esecuzione del codice

  • Errori di codice: esamina l'output stderr della risposta execute_code per identificare eventuali errori di sintassi, eccezioni di runtime o errori logici nel codice.

  • Problemi di I/O dei file:

    • File non trovato: assicurati che tutti i file di input specificati nell'array files di input_data siano referenziati correttamente nel codice. Il codice viene eseguito nella stessa cartella dei file e non può accedere ad altre cartelle.

    • File di output non generato: verifica che il codice stia scrivendo nel nome file di output previsto e che non ci siano errori che impediscono la creazione o la scrittura del file.

    • Limiti di dimensione: esiste un limite di dimensione di 100 MB per i file.

  • Persistenza dello stato: se il codice si basa sullo stato precedente, verifica di utilizzare lo stesso sandbox_name per le chiamate successive. Inoltre, assicurati che la sandbox non sia scaduta.

  • Timeout: l'esecuzione del codice va in timeout dopo 300 secondi. Valuta la possibilità di ottimizzare il codice per le prestazioni o di suddividere le attività complesse in passaggi più piccoli e più gestibili.

Gestione e pulizia della sandbox

  • Sandbox non trovata per l'eliminazione: se non riesci a eliminare una sandbox, assicurati che il sandbox_name che stai utilizzando sia corretto e che la sandbox esista ancora.

  • Motore agenti non trovato per l'eliminazione: analogamente alle sandbox, verifica il agent_engine_name quando tenti di eliminare l'istanza di Agent Platform.

  • Quote delle risorse: se crei molte sandbox o esegui esecuzioni frequenti, potresti riscontrare limiti di quota delle risorse. Controlla le quote del progetto per i servizi di Agent Platform e richiedi aumenti, se necessario. Per un elenco delle quote del motore agenti, consulta Quote.