API çağrılarıyla belgeler ve işlemler hakkında soru-cevap için üretken yapay zeka temsilcisi

Bu codelab hakkında

Son güncelleme Mar 18, 2025

Yazan: Andrey Shakirov

1. Genel Bakış

Bu laboratuvarda bir GenAI temsilcisi oluşturacak, temsilciyi Cloud Run uygulamasına bağlayacak ve Slack çalışma alanına entegre edeceksiniz.

Öğrenecekleriniz

Laboratuvarın birkaç ana bölümü vardır:

Gemini API'leriyle entegre edilecek Cloud Run uygulamasını dağıtma
Conversational Agent'ı oluşturma ve dağıtma
Agent'ı Slack'e entegre etme
PDF dokümanlarındaki soru-cevaplar için veri deposunu yapılandırma

Ön koşullar

Bu laboratuvarda, Cloud Console ve Cloud Shell ortamlarına aşina olmanız gerekir.

Cloud projesi oluşturma

Google Cloud Console'da oturum açın ve yeni bir proje oluşturun veya mevcut bir projeyi yeniden kullanın. Gmail veya Google Workspace hesabınız yoksa hesap oluşturmanız gerekir.

Proje adı, bu projenin katılımcılarının görünen adıdır. Google API'leri tarafından kullanılmayan bir karakter dizesidir. Dilediğiniz zaman güncelleyebilirsiniz.
Proje kimliği, tüm Google Cloud projelerinde benzersizdir ve değiştirilemez (ayarlandıktan sonra değiştirilemez). Cloud Console, benzersiz bir dize otomatik olarak oluşturur. Bu dizenin ne olduğu genellikle önemli değildir. Çoğu kod laboratuvarında proje kimliğinize (genellikle PROJECT_ID olarak tanımlanır) referans vermeniz gerekir. Oluşturulan kimliği beğenmezseniz rastgele başka bir kimlik oluşturabilirsiniz. Alternatif olarak, kendi anahtarınızı deneyerek kullanılabilir olup olmadığını görebilirsiniz. Bu adımdan sonra değiştirilemez ve proje boyunca geçerli kalır.
Bazı API'lerin kullandığı üçüncü bir değer (Proje Numarası) olduğunu belirtmek isteriz. Bu değerlerin üçü hakkında daha fazla bilgiyi dokümanlar bölümünde bulabilirsiniz.

Ardından, Cloud kaynaklarını/API'lerini kullanmak için Cloud Console'da faturalandırmayı etkinleştirmeniz gerekir. Bu codelab'i çalıştırmak çok pahalı değildir. Bu eğitimden sonra faturalandırılmamak için kaynakları kapatmak istiyorsanız oluşturduğunuz kaynakları veya projeyi silebilirsiniz. Yeni Google Cloud kullanıcıları 300 ABD doları değerinde ücretsiz deneme programına uygundur.

Ortam Kurulumu

Gemini sohbetini açın.

Google Cloud API için Gemini'yi etkinleştirin:

"Start chatting"yi tıklayın ve örnek sorulardan birini uygulayın veya denemek için kendi isteminizi yazın.

Deneyebileceğiniz istemler:

Cloud Run'u 5 temel noktada açıklayın.
Google Cloud Run Ürün Müdürü olduğunuzu varsayarak bir öğrenciye Cloud Run'u 5 kısa ve önemli noktayla açıklayın.
Google Cloud Run Ürün Müdürü olarak, Cloud Run'u Sertifikalı bir Kubernetes Geliştiricisine 5 kısa ve önemli noktayla açıklayın.
Google Cloud Run Ürün Müdürü olduğunuzu varsayalım. Kıdemli bir geliştiriciye, Cloud Run'u ne zaman GKE yerine kullanacağınızı 5 kısa ve önemli noktayla açıklayın.

Daha iyi istemler yazma hakkında daha fazla bilgi edinmek için İstem Rehberi'ne göz atın.

Google Cloud için Gemini, verilerinizi nasıl kullanır?

Google'ın gizlilik taahhüdü

Google, sektörde AI/ML gizlilik taahhüdü yayınlayan ilk şirketlerden biri oldu. Bu taahhüdümüzde, müşterilerin bulutta depolanan verileri üzerinde en yüksek düzeyde güvenlik ve denetime sahip olması gerektiğine olan inancımızı özetliyoruz.

Gönderdiğiniz ve aldığınız veriler

Gemini'ye sorduğunuz sorulara (analiz etmesi veya tamamlaması için gönderdiğiniz giriş bilgileri veya kodlar dahil) istem denir. Gemini'den aldığınız yanıtlara veya kod tamamlamalarına yanıt denir. Gemini, istemlerinizi veya yanıtlarını modellerini eğitmek için veri olarak kullanmaz.

İstemlerin şifrelenmesi

Gemini'ye istem gönderdiğinizde, Gemini'deki temel modele giriş olarak verileriniz aktarım sırasında şifrelenir.

Gemini'den oluşturulan program verileri

Gemini, birinci taraf Google Cloud kodunun yanı sıra belirli üçüncü taraf kodlarıyla eğitilmiştir. Gemini'nin sunduğu kod tamamlama, oluşturma veya analizler dahil olmak üzere kodunuzun güvenliği, test edilmesi ve etkililiğinden siz sorumlusunuz.

Google'ın istemlerinizi nasıl işlediği hakkında daha fazla bilgi edinin.

3. İstemleri test etme seçenekleri

İstemleri test etmek için çeşitli seçenekleriniz vardır.

Vertex AI Studio

Vertex AI Studio, Google Cloud'un Vertex AI platformunun bir parçasıdır ve üretken yapay zeka modellerinin geliştirilmesini ve kullanımını basitleştirmek ve hızlandırmak için özel olarak tasarlanmıştır.

Google AI Studio

Google AI Studio, istem mühendisliği ve Gemini API ile prototip oluşturmak ve denemeler yapmak için web tabanlı bir araçtır.

Gemini web uygulaması (gemini.google.com)

Google Gemini web uygulaması (gemini.google.com), Google'ın Gemini yapay zeka modellerinin gücünü keşfetmenize ve kullanmanıza yardımcı olmak için tasarlanmış web tabanlı bir araçtır.

Android için Google Gemini mobil uygulaması ve iOS'teki Google uygulaması

4. Depoyu klonlama

Google Cloud Console'a dönün ve arama çubuğunun sağındaki simgeyi tıklayarak Cloud Shell'i etkinleştirin.

Açılan terminalde aşağıdaki komutları çalıştırın

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

cd genai-for-developers

git checkout slack-agent-jira-lab

"Düzenleyiciyi aç"ı tıklayın.

"File / Open Folder" menü öğesini kullanarak "genai-for-developers"u açın.

Yeni bir terminal açma

5. Hizmet Hesabı Oluşturma

Yeni bir hizmet hesabı oluşturun. Cloud Run uygulamasından Vertex AI Gemini API'ye API çağrıları yapmak için bu hizmet hesabını kullanacaksınız.

Qwiklabs proje ayrıntılarınızı kullanarak proje ayrıntılarını yapılandırın.

Örnek: qwiklabs-gcp-00-2c10937585bb

gcloud config set project YOUR_QWIKLABS_PROJECT_ID

Hizmet hesabı oluşturun ve roller verin.

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"

Yetki vermeniz istenirse devam etmek için "Yetkilendir"i tıklayın.

Vertex AI API'lerini ve Gemini sohbet uygulamasını kullanmak için gerekli hizmetleri etkinleştirin.

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

Vertex AI API'lerini ve Gemini sohbet uygulamasını kullanmak için gerekli hizmetleri etkinleştirin.

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

Kod açıklamaları için Gemini Code Assist'i kullanma

"devai-api/app/routes.py" dosyasını açın, ardından dosyanın herhangi bir yerinde sağ tıklayın ve bağlam menüsünden "Gemini Code Assist > Explain this""yi seçin.

Gemini'nin, seçili dosyayla ilgili açıklamasını inceleyin.

6. Devai-API'yi Cloud Run'a dağıtma

Doğru klasörde olduğunuzdan emin olun.

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

Bu laboratuvarda, en iyi uygulamaları uygulayarak Cloud Run'da erişim jetonu ve LangChain API anahtarı değerlerini depolamak ve referans vermek için Secret Manager'ı kullanırız.

Ortam değişkenlerini ayarlayın. Bu komutu herhangi bir değişiklik yapmadan olduğu gibi çalıştırın.

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"

Secret Manager'da birkaç gizli anahtar oluşturup depolayın.

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

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

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

Uygulamayı Cloud Run'a dağıtın.

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

Artifact Registry Docker deposu oluşturmak için Y cevabını verin.

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

Gemini'den komutu açıklamasını isteyin:

What does this command do?

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

Aşağıdaki gcloud run deploy SERVICE_NAME --source=. akışını inceleyin. Daha fazla bilgi edinin.

Bu komut, arka planda Google Cloud'un buildpacks ve Cloud Build özelliklerini kullanarak makinenize Docker yüklemenize veya buildpack'ler ya da Cloud Build'i ayarlamanıza gerek kalmadan kaynak kodunuzdan otomatik olarak container görüntüleri oluşturur. Yani yukarıda açıklanan tek komut, gcloud builds submit ve gcloud run deploy komutlarının gerektirdiği işlemleri yapar.

Dockerfile sağladıysanız(bu depoda sağladık) Cloud Build, container görüntülerini otomatik olarak algılayıp oluşturmak için buildpack'lere güvenmek yerine Dockerfile'i kullanır. Derleme paketleri hakkında daha fazla bilgi edinmek için dokümanlara göz atın.

Console'da Cloud Build günlüklerini inceleyin.

Oluşturulan Docker görüntüsünü Artifact Registry'de inceleyin.

Cloud Console'da Cloud Run örneği ayrıntılarını inceleyin.

curl komutunu çalıştırarak uç noktasını test edin.

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

Yanıt markdown biçiminde olacaktır. Daha iyi okunabilirlik için önizleme modunda gösterilir.

7. Vertex AI Agent Builder

"Agent Builder" dosyasını bulup açın.

API'leri etkinleştirme:

Conversational Agent uygulaması oluşturun:

Dialogflow API'yi etkinleştirme:

Projenizi seçin:

"Temsilci oluştur"u tıklayın:

"Kendinizi oluşturun"u seçin.

Görünen ad için "Temsilci" yazın ve "Oluştur"u tıklayın.

Oyun Kitabı adını ayarlayın:

Agent

Hedef belirleyin:

Help user with questions about JIRA project

Ayar Talimatları:

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

"Kaydet"i tıklayın:

Sağ taraftaki simülatör sohbetiyle müşteri temsilcisini test edin:

Fareyle sol taraftaki anahtar simgesinin üzerine gelin. Araçlar menüsünü açıp yeni bir araç oluşturun:

Tür açılır menüsünden OpenAPI'yi seçin.

Araç adını ayarlayın:

jira-project-status

Set açıklaması:

Provides JIRA project status

Şemayı ayarlayın (YAML) - CLOUD RUN URL'NİZİ değiştirin. Sekmelere geçin ve Cloud Run hizmet URL'si için konsol çıkışını kontrol edin.

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:

 /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:
               $ref: '#/components/schemas/ProjectStatus'
                  
components:
 schemas:
   Prompt:
     type: object
     required:
       - prompt
     properties:
       prompt:
         type: string
   ProjectStatus:
     type: object
     required:
       - message
     properties:
       message:
         type: string

Araç yapılandırmasını kaydedin:

Sol menüden "Oyun kitapları"nı seçerek temsilci yapılandırmasına dönün ve aracı kullanma talimatlarını güncelleyin:

Yeni aracı kullanma talimatlarını ekleyin ve "Kaydet"i tıklayın:

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

"Örnekler" sekmesine geçin ve yeni örnek ekleyin:

Görünen Adı Ayarlama:

jira-project-flow

Alttaki menüyü kullanarak kullanıcı ile müşteri temsilcisi arasındaki görüşmeyi modelleyin:

Örnek akış:

Müşteri temsilcisi yanıtı: Proje kimliği nedir?

Kullanıcı girişi: TEST-PROJECT-100

Araç kullanımı: jira-project-status

Müşteri temsilcisi yanıtı: Proje durumu ayrıntıları.

Örneği oluşturmak için aşağıdaki referansı kullanın.

Kaydet'i tıklayın. Temsilci simülatörüne dönüp akışı test edin. Mevcut sohbetleri sıfırlayın.

Tebrikler! Cloud Run'da dağıtılan API'ye bağlı araçları entegre ederek Temsilci'nin işlem gerçekleştirmesini başarıyla sağladınız.

Vertex AI Agents ile ilgili en iyi uygulamaları inceleyin.

Mevcut temsilci ayarlarını inceleme

Günlük kaydı ayarları - Cloud Logging'i etkinleştirme
Git entegrasyonu: Git entegrasyonu, aracınızı bir Git deposuna göndermenize ve depodan almanıza olanak tanır.
Üretken model seçimi
Jeton sınırları(giriş ve çıkış)

Temsilci simülasyon aracı kontrollerini inceleyin:

8. Slack Entegrasyonu

Entegrasyonlar menüsünü açın ve Slack kartında "Bağlan"ı tıklayın.

https://api.slack.com/apps adresinde bağlantıyı açıp yeni bir Slack uygulaması oluşturun.

"Manifest" bölümünden şunları seçin:

Uygulamanızı geliştirmek için bir çalışma alanı seçin

YAML'e geçin ve şu manifest dosyasını yapıştırın:

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

"Oluştur"u tıklayın:

Workspace'e yükleme:

"#general" kanalını seçin ve "İzin ver"i tıklayın.

"Temel Bilgiler / Uygulama Kimlik Bilgileri" bölümünde "İmza Gizli Anahtarı"nı kopyalayın ve Temsilcinin Slack entegrasyonunda "İmza Jetonu" alanının değeri olarak ayarlayın.

"OAuth ve İzinler"i açın, "Bot Kullanıcısı OAuth Jetonu"nu kopyalayın ve "Erişim jetonu" alanı için Temsilcinin Slack entegrasyonunda ayarlayın.

Zorunlu alanları ayarlayın ve "Başlat"ı tıklayın.

Temsilcinin "Erişim Jetonu " değeri, Slack'taki "Bot Kullanıcısı OAUth Jetonu"dur.

Temsilcinin "İmzalama Jetonu " değeri, Slack'taki "İmzalama Gizli Anahtarı"dır.

"Webhook URL'sini" kopyalayın ve Slack uygulama yapılandırmasına dönün.

"Etkinlik Abonelikleri" bölümünü açın ve URL'yi yapıştırın.

Değişiklikleri kaydedin.

"Slack"ı açın ve "@Agent" yazarak bir temsilci ekleyin.

Örneğin, "@CX" adlı bir uygulama ekleyebilirsiniz.

Temsilciden JIRA proje özetini isteyin.

Tebrikler! Temsilci, Slack çalışma alanına başarıyla entegre edildi.

9. PDF dokümanları hakkında soru-cevap

Bu bölümde, PDF dokümanı kullanarak veri deposu oluşturma ve bunu temsilciye bağlayarak dokümanın içeriğine göre soru-cevap işlevini etkinleştirme işlemleri açıklanmaktadır.

Cloud Storage paketi oluşturma

Cloud Shell'i açın: https://shell.cloud.google.com/

Paket adını, GCP projenizin son 5 hanesini kullanarak ayarlayın. Örnek: pdf-docs-3dw21

BUCKET_NAME=pdf-docs-LAST-5-DIGITS-OF-YOUR-PROJECT

Bir paket oluşturun ve PDF dokümanı yükleyin.

gcloud storage buckets create gs://$BUCKET_NAME \
    --location=us \
    --default-storage-class=STANDARD \
    --no-public-access-prevention \
    --uniform-bucket-level-access

wget https://services.google.com/fh/files/misc/exec_guide_gen_ai.pdf 

gsutil cp exec_guide_gen_ai.pdf gs://$BUCKET_NAME

Veri deposu yapılandırması

Temsilci Konsolu'na dönüp "Agent"yi açın, aşağı kaydırın ve "+ Data store"yi tıklayın.

Aşağıdaki değerleri kullanın:

Araç adı: pdf-docs

Tür: Data store

Açıklama: pdf-docs

"Save"yi tıklayın.

Sayfanın alt kısmındaki "Add data stores" simgesini tıklayın. Ardından "Create new data store"yi tıklayın.

Veri kaynağı olarak "Cloud Storage"yi seçin.

Seç: Unstructured documents

Ardından GCS paketinizi/klasörünüzü seçin.

Veri deposu konumu için "us"yi seçin.

Veri deposu adı için: "pdf-docs"

Açılır listeden "Digital parser"i seçin.

Gelişmiş parçalara ayırmayı etkinleştirin.

Üst öğe başlıklarını parçalar halinde etkinleştirin.

"Create" öğesini tıklayın.

Veri deposunu tıklayın ve Dokümanlar, Etkinlik ve İşleme Yapılandırması'nı inceleyin.

İçe aktarma işleminin tamamlanması yaklaşık 5-10 dakika sürer.

Ayrıştırma ve parçalara ayırma seçenekleri

İçerik ayrıştırmayı aşağıdaki yöntemlerle kontrol edebilirsiniz:

Dijital ayrıştırıcı. Farklı bir ayrıştırıcı türü belirtilmediği sürece dijital ayrıştırıcı tüm dosya türleri için varsayılan olarak açıktır. Dijital ayrıştırıcı, veri deposu için başka bir varsayılan ayrıştırıcı belirtilmemişse veya belirtilen ayrıştırıcı, beslenen bir dokümanın dosya türünü desteklemiyorsa beslenen dokümanları işler.
PDF'ler için OCR ayrıştırma. Herkese açık önizleme. Taranmış PDF'ler veya resimlerde metin bulunan PDF'ler yüklemeyi planlıyorsanız PDF dizine ekleme işlemini iyileştirmek için OCR ayrıştırıcıyı etkinleştirebilirsiniz. PDF'ler için OCR ayrıştırma hakkında başlıklı makaleyi inceleyin.
Düzen ayrıştırıcı. RAG için Vertex AI Search'i kullanmayı planlıyorsanız HTML, PDF veya DOCX dosyaları için düzen ayrıştırıcıyı etkinleştirin. Bu ayrıştırıcı ve nasıl etkinleştirileceği hakkında bilgi edinmek için RAG için belgeleri parçalara ayırma başlıklı makaleyi inceleyin.

Belgeleri ayrıştırma ve parçalara bölme hakkında daha fazla bilgi edinin.

Araç yapılandırması

Temsilcinin Aracı yapılandırma ekranına dönün ve mevcut veri depolarını yenileyin.

Yeni oluşturduğunuz veri deposunu seçin ve "Confirm" simgesini tıklayın.

Topraklama ayarlarını yapın.

Şirket adı için "Google Cloud" yazın.

Yük ayarları: "Include snippets in Conversational Messenger response payload""yi işaretleyin. Değeri 5 olarak ayarlayın.

"Kaydet"i tıklayın.

Temsilcinin talimatları yapılandırması

Temsilci yapılandırmasına dönün.

Yeni talimat ekleyin:

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

Yapılandırmayı kaydedin.

PDF-Dokümanlar aracı için örnek oluşturma

Örnekler sekmesine geçin. Yeni bir örnek oluşturun: Guide to generative AI

"+" işlemlerini kullanarak:

"Kullanıcı girişi"ni ekleyin:

What are the main capabilities for generative AI?

"Araç kullanımı"nı ekleyin.

Araç ve İşlem: "pdf-docs"

Giriş (requestBody)

{
  "query": "Main capabilities for generative AI",
  "filter": "",
  "userMetadata": {},
  "fallback": ""
}

Araç Çıkışı:

{
  "answer": "Detailed answer about main capabilities for generative AI",
  "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"
    }
  ]
}

"Müşteri temsilcisi yanıtı"nı ekleme

Detailed answer about main capabilities. 

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

Yapılandırılmış örnek:

Araç çağırma yapılandırması:

Yapılandırmayı test etmek için simülasyona geçin.

Soru:

What are the 10 steps in the exec guide?

Çağrımlar açılır menüsünden "Agent"i seçin ve "Save as example"i tıklayın.

"user-question-flow" adını girin.

Özet ayarı: "Agent helped user answer question based on the pdf document" ve Kaydet'i tıklayın.

Temsilcinin yanıtını biçimlendirin ve araç çıkışı bölümündeki PDF doküman bağlantısını ekleyin.

Örneği kaydedin.

Simülasyon aracına dönün ve "Replay conversation"yi tıklayın. Güncellenen yanıt biçimini kontrol edin. Örneği kaydettikten sonra hata görürseniz tarayıcı pencerenizi yenilemeniz ve istemi tekrar göndererek sohbeti yeniden başlatmanız gerekebilir:

What are the 10 steps in the exec guide?

Başka bir soru sorun:

What are the main capabilities in the exec guide?

Kaynak PDF dokümanı.

Soru:

What should I consider when evaluating projects?

Kaynak PDF dokümanı.

Soru:

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

Kaynak PDF dokümanı.

Tebrikler! Temsilci artık PDF dokümanlarına dayalı yanıtlar verebilir.

10. Önceden oluşturulmuş aracılar

Ardından, soldaki menüden önceden oluşturulmuş temsilcileri keşfedeceksiniz.

Temsilcilerden birini seçip dağıtın. Agent'ın kurulumunu, talimatlarını ve araçlarını keşfedin.

11. Tebrikler!

Tebrikler, laboratuvarı tamamladınız.

Ele aldığımız konular:

Conversational Agents'ı oluşturma ve dağıtma
Cloud Run uygulaması tarafından desteklenen aracı için araç ekleme
Temsilciyi Slack çalışma alanına entegre etme
PDF dokümanlarda soru-cevap için veri deposunu yapılandırma

Sıradaki adım:

Vertex AI Agents ile ilgili en iyi uygulamaları inceleyin.

Temizleme

Bu eğiticide kullanılan kaynaklar için Google Cloud hesabınızın ücretlendirilmesini istemiyorsanız kaynakları içeren projeyi silin veya projeyi saklayıp kaynakları tek tek silin.

Projeyi silme

Faturalandırılmanın önüne geçmenin en kolay yolu, eğitim için oluşturduğunuz projeyi silmektir.

Hata bildir