Esta página es el punto de partida para solucionar problemas de Gemini Enterprise Agent Platform. Úsalo para diagnosticar un error, buscar un error específico, encontrar la guía para tu tarea o obtener asistencia.
Cómo diagnosticar un error
Antes de buscar una solución específica, recopila la siguiente información:
Lee el error
Anota el 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áquina, un vínculo a la documentación o una vista de registro prefiltrada si estos elementos 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 Tipo de recurso en Motor de razonamiento de Vertex AI y selecciona el valor correspondiente de Contenedor de recursos (el número de tu 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 que se produjera ningún cambio de tu lado suelen deberse a cuotas o a un incidente en curso:
- Compara tu uso con los límites del sistema y las cuotas.
- Consulta Google Cloud 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 un contenedor personalizado (BYOC) en una región |
Error en la 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 límite de frecuencia o agotamiento de recursos |
429, RESOURCE_EXHAUSTED, at capacity
|
La región está temporalmente al límite de su capacidad |
429, RESOURCE_EXHAUSTED, max_instances
|
Se superó la cantidad máxima de instancias para la región |
500 error interno del servidor de una plantilla compilada previamente |
Errores de plantilla compilada previamente |
Conflictos de versiones de cloudpickle o pydantic cuando se serializa el 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 personalizados de la cuenta de servicio |
400, INVALID_ARGUMENT,
REASONING_ENGINE_SECRET_ACCESS_DENIED,
referenced by spec.deployment_spec.secret_env |
Errores de acceso a Secret Manager |
InvalidArgument: 400 Provided filter is not valid
|
Se produjo un error al filtrar 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 (prohibido) |
| Errores de verificación de certificados que llegan a un destino de AC privada o autofirmada | No se pueden conectar los destinos de CA privada o autofirmada |
| Errores de protocolo de enlace TLS de un agente de contenedor personalizado (BYOC) | No se puede conectar el agente implementado con un contenedor personalizado (BYOC) |
| Errores de creación de la zona de pruebas | Problemas de creación de la zona de pruebas |
| Se agota el tiempo de espera de la ejecución del 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 devolvieron 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 se encuentra en el catálogo de errores, consulta la siguiente tabla para ver 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 |
| Cómo crear un agente | Crea un agente |
| Implementa un agente en Agent Runtime | Implementación del agente |
| Cómo llamar a un servicio externo desde un agente | Conectividad de Agent Gateway |
| Cómo enumerar, actualizar o borrar un agente implementado | Administra los agentes implementados |
| Ejecuta código en una zona de pruebas | Ejecución de código |
| Generar o recuperar recuerdos | Memory Bank de Agent Platform |
| Entrega de un modelo o alcance de una cuota de modelos | Solución de problemas de los servicios de aprendizaje automático |
Obtén asistencia
Si las guías de esta página no resuelven tu problema, consulta Cómo obtener ayuda para agentes para ver paquetes de asistencia, foros de la comunidad y cómo informar 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 permite tomar medidas.