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 modelos de linguagem grandes (LLMs) Gemini do Google e modelos de terceiros. O Vertex AI Studio é compatível com alguns modelos de terceiros oferecidos na Vertex AI como modelos como um serviço (MaaS), como os modelos Claude da Anthropic e Llama da Meta.

Neste guia de início rápido, você vai aprender a usar exemplos de comandos da galeria de comandos de IA generativa para realizar as seguintes tarefas:

  • Envie um comando de texto de resumo para a API Gemini.
  • Envie um comando de geração de código para a API Gemini.
  • Confira o código usado para gerar as respostas.

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

Neste guia de início rápido, você precisa concluir as etapas a seguir para configurar um projeto doGoogle Cloud e ativar a API Vertex AI.

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Vertex AI API.

    Enable the API

  5. Make sure that you have the following role or roles on the project: Vertex AI User

    Check for the roles

    1. In the Google Cloud console, go to the IAM page.

      Go to IAM
    2. Select the project.
    3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

    4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

    Grant the roles

    1. In the Google Cloud console, go to the IAM page.

      Acessar o IAM
    2. Selecionar um projeto.
    3. Clique em CONCEDER ACESSO.
    4. No campo Novos principais, insira seu identificador de usuário. Normalmente, é o endereço de e-mail de uma Conta do Google.

    5. Na lista Selecionar um papel, escolha um.
    6. Para conceder outros papéis, clique em Adicionar outro papel e adicione cada papel adicional.
    7. Clique em Salvar.
  6. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  7. Make sure that billing is enabled for your Google Cloud project.

  8. Enable the Vertex AI API.

    Enable the API

  9. Make sure that you have the following role or roles on the project: Vertex AI User

    Check for the roles

    1. In the Google Cloud console, go to the IAM page.

      Go to IAM
    2. Select the project.
    3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

    4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

    Grant the roles

    1. In the Google Cloud console, go to the IAM page.

      Acessar o IAM
    2. Selecionar um projeto.
    3. Clique em CONCEDER ACESSO.
    4. No campo Novos principais, insira seu identificador de usuário. Normalmente, é o endereço de e-mail de uma Conta do Google.

    5. Na lista Selecionar um papel, escolha um.
    6. Para conceder outros papéis, clique em Adicionar outro papel e adicione cada papel adicional.
    7. Clique em Salvar.
  10. Exemplos de comandos no Vertex AI Studio

    Um comando é um pedido em linguagem natural enviado a um modelo de linguagem para gerar uma resposta. Os comandos podem conter perguntas, instruções, informações contextuais, exemplos few-shot e entrada parcial para que o modelo conclua. Por exemplo, um comando pode ser: "Summarize the following article:" seguido pelo texto do artigo.

    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 comandos de amostra 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 modelos do Gemini no Vertex AI Studio

    Você pode testar diferentes recursos dos modelos usando comandos de amostra pré-criados da galeria de comandos. Os exemplos a seguir demonstram como usar comandos para resumo e geração de código.

    Comando de texto para resumo

    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. É possível 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" no Google Cloud console.
      Acessar a galeria de comandos

    2. No menu suspenso Tarefas, selecione Resumir.

    3. Abra o card Resumo em áudio.

      Este comando de exemplo inclui um arquivo de áudio e pede 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. Para escolher outro modelo do Gemini, clique 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 "Comando"

      A saída é mostrada 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, escolha seu idioma preferido para receber o código de amostra do comando ou abra o código Python em um notebook do Colab Enterprise.

    Comando de geração de código

    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" no Google Cloud console.
      Acessar a galeria de comandos

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

    3. Abra o card Gerar código com base em comentários.

      Este 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. Para escolher outro modelo do Gemini, clique em Mudar modelo.

      O modelo do Gemini no painel de configurações

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

      A saída é mostrada 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, escolha seu idioma preferido para receber o código de amostra do comando ou abra o código Python em um notebook do Colab Enterprise.

    Descobrir o que vem por aí com os comandos