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 di codice in un ambiente sandbox isolato. Include assistenza per errori di creazione della sandbox, timeout di esecuzione e 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 progetto Google Cloud disponga del ruolo IAM (Identity and Access Management) Agent Platform User (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.

  • Agent Engine non creato: prima di creare una sandbox, verifica che l'istanza della piattaforma dell'agente 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 difetti logici nel codice.

  • Problemi di I/O dei file:

    • File non trovato: assicurati che tutti i file di input specificati nell'array files del tuo 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 scriva nel nome file di output previsto e che non siano presenti errori che impediscono la creazione o la scrittura del file.

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

  • Persistenza dello stato: se il tuo 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 di codice scade dopo 300 secondi. Valuta la possibilità di ottimizzare il codice per migliorare le prestazioni o di suddividere le attività complesse in passaggi più piccoli e 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.

  • Agent Engine non trovato per l'eliminazione: come per le sandbox, verifica il agent_engine_name quando tenti di eliminare l'istanza della piattaforma dell'agente.

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