Visão geral do modo expresso da Gemini Enterprise Agent Platform

Visualizar

Este recurso está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Com a plataforma de agentes do Gemini Enterprise no modo expresso, você pode se inscrever e começar a criar aplicativos de IA generativa no Google Cloud. Essa experiência de configuração simplificada agiliza o acesso às Google Cloud APIs, simplificando a organização, o faturamento e o gerenciamento de projetos.

Para saber mais sobre a plataforma de agentes no modo expresso, consulte as Perguntas frequentes sobre o modo expresso do Google Cloud.

Inscrever-se no modo expresso

A plataforma de agentes está disponível no modo expresso para desenvolvedores com uma @gmail.com Conta do Google:

• Novos usuários: os novos usuários Google Cloud podem se inscrever em uma conta do modo expresso em um nível sem custo financeiro para testar a plataforma de agentes sem custo financeiro por até 90 dias, dentro das cotas especificadas. Não é necessário fornecer informações de faturamento para se inscrever no nível sem custo financeiro. Você pode fazer upgrade para um nível pago adicionando uma conta de faturamento.

  A plataforma de agentes no modo expresso é separada do Programa sem custo financeiro e não está disponível por ele, Google Cloud sem custo financeiro. Se você estiver no Google Cloud Programa sem custo financeiro, consulte os outros guias de início rápido na seção Como começar.

Para se inscrever na plataforma de agentes no modo expresso, abra o Modo expresso no Google Cloud console:

Acesse o modo expresso

Depois de configurar, você pode começar a usar a plataforma de agentes no modo expresso seguindo um dos tutoriais:

• Tutorial: Agent Studio no modo expresso
• Tutorial: API Agent Platform no modo expresso

Saiba mais sobre a plataforma de agentes no modo expresso

Ao se inscrever no modo expresso, Google Cloud ativa as APIs em seu nome. Esse processo acontece em segundo plano, então você pode começar a usar a plataforma de agentes sem precisar configurar recursos manualmente.

Ao se inscrever no modo expresso, você tem acesso ao seguinte:

• Recursos principais do Agent Studio. Teste e personalize comandos para diferentes modelos de IA generativa e receba o código correspondente para usar no seu aplicativo.
• Uma chave de API. Autentique solicitações do seu aplicativo.
• Nível sem custo financeiro para novos Google Cloud usuários durante 90 dias. Durante o limite de 90 dias do nível sem custo financeiro para novos Google Cloud usuários, você pode usar as APIs da plataforma de agentes que oferecem suporte ao modo expresso sem custo financeiro, até as cotas. Não é necessário fornecer informações de faturamento. Você pode aumentar os limites da cota a qualquer momento. É só ativar o faturamento.

Se você já é um usuário Google Cloud ou depois de ativar o faturamento, o nível sem custo financeiro de 90 dias será removido. Você faz a transição para um nível pago para acessar limites de cota estendidos e outros recursos Google Cloud . À medida que suas cotas aumentam, você só paga pelo que usa. A qualquer momento, você pode encerrar o modo expresso e começar a usar todos os Google Cloud serviços e recursos.

A tabela a seguir lista as diferenças entre as experiências do modo expresso e a experiência completa da plataforma de agentes:

Item	Modo expresso da plataforma de agentes no nível sem custo financeiro	Plataforma de agentes completa
Limite de tempo	90 dias	Ilimitado
Serviços disponíveis	Serviços básicos de IA generativa.	Todos os Google Cloud serviços, incluindo a plataforma de agentes.
Fontes de dados	Google Drive	Todas as fontes de dados disponíveis no Google Cloud.
Quota	Limites do nível sem custo financeiro. Consulte Modelos disponíveis e limites de taxa no modo expresso.	Limites padrão de pagamento por uso. Consulte Limites de taxa.
Formato padrão de endpoints de API	Use o endpoint global sem um ID do projeto ou local e transmita sua chave de API no cabeçalho HTTP x-goog-api-key (ou no parâmetro de consulta key). Por exemplo: https://aiplatform.googleapis.com/v1/publishers/google/models/MODEL_ID:streamGenerateContent	Especifique um ID do projeto e um local. Exemplo: https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:streamGenerateContent

Modelos disponíveis e limites de taxa no modo expresso

Você pode testar vários modelos no modo expresso, incluindo os modelos Gemini Flash. A tabela a seguir lista os modelos disponíveis no modo expresso, juntamente com os limites de taxa:

Categoria do modelo	Modelos disponíveis	Solicitações máximas por minuto
Gemini	gemini-3-pro-image	Dinâmica
	gemini-3.1-flash-image	Dinâmica
	gemini-3.1-pro-preview	Dinâmica
	gemini-3-flash-preview	Dinâmica
	gemini-2.5-pro	10
	gemini-2.5-flash-image	10
	gemini-2.5-flash	10
	gemini-2.5-flash-lite	10

Somente os modelos listados na tabela anterior têm suporte no modo expresso. Os modelos dedicados da API Gemini Live, como Gemini 3.8 Live (gemini-3.8-live) e áudio nativo da API Gemini 2.5 Flash Live (gemini-live-2.5-flash-native-audio), não têm suporte no modo expresso, e a API Gemini Live não está disponível no Google Cloud console no modo expresso. Para usar os modelos da API Gemini Live com suporte, faça upgrade do modo expresso para uma conta padrão Google Cloud.

Fluxo de trabalho da plataforma de agentes no modo expresso

Você pode começar a enviar solicitações do seu aplicativo para as APIs da plataforma de agentes em três etapas:

1. Depois de se inscrever no modo expresso, use o Agent Studio para testar os recursos da plataforma de agentes:

   Acessar o Agent Studio

   Por exemplo, selecione Agent Studio > Create prompt para criar e otimizar comandos multimodais usando vários modelos do Gemini.

2. Receba o código do que você implementou com a UI.

   Na página de comandos, clique em Criar com código > Receber código. Um painel é aberto mostrando o código que envia programaticamente as mesmas solicitações implementadas na UI. Você pode receber o código de uma linguagem de programação ou curl. Você pode usar o Google Colab para testar o código Python.

3. Use sua chave de API para autenticar com a API Agent Platform.

   No Google Cloud console no modo expresso, abra APIs e serviços > Credenciais:

   Ir para Credenciais

   Em seguida, copie a chave de API Generative Language para o código em que diz "YOUR_API_KEY". Exemplo:

   Python

   O SDK de IA generativa do Google para Python está disponível no PyPI e no GitHub:

   • google-genai no PyPI
   • python-genai no GitHub

   Para saber mais, consulte a referência do SDK para Python (abre em uma nova guia).

   from google import genai
   
   # TODO(developer): Update below line
   API_KEY = "YOUR_API_KEY"
   
   client = genai.Client(vertexai=True, api_key=API_KEY)
   
   response = client.models.generate_content(
       model="gemini-3.5-flash",
       contents="Explain bubble sort to me.",
   )
   
   print(response.text)
   # Example response:
   # Bubble Sort is a simple sorting algorithm that repeatedly steps through the list

O que há de diferente no modo expresso

A plataforma de agentes no modo expresso oferece um subconjunto dos recursos de IA generativa. Portanto, parte da documentação da plataforma de agentes não é relevante se você se inscreveu no modo expresso. Para detalhes sobre os endpoints de API disponíveis no modo expresso, consulte a referência da API REST da Agent Platform no modo expresso.

Além disso, os clientes Google Cloud costumam usar organizações e projetos para trabalhar com recursos (por exemplo, para chamar um endpoint de API). Ao usar a plataforma de agentes no modo expresso, não é necessário se preocupar com organizações ou projetos. No entanto, eles podem ser mencionados em parte da Google Cloud documentação que você referencia ao usar a plataforma de agentes no modo expresso. Você ainda pode usar a documentação, mas ignore conceitos e instruções que se referem a organizações e projetos. Além disso, o local que você selecionou ao se inscrever no modo expresso é usado em toda a experiência.

Ao chamar endpoints de API REST no modo expresso, use o formato de endpoint global para o modo expresso e autentique com sua chave de API:

URL do endpoint padrão	https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:streamGenerateContent
URL do endpoint no modo expresso	https://aiplatform.googleapis.com/v1/publishers/google/models/MODEL_ID:streamGenerateContent

Considere os seguintes detalhes de endpoint e autenticação ao enviar solicitações REST no modo expresso:

• Caminho do modelo do editor ({model}): na referência da API REST da plataforma de agentes no modo expresso, modelos de endpoint como https://aiplatform.googleapis.com/v1/{model}:streamGenerateContent e https://aiplatform.googleapis.com/v1beta1/{model}:streamGenerateContent usam {model} para representar o caminho completo do recurso do modelo do editor (publishers/google/models/MODEL_ID). Os dois são resolvidos para o mesmo URL do endpoint.
• Cabeçalho de autenticação da chave de API: não é necessário transmitir a chave de API como um parâmetro de consulta. Transmita a chave de API no cabeçalho HTTP x-goog-api-key (por exemplo, -H "x-goog-api-key: API_KEY"). Se o ambiente do cliente não permitir que você defina cabeçalhos HTTP, transmita o parâmetro de consulta do sistema key em vez disso (?key=API_KEY). Para mais informações, consulte Usar chaves de API.

Ver e gerenciar chaves de API

Para autenticar com endpoints da API Agent Platform que oferecem suporte ao modo expresso, use a chave de API criada para você durante a inscrição ou qualquer chave criada no modo expresso. Uma chave de API é uma string criptografada gerada automaticamente para você quando você se inscreve no modo expresso. Essas chaves de API podem ser visualizadas e gerenciadas na página APIs e serviços.

Para saber mais sobre as práticas recomendadas para gerenciar chaves de API, consulte Práticas recomendadas para gerenciar chaves de API.

Para visualizar e gerenciar suas chaves de API, faça o seguinte:

1. No Google Cloud console, acesse a página Chaves de API:

   Acessar chaves de API

Ativar e gerenciar o faturamento

Você pode aumentar suas cotas e remover o limite de 90 dias ativando o faturamento.

Depois de ativar o faturamento, você só paga pelo que usa. Você também pode salvar seus comandos e usar outras configurações no Google Cloud console que ficam esmaecidas quando o faturamento não está ativado.

Para gerenciar o faturamento, faça o seguinte:

1. Acesse a página de visão geral do Agent Studio no modo expresso.

   Acessar o Agent Studio

2. No Google Cloud console no modo expresso, abra Faturamento:

   Acessar o Faturamento

3. Gerencie suas contas de faturamento.

Começar a usar todos os Google Cloud recursos e serviços

O modo expresso foi projetado para ajudar você a começar. Quando estiver tudo pronto para usar outros Google Cloud serviços ou precisar de mais controle sobre o ambiente, você poderá fazer a transição da conta do modo expresso para uma conta padrão Google Cloud Esse processo às vezes é chamado de upgrade.

Você pode começar a usar todos os recursos e serviços disponíveis no Google Cloud seu projeto fazendo upgrade da conta do modo expresso.

Para fazer upgrade do modo expresso, faça o seguinte:

1. Acesse a página de visão geral do Agent Studio no modo expresso.

   Acessar o Agent Studio

2. Clique em Ativar agora e siga as instruções.

Depois de fazer upgrade do modo expresso, especifique o ID do projeto e o local em vez da chave de API ao chamar os endpoints de API REST. Exemplo:

https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:streamGenerateContent