Nesta página, mostramos como resolver problemas com o Agent Registry.
Cota de taxa de API excedida
Esse problema pode ocorrer se você interagir com a API Agent Registry ou navegar rapidamente pelo Agent Registry no Google Cloud console:
429 Too Many Requests
Para resolver esse problema, implemente a espera exponencial nos clientes da API para gerenciar as taxas de solicitação. A API Agent Registry tem uma cota de taxa padrão de 1.200 solicitações por minuto globalmente e por região.
Se você encontrar limitação ao alternar as guias no Google Cloud console, aguarde alguns
instantes e tente novamente. Se o caso de uso programático exigir limites mais altos,
solicite um aumento de cota
para a métrica RequestsPerMinute.
Erro de tamanho do payload durante o registro manual
Esse problema pode ocorrer se você registrar manualmente um agente ou servidor MCP: a API rejeita a solicitação com um erro informando que o payload é muito grande.
Para resolver esse problema, verifique se o arquivo agent-card.json ou toolspec.json tem menos de 10 KB. Os tamanhos do conteúdo AgentSpec e McpServerSpec são limitados a 10 KB. Minifique os arquivos JSON, remova espaços em branco desnecessários ou condense as descrições das ferramentas para obedecer a esse limite. Para mais informações, consulte
Esquemas JSON.
Agentes ou servidores MCP ausentes após a criação
Esse problema pode ocorrer se você criar um agente ou servidor MCP em um
produto Google Cloud compatível, como o Google Workspace ou o
Gemini Enterprise: o recurso não aparece ao chamar as APIs
ListAgents ou ListMcpServers.
Para resolver esse problema, aguarde a conclusão da sincronização em segundo plano. Seus recursos são atualizados em tempo real, mas outras integrações são preenchidas por jobs em lote off-line executados periodicamente. Se o recurso não aparecer após várias horas, verifique as configurações de Service Usage do projeto e confira se a API relevante está ativada.
Operações de longa duração parecem travadas
Esse problema pode ocorrer se você implantar agentes ou configurar vinculações complexas: a operação leva muito tempo e parece travada.
Para resolver esse problema, use a ferramenta get_operation MCP ou o endpoint de API google.longrunning.Operations.GetOperation para consultar o status da operação. Algumas criações de back-end de agente e MCP exigem um provisionamento de infraestrutura significativo, o que pode levar a tempos de operação de longa duração (LRO) que podem levar até 30 minutos. Configure as configurações de tempo limite do cliente e consulte a flag booleana done para verificar a conclusão.
Resultados vazios ao buscar vinculações disponíveis
Esse problema pode ocorrer se você buscar vinculações disponíveis para um provedor de autenticação: a API retorna uma empty array ou um erro de acesso, mesmo que você tenha verificado se a vinculação existe.
Para resolver esse problema, verifique se a principal tem as permissões corretas do IAM no recurso AuthProvider de destino. A API aplica verificações de IAM rigorosas e remove objetos Binding que referenciam provedores de autenticação aos quais o autor da chamada não tem acesso. Verifique se a principal tem o acesso necessário no provedor de autenticação e o papel roles/agentregistry.viewer no projeto.