Risolvere i problemi di Gemini Enterprise Agent Platform

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.

Diagnostica 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 da macchina, un link alla documentazione o una visualizzazione dei log prefiltrata, se presenti nel messaggio di errore.

Trova i log

Per cercare e filtrare i log degli errori dell'agente, utilizza Esplora log, imposta Tipo di risorsa su Vertex AI Reasoning Engine e seleziona il valore Container di risorse corrispondente (il numero del progetto) e il valore ID del motore di ragionamento.

Controlla le quote e Service Health

Gli errori che si verificano a intermittenza o che sono iniziati senza una modifica da parte tua sono spesso causati dalla quota o da un incidente in corso:

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 tentando 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, per il tuo primo deployment di container personalizzato (BYOC) in una regione Errore di creazione iniziale BYOC
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 risorsa esaurita o di limitazione di frequenza
429, RESOURCE_EXHAUSTED, at capacity Regione temporaneamente al limite della capacità
429, RESOURCE_EXHAUSTED, max_instances Il numero massimo di istanze supera il limite regionale
Errore interno del server 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 viene creata
iam.serviceAccounts.actAs negato, server dei metadati non disponibile Errori account di servizio personalizzati
400, INVALID_ARGUMENT, REASONING_ENGINE_SECRET_ACCESS_DENIED, referenced by spec.deployment_spec.secret_env Errori di accesso a Secret Manager
504, DEADLINE_EXCEEDED, REASONING_ENGINE_BUILD_TIMEOUT Timeout durante la creazione dell'immagine container
504, DEADLINE_EXCEEDED, REASONING_ENGINE_CONTAINER_START_TIMEOUT Il container non è stato avviato in tempo
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 Forbidden
Errori di verifica del certificato che raggiungono una destinazione CA privata o autofirmata Le destinazioni CA autofirmate o private non riescono a connettersi
Errori di TLS handshake 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 di codice, errori di I/O dei file in una sandbox Problemi di esecuzione del codice
RuntimeError: Failed to generate memory o non vengono restituiti ricordi dopo una sessione Nessun ricordo generato

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
Deployment di un agente in Agent Runtime Deployment degli agenti
Chiamata di 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 di questa pagina non risolvono il problema, consulta Assistenza per gli agenti per pacchetti di assistenza, forum della community e segnalazione di bug. Per domande sulla fatturazione, consulta 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 utilizzabile.