Instale as bibliotecas cliente da Vertex AI

As bibliotecas cliente oferecem uma experiência de programador otimizada para chamar a API Vertex AI. As bibliotecas cliente usam as convenções naturais de cada linguagem suportada e reduzem o código repetitivo que tem de escrever. O seguinte guia explica como instalar as bibliotecas e configurar a autenticação para as usar num 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.

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

  7. Bibliotecas cliente

    O Vertex AI fornece bibliotecas cliente para os seguintes idiomas. Selecione o idioma que quer usar.

    C#

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

    dotnet add package Google.Cloud.AIPlatform.V1
    

    Experimente exemplos de código

    Para ver ou obter exemplos de código individuais, aceda ao repositório do GitHub dotnet-aiplatform.

    Documentação da biblioteca cliente

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

    Java

    Se estiver a usar o Maven, adicione o seguinte às suas dependências:

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

    Se estiver a usar o Gradle, adicione o seguinte às suas dependências:

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

    Se estiver a usar o sbt, adicione o seguinte às suas dependências:

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

    Experimente exemplos de código

    Para ver ou obter exemplos de código individuais, aceda ao repositório do GitHub java-aiplatform.

    Documentação da biblioteca cliente

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

    Node.js

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

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

    npm install @google-cloud/aiplatform
    

    Documentação da biblioteca cliente

    Para mais informações, consulte a documentação da biblioteca cliente da Vertex AI para Node.js.

    Python

    A biblioteca cliente Python do Vertex AI é instalada quando instala o SDK Vertex AI para Python.

    Para mais informações, consulte o artigo Instale o SDK Vertex AI para Python.

    Go

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

    Reveja os pacotes disponíveis

    Reveja os pacotes Go da API Vertex AI disponíveis para determinar que pacote satisfaz melhor as necessidades do seu projeto:

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

      vertexai é um pacote criado por humanos que oferece acesso a capacidades e funcionalidades comuns.

      Este pacote é recomendado como ponto de partida para a maioria dos programadores que criam com a API Vertex AI. Para aceder a capacidades e funcionalidades ainda não abrangidas por este pacote, use o aiplatform gerado automaticamente.

    • Package cloud.google.com/go/aiplatform

      aiplatform é um pacote gerado automaticamente.

      Este pacote destina-se a projetos que requerem acesso às capacidades e funcionalidades da API Vertex AI ainda não disponibilizadas pelo pacote vertexai criado por humanos.

    Instalação

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

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

      go get cloud.google.com/go/vertexai
      
    • Package cloud.google.com/go/aiplatform

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

      go get cloud.google.com/go/aiplatform
      

    Amostras

    Documentação da biblioteca cliente

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