Instalar as bibliotecas de cliente da plataforma de agentes do Gemini Enterprise

As bibliotecas de cliente oferecem uma experiência de desenvolvedor otimizada para chamar a API da plataforma de agentes. As bibliotecas de cliente usam as convenções naturais de cada linguagem compatível e reduzem o código 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 Google Cloud conta do. Se você começou a usar o Google Cloud, crie uma conta para avaliar o desempenho dos 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 Agent Platform 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 Agent Platform 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 plataforma de agentes oferece bibliotecas de cliente para as seguintes linguagens. 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 plataforma de agentes.

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 da biblioteca de cliente da plataforma de agentes para Java.

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 da biblioteca de cliente da plataforma de agentes para Node.js.

Python

A biblioteca de cliente Python da plataforma de agentes do Gemini Enterprise é instalada quando você instala o SDK da plataforma de agentes para Python.

Para mais informações, consulte Instalar o SDK da plataforma de agentes 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 da plataforma de agentes 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 da plataforma de agentes. 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 da plataforma de agentes 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 plataforma de agentes para Go: