En esta página, se muestra cómo resolver problemas con el Registro de agentes.
Se superó la cuota de frecuencia de la API
Es posible que encuentres este problema si interactúas con la API de Agent Registry o navegas rápidamente por Agent Registry en la consola de Google Cloud :
429 Too Many Requests
Para resolver este problema, implementa la retirada exponencial en tus clientes de API para administrar las tasas 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.
Si experimentas limitaciones cuando cambias de pestañas en la consola de Google Cloud , 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 métrica RequestsPerMinute.
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 un tamaño inferior a 10 KB. Los tamaños de contenido de AgentSpec y McpServerSpec se limitan a 10 KB. Para cumplir con este límite, minimiza tus archivos JSON, quita los espacios en blanco innecesarios o condensa las descripciones de las herramientas. Para obtener más información, consulta Esquemas JSON.
Faltan agentes o servidores de MCP después de la creación
Es posible que te encuentres con 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 completan con trabajos por lotes sin conexión que se ejecutan periódicamente. Si tu recurso no aparece después de varias horas, verifica la configuración de Uso de servicios de tu proyecto y asegúrate de que la API pertinente esté habilitada.
Las operaciones de larga duración parecen estar atascadas
Es posible que encuentres este problema si implementas agentes o configuras vinculaciones complejas: la operación tarda una cantidad significativa de tiempo y parece que se detuvo.
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 backends de agentes y de 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 los parámetros 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 te encuentres con este problema si recuperas las vinculaciones disponibles para un proveedor de autenticación: la API devuelve un error de empty array o de acceso, incluso si verificaste que existe la vinculación.
Para resolver este problema, verifica que tu principal tenga los permisos de IAM correctos en el recurso AuthProvider de destino. La API aplica verificaciones estrictas de IAM y quita los objetos Binding que hacen referencia a proveedores de autenticación a los que el llamador 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.