Menginstal library klien Vertex AI

Halaman ini memandu Anda menginstal library klien Vertex AI untuk lingkungan yang terisolasi dari internet Google Distributed Cloud (GDC), yang memungkinkan Anda berinteraksi dengan berbagai layanan Vertex AI dari aplikasi dan lingkungan pengembangan 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 untuk menyiapkan aplikasi dan lingkungan pengembangan mereka guna mengaktifkan fitur AI. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Audiens untuk GDC yang terisolasi dari internet.

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. Hal 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: pustaka 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. Lakukan 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. Tetapkan peran Cloud AI Viewer (cloud-ai-viewer) ke akun layanan. Akun layanan memerlukan peran ini untuk mengakses layanan Vertex AI.

  4. Pastikan Anda telah menginstal Python versi 3.7.

Menginstal library klien

Setelah menyelesaikan prasyarat, ikuti langkah-langkah berikut untuk mendownload file tar, dan menggunakan 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 organisasi Anda di GDC.
    • CLIENT_LIBRARY: nama file client library yang ingin Anda download.
  2. Ekstrak file library:

    tar -zxf CLIENT_LIBRARY
    
  3. Instal library klien di Distributed Cloud:

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

    Ganti FOLDER_NAME dengan jalur ke direktori lokal tempat Anda mendownload file library.

  4. Impor library klien menggunakan skrip Python. Contoh berikut menunjukkan cuplikan kode skrip Python yang mengimpor library klien Vertex AI Translation untuk mengilustrasikan seperti apa tampilan library yang diimpor:

    from google.cloud import translate
    translate_client = translate.Client(
     client_options={"API_ENDPOINT": "https://foo-translation.googleapis.com"})
    result
    = translate_client.translate(text, target_language="ru")
    
    [...]
    
  5. Simpan skrip Python dengan nama, seperti translation-service.py.

  6. Jalankan skrip Python:

    python SCRIPT_NAME
    

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