Menginstal library klien Vertex AI

Library klien Vertex AI di Google Distributed Cloud (GDC) dengan air gap memungkinkan Anda mengakses API Pengenalan Karakter Optik (OCR), Speech-to-Text, Vertex AI Translation, dan Vertex AI Platform secara terprogram tanpa menulis permintaan server mentah. Ekstrak dan instal library klien langsung dari file tar-nya, atau impor library di notebook JupyterLab. Untuk mengetahui informasi selengkapnya tentang lingkungan notebook, lihat Mengelola notebook.

Dokumen ini ditujukan untuk developer aplikasi dalam grup operator aplikasi yang mengonfigurasi lingkungan aplikasi dan lingkungan pengembangan untuk mengaktifkan fitur AI. Untuk mengetahui informasi selengkapnya, lihat Audiens untuk dokumentasi GDC dengan air gap.

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. Siapkan 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 untuk skrip Python, seperti translation-service.py.