Risolvere i problemi relativi alla creazione di un agente utilizzando Agent Runtime

Questo documento descrive come risolvere gli errori che potresti riscontrare durante la creazione di un agente.

Errori di generazione dei contenuti

Problema:

Ricevi un messaggio di errore simile al seguente:

ValueError: Cannot get the Candidate text.
Response candidate content part has no text.

Possibile causa:

Questo errore potrebbe essere causato dall'utilizzo di una versione di langchain-google-vertexai non compatibile con google-cloud-aiplatform. È richiesta la versione 1.0.2 o successive di langchain-google-vertexai. Per verificare la versione in uso, esegui questo comando nel terminale:

pip show langchain-google-vertexai

Soluzione consigliata:

Installa la versione 1.0.2 di langchain-google-vertexai. Questa versione include gli aggiornamenti della chiamata di strumenti LangChain necessari per utilizzare google-cloud-aiplatform. Per aggiornare la versione di langchain-google-vertexai, esegui questo comando nel terminale:

pip install langchain-google-vertexai --upgrade

Dopo aver eseguito il comando di aggiornamento, verifica di utilizzare la versione 1.0.2 o successive eseguendo questo comando nel terminale:

pip show langchain-google-vertexai

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

Errore di creazione iniziale di Bring your own container (BYOC)

Problema:

Esegui il deployment degli agenti tramite BYOC in your Google Cloud project per la prima volta nella regione in cui ti trovi e ricevi un messaggio di errore simile al seguente:

Reasoning Engine resource <reasoning-engine-id> failed to start and cannot serve traffic.

Possibile causa:

L'errore è probabilmente dovuto al provisioning IAM interno di Agent Runtime su Gemini Enterprise Agent Platform. Il completamento e la propagazione delle modifiche richiedono tempo.

Soluzione consigliata:

Riprova la stessa richiesta di deployment dell'agente e l'operazione andrà a buon fine.