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 Gemini Enterprise Agent Platform 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 facilita o acesso às APIs do Google Cloud , simplificando a organização, o faturamento e o gerenciamento de projetos.

Para saber mais sobre a Agent Platform no modo expresso, consulte as perguntas frequentes sobre o modo expresso daGoogle Cloud.

Inscreva-se no modo expresso

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

• Novos usuários: novos usuários do 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. Para fazer upgrade para um nível pago, adicione uma conta de faturamento.

  A Agent Platform no modo expresso é separada e não está disponível no Programa sem custos financeiros do Google Cloud . Se você estiver no Google Cloud Programa sem custo financeiro, consulte os outros guias de início rápido na seção Primeiros passos.

Para se inscrever na Agent Platform no modo expresso, abra o Modo expresso no console do Google Cloud :

Acesse o modo expresso

Depois de concluir a configuração, comece a usar a Agent Platform no modo expresso seguindo um dos tutoriais:

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

Aprenda Mais sobre a Agent Platform no modo expresso

Quando você se inscreve no modo expresso, o Google Cloud ativa as APIs em seu nome. Esse processo acontece em segundo plano, então você pode começar a usar a Agent Platform sem precisar configurar recursos manualmente.

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

• Principais recursos 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. Autenticar solicitações do seu aplicativo.
• Nível sem custo financeiro para novos usuários do Google Cloud por 90 dias. Durante o limite de 90 dias do nível sem custo financeiro para novos usuários do Google Cloud , é possível 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á for um usuário do 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 do Google Cloud . À medida que suas cotas aumentam, você só paga pelo que usar. A qualquer momento, você pode encerrar o modo expresso e começar a usar todos os serviços e recursos do Google Cloud .

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 Agent Platform 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 serviços do Google Cloud , incluindo a Agent Platform.
Fontes de dados	Google Drive	Todas as fontes de dados disponíveis em Google Cloud.
Cota	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. Por 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

É possível testar vários modelos no modo expresso, incluindo os modelos do Gemini Flash. A tabela a seguir lista os modelos disponíveis no modo expresso, além dos limites de taxa:

Categoria do modelo	Modelos disponíveis	Máximo de solicitações 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 são compatíveis com o 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 são compatíveis com o modo expresso, e a API Gemini Live não está disponível no console doGoogle Cloud no modo expresso. Para usar os modelos compatíveis com a API Gemini Live, faça upgrade do modo expresso para uma conta padrão do Google Cloud.

Fluxo de trabalho da Agent Platform no modo expresso

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

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

   Acessar o Agent Studio

   Por exemplo, selecione Agent Studio > Criar comando 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 do comando, clique em Criar com código > Receber código. Um painel é aberto mostrando o código que envia de forma programática as mesmas solicitações que você implementou na UI. É possível acessar o código de uma linguagem de programação ou curl. Use o Google Colab para testar o código Python.

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

   No console do Google Cloud 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 onde está escrito "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 muda no modo expresso

A Plataforma de Agentes no modo expresso oferece um subconjunto dos recursos para IA generativa. Portanto, parte da documentação da Agent Platform 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 plataforma de agentes no modo expresso.

Além disso, os clientes do 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, você não precisa se preocupar com organizações ou projetos. No entanto, eles podem ser mencionados em parte da documentação do Google Cloud que você consulta ao usar a Plataforma de Agentes no modo expresso. Ainda é possível 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 sua experiência.

Ao chamar endpoints da 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

Lembre-se dos 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, os 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). Ambos são resolvidos para o mesmo URL de 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 sua 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 (?key=API_KEY). Para mais informações, consulte Usar chaves de API.

Ver e gerenciar chaves de API

Para autenticar com endpoints de API do Agent Platform que oferecem suporte ao modo expresso, use a chave de API que foi criada para você durante a inscrição ou qualquer chave que você tenha criado 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 as chaves de API, faça o seguinte:

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

   Acesse as chaves de API

Ativar e gerenciar o faturamento

Para aumentar suas cotas e remover o limite de 90 dias, ative o faturamento.

Depois de ativar o faturamento, você paga apenas pelo que usa. Também é possível salvar seus comandos e usar outras configurações no console do Google Cloud 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 console do Google Cloud no modo expresso, abra Faturamento:

   Acessar "Faturamento"

3. Gerencie suas contas de faturamento.

Comece a usar todos os recursos e serviços do Google Cloud

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

Para começar a usar todos os recursos e serviços disponíveis no Google Cloud no seu projeto, faça upgrade da sua 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