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

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

    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. If you're using a local shell, then create local authentication credentials for your user account: 

    gcloud auth application-default login

    You don't need to do this if you're using Cloud Shell.

    If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

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: