En esta página, se muestra cómo resolver problemas con Agent Registry.
Se excedió la cuota de frecuencia de la API
Es posible que encuentres este problema si interactúas con la API de Agent Registry o rápidamente navegas por Agent Registry en la Google Cloud consola:
429 Too Many Requests
Para resolver este problema, implementa la retirada exponencial en tus clientes de la API para administrar las frecuencias de solicitudes. La API de Agent Registry tiene una cuota de frecuencia predeterminada de 1,200 solicitudes por minuto a nivel global y por región (20 consultas por segundo).
Si encuentras limitaciones cuando cambias de pestaña en Google Cloud consola, espera
unos momentos y vuelve a intentarlo. Si tu caso de uso programático requiere límites más altos, solicita un aumento de cuota
para la RequestsPerMinute métrica.
Error de tamaño de carga útil durante el registro manual
Es posible que encuentres este problema si registras manualmente un agente o un servidor de MCP: la API rechaza la solicitud con un error que indica que la carga útil es demasiado grande.
Para resolver este problema, verifica que tu archivo agent-card.json o toolspec.json tenga menos de 10 KB. Los tamaños de contenido de AgentSpec y McpServerSpec están limitados a 10 KB. Minimiza tus archivos JSON, quita los espacios en blanco innecesarios o condensa las descripciones de las herramientas para cumplir con este límite. Para obtener más
información, consulta Esquemas JSON.
Faltan agentes o servidores de MCP después de la creación
Es posible que encuentres este problema si creas un agente o un servidor de MCP en un
producto Google Cloud compatible, como Google Workspace o
Gemini Enterprise: el recurso no aparece cuando se llama a las APIs de
ListAgents o ListMcpServers.
Para resolver este problema, espera a que se complete la sincronización en segundo plano. Tus recursos se actualizan en tiempo real, pero otras integraciones se propagan mediante trabajos por lotes sin conexión que se ejecutan de forma periódica. Si tu recurso no aparece después de varias horas, verifica la configuración de Uso del servicio de tu proyecto y asegúrate de que la API pertinente esté habilitada.
Las operaciones de larga duración parecen bloqueadas
Es posible que encuentres este problema si implementas agentes o configuras vinculaciones complejas: la operación tarda mucho tiempo y parece bloqueada.
Para resolver este problema, usa la herramienta de MCP get_operation o el extremo de API de google.longrunning.Operations.GetOperation para sondear el estado de la operación. Algunas creaciones de backend de agentes y MCP requieren un aprovisionamiento de infraestructura significativo, lo que puede generar tiempos de operación de larga duración (LRO) que pueden tardar hasta 30 minutos. Configura la configuración de tiempo de espera del cliente como resultado y sondea la marca booleana done para verificar la finalización.
Resultados vacíos cuando se recuperan las vinculaciones disponibles
Es posible que encuentres este problema si recuperas las vinculaciones disponibles para un proveedor de autenticación: la API muestra un empty array o un error de acceso, incluso si verificaste
que existe la vinculación.
Para resolver este problema, verifica que tu principal tenga los permisos correctos de Identity and Access Management (IAM) en el recurso AuthProvider de destino. La API aplica verificaciones estrictas de IAM y quita los objetos Binding que hacen referencia a los proveedores de autenticación a los que el emisor no tiene acceso. Asegúrate de que tu principal tenga el acceso requerido en el proveedor de autenticación y el rol roles/agentregistry.viewer en el proyecto.