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.
-
Crie uma conta de serviço:
-
No Console do Google Cloud, acesse a página Criar conta de serviço.
Acesse "Criar conta de serviço" - Selecione o projeto.
-
No campo Nome da conta de serviço, insira um nome. O Console do Google Cloud preenche o campo ID da conta de serviço com base nesse nome.
No campo Descrição da conta de serviço, insira uma descrição. Por exemplo,
Service account for quickstart
. - Clique em Criar e continuar.
-
Conceda o papel Project > Owner à conta de serviço do.
Para conceder o papel, encontre a lista Selecionar um papel e clique em Project > Owner.
- Clique em Continuar.
-
Clique em Concluído para terminar a criação da conta de serviço.
Não feche a janela do navegador. Você vai usá-la na próxima etapa.
-
-
Crie uma chave de conta de serviço:
- No console do Google Cloud, clique no endereço de e-mail da conta de serviço que você criou.
- Clique em Chaves.
- Clique em Adicionar chave e em Criar nova chave.
- Clique em Criar. O download de um arquivo de chave JSON é feito no seu computador.
- Clique em Fechar.
-
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.
-
Crie uma conta de serviço:
-
No Console do Google Cloud, acesse a página Criar conta de serviço.
Acesse "Criar conta de serviço" - Selecione o projeto.
-
No campo Nome da conta de serviço, insira um nome. O Console do Google Cloud preenche o campo ID da conta de serviço com base nesse nome.
No campo Descrição da conta de serviço, insira uma descrição. Por exemplo,
Service account for quickstart
. - Clique em Criar e continuar.
-
Conceda o papel Project > Owner à conta de serviço do.
Para conceder o papel, encontre a lista Selecionar um papel e clique em Project > Owner.
- Clique em Continuar.
-
Clique em Concluído para terminar a criação da conta de serviço.
Não feche a janela do navegador. Você vai usá-la na próxima etapa.
-
-
Crie uma chave de conta de serviço:
- No console do Google Cloud, clique no endereço de e-mail da conta de serviço que você criou.
- Clique em Chaves.
- Clique em Adicionar chave e em Criar nova chave.
- Clique em Criar. O download de um arquivo de chave JSON é feito no seu computador.
- Clique em Fechar.
-
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