Esta página es el punto de partida para solucionar problemas de Gemini Enterprise Agent Platform. Úsala para diagnosticar un error, buscar un error específico, encontrar la guía para tu tarea o obtener asistencia.
Diagnostica un error
Antes de buscar una solución específica, recopila la siguiente información:
Lee el error.
Toma nota del código de estado, como 400 o 429, y el texto exacto del mensaje. Puedes
buscar ambos en el catálogo de errores.
También puedes identificar la falla específica a partir de un motivo legible por máquinas, un vínculo a la documentación o una vista de registro filtrada previamente, si están presentes en el mensaje de error.
Busca los registros
Para buscar y filtrar los registros de errores del agente, usa el Explorador de registros, establece el Tipo de recurso en Motor de razonamiento de Vertex AI y selecciona el valor de Contenedor de recursos correspondiente (tu número de proyecto) y el valor de ID del motor de razonamiento.
Verifica las cuotas y el estado del servicio
Los errores que aparecen de forma intermitente o que comenzaron sin un cambio de tu parte suelen deberse a la cuota o a un incidente en curso:
- Compara tu uso con las cuotas y los límites del sistema.
- Consulta Cloud de Confiance by S3NS Service Health para ver si hay un incidente en curso en tu región.
Catálogo de errores
Busca el error que recibiste en la siguiente tabla. Si tu error no aparece en la lista, usa las guías de solución de problemas para la tarea que intentabas completar.
| Código o mensaje de estado | Solución |
|---|---|
ImportError: cannot import name 'reasoning_engines',
ImportError: cannot import name 'agent_engines' |
Versión desactualizada del SDK de Agent Platform para Python |
401 Context-Aware Access requirements are not met,
401 Request had invalid authentication credentials |
Errores de autorización 401 |
ValueError: Cannot get the Candidate text
|
Errores de generación de contenido |
failed to start and cannot serve traffic, en tu
primera implementación de contenedor personalizado (BYOC) en una región |
Error de creación de BYOC por primera vez |
failed to start and cannot serve traffic o
Request is prohibited by organization's policy,
dentro de un perímetro de Controles del servicio de VPC |
Errores de incumplimiento de VPC-SC |
429, RESOURCE_EXHAUSTED
|
Errores de recurso agotado o límite de frecuencia |
429, RESOURCE_EXHAUSTED, at capacity
|
La región alcanzó su capacidad máxima de forma temporal |
429, RESOURCE_EXHAUSTED, max_instances
|
La cantidad máxima de instancias supera el límite regional |
Error interno del servidor 500 de una plantilla compilada previamente |
Errores de plantilla compilada previamente |
Conflictos de versión de cloudpickle o pydantic cuando
serializas tu agente |
Errores de serialización |
NotFound: 404 Can not copy from "gs://..."
|
No se creó el subdirectorio del bucket de Cloud Storage |
Se rechazó iam.serviceAccounts.actAs, el servidor de metadatos
no está disponible |
Errores de cuentas de servicio personalizadas |
400, INVALID_ARGUMENT,
REASONING_ENGINE_SECRET_ACCESS_DENIED,
referenced by spec.deployment_spec.secret_env |
Errores de acceso a Secret Manager |
504, DEADLINE_EXCEEDED,
REASONING_ENGINE_BUILD_TIMEOUT |
Se agotó el tiempo de espera para compilar la imagen de contenedor |
504, DEADLINE_EXCEEDED,
REASONING_ENGINE_CONTAINER_START_TIMEOUT |
El contenedor no se inició a tiempo |
InvalidArgument: 400 Provided filter is not valid
|
Se produjo un error cuando se filtraba la lista de agentes |
google.api_core.exceptions.Unknown: None,
Failed to convert project number to project ID,
durante el inicio |
Errores durante el inicio de Agent Runtime |
403 Forbidden en una solicitud saliente |
Errores 403 de acceso prohibido |
| Fallas en la verificación de certificados que llegan a un destino de CA privado o autofirmado | Los destinos de CA privados o autofirmados no se conectan |
| Fallas en el protocolo de enlace TLS de un agente de contenedor personalizado (BYOC) | El agente implementado con un contenedor personalizado (BYOC) no se conecta |
| Errores de creación de la zona de pruebas | Problemas con la creación de la zona de pruebas |
| Se agota el tiempo de espera de la ejecución de código, se producen errores de E/S de archivos en una zona de pruebas | Problemas de ejecución de código |
RuntimeError: Failed to generate memory o no se devuelven recuerdos después de una sesión |
No se generaron recuerdos |
Guías de solución de problemas
Si no tienes un mensaje de error específico o tu error no está en el catálogo de errores, consulta la siguiente tabla para obtener la guía correspondiente a tu tarea:
| Tarea | Guía |
|---|---|
| Instala el SDK de Agent Platform y configura tu entorno | Configuración del entorno de Agent Runtime |
| Crea un agente | Crea un agente |
| Implementa un agente en Agent Runtime | Implementación de agentes |
| Llama a un servicio externo desde un agente | Conectividad de Agent Gateway |
| Enumera, actualiza o borra un agente implementado | Administra los agentes implementados |
| Ejecuta código en una zona de pruebas | Ejecución de código |
| Generando o recuperando recuerdos | Memory Bank de Agent Platform |
| Entregar un modelo o alcanzar una cuota de modelo | Soluciona problemas de los servicios de aprendizaje automático |
Obtén asistencia
Si las guías de esta página no resuelven tu problema, consulta Obtén ayuda para los agentes para ver los paquetes de asistencia, los foros de la comunidad y los informes de errores. Si tienes preguntas sobre la facturación, consulta Preguntas sobre la facturación.
Si presentas un error, proporciona la siguiente información:
- Código de estado
- Mensaje de error
- (Opcional) Comentarios si el mensaje de error es incorrecto, engañoso o no se puede resolver.