Menginstal library klien Vertex AI

Library klien memberikan pengalaman developer yang dioptimalkan untuk memanggil Vertex AI API. Library klien menggunakan konvensi alami setiap bahasa yang didukung dan mengurangi kode boilerplate yang harus Anda tulis. Panduan berikut menjelaskan cara menginstal library dan menyiapkan autentikasi untuk menggunakannya di lingkungan pengembangan lokal.

Sebelum memulai

  1. Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

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

  6. Jika Anda menggunakan shell lokal, buat kredensial autentikasi lokal untuk akun pengguna Anda: 

    gcloud auth application-default login

    Anda tidak perlu melakukan langkah ini jika menggunakan Cloud Shell.

    Jika error autentikasi ditampilkan, dan Anda menggunakan penyedia identitas (IdP) eksternal, konfirmasi bahwa Anda telah login ke gcloud CLI dengan identitas gabungan Anda.

Library klien

Vertex AI menyediakan library klien untuk bahasa berikut. Pilih bahasa yang ingin digunakan.

C#

Jalankan perintah berikut untuk menambahkan referensi paket Google.Cloud.AIPlatform.V1 ke file project Anda:

dotnet add package Google.Cloud.AIPlatform.V1

Mencoba contoh kode

Untuk melihat atau mendapatkan contoh kode individu, buka repositori GitHub dotnet-aiplatform.

Dokumentasi library klien

Untuk mengetahui informasi selengkapnya, lihat dokumentasi library klien .NET Vertex AI.

Java

Jika Anda menggunakan Maven, tambahkan kode berikut ke dependensi Anda:

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

Jika menggunakan Gradle, tambahkan kode berikut ke dependensi Anda:

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

Jika Anda menggunakan sbt, tambahkan kode berikut ke dependensi Anda:

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

Mencoba contoh kode

Untuk melihat atau mendapatkan contoh kode individu, buka repositori GitHub java-aiplatform.

Dokumentasi library klien

Untuk informasi selengkapnya, lihat dokumentasi library klien Vertex AI untuk Java.

Node.js

Sebelum menginstal library, siapkan lingkungan Anda untuk pengembangan Node.js.

Jalankan perintah berikut di lingkungan Anda untuk menginstal library klien:

npm install @google-cloud/aiplatform

Dokumentasi library klien

Untuk informasi selengkapnya, lihat dokumentasi library klien Vertex AI untuk Node.js.

Python

Library klien Python Vertex AI diinstal saat Anda menginstal Vertex AI SDK untuk Python.

Untuk mengetahui informasi selengkapnya, lihat Menginstal Vertex AI SDK untuk Python.

Go

Sebelum menginstal library, siapkan lingkungan Anda untuk pengembangan Go.

Meninjau paket yang tersedia

Tinjau paket Go Vertex AI API yang tersedia untuk menentukan paket mana yang paling sesuai dengan kebutuhan project Anda:

  • Paket cloud.google.com/go/vertexai (direkomendasikan)

    vertexai adalah paket yang dibuat oleh manusia yang menyediakan akses ke kemampuan dan fitur umum.

    Paket ini direkomendasikan sebagai titik awal bagi sebagian besar developer yang membangun dengan Vertex AI API. Untuk mengakses kemampuan dan fitur yang belum tercakup dalam paket ini, gunakan aiplatform yang dibuat otomatis.

  • Paket cloud.google.com/go/aiplatform

    aiplatform adalah paket yang dibuat otomatis.

    Paket ini ditujukan untuk project yang memerlukan akses ke kemampuan dan fitur Vertex AI API yang belum disediakan oleh paket vertexai yang ditulis manusia.

Penginstalan

  • Paket cloud.google.com/go/vertexai (direkomendasikan)

    Jalankan perintah berikut untuk menginstal paket ini di lingkungan Anda:

    go get cloud.google.com/go/vertexai

  • Paket cloud.google.com/go/aiplatform

    Jalankan perintah berikut untuk menginstal paket ini di lingkungan Anda:

    go get cloud.google.com/go/aiplatform

Sampel

Dokumentasi library klien

Untuk mengetahui informasi selengkapnya tentang library ini, lihat dokumentasi library klien Vertex AI untuk Go: