Questa pagina è il punto di partenza per la risoluzione dei problemi di Gemini Enterprise Agent Platform. Utilizzalo per diagnosticare un errore, cercare un errore specifico, trovare la guida per la tua attività o ricevere assistenza.
Diagnosticare un errore
Prima di cercare una correzione specifica, raccogli le seguenti informazioni:
Leggi l'errore
Prendi nota del codice di stato, ad esempio 400 o 429, e del testo esatto del messaggio. Puoi cercarli entrambi nel catalogo degli errori.
Puoi anche identificare l'errore specifico da un motivo leggibile dalla macchina, da un link alla documentazione o da una visualizzazione dei log prefiltrata, se presenti nel messaggio di errore.
Trovare i log
Per cercare e filtrare i log degli errori dell'agente, utilizza Esplora log, imposta Tipo di risorsa su Vertex AI Motore di ragionamento e seleziona il valore Contenitore di risorse corrispondente (il numero di progetto) e il valore ID motore di ragionamento.
Controllare le quote e l'integrità del servizio
Gli errori che si verificano a intermittenza o che sono iniziati senza una modifica da parte tua sono spesso causati da una quota o da un incidente in corso:
- Confronta il tuo utilizzo con le quote e i limiti di sistema.
- Controlla Google Cloud Service Health per verificare la presenza di un incidente in corso nella tua regione.
Catalogo degli errori
Individua l'errore che hai ricevuto nella tabella seguente. Se l'errore non è elencato, utilizza le guide per la risoluzione dei problemi per l'attività che stavi cercando di completare.
| Codice o messaggio di stato | Risoluzione |
|---|---|
ImportError: cannot import name 'reasoning_engines',
ImportError: cannot import name 'agent_engines' |
Versione obsoleta dell'SDK Agent Platform per Python |
401 Context-Aware Access requirements are not met,
401 Request had invalid authentication credentials |
Errori di autorizzazione 401 |
ValueError: Cannot get the Candidate text
|
Errori di generazione dei contenuti |
failed to start and cannot serve traffic, al primo deployment di un container personalizzato (BYOC) in una regione |
Errore di creazione BYOC per la prima volta |
failed to start and cannot serve traffic o
Request is prohibited by organization's policy,
all'interno di un perimetro dei Controlli di servizio VPC |
Errori di violazione VPC-SC |
429, RESOURCE_EXHAUSTED
|
Errori di risorsa esaurita o limite di frequenza |
429, RESOURCE_EXHAUSTED, at capacity
|
Regione temporaneamente al completo |
429, RESOURCE_EXHAUSTED, max_instances
|
Il numero massimo di istanze supera il limite regionale |
500 errore interno del server da un modello predefinito |
Errori nei modelli predefiniti |
cloudpickle o conflitti di versione pydantic durante la
serializzazione dell'agente |
Errori di serializzazione |
NotFound: 404 Can not copy from "gs://..."
|
La sottodirectory del bucket Cloud Storage non viene creata |
iam.serviceAccounts.actAs negato, server di metadati
non disponibile |
Errori account di servizio personalizzato |
400, INVALID_ARGUMENT,
REASONING_ENGINE_SECRET_ACCESS_DENIED,
referenced by spec.deployment_spec.secret_env |
Errori di accesso a Secret Manager |
InvalidArgument: 400 Provided filter is not valid
|
Errore durante il filtraggio dell'elenco degli agenti |
google.api_core.exceptions.Unknown: None,
Failed to convert project number to project ID,
durante l'avvio |
Errori durante l'avvio di Agent Runtime |
403 Forbidden in una richiesta in uscita |
Errori 403: accesso negato |
| Errori di verifica dei certificati che raggiungono una destinazione CA autofirmata o privata | Le destinazioni autofirmate o CA privata non riescono a connettersi |
| Errori di handshake TLS da un agente container personalizzato (BYOC) | L'agente di cui è stato eseguito il deployment con il contenitore personalizzato (BYOC) non riesce a connettersi |
| Errori di creazione della sandbox | Problemi di creazione della sandbox |
| Timeout dell'esecuzione del codice, errori di I/O dei file in una sandbox | Problemi di esecuzione del codice |
RuntimeError: Failed to generate memory o nessun
ricordo restituito dopo una sessione |
Non sono stati generati ricordi |
Guide per la risoluzione dei problemi
Se non hai un messaggio di errore specifico o se l'errore non è presente nel catalogo degli errori, consulta la tabella seguente per la guida corrispondente alla tua attività:
| Attività | Guida |
|---|---|
| Installazione dell'SDK Agent Platform e configurazione dell'ambiente | Configurazione dell'ambiente Agent Runtime |
| Creazione di un agente | Crea un agente |
| Eseguire il deployment di un agente in Agent Runtime | Deployment dell'agente |
| Chiamare un servizio esterno da un agente | Connettività di Agent Gateway |
| Elenco, aggiornamento o eliminazione di un agente di cui è stato eseguito il deployment | Gestisci gli agenti di cui è stato eseguito il deployment |
| Esecuzione del codice in un sandbox | Esecuzione di codice |
| Generazione o recupero dei ricordi | Agent Platform Memory Bank |
| Pubblicazione di un modello o raggiungimento di una quota del modello | Risoluzione dei problemi relativi ai servizi di machine learning |
Assistenza
Se le guide in questa pagina non risolvono il problema, consulta la sezione Richiedere assistenza per gli agenti per pacchetti di assistenza, forum della community e segnalazione di bug. Per domande sulla fatturazione, consulta la sezione Domande sulla fatturazione.
Se segnali un bug, fornisci le seguenti informazioni:
- Codice di stato
- Messaggio di errore
- (Facoltativo) Feedback se il messaggio di errore è errato, fuorviante o non attuabile.