Questa pagina è il punto di partenza per la risoluzione dei problemi di Gemini Enterprise Agent Platform. Utilizzala 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:
Leggere l'errore
Prendi nota del codice di stato, ad esempio 400 o 429, e del testo esatto del messaggio. Puoi cercare entrambi nel catalogo degli errori.
Puoi anche identificare l'errore specifico da un motivo leggibile dalla macchina, un link alla documentazione o una visualizzazione dei log prefiltrata, se presenti nel messaggio di errore.
Trovare i log
Per cercare e filtrare i log degli errori degli agenti, utilizza Esplora log, imposta Tipo di risorsa su Vertex AI Reasoning Engine e seleziona il valore Contenitore di risorse corrispondente (il numero del progetto) e il valore ID Reasoning Engine.
Controllare le quote e l'integrità del servizio
Gli errori che si verificano in modo intermittente o che sono iniziati senza modifiche 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 se è in corso un incidente nella tua regione.
Catalogo degli errori
Trova 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 di stato o messaggio | 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 alla prima esecuzione |
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 di VPC-SC |
429, RESOURCE_EXHAUSTED
|
Errori di esaurimento delle risorse o di limite di frequenza |
Errore server interno 500 da un modello predefinito |
Errori dei modelli predefiniti |
Conflitti di versione cloudpickle o pydantic durante la serializzazione dell'agente |
Errori di serializzazione |
NotFound: 404 Can not copy from "gs://..."
|
La sottodirectory del bucket Cloud Storage non è stata creata |
iam.serviceAccounts.actAs denied, server dei metadati non disponibile |
Errori degli account di servizio personalizzati |
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 su una richiesta in uscita |
Errori 403: accesso negato |
| Errori di verifica del certificato durante il raggiungimento di una destinazione CA autofirmata o privata | Impossibile connettersi alle destinazioni CA autofirmate o private |
| Errori di handshake TLS da un agente container personalizzato (BYOC) | Impossibile connettersi all'agente di cui è stato eseguito il deployment con un container personalizzato (BYOC) |
| 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 memoryo 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 |
|---|---|
| Installare l'SDK Agent Platform e configurare l'ambiente | Configurazione dell'ambiente di Agent Runtime |
| Creare 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 |
| Elencare, aggiornare o eliminare un agente di cui è stato eseguito il deployment | Gestire gli agenti di cui è stato eseguito il deployment |
| Eseguire il codice in una sandbox | Esecuzione del codice |
| Generare o recuperare ricordi | Memory Bank di Agent Platform |
| Pubblicare un modello o raggiungere una quota di modelli | Risolvere i problemi dei servizi di machine learning |
Richiedere assistenza
Se le guide in questa pagina non risolvono il problema, consulta Richiedere assistenza per gli agenti per i pacchetti di assistenza, i forum della community e la segnalazione di bug. Per domande sulla fatturazione, consulta la pagina Domande sullafatturazione.
Se presenti un bug, fornisci le seguenti informazioni:
- Codice di stato
- Messaggio di errore
- (Facoltativo) Feedback se il messaggio di errore è errato, fuorviante o non utilizzabile.