Menginstal library klien Vertex AI

Halaman ini memandu Anda menginstal library klien Vertex AI untuk Google Distributed Cloud (GDC) dengan air gap, yang memungkinkan Anda berinteraksi dengan berbagai layanan Vertex AI dari lingkungan pengembangan dan aplikasi Anda. Anda dapat mempelajari jenis library klien yang tersedia untuk Vertex AI API dan langkah-langkah untuk menginstalnya dari file tar.

Halaman ini ditujukan bagi developer aplikasi dalam grup operator aplikasi yang bertanggung jawab menyiapkan lingkungan pengembangan dan aplikasi mereka untuk mengaktifkan fitur AI. Untuk mengetahui informasi selengkapnya, lihat Audiens untuk dokumentasi GDC dengan air gap.

Setiap layanan Vertex AI menyediakan API. Meskipun Anda dapat berinteraksi langsung dengan API ini melalui permintaan server mentah, library klien menyederhanakan akses terprogram dari bahasa yang didukung di Distributed Cloud. Library ini mengurangi kode yang diperlukan, terutama saat bekerja di lingkungan seperti notebook JupyterLab.

Anda dapat menginstal library klien Vertex AI menggunakan metode berikut:

  • Ekstrak file library langsung dari file tar.
  • Gunakan notebook JupyterLab untuk mengimpor library.
  • Mengimpor library klien dari notebook. Untuk mengetahui informasi selengkapnya, lihat Mengelola notebook.

Library klien Vertex AI

Vertex AI menawarkan berbagai versi library klien untuk sistem operasi CentOS dan Ubuntu.

Konvensi penamaan library klien Vertex AI dalam file tar didasarkan pada sistem operasi, nama layanan, dan versi. Nama file mengikuti format berikut:

OS-google-cloud-SERVICE-VERSION.tar.gz

Ganti kode berikut:

  • OS: nama sistem operasi tempat Anda ingin menginstal library klien. Nilai yang diizinkan adalah centos dan ubuntu.

  • SERVICE: nama layanan Vertex AI tempat Anda ingin mendownload library klien. Berikut adalah nilai yang diizinkan:

    • aiplatform: library klien Vertex AI Platform.
    • speech: library klien Speech-to-Text.
    • translate: library klien Vertex AI Translation.
    • vision: library klien OCR.

  • VERSION: nomor versi library klien, seperti 3.8.0.

Tabel berikut berisi library klien Vertex AI yang didukung Distributed Cloud:

Layanan Vertex AI Sistem operasi Nama file
OCR Centos centos-google-cloud-vision-3.0.0.tar.gz
Ubuntu ubuntu-google-cloud-vision-3.0.0.tar.gz
Speech-to-Text Centos centos-google-cloud-speech-2.15.0.tar.gz
Ubuntu ubuntu-google-cloud-speech-2.15.0.tar.gz
Vertex AI Translation Centos centos-google-cloud-translate-3.8.0.tar.gz
Ubuntu ubuntu-google-cloud-translate-3.8.0.tar.gz
Vertex AI Platform Centos centos-google-cloud-aiplatform-1.34.0.tar.gz
Ubuntu ubuntu-google-cloud-aiplatform-1.34.0.tar.gz

Sebelum memulai

Sebelum mendownload file tar dan mengekstrak library klien, ikuti langkah-langkah berikut:

  1. Menyiapkan project untuk Vertex AI.

  2. Melakukan autentikasi dengan gdcloud CLI:

    gdcloud auth login

    Untuk mengetahui informasi selengkapnya tentang cara melakukan autentikasi dengan penyedia identitas yang dikonfigurasi, lihat autentikasi gdcloud CLI.

  3. Pastikan Anda telah menginstal Python 3.7 hingga 3.10. Tarball library klien berisi wheel untuk cp37 hingga cp310.

Menginstal library klien

Setelah menyelesaikan prasyarat, ikuti langkah-langkah berikut untuk mendownload file tar, dan gunakan file tar untuk menginstal library klien:

  1. Download library klien yang ingin Anda instal:

    wget https://GDC_URL/.well-known/static/client-libraries/CLIENT_LIBRARY

    Ganti kode berikut:

    • GDC_URL: URL Konsol GDC untuk organisasi Anda.
    • CLIENT_LIBRARY: nama file library klien yang ingin Anda download.

  2. Ekstrak file library:

    tar -zxf CLIENT_LIBRARY

    Mengekstrak OS-google-cloud-SERVICE-VERSION.tar.gz (misalnya, centos-google-cloud-speech-2.15.0.tar.gz) akan membuat direktori LIBRARY_NAME (misalnya, google-cloud-speech, tanpa awalan OS- atau akhiran -VERSION).

  3. Instal library klien di Distributed Cloud:

    pip install -r LIBRARY_NAME/requirements.txt --no-index --find-links LIBRARY_NAME

    Ganti LIBRARY_NAME dengan nama direktori library yang diekstrak, seperti google-cloud-speech.

  4. Jika Anda telah menginstal library klien Speech-to-Text, verifikasi penginstalan dan versinya (2.15.0):

    from google.cloud import speech_v1p1beta1 as speech

print(speech.__version__)

    Output akan menampilkan versi yang diinstal:

    2.15.0

  5. Impor library klien menggunakan skrip Python. Contoh berikut menunjukkan cuplikan kode skrip Python yang mengimpor library klien Vertex AI Translation untuk mengilustrasikan tampilan pengimporan library:

    from google.cloud import translate
from google.api_core.client_options import ClientOptions
import google.auth
from google.auth.transport import requests

creds, _ = google.auth.default()
creds = creds.with_gdch_audience("https://ENDPOINT:443")
creds.refresh(requests.Request())
client = translate.TranslationServiceClient(
    credentials=creds, client_options=ClientOptions(api_endpoint="ENDPOINT:443"))
response = client.translate_text(request={
    "parent": "projects/PROJECT_ID", "target_language_code": "ru",
    "mime_type": "text/plain", "contents": ["Hello"]})
print(response.translations[0].translated_text)

    Ganti kode berikut:

    • ENDPOINT: endpoint Vertex AI Translation yang Anda gunakan untuk organisasi, tanpa awalan https:// atau port :443. Untuk mengetahui informasi selengkapnya, lihat status dan endpoint layanan.
    • PROJECT_ID: project ID Anda.

    Untuk mengetahui informasi selengkapnya tentang cara membuat permintaan Vertex AI Translation, pelajari fitur terjemahan atau terjemahkan teks.

  6. Simpan skrip Python dengan nama, seperti translation-service.py.

  7. Jalankan skrip Python:

    python SCRIPT_NAME

    Ganti SCRIPT_NAME dengan nama yang Anda berikan ke skrip Python, seperti translation-service.py.