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

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 agiliza o acesso às APIs do Google Cloud ao simplificar 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 do Google Cloud.

Inscrever-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: quem ainda não usa o Google Cloud pode 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 plano pago, adicione uma conta de faturamento.

    A Agent Platform no modo expresso é separada e não está disponível pelo Google Cloud Programa sem custos financeiros. 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 Agent Platform no modo expresso, abra Modo expresso no console Google Cloud :

Acessar o modo expresso

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

Aprenda Mais sobre a Agent Platform no modo expresso

Ao se inscrever 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 plataforma de agentes 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. Autentique as solicitações do seu aplicativo.
  • Nível sem custo financeiro para novos usuários do Google Cloud durante 90 dias. Durante o limite de 90 dias do nível sem custo financeiro para novos usuários do Google Cloud , você pode usar as APIs da plataforma de agentes que oferecem suporte ao modo expresso sem custo financeiro, até atingir 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 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 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 Agent Platform:

Item Modo expresso da Agent Platform no nível sem custo financeiro Agent Platform 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

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

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

Apenas 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 consoleGoogle Cloud no modo expresso. Para usar os modelos compatíveis da 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 plataforma de agentes 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 de comandos, clique em Criar com código > Receber código. Um painel é aberto mostrando o código que envia de maneira programática as mesmas solicitações que você implementou na UI. Você pode acessar 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 console Google Cloud no modo expresso, abra APIs e serviços > Credenciais:

    Ir para Credenciais

    Em seguida, copie a chave de API da API Generative Language no código onde está escrito "YOUR_API_KEY". Por exemplo:

    Python

    O SDK de IA generativa do Google para Python está disponível no PyPI e 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 Agent Platform 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 mais 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 no Google Cloud normalmente usam organizações e projetos para trabalhar com recursos (por exemplo, para chamar um endpoint de API). Ao usar a Agent Platform no modo expresso, não é preciso se preocupar com organizações ou projetos. No entanto, você pode encontrar menções a eles em algumas das documentações Google Cloud que você consulta ao usar a Agent Platform 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 selecionado ao se inscrever no modo expresso é usado em toda a sua experiência.

Ao chamar endpoints da API REST no modo express, use o formato de endpoint global para o modo express e faça a autenticação 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 Agent Platform 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 resolvem 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 a definição de 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 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 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 console do Google Cloud , acesse a página Chaves de API:

    Acesse as chaves de API

Ativar e gerenciar o faturamento

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

Depois de ativar o faturamento, você paga apenas pelo que usar. Você também pode 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.

Você pode começar a usar todos os recursos e serviços disponíveis no Google Cloud no seu projeto ao fazer 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. Por exemplo:

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