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 instalá-los.
Antes de começar
- Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, 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.
-
No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.
-
Ative a Vertex AI API.
-
Create a service account:
-
In the Google Cloud console, go to the Create service account page.
Go to Create service account - Select your project.
-
In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.
In the Service account description field, enter a description. For example,
Service account for quickstart
. - Click Create and continue.
-
Grant the Project > Owner role to the service account.
To grant the role, find the Select a role list, then select Project > Owner.
- Click Continue.
-
Click Done to finish creating the service account.
Do not close your browser window. You will use it in the next step.
-
-
Create a service account key:
- In the Google Cloud console, click the email address for the service account that you created.
- Click Keys.
- Click Add key, and then click Create new key.
- Click Create. A JSON key file is downloaded to your computer.
- Click Close.
-
Defina a variável de ambiente
GOOGLE_APPLICATION_CREDENTIALS
como o caminho do arquivo JSON que contém suas credenciais. Essa variável só se aplica à sessão de shell atual. Assim, se você abrir uma nova sessão, precisará definir a variável novamente. -
No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.
-
Ative a Vertex AI API.
-
Create a service account:
-
In the Google Cloud console, go to the Create service account page.
Go to Create service account - Select your project.
-
In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.
In the Service account description field, enter a description. For example,
Service account for quickstart
. - Click Create and continue.
-
Grant the Project > Owner role to the service account.
To grant the role, find the Select a role list, then select Project > Owner.
- Click Continue.
-
Click Done to finish creating the service account.
Do not close your browser window. You will use it in the next step.
-
-
Create a service account key:
- In the Google Cloud console, click the email address for the service account that you created.
- Click Keys.
- Click Add key, and then click Create new key.
- Click Create. A JSON key file is downloaded to your computer.
- Click Close.
-
Defina a variável de ambiente
GOOGLE_APPLICATION_CREDENTIALS
como o caminho do arquivo JSON que contém suas credenciais. Essa variável só se aplica à sessão de shell atual. Assim, se você abrir uma nova sessão, precisará definir a variável novamente.
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 amostras de
Para conferir ou acessar exemplos de código individuais, acesse o repositório dotnet-aiplatform do GitHub.
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 amostras de
Para ver ou ver amostras de código individuais, acesse o repositório java-aiplatform no GitHub.
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
Pacote cloud.google.com/go/vertexai (recomendado)
Exemplos de uso desse pacote estão disponíveis no repositório
golang-samples
do GitHub do diretório de nível superiorvertexai
:Pacote cloud.google.com/go/aiplatform
Exemplos de uso desse pacote estão disponíveis no repositório
golang-samples
do GitHub do diretório de nível superioraiplatform
:
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:
Pacote cloud.google.com/go/vertexai (recomendado)
- Referência da API Vertex AI
cloud.google.com/go/vertexai
- Referência da API Vertex AI
Pacote cloud.google.com/go/aiplatform
- Referência da API Vertex AI v1
cloud.google.com/go/aiplatform
- Referência da API Vertex AI v1beta1
cloud.google.com/go/aiplatform
- Referência da API Vertex AI v1