Risolvere i problemi di deployment di un'applicazione

Questo documento mostra come risolvere gli errori che potresti riscontrare durante il deployment di un'applicazione.

Errori del modello predefinito

Se riscontri problemi con il modello LangchainAgent durante l'implementazione, la causa potrebbe essere uno dei problemi descritti in questa sezione.

Errori di Model Builder o Runnable Builder

Problema:

Ricevi un messaggio di errore simile al seguente:

AttributeError: 'LangchainAgent' object has no attribute '_model_builder'

o

AttributeError: 'LangchainAgent' object has no attribute '_runnable_builder'

Possibile causa:

Questo può accadere se hai utilizzato una versione di google-cloud-aiplatform che è dopo il giorno 1.50.0 per definire il LangchainAgent nel tuo sviluppo dell'ambiente di rete, ma ne stai eseguendo il deployment con una versione precedente a 1.51.0 nel mese di requirements=. Per controllare quale versione utilizzi nell'ambiente di sviluppo, esegui il seguente comando nel terminale:

pip show google-cloud-aiplatform

Soluzione consigliata:

Se utilizzi una versione di google-cloud-aiplatform precedente alla versione 1.51.0, specifica una versione di google-cloud-aiplatform precedente alla versione 1.51.0 in requirements= durante il deployment del motore di ragionamento.

Se utilizzi una versione di google-cloud-aiplatform successiva alla versione 1.50.0, specifica una versione di google-cloud-aiplatform successiva alla versione 1.50.0 in requirements= durante il deployment del motore di ragionamento.

Errori interni del server

Problema:

Ricevi un messaggio di errore simile al seguente:

InternalServerError: 500 Revision XXX is not ready and cannot serve traffic.

Purtroppo, si tratta di un errore generico per eventuali problemi con il contenitore in fase di esecuzione e la possibile causa è uno dei tanti errori che potrebbero verificarsi.

Possibili cause:

  • Stato Sporco su LangchainAgent. Questo può accadere se .set_up() è stata chiamata il giorno LangchainAgent prima il deployment nel motore di ragionamento.
  • Versioni del pacchetto incoerenti. Questo può accadere se i pacchetti installati nell'ambiente di sviluppo sono diversi dai pacchetti installati dell'ambiente remoto nel motore di ragionamento.

Soluzioni consigliate:

Errori di serializzazione

In generale, è importante garantire che gli elementi "locali" e "telecomando" ambienti sono sincronizzati durante il deployment nel motore di ragionamento. Per farlo, procedi nel seguente modo: che specifica requirements= quando deployment a motore di ragionamento.

Se riscontri problemi di serializzazione (gli errori relativi a "pickle" o "pickling" sono sinonimi di errori di "serializzazione"), il problema potrebbe essere uno di quelli descritti in questa sezione.

Versione pidantica

Problema:

Ricevi un messaggio di errore simile al seguente:

PicklingError: Can't pickle <cyfunction str_validator at 0x7ca030133d30>: it's
not the same object as pydantic.validators.str_validator

Possibile causa:

Questo può accadere se il pacchetto pydantic è precedente alla versione 2.6.4. Per controllare la versione in uso, esegui il seguente comando nel terminale:

pip show pydantic

Soluzione consigliata:

Aggiorna il pacchetto eseguendo questo comando nel terminale:

pip install pydantic --upgrade

Esegui questo comando nel terminale per verificare che sia in uso la versione 2.6.4 o versioni successive:

pip show pydantic

Se sei in un'istanza del notebook (ad esempio Jupyter, Colab o Workbench), potresti dover riavviare il runtime per utilizzare i pacchetti aggiornati.

Versione Cloudpickle

Problema:

Ricevi un messaggio di errore simile al seguente:

AttributeError: Can't get attribute '_class_setstate' on <module 'cloudpickle.cloudpickle'
from '/usr/local/lib/python3.10/site-packages/cloudpickle/cloudpickle.py'>

Possibile causa:

Ciò potrebbe verificarsi se la versione del pacchetto cloudpickle è diversa nell'ambiente di sviluppo e nell'ambiente di deployment. Per controllare la versione in uso durante lo sviluppo, esegui il seguente comando nel terminale:

pip show cloudpickle

Soluzione consigliata:

Esegui il deployment della stessa versione di cloudpickle in entrambi gli ambienti (ovvero l'ambiente di sviluppo locale e l'ambiente del motore di ragionamento di cui è stato eseguito il deployment da remoto) specificando requirements= durante il deployment del motore di ragionamento.

Errori interni del server

Problema:

Ricevi un messaggio di errore simile al seguente:

InternalServerError: 500 Revision XXX is not ready and cannot serve traffic.

Possibile causa:

Questo può accadere se sys_version= è diverso dall'ambiente di sviluppo quando deployment a motore di ragionamento.

Soluzione consigliata:

Valuta la possibilità di rimuovere sys_version= dagli argomenti di input durante il deployment in di ragionamento. Se i problemi persistono, segnala un bug.

Errori del bucket Cloud Storage

Se stai riscontrando problemi con il bucket gestione temporanea Cloud Storage utilizzati al momento del deployment per raccogliere e caricare l'agente, potrebbero essere dovuti a uno dei seguenti problemi:

Errori di autorizzazione

Soluzione consigliata:

Se vuoi utilizzare un bucket preesistente: assicurati che l'entità autenticata per utilizzare Vertex AI (tu o un account di servizio) abbia accesso Storage Admin al bucket e concedi le autorizzazioni all'account di servizio del motore di ragionamento gestito da Google.

In alternativa, puoi specificare un nuovo bucket quando esegui il deployment nel motore di ragionamento e l'SDK del client del motore di ragionamento creerà il bucket con autorizzazioni aggiuntive.

Se i problemi persistono, invia una segnalazione di bug.

La sottodirectory del bucket Cloud Storage non è stata creata

Problema:

Ricevi un messaggio di errore simile al seguente:

NotFound: 404 Can not copy from \"gs://[LOCATION]-*/reasoning_engine/reasoning_engine.pkl\" to \"gs://*/code.pkl\", check if the source object and target bucket exist.

L'errore 404 si verifica quando il sistema tenta di copiare in una cartella che non esiste.

Possibile causa:

Ciò è probabilmente dovuto a un problema di interpolazione di stringhe nelle versioni di google-cloud-aiplatform precedenti alla versione 1.49.0. Questo problema è stato risolto nelle versioni successive. Per verificare qual è la tua versione di google-cloud-aiplatform esegui questo comando nel tuo terminale:

pip show google-cloud-aiplatform

Soluzione consigliata:

Aggiorna il pacchetto eseguendo questo comando nel terminale:

pip install google-cloud-aiplatform --upgrade

Verifica di utilizzare la versione 1.49.0 o successiva di google-cloud-aiplatform eseguendo il seguente comando nel terminale:

pip show google-cloud-aiplatform

Se utilizzi un'istanza del notebook (ad esempio Jupyter, Colab o Workbench), potrebbe essere necessario riavviare il runtime prima di poter utilizzare i pacchetti aggiornati.