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 Tipo de recurso en Motor de razonamiento de Vertex AI y selecciona el valor correspondiente de Contenedor de recursos (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 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. Los errores con un código de estado se enumeran primero, en orden numérico, seguidos por el resto en orden alfabético. 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 |
|---|---|
400, FAILED_PRECONDITION,
REASONING_ENGINE_A2A_NOT_CONFIGURED |
No se definieron los métodos A2A |
400, FAILED_PRECONDITION,
REASONING_ENGINE_NO_RUNNING_INSTANCES |
El agente no tiene instancias en ejecución |
400, FAILED_PRECONDITION,
REASONING_ENGINE_REQUEST_TOO_LARGE |
La carga útil de la solicitud es demasiado grande |
400, INVALID_ARGUMENT,
REASONING_ENGINE_BUILD_FAILED |
No se pudo compilar la imagen de contenedor |
400, INVALID_ARGUMENT,
REASONING_ENGINE_CONTAINER_FAILED_TO_START |
No se pudo iniciar el contenedor |
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 cuando se filtraba la lista de agentes |
401 Context-Aware Access requirements are not met,
401 Request had invalid authentication credentials |
Errores de autorización 401 |
403 Forbidden en una solicitud saliente |
Errores 403 de acceso prohibido |
403, PERMISSION_DENIED,
REASONING_ENGINE_NOT_ACTIVE |
El agente no está activo |
404, NOT_FOUND,
REASONING_ENGINE_NOT_FOUND |
No se encontró el agente |
NotFound: 404 Can not copy from "gs://..."
|
No se creó el subdirectorio del bucket de Cloud Storage |
409, ABORTED,
REASONING_ENGINE_AGENT_GATEWAY_CONCURRENT_PROVISION_ABORTED |
Se anuló la vinculación de Agent Gateway |
413, Request Entity Too Large, Request payload
exceeds the 32 MiB maximum |
La carga útil de la solicitud es demasiado grande |
429, RESOURCE_EXHAUSTED
|
Se superó el límite de frecuencia o la cuota de la API |
429, RESOURCE_EXHAUSTED, at capacity
|
Región temporalmente con capacidad máxima |
429, RESOURCE_EXHAUSTED, max_instances
|
La cantidad máxima de instancias supera el límite regional |
429, RESOURCE_EXHAUSTED,
REASONING_ENGINE_AGENT_GATEWAY_LOOKUP_THROTTLED |
Búsqueda de Agent Gateway limitada |
Error interno del servidor 500 de una plantilla compilada previamente |
Errores de plantilla compilada previamente |
500, INTERNAL,
REASONING_ENGINE_PROVISIONING_FAILED |
No se pudo aprovisionar el entorno |
503, UNAVAILABLE,
REASONING_ENGINE_AGENT_GATEWAY_PROVISION_UNAVAILABLE
|
La vinculación de Agent Gateway no está disponible temporalmente |
504, DEADLINE_EXCEEDED,
REASONING_ENGINE_AGENT_GATEWAY_PROVISION_TIMEOUT |
Se agotó el tiempo de espera de la vinculación de Agent Gateway |
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 |
| Fallas en la verificación de certificados que llegan a un destino de AC privado o autofirmado | Los destinos de CA privados o autofirmados no se pueden conectar |
Conflictos de versión de cloudpickle o pydantic cuando
serializas tu agente |
Errores de serialización |
| 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 |
Lista vacía de .operation_schemas()
|
Los esquemas de operación están vacíos |
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 |
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 |
google.api_core.exceptions.Unknown: None,
Failed to convert project number to project ID,
durante el inicio |
Errores durante el inicio de Agent Runtime |
Se rechazó iam.serviceAccounts.actAs, el servidor de metadatos
no está disponible |
Errores de la cuenta de servicio personalizada |
ImportError: cannot import name 'reasoning_engines',
ImportError: cannot import name 'agent_engines' |
Versión desactualizada del SDK de Agent Platform para Python |
PermissionDenied cuando consultas a un agente
|
Se produjo un error PermissionDenied cuando se consultaba el agente |
Reasoning Engine Execution failed
|
No se pudo ejecutar el motor de razonamiento |
RuntimeError: Failed to generate memory, o no se devuelven
recuerdos después de una sesión |
No se generaron recuerdos |
| Errores de creación de la zona de pruebas | Problemas con la creación de la zona de pruebas |
| 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 |
ValueError: Cannot get the Candidate text
|
Errores de generación de contenido |
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 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 |
| Creando un agente | Crea un agente |
| Implementa un agente en Agent Runtime | Implementación de agentes |
| Usa un agente implementado | Usa un agente |
| 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 |
| Generar o recuperar recuerdos | Agent Platform Memory Bank |
| 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.