Menyiapkan project dan lingkungan pengembangan

Panduan ini menjelaskan cara menyiapkan Google Cloud project untuk mulai menggunakan Gemini Enterprise Agent Platform Vision.

Menyiapkan project

  1. Login keakun Anda. Google Cloud 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. Instal Google Cloud CLI.

  3. Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu .

  4. Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut: 

    gcloud init

  5. Buat atau pilih Google Cloud project.

    Peran yang diperlukan untuk memilih atau membuat project

    • Memilih project: Memilih project tidak memerlukan peran IAM tertentu Anda dapat memilih project mana pun yang telah diberi peran.
    • Membuat project: Untuk membuat project, Anda memerlukan peran Project Creator (roles/resourcemanager.projectCreator), yang berisi izin resourcemanager.projects.create. Pelajari cara memberikan peran.

    • Buat Google Cloud project:

      gcloud projects create PROJECT_ID

      Ganti PROJECT_ID dengan nama untuk Google Cloud project yang Anda buat.

    • Pilih Google Cloud project yang Anda buat:

      gcloud config set project PROJECT_ID

      Ganti PROJECT_ID dengan nama Google Cloud project Anda.

  6. Pastikan penagihan diaktifkan untuk Google Cloud project Anda.

  7. Aktifkan Vertex AI Vision API:

    Peran yang diperlukan untuk mengaktifkan API

    Untuk mengaktifkan API, Anda memerlukan izin serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Admin Penggunaan Layanan (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran. 

    gcloud services enable visionai.googleapis.com

  8. Menyiapkan autentikasi:

    1. Pastikan Anda memiliki peran IAM Membuat Akun Layanan (roles/iam.serviceAccountCreator) dan peran Admin IAM Project (roles/resourcemanager.projectIamAdmin). Pelajari cara memberikan peran.

    2. Buat akun layanan: 

      gcloud iam service-accounts create SERVICE_ACCOUNT_NAME

      Ganti SERVICE_ACCOUNT_NAME dengan nama untuk akun layanan.

    3. Berikan peran IAM roles/visionai.editor ke akun layanan: 

      gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com" --role=roles/visionai.editor

      Ganti kode berikut:

      • SERVICE_ACCOUNT_NAME: nama dari akun layanan.
      • PROJECT_ID: project ID dimana Anda membuat akun layanan

    4. Membuat file kunci: 

      gcloud iam service-accounts keys create FILE_NAME.json --iam-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com

      Ganti kode berikut:

      • FILE_NAME: nama untuk file kunci
      • SERVICE_ACCOUNT_NAME: nama dari akun layanan.
      • PROJECT_ID: project ID dimana Anda membuat akun layanan

  9. 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 kembali variabel.

  10. Instal Google Cloud CLI.

  11. Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu .

  12. Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut: 

    gcloud init

  13. Buat atau pilih Google Cloud project.

    Peran yang diperlukan untuk memilih atau membuat project

    • Memilih project: Memilih project tidak memerlukan peran IAM tertentu Anda dapat memilih project mana pun yang telah diberi peran.
    • Membuat project: Untuk membuat project, Anda memerlukan peran Project Creator (roles/resourcemanager.projectCreator), yang berisi izin resourcemanager.projects.create. Pelajari cara memberikan peran.

    • Buat Google Cloud project:

      gcloud projects create PROJECT_ID

      Ganti PROJECT_ID dengan nama untuk Google Cloud project yang Anda buat.

    • Pilih Google Cloud project yang Anda buat:

      gcloud config set project PROJECT_ID

      Ganti PROJECT_ID dengan nama Google Cloud project Anda.

  14. Pastikan penagihan diaktifkan untuk Google Cloud project Anda.

  15. Aktifkan Vertex AI Vision API:

    Peran yang diperlukan untuk mengaktifkan API

    Untuk mengaktifkan API, Anda memerlukan izin serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Admin Penggunaan Layanan (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran. 

    gcloud services enable visionai.googleapis.com

  16. Menyiapkan autentikasi:

    1. Pastikan Anda memiliki peran IAM Membuat Akun Layanan (roles/iam.serviceAccountCreator) dan peran Admin IAM Project (roles/resourcemanager.projectIamAdmin). Pelajari cara memberikan peran.

    2. Buat akun layanan: 

      gcloud iam service-accounts create SERVICE_ACCOUNT_NAME

      Ganti SERVICE_ACCOUNT_NAME dengan nama untuk akun layanan.

    3. Berikan peran IAM roles/visionai.editor ke akun layanan: 

      gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com" --role=roles/visionai.editor

      Ganti kode berikut:

      • SERVICE_ACCOUNT_NAME: nama dari akun layanan.
      • PROJECT_ID: project ID dimana Anda membuat akun layanan

    4. Membuat file kunci: 

      gcloud iam service-accounts keys create FILE_NAME.json --iam-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com

      Ganti kode berikut:

      • FILE_NAME: nama untuk file kunci
      • SERVICE_ACCOUNT_NAME: nama dari akun layanan.
      • PROJECT_ID: project ID dimana Anda membuat akun layanan

  17. 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 kembali variabel.

Tugas tertentu mengharuskan Anda menggunakan produk tambahan Google Cloud selain Agent Platform Vision. Anda mungkin perlu melakukan tugas penyiapan tambahan untuk menggunakan produk lain Google Cloud .

Gemini Enterprise Agent Platform Vision SDK

Agent Platform Vision Software Development Kit (SDK) berisi alat dan library untuk mengembangkan program dan alur kerja kustom dengan Agent Platform Vision.

Alat ini mengacu pada sekumpulan file sumber biner yang membantu produktivitas Anda saat menggunakan atau mengembangkan solusi menggunakan Agent Platform Vision. Anda juga dapat menambahkan file sumber biner ini ke dalam skrip untuk membantu mengelola deployment skala yang lebih besar. Antarmuka command line (CLI) vaictl adalah contoh dalam kategori ini.

Library mengacu pada sekumpulan API pemrograman yang dapat Anda gunakan untuk mengelola, mengontrol, dan melakukan I/O berbagai bentuk secara terprogram dengan Agent Platform Vision. API pemrograman C++ adalah contoh dalam kategori ini.

Kode untuk alat dan library bersifat open source dan kami menyambut developer untuk membangunnya secara langsung. Untuk alat, kami juga menawarkan file biner bawaan di platform tertentu yang dapat Anda download untuk penggunaan langsung. Kami juga menawarkan image Docker jika platform Anda tidak didukung secara langsung.

Prasyarat

Pertimbangkan prasyarat ini sebelum Anda menggunakan Gemini Enterprise Agent Platform Vision SDK.

Platform yang didukung

Kami hanya mendukung langsung mesin x86 yang menjalankan distribusi Linux berbasis Debian. Kami juga menawarkan image Docker dengan alat yang sudah dibuat dan diinstal jika Anda menggunakan platform lain.

Persyaratan software tambahan

Sebagian besar dependensi software pihak ketiga yang diperlukan Gemini Enterprise Agent Platform Vision SDK dikelola secara otomatis saat Anda menginstal biner bawaan. Namun, untuk menggunakan aspek tertentu dari fitur dan alur kerja SDK, Anda harus menginstal dependensi tambahan. Bagian ini mencantumkan pengecualian ini dan cara mendownload serta menginstalnya.

Python SDK

Paket pip Python menginstal semua dependensinya secara otomatis. Namun, penginstalan Python dasar Anda harus memenuhi kondisi berikut:

  • Python >= 3.8.

Membangun dari dependensi sumber

Sebagian besar pengguna dapat menggunakan biner SDK bawaan untuk alur kerja mereka. Jika ingin mengembangkan dan membangun SDK dari sumber, Anda juga harus memastikan sistem Anda memenuhi persyaratan berikut.

  • Instal Bazel. Untuk petunjuk penginstalan, lihat dokumentasi Bazel.

  • Di Ubuntu 20.04, Anda juga memerlukan beberapa dependensi sistem. Anda dapat menginstalnya dengan perintah berikut:

    apt-get install -y --no-install-recommends \
    autoconf \
    automake \
    build-essential \
    ca-certificates \
    flex \
    bison \
    python3 \
    nasm \
    libjpeg-dev

Mendapatkan biner bawaan

Alat vaictl adalah alat biner siap pakai yang dapat digunakan untuk mengontrol Agent Platform Vision, serta mengirim dan menerima data yang diproses.

Bagian ini menunjukkan cara mendownload dan menginstal alat ini.

Menginstal paket Debian

Anda memiliki dua opsi untuk menggunakan alat command line vaictl, yang diperlukan untuk bekerja dengan I/O (data streaming):

  • Menginstal alat command line secara lokal (OS: Debian GNU/Linux, arsitektur CPU: x86_64) atau
  • Menjalankan perintah dalam image Docker yang telah menginstal semua dependensi.

Gunakan langkah-langkah berikut untuk mendapatkan alat command line vaictl:

Unduh paket

Untuk penginstalan langsung, kami hanya mendukung distribusi Debian/Ubuntu.

Anda juga dapat mendownload paket Debian ini dari halaman rilis GitHub Gemini Enterprise Agent Platform Vision SDK.

  1. (Opsional) Hapus versi vaictl sebelumnya.

    Sebelum dapat menginstal alat command line vaictl, Anda harus menghapus versi alat sebelumnya di mesin Anda:

    sudo apt-get remove visionai
  2. Download paket yang diperlukan. Anda dapat mendownload paket dari halaman rilis GitHub, atau menggunakan perintah berikut: 
    wget https://github.com/google/visionai/releases/download/v0.0.5/visionai_0.0-5_amd64.deb
  3. Setelah mendownload paket, jalankan perintah berikut di direktori Anda mendownload file: 
    sudo apt install ./visionai_0.0-5_amd64.deb
  4. Verifikasi penginstalan: 
    vaictl --help

Mendapatkan Docker

Anda bisa mendapatkan image Docker yang telah menginstal Gemini Enterprise Agent Platform Vision SDK dan semua dependensinya. Image Docker ini tersedia di gcr.io/visionai-public-images/vaictl.

  1. Download image dari Container Registry: 
    docker pull gcr.io/visionai-public-images/vaictl
  2. Jalankan terminal container interaktif. 
    docker run -it --rm gcr.io/visionai-public-images/vaictl /bin/bash
  3. Verifikasi fungsi: 
    vaictl --help

Mendapatkan kode sumber

Gemini Enterprise Agent Platform Vision SDK bersifat open source dan tersedia secara publik di GitHub.

Meskipun SDK bergantung pada definisi API layanan, dependensi ini sudah dikelola secara otomatis oleh Bazel dan Anda tidak perlu mendapatkannya secara eksplisit. Namun, jika Anda memerlukan akses langsung ke API layanan, Anda bisa mendapatkannya di googleapis repositori GitHub.

SDK pemrograman Python

Agent Platform Vision juga mendukung Python SDK. Untuk memprogram dengan SDK ini, pastikan Anda telah memenuhi dependensi Python SDK dasar sebelum Anda menginstal Python SDK.

Untuk informasi referensi SDK, lihat referensi Python SDK.

Untuk contoh kode yang menggunakan Python SDK, lihat tutorial Wajah buram dengan Python SDK, atau lihat beberapa contoh dalam distribusi sumber di direktori visionai/python/examples/.

Mendapatkan paket Python SDK

Gemini Enterprise Agent Platform Vision SDK juga berisi library Python. Download dan instal versi bawaan Python SDK dengan petunjuk berikut.

  1. Download paket.

    Anda dapat mendownload paket Python SDK dari halaman rilis GitHub Gemini Enterprise Agent Platform Vision SDK, atau Anda dapat menjalankan perintah:

    wget https://github.com/google/visionai/releases/download/v0.0.5/visionai-0.0.5-py3-none-any.whl

  2. Opsional. Buat dan aktifkan lingkungan virtual baru:

    python3 -m venv vaivenv
source vaivenv/bin/activate

  3. Instal paket:

    pip3 install visionai-0.0.5-py3-none-any.whl

  4. Opsional. Konfirmasi bahwa penginstalan berhasil:

    python3

    import visionai

  5. Opsional. Nonaktifkan lingkungan virtual Anda:

    deactivate

SDK pemrograman C++

C++ adalah SDK pemrograman pertama yang kami dukung. SDK publik C++ terletak di visionai/public/streams.h. Untuk informasi referensi, lihat referensi dokumentasi.

Langkah berikutnya

Sebelumnya
Panduan memulai: Membangun aplikasi di konsol