Guia de início rápido: enviar comandos de texto para o Gemini usando o Vertex AI Studio

Use o Vertex AI Studio para criar, testar e gerenciar comandos para os Gemini modelos de linguagem grandes (LLMs) do Google e modelos de terceiros. O Vertex AI Studio oferece suporte a determinados modelos de terceiros oferecidos na Vertex AI como modelos como serviço (MaaS), como os modelos do Anthropic Claude e do Llama da Meta.

Neste guia de início rápido, você fará as seguintes tarefas:

  • Enviar esses comandos para a API Gemini usando exemplos da galeria de comandos de IA generativa, incluindo o seguinte:
    • Um comando de texto de resumo
    • Um comando de geração de código
  • Ver o código usado para gerar as respostas

Antes de começar a fazer perguntas no Vertex AI Studio

Este guia de início rápido exige que você conclua as etapas a seguir para configurar um Google Cloud projeto e ativar a API Vertex AI.

Para conseguir as permissões necessárias para concluir as tarefas neste guia de início rápido, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

  1. Faça login na sua Google Cloud conta do. Se você não conhece o Google Cloud, crie uma conta para avaliar o desempenho dos nossos produtos em cenários reais. Clientes novos também recebem US $300 em créditos para executar, testar e implantar cargas de trabalho.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Vertex AI API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Vertex AI API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

Exemplos de comandos no Vertex AI Studio

Um comando é um pedido em linguagem natural enviado a um modelo de linguagem que gera uma resposta. Os comandos podem conter perguntas, instruções, informações contextuais, exemplos few-shot, e entrada parcial para que o modelo conclua. Depois que o modelo recebe um comando, dependendo do tipo de modelo usado, ele pode gerar texto, embeddings, código, imagens, vídeos, músicas e mais.

Os exemplos de comandos na galeria de comandos do Vertex AI Studio são pré-criados para ajudar a demonstrar os recursos do modelo. Cada comando é pré-configurado com um modelo e valores de parâmetro especificados. Dessa maneira, basta abrir o comando de amostra e clicar em Enviar para gerar uma resposta.

Testar o modelo Gemini flash usando um comando de texto de resumo

Envie um comando de texto de resumo para a API Gemini na Vertex AI. Uma tarefa de resumo extrai as informações mais importantes do texto. Você pode fornecer informações no comando para ajudar o modelo a criar um resumo ou pedir que ele crie um resumo por conta própria.

  1. Acesse a página Galeria de comandos na seção "Vertex AI" noconsole. Google Cloud
    Acessar a galeria de comandos

  2. No menu suspenso Tarefas, selecione Resumir.

  3. Abra o card Resumo de áudio.

    Esse exemplo de comando inclui um arquivo de áudio e solicita um resumo do conteúdo do arquivo em uma lista com marcadores.

    O texto do comando de resumo de áudio e o arquivo de áudio

  4. No painel de configurações, o valor padrão do modelo está definido como Gemini-2.0-flash-001. Você pode escolher um modelo diferente do Gemini clicando em Mudar modelo.

    O modelo do Gemini no painel de configurações

  5. Clique em Enviar para gerar o resumo.

    O botão "Enviar" na caixa de comando

    A saída é exibida na resposta.

  6. Para conferir o código da API Vertex AI usado para gerar o resumo da transcrição, clique em Criar com código > Receber código.

    No painel Receber código , você pode escolher o idioma preferido para receber o exemplo de código do comando ou abrir o código Python em um notebook do Colab Enterprise.

Testar o modelo Gemini flash usando um comando de geração de código

Envie um comando de geração de código para a API Gemini na Vertex AI. Uma tarefa de geração de código usa uma descrição de linguagem natural para escrever código.

  1. Acesse a página Galeria de comandos na seção "Vertex AI" noconsole. Google Cloud
    Acessar a galeria de comandos

  2. No menu suspenso Tarefas, selecione Código.

  3. Abra o card Gerar código de comentários.

    Esse exemplo de comando inclui uma instrução do sistema que informa ao modelo como responder e alguns métodos Java incompletos.

    O texto do comando de geração de código

  4. No painel de configurações, o valor padrão do modelo está definido como Gemini-2.0-flash-001. Você pode escolher um modelo diferente do Gemini clicando em Mudar modelo.

    O modelo do Gemini no painel de configurações

  5. Para concluir cada método gerando código nas áreas marcadas como <WRITE CODE HERE>, clique em Enviar .

    A saída é exibida na resposta.

  6. Para conferir o código da API Vertex AI usado para gerar o resumo da transcrição, clique em Criar com código > Receber código.

    No painel Receber código , você pode escolher o idioma preferido para receber o exemplo de código do comando ou abrir o código Python em um notebook do Colab Enterprise.

Descubra o que vem a seguir com os comandos