Agen GenAI untuk Uji Kualitas melalui dokumen dan panggilan API

1. Ringkasan

Di lab ini, Anda akan membuat Agen GenAI, menghubungkannya ke aplikasi Cloud Run, dan mengintegrasikan agen ke ruang kerja Slack.

8541c95a7fbc9be7.png

Yang akan Anda pelajari

Ada beberapa bagian utama dalam lab ini:

  • Men-deploy aplikasi Cloud Run untuk berintegrasi dengan Gemini API
  • Membuat dan men-deploy Agen Vertex AI
  • Mengintegrasikan Agen ke Slack
  • Mengonfigurasi penyimpanan data untuk Tanya Jawab melalui dokumen PDF

Prasyarat

  • Di lab ini, Anda dianggap telah memahami Konsol Cloud dan lingkungan Cloud Shell.

2. Penyiapan dan Persyaratan

Penyiapan Project Cloud

  1. Login ke Google Cloud Console dan buat project baru atau gunakan kembali project yang sudah ada. Jika belum memiliki akun Gmail atau Google Workspace, Anda harus membuatnya.

fbef9caa1602edd0.png

a99b7ace416376c4.png

5e3ff691252acf41.png

  • Project name adalah nama tampilan untuk peserta project ini. String ini adalah string karakter yang tidak digunakan oleh Google API. Anda dapat memperbaruinya kapan saja.
  • Project ID bersifat unik di semua project Google Cloud dan tidak dapat diubah (tidak dapat diubah setelah ditetapkan). Cloud Console otomatis membuat string unik; biasanya Anda tidak mementingkan kata-katanya. Di sebagian besar codelab, Anda harus merujuk Project ID-nya (umumnya diidentifikasi sebagai PROJECT_ID). Jika tidak suka dengan ID yang dibuat, Anda dapat membuat ID acak lainnya. Atau, Anda dapat mencobanya sendiri, dan lihat apakah ID tersebut tersedia. ID tidak dapat diubah setelah langkah ini dan tersedia selama durasi project.
  • Sebagai informasi, ada nilai ketiga, Project Number, yang digunakan oleh beberapa API. Pelajari lebih lanjut ketiga nilai ini di dokumentasi.
  1. Selanjutnya, Anda harus mengaktifkan penagihan di Konsol Cloud untuk menggunakan resource/API Cloud. Menjalankan operasi dalam codelab ini tidak akan memakan banyak biaya, bahkan mungkin tidak sama sekali. Guna mematikan resource agar tidak menimbulkan penagihan di luar tutorial ini, Anda dapat menghapus resource yang dibuat atau menghapus project-nya. Pengguna baru Google Cloud memenuhi syarat untuk mengikuti program Uji Coba Gratis senilai $300 USD.

Penyiapan Lingkungan

Buka chat Gemini.

e1e9ad314691368a.png

Aktifkan Cloud AI Companion API:

66cb6e561e384bbf.png

Klik "Start chatting" dan ikuti salah satu contoh pertanyaan atau ketik perintah Anda sendiri untuk mencobanya.

5482c153eef23126.png

Perintah yang dapat dicoba:

  • Jelaskan Cloud Run dalam 5 poin utama.
  • Anda adalah Product Manager Google Cloud Run, jelaskan Cloud Run kepada seorang siswa dalam 5 poin penting singkat.
  • Anda adalah Product Manager Google Cloud Run, jelaskan Cloud Run kepada Developer Kubernetes Bersertifikat dalam 5 poin penting singkat.
  • Anda adalah Product Manager Google Cloud Run, jelaskan kapan Anda akan menggunakan Cloud Run versus GKE kepada Developer Senior dalam 5 poin penting singkat.

Lihat Panduan Perintah untuk mempelajari lebih lanjut cara menulis perintah yang lebih baik.

Cara Gemini untuk Google Cloud menggunakan data Anda

Komitmen privasi Google

Google adalah salah satu yang pertama di industri yang memublikasikan komitmen privasi AI/ML, yang menguraikan keyakinan kami bahwa pelanggan harus memiliki tingkat keamanan dan kontrol tertinggi atas data mereka yang disimpan di cloud.

Data yang Anda kirimkan dan terima

Pertanyaan yang Anda ajukan kepada Gemini, termasuk informasi input atau kode yang Anda kirimkan ke Gemini untuk dianalisis atau diselesaikan, disebut perintah. Jawaban atau penyelesaian kode yang Anda terima dari Gemini disebut respons. Gemini tidak menggunakan perintah Anda atau responsnya sebagai data untuk melatih modelnya.

Enkripsi perintah

Saat Anda mengirimkan perintah ke Gemini, data Anda dienkripsi selama pengiriman sebagai input ke model pokok di Gemini.

Data program yang dihasilkan dari Gemini

Gemini dilatih dengan kode Google Cloud pihak pertama serta kode pihak ketiga yang dipilih. Anda bertanggung jawab atas keamanan, pengujian, dan efektivitas kode Anda, termasuk penyelesaian, pembuatan, atau analisis kode yang ditawarkan Gemini kepada Anda.

Pelajari lebih lanjut cara Google menangani perintah Anda.

3. Opsi untuk menguji perintah

Anda memiliki beberapa opsi untuk menguji perintah.

Vertex AI Studio adalah bagian dari platform Vertex AI Google Cloud, yang dirancang khusus untuk menyederhanakan dan mempercepat pengembangan serta penggunaan model AI generatif.

Google AI Studio adalah alat berbasis web untuk membuat prototipe dan bereksperimen dengan rekayasa perintah dan Gemini API.

Aplikasi web Google Gemini (gemini.google.com) adalah alat berbasis web yang dirancang untuk membantu Anda menjelajahi dan memanfaatkan kecanggihan model AI Gemini Google.

4. Meng-clone repo

Kembali ke Konsol Google Cloud dan aktifkan Cloud Shell dengan mengklik ikon di sebelah kanan kotak penelusuran.

3e0c761ca41f315e.png

Di terminal yang terbuka, jalankan perintah berikut

git clone https://github.com/GoogleCloudPlatform/genai-for-developers.git

cd genai-for-developers

git checkout slack-agent-jira-lab

Klik "Buka Editor"

63e838aebfdd2423.png

Dengan menggunakan item menu "File / Open Folder", buka "genai-for-developers".

e3b9bd9682acf539.png

Membuka terminal baru

62dccf5c78880ed9.png

5. Buat Akun Layanan

Buat akun layanan dan kunci baru.

Anda akan menggunakan akun layanan ini untuk melakukan panggilan API ke Vertex AI Gemini API dari aplikasi Cloud Run.

Konfigurasikan detail project menggunakan detail project qwiklabs Anda.

Contoh: qwiklabs-gcp-00-2c10937585bb

gcloud config set project YOUR_QWIKLABS_PROJECT_ID

Buat akun layanan dan berikan peran.

export LOCATION=us-central1
export PROJECT_ID=$(gcloud config get-value project)
export SERVICE_ACCOUNT_NAME='vertex-client'
export DISPLAY_NAME='Vertex Client'
export KEY_FILE_NAME='vertex-client-key'

gcloud iam service-accounts create $SERVICE_ACCOUNT_NAME --project $PROJECT_ID --display-name "$DISPLAY_NAME"

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

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

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

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

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

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

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


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

Jika diminta untuk memberikan otorisasi, klik "Authorize" untuk melanjutkan.

6356559df3eccdda.png

Aktifkan layanan yang diperlukan untuk menggunakan Vertex AI API dan chat Gemini.

gcloud services enable \
    generativelanguage.googleapis.com \
    aiplatform.googleapis.com \
    cloudaicompanion.googleapis.com \
    run.googleapis.com \
    cloudresourcemanager.googleapis.com

Aktifkan layanan yang diperlukan untuk menggunakan Vertex AI API dan chat Gemini.

gcloud services enable \
    artifactregistry.googleapis.com \
    cloudbuild.googleapis.com \
    runapps.googleapis.com \
    workstations.googleapis.com \
    servicemanagement.googleapis.com \
    secretmanager.googleapis.com \
    containerscanning.googleapis.com

Mengaktifkan Gemini Code Assist

Klik ikon "Gemini", di sudut kanan bawah, klik "Sign-in" dan "Select Google Cloud project".

4a7f4640f66037f.png

8b4405d7366d2cad.png

bd07352707166136.png

Dari jendela pop-up, pilih project qwiklabs Anda.

Contoh:

70ae6837db397e2a.png

Buka file "devai-api/app/routes.py", lalu klik kanan di mana saja dalam file dan pilih "Gemini Code Assist > Explain this" dari menu konteks.

e54daef175df3cf0.png

Tinjau penjelasan Gemini untuk file yang dipilih.

e666676dce8b94d6.png

6. Men-deploy Devai-API ke Cloud Run

Pastikan Anda berada di folder yang benar.

cd ~/genai-for-developers/devai-api

Untuk lab ini, kita akan mengikuti praktik terbaik dan menggunakan Secret Manager untuk menyimpan dan mereferensikan nilai Token Akses dan Kunci API LangChain di Cloud Run.

Menetapkan variabel lingkungan.

export JIRA_API_TOKEN=your-jira-token
export JIRA_USERNAME="YOUR-EMAIL"
export JIRA_INSTANCE_URL="https://YOUR-JIRA-PROJECT.atlassian.net"
export JIRA_PROJECT_KEY="YOUR-JIRA-PROJECT-KEY"
export JIRA_CLOUD=true

export GITLAB_PERSONAL_ACCESS_TOKEN=your-gitlab-token
export GITLAB_URL="https://gitlab.com"
export GITLAB_BRANCH="devai"
export GITLAB_BASE_BRANCH="main"
export GITLAB_REPOSITORY="GITLAB-USERID/GITLAB-REPO"

export LANGCHAIN_API_KEY=your-langchain-key
export LANGCHAIN_TRACING_V2=true
export LANGCHAIN_ENDPOINT="https://api.smith.langchain.com"

Simpan Token Akses JIRA di Secret Manager.

echo -n $JIRA_API_TOKEN | \
 gcloud secrets create JIRA_API_TOKEN \
 --data-file=-

Simpan Token Akses GitLab di Secret Manager.

echo -n $GITLAB_PERSONAL_ACCESS_TOKEN | \
 gcloud secrets create GITLAB_PERSONAL_ACCESS_TOKEN \
 --data-file=-

Simpan Kunci API LangChain di Secret Manager.

echo -n $LANGCHAIN_API_KEY | \
 gcloud secrets create LANGCHAIN_API_KEY \
 --data-file=-

Men-deploy aplikasi ke Cloud Run.

gcloud run deploy devai-api \
  --source=. \
  --region="$LOCATION" \
  --allow-unauthenticated \
  --service-account vertex-client \
  --set-env-vars PROJECT_ID="$PROJECT_ID" \
  --set-env-vars LOCATION="$LOCATION" \
  --set-env-vars GITLAB_URL="$GITLAB_URL" \
  --set-env-vars GITLAB_REPOSITORY="$GITLAB_REPOSITORY" \
  --set-env-vars GITLAB_BRANCH="$GITLAB_BRANCH" \
  --set-env-vars GITLAB_BASE_BRANCH="$GITLAB_BASE_BRANCH" \
  --set-env-vars JIRA_USERNAME="$JIRA_USERNAME" \
  --set-env-vars JIRA_INSTANCE_URL="$JIRA_INSTANCE_URL" \
  --set-env-vars JIRA_PROJECT_KEY="$JIRA_PROJECT_KEY" \
  --set-env-vars JIRA_CLOUD="$JIRA_CLOUD" \
  --set-env-vars LANGCHAIN_TRACING_V2="$LANGCHAIN_TRACING_V2" \
  --update-secrets="LANGCHAIN_API_KEY=LANGCHAIN_API_KEY:latest" \
  --update-secrets="GITLAB_PERSONAL_ACCESS_TOKEN=GITLAB_PERSONAL_ACCESS_TOKEN:latest" \
  --update-secrets="JIRA_API_TOKEN=JIRA_API_TOKEN:latest" \
  --min-instances=1 \
  --max-instances=3

Jawab Y untuk membuat repositori Docker Artifact Registry.

Deploying from source requires an Artifact Registry Docker repository to store built containers. A repository named [cloud-run-source-deploy] in 
region [us-central1] will be created.

Do you want to continue (Y/n)?  y

Minta Gemini untuk menjelaskan perintah:

94d5487568b08dd2.png

Tinjau alur gcloud run deploy SERVICE_NAME --source=. di bawah. Pelajari lebih lanjut.

5c122a89dd11822e.png

Di balik layar, perintah ini menggunakan buildpacks dan Cloud Build Google Cloud untuk mem-build image container secara otomatis dari kode sumber Anda tanpa harus menginstal Docker di komputer atau menyiapkan buildpack atau Cloud Build. Artinya, satu perintah yang dijelaskan di atas melakukan apa yang sebaliknya memerlukan perintah gcloud builds submit dan gcloud run deploy.

Jika Anda telah menyediakan Dockerfile(yang telah kita lakukan di repositori ini), Cloud Build akan menggunakannya untuk mem-build image container, bukan mengandalkan buildpack untuk mendeteksi dan mem-build image container secara otomatis. Untuk mempelajari buildpack lebih lanjut, lihat dokumentasi.

Tinjau log Cloud Build di Konsol.

Tinjau image Docker yang dibuat di Artifact Registry.

Buka cloud-run-source-deploy/devai-api dan tinjau kerentanan yang terdeteksi secara otomatis. Periksa bug yang memiliki perbaikan yang tersedia dan lihat cara memperbaikinya berdasarkan deskripsi.

d00c9434b511be44.png

Tinjau detail instance Cloud Run di Cloud Console.

Uji endpoint dengan menjalankan perintah curl.

curl -X POST \
   -H "Content-Type: application/json" \
   -d '{"prompt": "PROJECT-100"}' \
   $(gcloud  run services list --filter="(devai-api)" --format="value(URL)")/generate

Tinjau output:

bda86deaa1c449a8.png

7. Vertex AI Agent Builder

Telusuri dan buka "Agent Builder".

b99ae5b6ca1d6340.png

Mengaktifkan API

4bf2b240bd51db8.png

Buat aplikasi Agen:

2e50007e454b504.png

Ketik "Agen" untuk Nama tampilan, lalu klik "Setujui & Buat".

6c49a874c48d0401.png

Menetapkan Nama Agen:

Agent

Tetapkan Sasaran:

Help user with questions about JIRA project

Petunjuk Setelan:

- Greet the users, then ask how you can help them today.
- Summarize the user's request and ask them to confirm that you understood correctly.
  - If necessary, seek clarifying details.
- Thank the user for their business and say goodbye.

Klik "Simpan":

6ef0ca47100008e0.png

Uji Agen menggunakan chat emulator di sisi kanan:

32f49a9791302535.png

Buka menu Alat dan buat Alat baru:

c236b95409dfedc3.png

Pilih OpenAPI dari dropdown Jenis.

Menetapkan Nama Alat:

jira-project-status

Tetapkan Deskripsi:

Returns JIRA project status

Set Schema (YAML) - ganti URL CLOUD RUN ANDA.

openapi: 3.0.0
info:
 title: CR API
 version: 1.0.0
 description: >-
   This is the OpenAPI specification of a service.
servers:
 - url: 'https://YOUR CLOUD RUN URL'
paths:
 /create-jira-issue:
   post:
     summary: Request impl
     operationId: create-jira-issue
     requestBody:
       description: Request impl
       required: true
       content:
         application/json:
           schema:
             $ref: '#/components/schemas/Prompt'
     responses:
       '200':
         description: Generated
         content:
           application/json:
             schema:
               type: string
 /generate:
   post:
     summary: Request impl
     operationId: generate
     requestBody:
       description: Request impl
       required: true
       content:
         application/json:
           schema:
             $ref: '#/components/schemas/Prompt'
     responses:
       '200':
         description: Generated
         content:
           application/json:
             schema:
               type: string

 /test:
   get:
     summary: Request impl
     operationId: test
     responses:
       '200':
         description: Generated
         content:
           application/json:
             schema:
               type: string                    
components:
 schemas:
   Prompt:
     type: object
     required:
       - prompt
     properties:
       prompt:
         type: string

Simpan konfigurasi Alat:

f99ce79ba79e3a4b.png

Kembali ke Konfigurasi agen dan perbarui petunjuk untuk menggunakan alat ini:

Tambahkan petunjuk untuk menggunakan alat baru:

- Use ${TOOL: jira-project-status} to help the user with JIRA project status.

4dabf135b37b044b.png

Beralih ke tab Examples dan tambahkan contoh baru:

5b1fb22e49500362.png

Menetapkan Nama Tampilan:

jira-project-flow

Dengan menggunakan menu di bagian bawah, buat model percakapan antara pengguna dan agen:

54ffb5e7744a0772.png

14cced6461a65811.png

Konfigurasi pemanggilan alat:

82af695d2f21c4f0.png

Klik Simpan dan Batal. Kembali ke emulator Agen dan uji alur.

ec137f71bf6075e2.png

f76fd38c32e29f0a.png

Tinjau Praktik Terbaik untuk Agen Vertex AI

Setelan Agen

564dd5371999a3f1.png

b5b04f282fcee3e8.png

Setelan pencatatan log

af30487d72c1cfa2.png

Konfigurasi model.

53191049428693c7.png

Integrasi GitGub untuk mengirim dan memulihkan konfigurasi Agen.

7170649a9c027857.png

Kontrol emulator agen:

59fd8b2343e89513.png

8. Integrasi Slack

Buka menu Integrasi dan klik "Hubungkan" di kartu Slack.

36f3992134479a37.png

e7ee0826668bfa2b.png

c3e36f4dacbe3f9b.png

Buka link dan buat aplikasi Slack baru di https://api.slack.com/apps

cbf13edc1b284899.png

Pilih dari "Manifes":

64fa9c75afecdb3e.png

Memilih ruang kerja untuk mengembangkan aplikasi

99a3d5b37cdf8f76.png

Beralihlah ke YAML dan tempel manifes ini:

display_information:
  name: Agent
  description: Agent
  background_color: "#1148b8"
features:
  app_home:
    home_tab_enabled: false
    messages_tab_enabled: true
    messages_tab_read_only_enabled: false
  bot_user:
    display_name: Agent
    always_online: true
oauth_config:
  scopes:
    bot:
      - app_mentions:read
      - chat:write
      - im:history
      - im:read
      - im:write
      - incoming-webhook
settings:
  event_subscriptions:
    request_url: https://dialogflow-slack-4vnhuutqka-uc.a.run.app
    bot_events:
      - app_mention
      - message.im
  org_deploy_enabled: false
  socket_mode_enabled: false
  token_rotation_enabled: false

Klik "Buat":

5f0b3d2c44022eb9.png

Menginstal ke Workspace:

aa1c2ea1b700c838.png

Pilih saluran "#general" dan klik "Izinkan"

18eba659946fc65f.png

Di bagian "Informasi Dasar / Kredensial Aplikasi" - salin "Rahasia Penandatanganan" dan tetapkan di integrasi Slack.

31d62babb57e523d.png

bd9f7e3be3b9ea4e.png

Buka "OAuth & Izin", lalu salin "Token OAuth Pengguna Bot" dan tetapkan di integrasi Slack.

e74c7e003c31258.png

Tetapkan kolom yang wajib diisi, lalu klik "Mulai".

Nilai "Access Token" agen adalah "Bot User OAUth Token" dari Slack.

Nilai "Signing Token" agen adalah "Signing Secret" dari Slack.

a00d22bdaeed3ab8.png

7e71e37750fd063a.png

Salin "Webhook URL" dan kembali ke konfigurasi aplikasi Slack.

Buka bagian "Langganan Peristiwa" dan tempel URL.

a1e7271934c714d9.png

Simpan perubahan.

e6d9b43b3787b6e7.png

Buka "Slack" dan tambahkan agen dengan mengetik "@Agent".

Misalnya, menambahkan aplikasi dengan nama "@CX".

72313066707f947b.png

63becbd80824f8d8.png

c98e193062b096f0.png

Minta ringkasan project JIRA kepada agen.

6edfdb74760548ad.png

9. Tanya jawab tentang dokumen PDF

Membuat Bucket Cloud Storage

Buka GCS di Cloud Console: https://console.cloud.google.com/storage/browser

Buat bucket baru.

Untuk nama bucket, ketik: "pdf-docs" + 5 digit terakhir project GCP Anda.

Jenis lokasi: multi-region, us.

Kelas penyimpanan: Standard

Kontrol akses: Uniform

Perlindungan data: uncheck soft delete policy

Klik "Create".

Konfirmasi "Public access will be prevented".

Download laporan PDF dan upload ke bucket. https://services.google.com/fh/files/misc/exec_guide_gen_ai.pdf

Bucket dengan tampilan file yang diupload:

ff09ac8da88fb680.png

Konfigurasi penyimpanan data

Kembali ke Konsol Agen dan buka "Agent", scroll ke bawah, lalu klik "+ Data store".

e20b69db922e37d7.png

Gunakan nilai berikut:

Nama alat: pdf-docs

Jenis: Data store

Deskripsi: pdf-docs

Klik "Save"

c5bc7a2e458213ba.png

Klik "Create a data store" di bagian bawah halaman.

Klik "AGREE" saat ditanya "Apakah Anda setuju untuk menyimpan data penelusuran & percakapan Anda di wilayah Amerika Serikat?"

Ketik "Google" di kolom "Berikan Perusahaan".

Di layar berikutnya, klik "CREATE DATA STORE".

Pilih "Cloud Storage" sebagai sumber data.

Menyiapkan data untuk penyerapan

https://cloud.google.com/generative-ai-app-builder/docs/prepare-data

File HTML dan TXT harus berukuran 2,5 MB atau lebih kecil.

File PDF, PPTX, dan DOCX harus berukuran 100 MB atau lebih kecil.

Anda dapat mengimpor hingga 100.000 file sekaligus.

Pilih: unstructured documents

Lalu, pilih bucket/folder GCS Anda.

e8534a921059e3a2.png

Klik lanjutkan: ed5ad1fabe9503a4.png

Untuk jenis nama penyimpanan data: "pdf-docs"

Pilih "Digital parser" dari dropdown.

Aktifkan pengelompokan lanjutan.

Mengaktifkan judul ancestor dalam beberapa bagian.

Klik "Create".

1a5222b86ee6c58e.png

3119b5fec43c9294.png

Pilih penyimpanan data, lalu klik "Create"

43d5be0a0aca6f8.png

9fd7fc7c1462d114.png

Klik penyimpanan data dan tinjau Dokumen, Aktivitas, dan Konfigurasi Pemrosesan.

872d9142615e90c9.png

Perlu waktu sekitar 5-10 menit untuk menyelesaikan impor.

d9739a4af2244e03.png

Opsi Mengurai dan Membagi

Anda dapat mengontrol penguraian konten dengan cara berikut:

  • Parser digital. Parser digital aktif secara default untuk semua jenis file, kecuali jika jenis parser yang berbeda ditentukan. Parser digital memproses dokumen yang ditransfer jika tidak ada parser default lain yang ditentukan untuk penyimpanan data atau jika parser yang ditentukan tidak mendukung jenis file dokumen yang ditransfer.
  • Pemrosesan OCR untuk PDF. Pratinjau publik. Jika berencana mengupload PDF yang dipindai atau PDF dengan teks di dalam gambar, Anda dapat mengaktifkan parser OCR untuk meningkatkan pengindeksan PDF. Lihat Tentang penguraian OCR untuk PDF.
  • Parser tata letak. Pratinjau publik. Aktifkan parser tata letak untuk file HTML, PDF, atau DOCX jika Anda berencana menggunakan Vertex AI Search untuk RAG. Lihat Membuat dokumen menjadi beberapa bagian untuk RAG untuk mengetahui informasi tentang parser ini dan cara mengaktifkannya.

Pelajari lebih lanjut cara mengurai dan mengelompokkan dokumen.

Konfigurasi alat

Kembali ke tab dengan konfigurasi Alat.

Muat ulang browser dan pilih "pdf-docs" dari dropdown Tidak Terstruktur.

71323e788b35ca66.png

Konfigurasikan pentanahan.

Ketik "Google" untuk nama perusahaan.

Setelan payload - centang "Include snippets in the response payload"

b0cb701d13ad4264.png

Klik "Save".

91a546957bdfe029.png

7535b85cfc7febe6.png

Konfigurasi petunjuk agen

Kembali ke Konfigurasi agen.

Tambahkan petunjuk baru:

- Provide detailed answer to users questions about the exec guide to gen ai using information in the ${TOOL:pdf-docs}

9b9548497ddaccbd.png

Simpan konfigurasi.

Membuat contoh untuk alat PDF-Docs

Beralihlah ke tab Contoh. Buat contoh baru.

Menggunakan tindakan "+":

4da93695907c97ad.png

Tambahkan "Input pengguna":

What are the main capabilities?

Tambahkan "Penggunaan alat".

  • Alat & Tindakan: "pdf-docs"

Input (requestBody)

{
  "query": "Main capabilities",
  "filter": "",
  "userMetadata": {},
  "fallback": ""
}

Output Alat:

{
  "answer": "Detailed answer about main capabilities",
  "snippets": [
    {
      "uri": "https://storage.cloud.google.com/pdf-docs-49ca4/exec_guide_gen_ai.pdf",
      "text": "Detailed answer about main capabilities",
      "title": "exec_guide_gen_ai"
    }
  ]
}

Menambahkan "Respons agen"

Detailed answer about main capabilities. 

https://storage.cloud.google.com/pdf-docs-49ca4/exec_guide_gen_ai.pdf

Contoh yang dikonfigurasi:

2968363e05f3325e.png

Konfigurasi pemanggilan alat:

658316bb29ac352d.png

Uji konfigurasi dengan mengirim pertanyaan ke Agen di emulator.

Pertanyaan:

What are the 10 steps in the exec guide?

5b2329c494ad0d17.png

Pilih "Agent", lalu klik "Save example".

e79c86aa04a9572f.png

Berikan nama "user-question-flow" dan simpan.

Format respons agen dan sertakan link ke dokumen pdf dari bagian output alat.

50f2bcee082ac38d.png

Simpan contoh.

Kembali ke emulator dan klik "Replay conversation". Periksa format respons yang diperbarui.

8db40e424f448a2d.png

Ajukan pertanyaan lain:

What are the main capabilities in the exec guide?

6f103fdac8ec4cda.png

Dokumen PDF sumber.

5b3e6d2ceda99247.png

Pertanyaan:

What should I consider when evaluating projects?

ec7e0f5884772385.png

Dokumen PDF sumber.

57a0d331aa91f04b.png

Pertanyaan:

What are the priority use cases in Retail and CPG in the exec guide?

7a18ba3ca0fe90c5.png

Dokumen PDF sumber.

b4d07e6e7d9adc00.png

10. Agen Bawaan

Jelajahi Agen bawaan dari menu di sebelah kiri.

5720dc5343aede65.png

Pilih salah satu agen dan deploy. Pelajari penyiapan, petunjuk, dan alat Agen.

2a3db1129b5a1461.png

11. Selamat!

Selamat, Anda telah menyelesaikan lab!

Yang telah kita bahas:

  • Cara men-deploy aplikasi Cloud Run untuk berintegrasi dengan Gemini API
  • Cara membuat dan men-deploy Agen Vertex AI
  • Cara menambahkan integrasi Slack untuk Agen
  • Cara mengonfigurasi penyimpanan data untuk Tanya Jawab melalui dokumen PDF

Langkah berikutnya:

Pembersihan

Agar tidak dikenai biaya pada akun Google Cloud Anda untuk resource yang digunakan dalam tutorial ini, hapus project yang berisi resource tersebut, atau simpan project dan hapus setiap resource.

Menghapus project

Cara termudah untuk menghilangkan penagihan adalah dengan menghapus project yang Anda buat untuk tutorial.

©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.