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

Sebelum memulai

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. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

3. Aktifkan Vertex AI API.

   Mengaktifkan API

4. Buat akun layanan:

   1. Di konsol Google Cloud, buka halaman Buat akun layanan.

      Buka Create service account
   2. Pilih project Anda.

   3. Di kolom Nama akun layanan, masukkan nama. Konsol Google Cloud akan mengisi kolom ID akun layanan berdasarkan nama ini.

      Di kolom Deskripsi akun layanan, masukkan sebuah deskripsi. Sebagai contoh, Service account for quickstart.

   4. Klik Buat dan lanjutkan.

   5. Berikan peran Project > Owner ke akun layanan.

      Untuk memberikan peran, temukan daftar Pilih peran, lalu pilih Project > Owner.

      Catatan: Kolom Peran memengaruhi resource mana yang dapat diakses oleh akun layanan di project Anda. Anda dapat mencabut peran ini atau memberikan peran tambahan di lain waktu. Dalam lingkungan produksi, jangan berikan peran Owner, Editor, atau Viewer. Sebagai gantinya, berikan peran standar atau peran khusus yang memenuhi kebutuhan Anda.
   6. Klik Lanjutkan.

   7. Klik Selesai untuk menyelesaikan pembuatan akun layanan.

      Jangan tutup jendela browser Anda. Anda akan menggunakannya pada langkah berikutnya.

5. Membuat kunci akun layanan:

   1. Di konsol Google Cloud, klik alamat email untuk akun layanan yang telah dibuat.
   2. Klik Kunci.
   3. Klik Tambahkan kunci, lalu klik Buat kunci baru.
   4. Klik Create. File kunci JSON akan didownload ke komputer Anda.
   5. Klik Close.

6. Tetapkan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS ke jalur file JSON yang berisi kredensial Anda. Variabel ini hanya berlaku untuk sesi shell Anda saat ini. Jadi, jika Anda membuka sesi baru, tetapkan variabel kembali.

   Contoh: Linux atau macOS

   export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

   Ganti KEY_PATH dengan jalur file JSON yang berisi kredensial Anda.

   Contoh:

   export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

   Contoh: Windows

   Untuk PowerShell:

   $env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

   Ganti KEY_PATH dengan jalur file JSON yang berisi kredensial Anda.

   Contoh:

   $env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

   Untuk command prompt:

   set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

   Ganti KEY_PATH dengan jalur file JSON yang berisi kredensial Anda.

7. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

8. Aktifkan Vertex AI API.

   Mengaktifkan API

9. Buat akun layanan:

   1. Di konsol Google Cloud, buka halaman Buat akun layanan.

      Buka Create service account
   2. Pilih project Anda.

   3. Di kolom Nama akun layanan, masukkan nama. Konsol Google Cloud akan mengisi kolom ID akun layanan berdasarkan nama ini.

      Di kolom Deskripsi akun layanan, masukkan sebuah deskripsi. Sebagai contoh, Service account for quickstart.

   4. Klik Buat dan lanjutkan.

   5. Berikan peran Project > Owner ke akun layanan.

      Untuk memberikan peran, temukan daftar Pilih peran, lalu pilih Project > Owner.

      Catatan: Kolom Peran memengaruhi resource mana yang dapat diakses oleh akun layanan di project Anda. Anda dapat mencabut peran ini atau memberikan peran tambahan di lain waktu. Dalam lingkungan produksi, jangan berikan peran Owner, Editor, atau Viewer. Sebagai gantinya, berikan peran standar atau peran khusus yang memenuhi kebutuhan Anda.
   6. Klik Lanjutkan.

   7. Klik Selesai untuk menyelesaikan pembuatan akun layanan.

      Jangan tutup jendela browser Anda. Anda akan menggunakannya pada langkah berikutnya.

10. Membuat kunci akun layanan:

    1. Di konsol Google Cloud, klik alamat email untuk akun layanan yang telah dibuat.
    2. Klik Kunci.
    3. Klik Tambahkan kunci, lalu klik Buat kunci baru.
    4. Klik Create. File kunci JSON akan didownload ke komputer Anda.
    5. Klik Close.

11. Tetapkan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS ke jalur file JSON yang berisi kredensial Anda. Variabel ini hanya berlaku untuk sesi shell Anda saat ini. Jadi, jika Anda membuka sesi baru, tetapkan variabel kembali.

    Contoh: Linux atau macOS

    export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

    Ganti KEY_PATH dengan jalur file JSON yang berisi kredensial Anda.

    Contoh:

    export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

    Contoh: Windows

    Untuk PowerShell:

    $env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

    Ganti KEY_PATH dengan jalur file JSON yang berisi kredensial Anda.

    Contoh:

    $env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

    Untuk command prompt:

    set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

    Ganti KEY_PATH dengan jalur file JSON yang berisi kredensial 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 satu per satu, 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 Vertex AI API Go yang tersedia untuk menentukan paket mana yang paling sesuai dengan kebutuhan project Anda:

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

  vertexai adalah paket yang ditulis manusia yang memberikan akses ke kemampuan dan fitur umum.

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

• Paket cloud.google.com/go/aiplatform

  aiplatform adalah paket yang dibuat secara otomatis.

  Paket ini ditujukan untuk project yang memerlukan akses ke kemampuan dan fitur Vertex AI API yang belum disediakan oleh paket vertexai buatan 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

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

  Contoh untuk menggunakan paket ini tersedia di repositori GitHub golang-samples pada direktori vertexai level atas:

  github.com/GoogleCloudPlatform/golang-samples > vertexai

• Paket cloud.google.com/go/aiplatform

  Contoh untuk menggunakan paket ini tersedia di repositori GitHub golang-samples pada direktori aiplatform level atas:

  github.com/GoogleCloudPlatform/golang-samples > aiplatform

Dokumentasi library klien

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

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

  • Vertex AI cloud.google.com/go/vertexai Referensi API

• Paket cloud.google.com/go/aiplatform

  • Referensi API Vertex AI cloud.google.com/go/aiplatform v1
  • Referensi API Vertex AI cloud.google.com/go/aiplatform v1beta1