GSP1229

Ringkasan

Gemini adalah rangkaian model AI generatif yang dikembangkan oleh Google DeepMind dan dirancang untuk kasus penggunaan multimodal. Gemini API menyediakan akses ke model Gemini Pro Vision dan Gemini Pro. Di lab ini, Anda akan memahami cara mengintegrasikan Vertex AI Gemini API dengan aplikasi dan membangun serta men-deploy aplikasi sampel yang dikembangkan di Google Cloud Run.

Vertex AI Gemini API

Vertex AI Gemini API menyediakan antarmuka terpadu untuk berinteraksi dengan model-model Gemini. Saat ini ada dua model yang tersedia di Gemini API:

1. Model Gemini Pro (gemini-pro): Dirancang untuk menangani tugas bahasa alami, teks multiturn dan chat kode, serta pembuatan kode.
2. Model Gemini Pro Vision (gemini-pro-vision): Mendukung prompt multimodal. Anda dapat menyertakan teks, gambar, dan video dalam permintaan prompt dan mendapatkan respons teks atau kode.

Anda dapat berinteraksi dengan Gemini API menggunakan metode berikut:

• Menggunakan Vertex AI Studio untuk pengujian cepat dan pembuatan perintah
• Menggunakan perintah cURL
• Menggunakan Vertex AI SDK

Lab ini berfokus pada cara mengintegrasikan model Gemini Pro dengan aplikasi Streamlit dan men-deploy aplikasi tersebut di Google Cloud Run.

Untuk mengetahui informasi selengkapnya, lihat dokumentasi AI Generatif di Vertex AI.

Tujuan

Di lab ini, Anda akan mempelajari cara:

• Mengintegrasikan Vertex AI Gemini API dengan aplikasi
• Membangun dan men-deploy aplikasi sampel yang dikembangkan di Google Cloud Run
• Menggunakan framework Streamlit untuk membangun aplikasi Cloud Run

Penyiapan dan persyaratan

Sebelum mengklik tombol Mulai Lab

Baca petunjuk ini. Lab memiliki timer dan Anda tidak dapat menjedanya. Timer, yang dimulai saat Anda mengklik Start Lab, akan menampilkan durasi ketersediaan resource Google Cloud untuk Anda.

Lab praktik ini dapat Anda gunakan untuk melakukan sendiri aktivitas lab di lingkungan cloud sungguhan, bukan di lingkungan demo atau simulasi. Untuk mengakses lab ini, Anda akan diberi kredensial baru yang bersifat sementara dan dapat digunakan untuk login serta mengakses Google Cloud selama durasi lab.

Untuk menyelesaikan lab ini, Anda memerlukan:

• Akses ke browser internet standar (disarankan browser Chrome).

Catatan: Gunakan jendela Samaran atau browser pribadi untuk menjalankan lab ini. Hal ini akan mencegah konflik antara akun pribadi Anda dan akun Siswa yang dapat menyebabkan tagihan ekstra pada akun pribadi Anda.

• Waktu untuk menyelesaikan lab. Ingat, setelah dimulai, lab tidak dapat dijeda.

Catatan: Jika Anda sudah memiliki project atau akun pribadi Google Cloud, jangan menggunakannya untuk lab ini agar terhindar dari tagihan ekstra pada akun Anda.

Cara memulai lab dan login ke Google Cloud Console

1. Klik tombol Start Lab. Jika Anda perlu membayar lab, jendela pop-up akan terbuka untuk memilih metode pembayaran. Di sebelah kiri adalah panel Lab Details dengan info berikut:

   • Tombol Open Google Cloud console
   • Waktu tersisa
   • Kredensial sementara yang harus Anda gunakan untuk lab ini
   • Informasi lain, jika diperlukan, untuk menyelesaikan lab ini

2. Klik Open Google Cloud console (atau klik kanan dan pilih Open Link in Incognito Window jika Anda menjalankan browser Chrome).

   Lab akan menjalankan resource, lalu membuka tab lain yang menampilkan halaman Sign in.

   Tips: Atur tab di jendela terpisah secara berdampingan.

   Catatan: Jika Anda melihat dialog Choose an account, klik Use Another Account.

3. Jika perlu, salin Username di bawah dan tempel ke dialog Sign in.

   {{{user_0.username | "Username"}}}

   Anda juga dapat menemukan Username di panel Lab Details.

4. Klik Next.

5. Salin Password di bawah dan tempel ke dialog Welcome.

   {{{user_0.password | "Password"}}}

   Anda juga dapat menemukan Password di panel Lab Details.

6. Klik Next.

   Penting: Anda harus menggunakan kredensial yang diberikan lab. Jangan menggunakan kredensial akun Google Cloud Anda. Catatan: Menggunakan akun Google Cloud sendiri untuk lab ini dapat dikenai biaya tambahan.

7. Klik halaman berikutnya:

   • Setujui persyaratan dan ketentuan.
   • Jangan tambahkan opsi pemulihan atau autentikasi 2 langkah (karena ini akun sementara).
   • Jangan mendaftar uji coba gratis.

Setelah beberapa saat, Konsol Google Cloud akan terbuka di tab ini.

Catatan: Untuk melihat menu dengan daftar produk dan layanan Google Cloud, klik Navigation menu di kiri atas.

Tugas 1. Menjalankan Aplikasi Secara Lokal

Di bagian ini, Anda akan menjalankan aplikasi Streamlit secara lokal di Cloud Shell.

Membuat Clone Repositori

1. Buka terminal Cloud Shell baru dengan mengklik ikon Cloud Shell di pojok kanan atas Konsol Cloud.

2. Jalankan perintah berikut untuk membuat clone repo, dan buka direktori gemini-streamlit-cloudrun di Cloud Shell menggunakan perintah berikut.

git clone https://github.com/GoogleCloudPlatform/generative-ai.git cd generative-ai/gemini/sample-apps/gemini-streamlit-cloudrun

Untuk menjalankan Aplikasi Streamlit, Anda perlu melakukan beberapa langkah tambahan.

Menjalankan aplikasi

1. Menyiapkan lingkungan virtual Python dan menginstal dependensi:

python3 -m venv gemini-streamlit source gemini-streamlit/bin/activate pip install -r requirements.txt

2. Aplikasi Anda memerlukan akses ke dua variabel lingkungan:

• GCP_PROJECT : Ini adalah ID project Google Cloud.
• GCP_REGION : Ini adalah region tempat Anda men-deploy aplikasi Cloud Run Anda. Misalnya, us-central1.

Variabel-variabel ini diperlukan karena inisialisasi Vertex AI memerlukan ID project Google Cloud dan region. Baris kode yang spesifik dari fungsi app.py diperlihatkan di sini: vertexai.init(project=PROJECT_ID, location=LOCATION)

Di Cloud Shell, jalankan perintah berikut:

GCP_PROJECT='{{{ project_0.project_id | Project ID}}}' GCP_REGION='{{{ project_0.default_region | Region }}}'

3. Untuk menjalankan aplikasi secara lokal, jalankan perintah berikut.

streamlit run app.py \ --browser.serverAddress=localhost \ --server.enableCORS=false \ --server.enableXsrfProtection=false \ --server.port 8080

Output:

Collecting usage statistics. To deactivate, set browser.gatherUsageStats to False. You can now view your Streamlit app in your browser. URL: http://localhost:8080

4. Aplikasi akan dimulai dan Anda akan diberikan URL ke aplikasi tersebut. Klik link untuk melihat aplikasi di browser atau gunakan fungsi pratinjau web Cloud Shell untuk meluncurkan halaman pratinjau.

5. Sesuaikan parameter untuk pembuatan cerita dan klik Generate my story.

6. Kembali ke Cloud Shell dan otorisasi aplikasi untuk mengakses Gemini API. Setelah memberikan otorisasi kepada aplikasi, Anda dapat membuka aplikasi kembali untuk melihat responsnya.

Catatan: Aplikasi akan memerintahkan Vertex AI Gemini API dan menampilkan respons. Agar hal ini berfungsi, setelah memilih Generate my story, Anda perlu membuka kembali Cloud Shell untuk memberikan otorisasi kepada aplikasi untuk mengakses Gemini API.

6. Setelah selesai menguji aplikasi, Anda dapat menghentikan aplikasi dengan memasukkan Ctrl + C di Cloud Shell.

Tugas 2. Membangun dan Men-deploy Aplikasi di Cloud Run

Di bagian ini, Anda akan men-deploy Aplikasi Streamlit di Cloud Run.

Anda sekarang akan membangun image Docker untuk aplikasi dan mengirimnya ke Artifact Registry. Untuk melakukannya, Anda akan memerlukan satu set variabel lingkungan yang akan mengarah ke nama Artifact Registry. Perintah di bawah ini akan membuat repositori Artifact Registry untuk Anda.

1. Di Cloud Shell, jalankan perintah berikut:

AR_REPO='gemini-repo' SERVICE_NAME='gemini-streamlit-app' gcloud artifacts repositories create "$AR_REPO" --location="$GCP_REGION" --repository-format=Docker gcloud builds submit --tag "$GCP_REGION-docker.pkg.dev/$GCP_PROJECT/$AR_REPO/$SERVICE_NAME"

Output:

DONE -------------------------------------------------------------------------------- ID CREATE_TIME DURATION SOURCE IMAGES STATUS a601ffd1-c282-43d2-942c-53cc13f43bf2 2023-12-18T11:37:30+00:00 2M29S gs://qwiklabs-gcp-00-eb090e9513e8_cloudbuild/source/1702899440.87287-549e1a0cc5644b3c9535ff57f4a63d02.tgz us-central1-docker.pkg.dev/qwiklabs-gcp-00-eb090e9513e8/gemini-repo/gemini-streamlit-app (+1 more) SUCCESS

2. Langkah terakhir adalah men-deploy layanan di Cloud Run dengan image yang telah dibangun dan telah dikirim ke Artifact Registry pada langkah sebelumnya.

gcloud run deploy "$SERVICE_NAME" \ --port=8080 \ --image="$GCP_REGION-docker.pkg.dev/$GCP_PROJECT/$AR_REPO/$SERVICE_NAME" \ --allow-unauthenticated \ --region=$GCP_REGION \ --platform=managed \ --project=$GCP_PROJECT \ --set-env-vars=GCP_PROJECT=$GCP_PROJECT,GCP_REGION=$GCP_REGION

Setelah deployment berhasil dilakukan, Anda akan diberikan URL ke layanan Cloud Run. Anda dapat mengunjunginya di browser untuk melihat aplikasi Cloud Run yang baru saja di-deploy.

Output:

⠼ Deploying new service... Done. ✓ Deploying new service... Done. Done. Service [gemini-streamlit-app] revision [gemini-streamlit-app-00001-srg] has been deployed and is serving 100 percent of traffic. Service URL: https://gemini-streamlit-app-hc2gb6hsia-uc.a.run.app

Pilih fungsionalitas yang ingin Anda periksa dan aplikasi akan memerintahkan Vertex AI Gemini API serta menampilkan respons.

Klik Check my progress untuk memverifikasi tujuan. Membangun dan Men-deploy Aplikasi di Cloud Run

Selamat!

Selamat! Di lab ini, Anda telah mempelajari cara mengintegrasikan Vertex AI Gemini API dengan aplikasi dan membangun serta men-deploy aplikasi sampel yang dikembangkan di Google Cloud Run.

Langkah berikutnya/pelajari lebih lanjut

• Lihat dokumentasi AI Generatif di Vertex AI.
• Pelajari AI Generatif lebih lanjut di channel YouTube Google Cloud Tech.
• Repositori resmi AI Generatif Google Cloud
• Contoh notebook Gemini

Sertifikasi dan pelatihan Google Cloud

...membantu Anda mengoptimalkan teknologi Google Cloud. Kelas kami mencakup keterampilan teknis dan praktik terbaik untuk membantu Anda memahami dengan cepat dan melanjutkan proses pembelajaran. Kami menawarkan pelatihan tingkat dasar hingga lanjutan dengan opsi on demand, live, dan virtual untuk menyesuaikan dengan jadwal Anda yang sibuk. Sertifikasi membantu Anda memvalidasi dan membuktikan keterampilan serta keahlian Anda dalam teknologi Google Cloud.

Manual Terakhir Diperbarui pada 07 Maret 2024

Lab Terakhir Diuji pada 07 Maret 2024

Hak cipta 2024 Google LLC Semua hak dilindungi undang-undang. Google dan logo Google adalah merek dagang dari Google LLC. Semua nama perusahaan dan produk lain mungkin adalah merek dagang masing-masing perusahaan yang bersangkutan.