O Agent Registry usa cotas e limites do sistema para manter uma alocação justa de recursos, evitar sobrecargas de serviço e ajudar você a gerenciar o uso de recursos.
As cotas e os limites do sistema são semelhantes, mas diferem das seguintes maneiras:
- As cotas têm valores definidos por padrão, mas geralmente é possível solicitar ajustes.
- Os limites do sistema são valores que não podem ser alterados.
OGoogle Cloud usa cotas para garantir a imparcialidade e reduzir picos no uso e na disponibilidade de recursos. Uma cota restringe a alocação de um recurso doGoogle Cloud para uso do seu projeto do Google Cloud . As cotas se aplicam a vários tipos de recursos, incluindo hardware, software e componentes de rede. Por exemplo, elas podem restringir o número de chamadas de API para um serviço, o número de balanceadores de carga usados simultaneamente pelo projeto ou o número de projetos que podem ser criados. As cotas protegem a comunidade de usuários doGoogle Cloud , impedindo a sobrecarga de serviços. Elas também ajudam você a gerenciar seus próprios recursos do Google Cloud .
O sistema de cotas do Cloud faz o seguinte:
- Monitora o consumo de produtos e serviços do Google Cloud .
- Restringe o consumo desses recursos.
- Possibilita a solicitação de mudanças no valor das cotas e a automatização de ajustes de cotas.
Na maioria dos casos, quando você tenta consumir mais de um recurso do que a cota permite, o sistema bloqueia o acesso ao recurso, e a tarefa que você está tentando executar falha.
As cotas geralmente se aplicam ao nível do projeto do Google Cloud . O uso de um recurso em um projeto não afeta a cota disponível em outro. Em um projeto do Google Cloud , as cotas são compartilhadas entre todos os aplicativos e endereços IP.
Saiba mais em Visão geral das cotas do Cloud.
cotas de alocação.
As cotas de alocação restringem a quantidade de um recurso específico que o Agent Registry permite usar em um determinado momento. Quando você cria um recurso, a cota disponível para ele diminui. Quando você exclui o recurso, a cota é restaurada.
A tabela a seguir lista as cotas de alocação que se aplicam ao Agent Registry e o valor padrão de cada cota.
| Cota | Valor |
|---|---|
| Máximo de agentes por projeto | 100 (global e por região) |
| Máximo de servidores MCP por projeto | 100 (global e por região) |
| Máximo de endpoints por projeto | 100 (global e por região) |
| Máximo de vinculações por projeto | 100 (global e por região) |
| Máximo de habilidades A2A por projeto | 100 (global e por região) |
| Máximo de habilidades independentes por projeto e por local | 100 (global, multirregiões e por região) |
| Máximo de revisões de habilidade por projeto e local, compartilhadas entre todas as habilidades no local | 500 (global, multirregional e por região) |
cotas de taxa.
As cotas de taxa restringem a taxa de consumo de um recurso. As cotas de taxa por minuto são redefinidas a cada minuto. A tabela a seguir lista as cotas de taxa que se aplicam ao Agent Registry e o valor padrão de cada cota.
| Cota | Valor |
|---|---|
| Agregue solicitações de API em métodos globais e regionais | 12.000 por minuto por projeto (200 QPS) |
| Solicitações de API globais | 1.200 por minuto por projeto (20 QPS) |
| Solicitações de API regionais | 1.200 por minuto por projeto por região (20 QPS) |
| Criar, atualizar e excluir solicitações de habilidades e revisões de habilidades | 120 por minuto por projeto por local (2 QPS). Global, multirregional e por região) |
| Receber, listar e pesquisar solicitações de habilidades e revisões de habilidades | 1.200 por minuto por projeto e por local (20 QPS. Global, multirregional e por região) |
Limites do sistema
A tabela a seguir lista os limites do sistema que se aplicam ao Agent Registry e o valor de cada limite.
| Limite do sistema | Valor |
|---|---|
| Tamanho do nome de exibição | 63 caracteres (serviços e vinculações); 128 caracteres (habilidades) |
| Tamanho da descrição | 2.048 caracteres |
| Tamanho do conteúdo da especificação do agente | 150 KB |
| Tamanho do conteúdo da especificação do servidor MCP | 150 KB |
| Tamanho máximo do payload de habilidade compactado (ZIP) | 1 MB |
| Tamanho máximo total do payload de habilidades descompactado para habilidades verificadas | 10 MB, aplicados quando a verificação está ativada |
| Tamanho máximo de arquivo individual não compactado no payload de habilidades para habilidades verificadas | 1 MB, aplicado quando a verificação está ativada |
| Máximo de habilidades ou ferramentas A2A por serviço | 100 |
| Tamanho máximo da paginação | 100 |
| Número máximo de projetos membros por projeto de gerenciamento para o resumo entre projetos | 10.000 |
Cotas de serviço downstream e A2A agêntico
Quando os agentes orquestradores descobrem e chamam agentes Agent2Agent (A2A) ou ferramentas do Protocolo de Contexto de Modelo (MCP), o Google Cloud avalia o consumo de cota em três camadas separadas:
- Cotas de descoberta e gerenciamento do registro: as cotas de alocação e taxa listadas neste documento regem apenas as solicitações de registro, gerenciamento, pesquisa e pesquisa de metadados enviadas ao Agent Registry. O agente de execução e as chamadas de ferramenta não consomem a cota de taxa do Agent Registry depois que o cliente pesquisa rápida um agente de destino ou um URL de endpoint do servidor MCP.
- Cotas do Agent Runtime de destino: cada Agent Runtime ou serviço Google Cloud de destino aplica as próprias cotas de taxa. Para limites específicos de serviço, consulte a documentação de cotas do serviço de destino ou veja as cotas específicas da API.
- Cotas de token e API por serviço downstream: quando um agente A2A chama APIs downstream do Google Cloud ou ferramentas MCP, essas chamadas consomem as cotas de taxa de API por serviço do projeto de cota ou do projeto de recurso faturado para cada solicitação. Loops de raciocínio autônomos, novas tentativas e subagentes paralelos podem gerar tráfego em rajadas em relação às cotas de projetos compartilhados. Monitore o uso em Cotas do Cloud e reduza o uso solicitando valores de cota mais baixos, conforme descrito em Ver e gerenciar cotas. Para ajudar a limitar o consumo de tokens de LLM compartilhados no tráfego de saída do agente, configure políticas de gerenciamento de tokens no Secure Web Proxy e no Gateway de Agente.
Receber nomes de métricas de cota e limite do sistema
As cotas e os limites do sistema têm dois tipos de nomes: nomes de exibição e nomes de métricas. Os nomes de exibição têm espaços e letras maiúsculas que facilitam a leitura para humanos. Os nomes de métricas geralmente são minúsculos e delimitados por sublinhados em vez de espaços. O formato exato depende do serviço.
As instruções a seguir mostram como receber nomes de métricas para cotas e limites do sistema usando o console do Google Cloud ou a Google Cloud CLI.
Console
No console do Google Cloud , acesse a página IAM e administrador > Cotas e limites do sistema:
Acesse "Cotas e limites do sistema
A tabela nesta página mostra cotas e limites do sistema que têm uso ou valores ajustados, além de uma entrada de referência para outras cotas. A entrada de referência tem a palavra "default" entre parênteses no final da lista na coluna Nome. Por exemplo,
SetIAMPolicy requests per minute per region (default)é a entrada de referência para a cotaSetIamPolicyRequestsPerMinutePerProject.Se a coluna Métrica não aparecer, siga estas etapas.
- Clique em Opções de exibição de coluna.
- Selecione Métrica.
- Clique em OK. A coluna Métrica aparece na tabela.
A coluna Métrica mostra os nomes das métricas. Para filtrar os resultados, insira um nome ou valor de propriedade no campo ao lado de Filtro.
gcloud
Para receber os nomes das métricas de um serviço do Google Cloud usando a CLI gcloud, execute o comando quotas info list. Para pular linhas que não listam nomes de métricas, transmita a saída para um comando como grep com metric: como o termo de pesquisa ou use a flag --format da CLI gcloud:
gcloud beta quotas info list --project=PROJECT_ID_OR_NUMBER \
--service=SERVICE_NAME --format="value(metric)"
Substitua:
PROJECT_ID_OR_NUMBER: o ID ou o número do projeto.SERVICE_NAME: o nome do serviço com as métricas de cota que você quer ver. Por exemplo, o nome do serviço do Compute Engine écompute.googleapis.com. Inclua a partegoogleapis.comdo nome do serviço.
Solicitar um ajuste de cota
Para ajustar a maioria das cotas, use o console do Google Cloud . Para mais informações, consulte Solicitar ajuste de cota.