Este documento explica os detalhes de preços do Agent Registry. É possível registrar, catalogar e descobrir recursos no Agent Registry sem custo financeiro, e você paga apenas pelos recursos de segurança opcionais de valor agregado que usar.
Visão geral de preços
O Agent Registry oferece registro, armazenamento e descoberta de catálogo de base sem custos financeiros. Não há cobranças pelo registro, armazenamento, atualização ou pesquisa de agentes, servidores MCP, endpoints, habilidades ou revisões de habilidades no Agent Registry.
As cobranças de consumo só são aplicadas quando você usa a verificação de vulnerabilidades de skill para analisar novas revisões de skill em busca de riscos de segurança, como injeção de comandos ou padrões de exfiltração de dados.
A tabela a seguir resume os preços dos recursos do Agent Registry em dólares americanos (USD):
| Recurso | Métrica de faturamento | Preço (USD) | Início da vigência |
|---|---|---|---|
| Armazenamento de catálogo para agentes, servidores MCP, endpoints, habilidades e revisões de habilidades | agentregistry.googleapis.com/object_storage |
Incluído sem custos financeiros (US$ 0,00) | Sempre |
| Operações de API de descoberta, pesquisa e Agent Registry do catálogo | Nenhum | Incluído sem custos financeiros (US$ 0,00) | Sempre |
| Verificação de vulnerabilidades de habilidades | agentregistry.googleapis.com/token_usage |
Incluído sem custos financeiros (US$ 0,00) | Até 31 de dezembro de 2026 |
| US$ 8,00 por 1 milhão de tokens de entrada | 1º de janeiro de 2027 |
Preços da verificação de vulnerabilidades de habilidades
A verificação de vulnerabilidades da habilidade inspeciona os pacotes de habilidades enviados em busca de vulnerabilidades de segurança ao criar uma revisão de habilidade. Até 31 de dezembro de 2026, a verificação de vulnerabilidades de habilidades está disponível sem custos financeiros. A partir de 1º de janeiro de 2027, a verificação de vulnerabilidades de habilidades vai custar US $8, 00 por 1 milhão de tokens de entrada.
Atualizações de preços e programação de faturamento
O armazenamento, o gerenciamento e a descoberta de habilidades no Agent Registry estão incluídos sem custos financeiros (US$ 0, 00). Não há cobrança pelo armazenamento de habilidades ou pelas operações de catálogo. Você só recebe uma cobrança quando o Agent Registry verifica uma nova revisão de habilidade em busca de vulnerabilidades.
A programação a seguir se aplica ao faturamento de habilidades no Agent Registry:
- Até 31 de dezembro de 2026: a verificação de vulnerabilidades de habilidades no Agent Registry continua disponível sem custos financeiros (US$ 0, 00).
- 1º de janeiro de 2027: o faturamento por consumo (US$ 8, 00 por 1 milhão de tokens de entrada) entra em vigor para a verificação de vulnerabilidades de habilidades no Agent Registry.
Taxas de verificação
O Agent Registry aciona uma verificação de vulnerabilidades assíncrona somente quando todas as condições a seguir são atendidas:
- Você registra uma nova skill com uma carga útil de revisão inicial ou cria uma revisão de skill fazendo upload de um arquivo ZIP.
- O campo
scanningConfig.policyda habilidade está definido comoENABLED_BLOCKING, que é a configuração padrão para novas habilidades, ouENABLED_NONBLOCKING.
Não há cobranças de verificação para os seguintes recursos e operações:
- Revisões de habilidades atuais: o Agent Registry não verifica retroativamente revisões de habilidades atuais. Você só recebe uma cobrança quando faz upload de uma nova revisão de skill.
- Habilidades com a verificação desativada: não há cobranças de verificação quando o campo
scanningConfig.policyde uma habilidade é definido comoDISABLED. - Skills criadas pelo Google: as skills pré-registradas de editores do Google não geram cobranças de verificação no seu projeto.
- Atualizações de metadados e downloads de payload: atualizar metadados de skill, mudar o estado do ciclo de vida ou o ponteiro de revisão padrão de uma skill, pesquisar skills ou baixar payloads de revisão de skill não aciona uma verificação e não gera cobranças.
Uso de tokens para verificação de habilidades
O Agent Registry mede as cobranças de verificação de vulnerabilidades de habilidades estritamente nos tokens de entrada do pacote de habilidades enviado, incluindo o arquivo de instruções SKILL.md, scripts de código e recursos de texto no arquivo ZIP.
Você não recebe cobranças por comandos do sistema de segurança interno, passagens de avaliação de vários modelos, tokens de raciocínio de modelo intermediário ou tokens de saída gerados pelo scanner de vulnerabilidades.
Exemplo de preço
Suponha que você faça upload de uma nova revisão de habilidade empacotada como um arquivo ZIP de 10 KB. Um pacote de habilidade típico entre 8 KB e 12 KB contém aproximadamente 2.000 a 3.000 tokens de entrada:
- Conteúdo de habilidade enviado por upload: 2.500 tokens de entrada (0,0025 milhão de tokens de entrada)
- Preço unitário (a partir de 1º de janeiro de 2027): US$ 8, 00 por 1 milhão de tokens de entrada
- Custo total da verificação de revisão: 0,0025 × US $8,00 = US $0,02
Pesquisas subsequentes, atualizações de metadados e downloads de tempo de execução dessa revisão de skill não geram cobranças no Agent Registry.
Gerenciar e desativar custos de verificação
Por padrão, as novas habilidades no Agent Registry definem scanningConfig.policy como ENABLED_BLOCKING. Se você quiser registrar habilidades ou enviar revisões de habilidades
sem incorrer em cobranças de verificação de vulnerabilidades, defina a política de verificação
de uma habilidade como DISABLED.
É possível configurar a política de verificação usando a Google Cloud CLI ou a API Agent Registry:
gcloud
Para criar uma habilidade com a verificação de vulnerabilidades desativada, inclua a flag --scanning-policy=disabled:
gcloud alpha agent-registry skills create SKILL_ID \
--project=PROJECT_ID \
--location=LOCATION \
--display-name="DISPLAY_NAME" \
--description="DESCRIPTION" \
--scanning-policy=disabled \
--payload="LOCAL_ZIP_PATH"
Para desativar a verificação de vulnerabilidades em uma skill antes de fazer upload de novas
revisões, execute o comando skills update com a flag
--scanning-policy=disabled:
gcloud alpha agent-registry skills update private-SKILL_ID \
--project=PROJECT_ID \
--location=LOCATION \
--scanning-policy=disabled
Substitua:
SKILL_ID: o ID da habilidade.PROJECT_ID: o ID do projeto Google Cloud .LOCATION: o local do registro, comoglobal.DISPLAY_NAME: um nome de exibição para a habilidade.DESCRIPTION: uma descrição da habilidade.LOCAL_ZIP_PATH: o caminho local para o arquivo ZIP da sua skill.
REST
Para desativar a verificação de vulnerabilidades em uma habilidade usando a API REST, defina
scanningConfig.policy como DISABLED no corpo da solicitação PATCH:
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{
"scanningConfig": {
"policy": "DISABLED"
}
}' \
"https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/private-SKILL_ID?updateMask=scanningConfig"
Substitua:
PROJECT_ID: o ID do projeto Google Cloud .LOCATION: o local do registro, comoglobal.SKILL_ID: o ID da habilidade.
Os valores permitidos para scanningConfig.policy são ENABLED_BLOCKING,
ENABLED_NONBLOCKING e DISABLED.
Custos de outros serviços do Google Cloud
O armazenamento e a descoberta de catálogos no Agent Registry estão incluídos sem custo financeiro, mas você pode incorrer em cobranças separadas ao usar outros serviços doGoogle Cloud com o Agent Registry:
- Cloud Storage: se você importar arquivos ZIP de habilidades de um bucket do Cloud Storage, os preços padrão do Cloud Storage serão aplicados aos objetos armazenados no bucket.
- Tempos de execução de agentes e ferramentas: a hospedagem e a execução de agentes ou servidores MCP em tempos de execução, como o tempo de execução de agentes na plataforma de agentes do Gemini Enterprise, o Cloud Run ou o Google Kubernetes Engine (GKE), geram cobranças padrão de computação e tempo de execução para esses serviços.
A seguir
- Receba ajuda com dúvidas sobre faturamento ou leia a documentação do Cloud Billing.
- Saiba como registrar habilidades e gerenciar revisões de habilidades.
- Consulte as cotas e limites do Agent Registry.