Instalar as bibliotecas de cliente da Vertex AI

As bibliotecas de cliente oferecem uma experiência de desenvolvedor otimizada para chamar a API Vertex AI. As bibliotecas de cliente usam as convenções naturais de cada linguagem compatível e reduzem o código de boilerplate que você precisa escrever. O guia a seguir explica como instalar as bibliotecas e configurar a autenticação para usá-las em um ambiente de desenvolvimento local.

Antes de começar

  1. Faça login na sua conta do Google Cloud . Se você começou a usar o Google Cloud, crie uma conta para avaliar o desempenho de nossos produtos em situações 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. 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

  4. 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

  5. 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

    6.

  6. Se você estiver usando um shell local, crie credenciais de autenticação local para sua conta de usuário: 

    gcloud auth application-default login

    Não é necessário fazer isso se você estiver usando o Cloud Shell.

    Se um erro de autenticação for retornado e você estiver usando um provedor de identidade (IdP) externo, confirme se você fez login na CLI gcloud com sua identidade federada.

Bibliotecas de cliente

A Vertex AI fornece bibliotecas de cliente nos idiomas a seguir. Selecione o idioma que você quer usar.

C#

Execute o seguinte comando para adicionar a referência do pacote Google.Cloud.AIPlatform.V1 ao arquivo de projeto:

dotnet add package Google.Cloud.AIPlatform.V1

Testar exemplos de código

Para conferir ou acessar exemplos de código individuais, acesse o repositório do GitHub dotnet-aiplatform.

Documentação da biblioteca de cliente

Para mais informações, consulte a documentação da biblioteca de cliente .NET da Vertex AI.

Java

Se você estiver usando o Gradle, adicione isto às dependências:

<dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>google-cloud-aiplatform</artifactId>
  <version>3.35.0</version>
</dependency>

Se você estiver usando o Gradle, adicione isto às dependências:

compile 'com.google.cloud:google-cloud-aiplatform:3.35.0'

Se você estiver usando o sbt, adicione o seguinte às suas dependências:

libraryDependencies += "com.google.cloud" % "google-cloud-aiplatform" % "3.35.0"

Testar exemplos de código

Para exibir ou acessar exemplos de código individuais, acesse o repositório GitHub java-aiplatform.

Documentação da biblioteca de cliente

Para mais informações, consulte a documentação do cliente da Vertex AI para Java (em inglês).

Node.js

Antes de instalar a biblioteca, prepare o ambiente para o desenvolvimento do Node.js.

Execute o seguinte comando no seu ambiente para instalar a biblioteca de cliente:

npm install @google-cloud/aiplatform

Documentação da biblioteca de cliente

Para mais informações, consulte a documentação do cliente Vertex AI para documentação do Node.js (em inglês).

Python

A biblioteca de cliente Python da Vertex AI é instalada quando você instala o SDK da Vertex AI para Python.

Para mais informações, consulte Instalar o SDK da Vertex AI para Python.

Go

Antes de instalar a biblioteca, prepare o ambiente para desenvolvimento em Go.

Analisar pacotes disponíveis

Analise os pacotes disponíveis da API Vertex AI em Go para determinar qual deles atende melhor às necessidades do seu projeto:

  • Pacote cloud.google.com/go/vertexai (recomendado)

    vertexai é um pacote criado por humanos que fornece acesso a recursos e capabilities comuns.

    Esse pacote é recomendado como ponto de partida para a maioria dos desenvolvedores que criam usando a API Vertex AI. Para acessar recursos e capabilities ainda não cobertos por esse pacote, use o aiplatform gerado automaticamente.

  • Pacote cloud.google.com/go/aiplatform

    aiplatform é um pacote gerado automaticamente.

    Esse pacote é destinado a projetos que exigem acesso a recursos e capabilities da API Vertex AI ainda não fornecidos pelo pacote vertexai criado por humanos.

Instalação

  • Pacote cloud.google.com/go/vertexai (recomendado)

    Execute o seguinte comando para instalar o pacote no seu ambiente:

    go get cloud.google.com/go/vertexai

  • Pacote cloud.google.com/go/aiplatform

    Execute o seguinte comando para instalar o pacote no seu ambiente:

    go get cloud.google.com/go/aiplatform

Amostras

Documentação da biblioteca de cliente

Para mais informações sobre a biblioteca, consulte a documentação da biblioteca de cliente da Vertex AI para Go: