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.
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 de documentación o una vista de registro prefiltrada si están presentes en el mensaje de error.
Busca los registros
Para buscar y filtrar registros de errores de agentes, usa el Explorador de registros, establece Tipo de recurso en Vertex AI Reasoning Engine 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 el estado del servicio para ver si hay un incidente en curso en tu región.Google Cloud
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 por primera vez de BYOC |
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 de recursos agotados |
Error interno del servidor 500 de una plantilla compilada previamente |
Errores de plantilla compilada previamente |
Conflictos de versiones de cloudpickle o pydantic cuando se serializa tu agente |
Errores de serialización |
NotFound: 404 Can not copy from "gs://..."
|
No se creó el subdirectorio del bucket de Cloud Storage |
iam.serviceAccounts.actAs denegado, servidor de metadatos no disponible |
Errores de cuentas de servicio personalizadas |
InvalidArgument: 400 Provided filter is not valid
|
Error cuando se filtra 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 de salida |
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 AC 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 de código, errores de E/S de archivos en una zona de pruebas | Problemas de ejecución de código |
RuntimeError: Failed to generate memoryo no se muestran 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 |
|---|---|
| Instalar el SDK de Agent Platform y configurar tu entorno | Configuración del entorno de Agent Runtime |
| Crear un agente | Crear un agente |
| Implementar un agente en Agent Runtime | Implementación de agentes |
| Llamar a un servicio externo desde un agente | Conectividad de Agent Gateway |
| Mostrar, actualizar o borrar un agente implementado | Administrar agentes implementados |
| Ejecutar código en una zona de pruebas | Ejecución de código |
| Generar o recuperar recuerdos | Memory Bank de Agent Platform |
| Entregar un modelo o alcanzar una cuota de modelo | Solución de problemas de los servicios de aprendizaje automático |
Obtenga asistencia
Si las guías de esta página no resuelven tu problema, consulta Obtén ayuda para agentes para obtener paquetes de asistencia, foros de la comunidad y notificaciones de errores. Si tienes preguntas sobre la facturación, consulta Facturación preguntas.
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 realizar ninguna acción.