Soluciona problemas de Gemini Enterprise Agent Platform

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:

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.