نماینده GenAI برای QA بر روی اسناد و تماس‌های API

1. بررسی اجمالی

در این آزمایشگاه، یک GenAI Agent ایجاد می‌کنید، آن را به برنامه Cloud Run متصل می‌کنید و عامل را در فضای کاری Slack ادغام می‌کنید.

8541c95a7fbc9be7.png

آنچه خواهید آموخت

چندین بخش اصلی در آزمایشگاه وجود دارد:

  • برنامه Cloud Run را برای ادغام با API های Gemini اجرا کنید
  • ایجاد و استقرار Vertex AI Agent
  • Agent را در Slack ادغام کنید
  • ذخیره داده را برای پرسش و پاسخ روی اسناد PDF پیکربندی کنید

پیش نیازها

  • این آزمایشگاه آشنایی با محیط های Cloud Console و Cloud Shell را فرض می کند.

2. راه اندازی و الزامات

راه اندازی پروژه ابری

  1. به Google Cloud Console وارد شوید و یک پروژه جدید ایجاد کنید یا از یک موجود استفاده مجدد کنید. اگر قبلاً یک حساب Gmail یا Google Workspace ندارید، باید یک حساب ایجاد کنید .

fbef9caa1602edd0.png

a99b7ace416376c4.png

5e3ff691252acf41.png

  • نام پروژه نام نمایشی برای شرکت کنندگان این پروژه است. این یک رشته کاراکتری است که توسط API های Google استفاده نمی شود. همیشه می توانید آن را به روز کنید.
  • شناسه پروژه در تمام پروژه‌های Google Cloud منحصربه‌فرد است و تغییرناپذیر است (پس از تنظیم نمی‌توان آن را تغییر داد). Cloud Console به طور خودکار یک رشته منحصر به فرد تولید می کند. معمولاً برای شما مهم نیست که چیست. در اکثر کدها، باید شناسه پروژه خود را ارجاع دهید (معمولاً با نام PROJECT_ID شناخته می شود). اگر شناسه تولید شده را دوست ندارید، ممکن است یک شناسه تصادفی دیگر ایجاد کنید. از طرف دیگر، می‌توانید خودتان را امتحان کنید، و ببینید آیا در دسترس است یا خیر. پس از این مرحله نمی توان آن را تغییر داد و در طول مدت پروژه باقی می ماند.
  • برای اطلاع شما، یک مقدار سوم وجود دارد، یک شماره پروژه ، که برخی از API ها از آن استفاده می کنند. در مورد هر سه این مقادیر در مستندات بیشتر بیاموزید.
  1. در مرحله بعد، برای استفاده از منابع Cloud/APIها باید صورتحساب را در کنسول Cloud فعال کنید . اجرا کردن از طریق این کد لبه هزینه زیادی نخواهد داشت. برای خاموش کردن منابع برای جلوگیری از تحمیل صورت‌حساب فراتر از این آموزش، می‌توانید منابعی را که ایجاد کرده‌اید حذف کنید یا پروژه را حذف کنید. کاربران جدید Google Cloud واجد شرایط برنامه آزمایشی رایگان 300 دلاری هستند.

راه اندازی محیط

چت Gemini را باز کنید.

e1e9ad314691368a.png

فعال کردن Cloud AI Companion API:

66cb6e561e384bbf.png

روی " Start chatting " کلیک کنید و یکی از نمونه سوالات را دنبال کنید یا درخواست خود را تایپ کنید تا آن را امتحان کنید.

5482c153eef23126.png

درخواست برای امتحان کردن:

  • Cloud Run را در 5 نکته کلیدی توضیح دهید.
  • شما مدیر محصول Google Cloud Run هستید، Cloud Run را در 5 نکته کلیدی کوتاه برای دانش آموز توضیح دهید.
  • شما مدیر محصول Google Cloud Run هستید، در 5 نکته کلیدی کوتاه، Cloud Run را به یک توسعه دهنده معتبر Kubernetes توضیح دهید.
  • شما مدیر محصول Google Cloud Run هستید، در 5 نکته کلیدی کوتاه توضیح دهید که چه زمانی از Cloud Run در مقابل GKE استفاده می کنید.

برای کسب اطلاعات بیشتر در مورد نوشتن دستورات بهتر ، راهنمای درخواست را بررسی کنید.

Gemini for Google Cloud چگونه از داده های شما استفاده می کند

تعهد حریم خصوصی Google

Google یکی از اولین شرکت‌هایی در این صنعت بود که تعهد حفظ حریم خصوصی AI/ML را منتشر کرد، که این اعتقاد ما را نشان می‌دهد که مشتریان باید بالاترین سطح امنیت و کنترل را بر داده‌های ذخیره‌شده در ابر داشته باشند.

داده هایی که ارسال و دریافت می کنید

به سؤالاتی که از Gemini می‌پرسید، از جمله اطلاعات ورودی یا کدی که برای تجزیه و تحلیل یا تکمیل به Gemini ارسال می‌کنید، درخواست‌ها گفته می‌شود. پاسخ ها یا تکمیل کدهایی که از جمینی دریافت می کنید، پاسخ نامیده می شوند. Gemini از دستورات یا پاسخ های شما به عنوان داده برای آموزش مدل های خود استفاده نمی کند .

رمزگذاری دستورات

هنگامی که درخواست‌هایی را به Gemini ارسال می‌کنید، داده‌های شما در حین انتقال به عنوان ورودی مدل اصلی در Gemini رمزگذاری می‌شوند .

داده های برنامه تولید شده از Gemini

Gemini روی کدهای Google Cloud شخص اول و همچنین کدهای شخص ثالث منتخب آموزش دیده است. شما مسئول امنیت، آزمایش و اثربخشی کد خود هستید ، از جمله هر گونه تکمیل، تولید یا تجزیه و تحلیل کدی که Gemini به شما ارائه می دهد.

بیشتر بیاموزید که چگونه Google با درخواست‌های شما برخورد می‌کند.

3. گزینه هایی برای آزمایش فرمان ها

شما چندین گزینه برای آزمایش دستورات دارید.

Vertex AI Studio بخشی از پلتفرم Vertex AI Google Cloud است که به طور خاص برای ساده سازی و تسریع توسعه و استفاده از مدل های هوش مصنوعی مولد طراحی شده است.

Google AI Studio یک ابزار مبتنی بر وب برای نمونه سازی و آزمایش با مهندسی سریع و Gemini API است.

برنامه وب Google Gemini (gemini.google.com) یک ابزار مبتنی بر وب است که برای کمک به شما در کشف و استفاده از قدرت مدل‌های هوش مصنوعی Gemini Google طراحی شده است.

4. مخزن را شبیه سازی کنید

به Google Cloud Console برگردید و Cloud Shell را با کلیک بر روی نماد سمت راست نوار جستجو فعال کنید.

3e0c761ca41f315e.png

در ترمینال باز شده، دستورات زیر را اجرا کنید

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

cd genai-for-developers

git checkout slack-agent-jira-lab

روی "باز کردن ویرایشگر" کلیک کنید

63e838aebfdd2423.png

با استفاده از آیتم منوی " File / Open Folder "، " genai-for-developers " را باز کنید.

e3b9bd9682acf539.png

یک ترمینال جدید باز کنید

62dccf5c78880ed9.png

5. ایجاد حساب خدمات

یک حساب سرویس و کلیدهای جدید ایجاد کنید.

از این حساب سرویس برای برقراری تماس های API با Vertex AI Gemini API از برنامه Cloud Run استفاده خواهید کرد.

جزئیات پروژه را با استفاده از جزئیات پروژه qwiklabs خود پیکربندی کنید.

مثال: qwiklabs-gcp-00-2c10937585bb

gcloud config set project YOUR_QWIKLABS_PROJECT_ID

حساب سرویس ایجاد کنید و نقش‌های اعطا کنید.

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

اگر از شما خواسته شد که مجوز دهید، برای ادامه روی "مجوز" کلیک کنید.

6356559df3eccdda.png

برای استفاده از Vertex AI API و Gemini، سرویس های مورد نیاز را فعال کنید.

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

برای استفاده از Vertex AI API و 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

Gemini Code Assist را فعال کنید

روی نماد "Gemini" کلیک کنید، در گوشه سمت راست پایین، روی " Sign-in " و " Select Google Cloud project " کلیک کنید.

4a7f4640f66037f.png

8b4405d7366d2cad.png

bd07352707166136.png

از پنجره بازشو، پروژه qwiklabs خود را انتخاب کنید.

مثال:

70ae6837db397e2a.png

فایل " devai-api/app/routes.py " را باز کنید و سپس در هر نقطه از فایل کلیک راست کرده و " Gemini Code Assist > Explain this" را از منوی زمینه انتخاب کنید.

e54daef175df3cf0.png

توضیحات Gemini را برای فایل انتخابی مرور کنید.

e666676dce8b94d6.png

6. Devai-API را در Cloud Run اجرا کنید

بررسی کنید که در پوشه مناسب هستید.

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

برای این آزمایشگاه، ما بهترین شیوه‌ها را دنبال می‌کنیم و از Secret Manager برای ذخیره و ارجاع به Access Token و LangChain API Key در Cloud Run استفاده می‌کنیم.

تنظیم متغیرهای محیطی

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"

رمز دسترسی JIRA را در Secret Manager ذخیره کنید.

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

رمز دسترسی GitLab را در Secret Manager ذخیره کنید.

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

کلید API LangChain را در مدیر مخفی ذخیره کنید.

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

استقرار برنامه در 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

برای ایجاد مخزن Artifact Registry Docker به Y پاسخ دهید.

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 بخواهید دستور را توضیح دهد:

94d5487568b08dd2.png

gcloud run deploy SERVICE_NAME --source=. جریان زیر بیشتر بدانید .

5c122a89dd11822e.png

در پشت صحنه، این دستور buildpacks های Google Cloud و Cloud Build برای ساخت خودکار تصاویر کانتینر از کد منبع شما بدون نیاز به نصب Docker بر روی دستگاه یا تنظیم buildpacks یا Cloud Build استفاده می کند. یعنی فرمان واحدی که در بالا توضیح داده شد، کاری را انجام می دهد که در غیر این صورت gcloud builds submit و دستورات gcloud run deploy نیاز دارد.

اگر Dockerfile را ارائه کرده‌اید (که ما در این مخزن انجام دادیم)، Cloud Build از آن برای ساخت تصاویر کانتینر در مقابل تکیه بر بسته‌های ساخت برای شناسایی و ساخت خودکار تصاویر کانتینر استفاده می‌کند. برای کسب اطلاعات بیشتر در مورد buildpack ها، مستندات را بررسی کنید.

گزارش‌های Cloud Build را در کنسول مرور کنید.

تصویر داکر ایجاد شده را در آرتیفکت رجیستری بررسی کنید.

cloud-run-source-deploy/devai-api را باز کنید و آسیب پذیری هایی را که به طور خودکار شناسایی شده اند بررسی کنید. مواردی را که دارای رفع مشکل هستند بررسی کنید و ببینید که چگونه می توان بر اساس توضیحات آن را برطرف کرد.

d00c9434b511be44.png

جزئیات نمونه Cloud Run را در Cloud Console مرور کنید.

نقطه پایانی را با اجرای دستور curl تست کنید.

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

خروجی بررسی:

bda86deaa1c449a8.png

7. Vertex AI Agent Builder

"Agent Builder" را جستجو کرده و باز کنید.

b99ae5b6ca1d6340.png

API ها را فعال کنید

4bf2b240bd51db8.png

ایجاد اپلیکیشن عامل:

2e50007e454b504.png

برای نمایش نام، "Agent" را تایپ کنید و روی "Agree & Create" کلیک کنید.

6c49a874c48d0401.png

تنظیم نام نماینده:

Agent

تعیین هدف:

Help user with questions about JIRA project

دستورات تنظیم:

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

روی "ذخیره" کلیک کنید:

6ef0ca47100008e0.png

Agent را با استفاده از چت شبیه ساز در سمت راست آزمایش کنید:

32f49a9791302535.png

منوی Tools را باز کنید و یک ابزار جدید ایجاد کنید:

c236b95409dfedc3.png

OpenAPI از منوی کشویی Type انتخاب کنید.

تنظیم نام ابزار:

jira-project-status

توضیحات مجموعه:

Returns JIRA project status

طرحواره (YAML) را تنظیم کنید - URL اجرای ابری خود را جایگزین کنید.

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

پیکربندی ابزار را ذخیره کنید:

f99ce79ba79e3a4b.png

برای استفاده از ابزار، به پیکربندی عامل برگردید و دستورالعمل‌های به‌روزرسانی کنید:

دستورالعمل ها را برای استفاده از ابزار جدید اضافه کنید:

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

4dabf135b37b044b.png

به تب Examples بروید و مثال جدیدی اضافه کنید:

5b1fb22e49500362.png

تنظیم نام نمایشی:

jira-project-flow

با استفاده از منوی پایین، مکالمه بین کاربر و نماینده را مدل کنید:

54ffb5e7744a0772.png

14cced6461a65811.png

پیکربندی فراخوانی ابزار:

82af695d2f21c4f0.png

روی ذخیره و لغو کلیک کنید. به شبیه ساز Agent برگردید و جریان را تست کنید.

ec137f71bf6075e2.png

f76fd38c32e29f0a.png

بهترین روش ها را برای Vertex AI Agents مرور کنید

تنظیمات نماینده

564dd5371999a3f1.png

b5b04f282fcee3e8.png

تنظیمات ثبت نام

af30487d72c1cfa2.png

پیکربندی مدل

53191049428693c7.png

ادغام GitGub برای فشار دادن و بازیابی پیکربندی Agent.

7170649a9c027857.png

کنترل های شبیه ساز عامل:

59fd8b2343e89513.png

8. Slack Integration

منوی Integrations را باز کنید و روی "Connect" در کاشی Slack کلیک کنید.

36f3992134479a37.png

e7ee0826668bfa2b.png

c3e36f4dacbe3f9b.png

پیوند را باز کنید و یک برنامه Slack جدید در https://api.slack.com/apps ایجاد کنید

cbf13edc1b284899.png

از "مانیفست" انتخاب کنید:

64fa9c75afecdb3e.png

یک فضای کاری برای توسعه برنامه خود انتخاب کنید

99a3d5b37cdf8f76.png

به YAML بروید و این مانیفست را جای‌گذاری کنید:

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

روی "ایجاد" کلیک کنید:

5f0b3d2c44022eb9.png

نصب در Workspace:

aa1c2ea1b700c838.png

کانال "#عمومی" را انتخاب کنید و روی "اجازه دادن" کلیک کنید.

18eba659946fc65f.png

در بخش «اطلاعات اولیه / اعتبار برنامه» - «Signing Secret» را کپی کنید و آن را در Slack ادغام کنید.

31d62babb57e523d.png

bd9f7e3be3b9ea4e.png

"OAuth & Permissions" را باز کنید و "Bot User OAuth Token" را کپی کنید و آن را در Slack integration قرار دهید.

e74c7e003c31258.png

فیلدهای مورد نیاز را تنظیم کنید و روی "شروع" کلیک کنید.

مقدار " Access Token " عامل "Bot User OAUth Token" از Slack است.

مقدار " Signing Token " نماینده ، "Signing Secret" از Slack است.

a00d22bdaeed3ab8.png

7e71e37750fd063a.png

«URL Webhook» را کپی کنید و به پیکربندی برنامه Slack برگردید.

بخش «اشتراک‌های رویداد» را باز کرده و آدرس اینترنتی را جای‌گذاری کنید.

a1e7271934c714d9.png

تغییرات را ذخیره کنید.

e6d9b43b3787b6e7.png

"Slack" را باز کنید و با تایپ کردن "Agent@" یک نماینده اضافه کنید.

به عنوان مثال، اضافه کردن یک برنامه با نام "@CX".

72313066707f947b.png

63becbd80824f8d8.png

c98e193062b096f0.png

از نماینده خلاصه پروژه JIRA را بخواهید.

6edfdb74760548ad.png

9. پرسش و پاسخ بر روی اسناد PDF

ایجاد سطل ذخیره سازی ابری

GCS را در Cloud Console باز کنید: https://console.cloud.google.com/storage/browser

یک سطل جدید ایجاد کنید.

برای نوع نام سطل: " pdf-docs " + 5 رقم آخر پروژه GCP شما.

نوع مکان: multi-region, us .

کلاس ذخیره سازی: Standard

کنترل دسترسی: Uniform

حفاظت از داده ها: uncheck soft delete policy

روی " Create " کلیک کنید.

"دسترسی عمومی جلوگیری خواهد شد" را تأیید کنید.

گزارش PDF را دانلود کرده و در سطل آپلود کنید. https://services.google.com/fh/files/misc/exec_guide_gen_ai.pdf

سطل با نمای فایل آپلود شده:

ff09ac8da88fb680.png

پیکربندی ذخیره اطلاعات

به Agent Console برگردید و " Agent " را باز کنید، به پایین بروید و روی " + Data store " کلیک کنید.

e20b69db922e37d7.png

از مقادیر زیر استفاده کنید:

نام ابزار: pdf-docs

نوع: Data store

توضیحات: pdf-docs

روی " Save " کلیک کنید

c5bc7a2e458213ba.png

روی « Create a data store » در پایین صفحه کلیک کنید.

هنگامی که AGREE شما در مورد "آیا موافقت می کنید که ذخیره داده های جستجو و مکالمه شما در منطقه ایالات متحده باشد؟"

" Google " را در قسمت "Provide Company" تایپ کنید.

در صفحه بعدی، روی " CREATE DATA STORE " کلیک کنید.

" Cloud Storage " را به عنوان منبع داده انتخاب کنید.

داده ها را برای بلع آماده کنید

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

فایل های HTML و TXT باید 2.5 مگابایت یا کوچکتر باشند.

فایل های PDF، PPTX و DOCX باید 100 مگابایت یا کوچکتر باشند.

شما می توانید تا 100000 فایل را همزمان وارد کنید.

انتخاب کنید: unstructured documents

و سطل/پوشه GCS خود را انتخاب کنید.

e8534a921059e3a2.png

روی ادامه کلیک کنید: ed5ad1fabe9503a4.png

برای نام فروشگاه داده نوع: " pdf-docs "

از منوی کشویی " Digital parser " را انتخاب کنید.

قطعه سازی پیشرفته را فعال کنید.

سرفصل های نیاکان را به صورت تکه فعال کنید.

روی " Create " کلیک کنید.

1a5222b86ee6c58e.png

3119b5fec43c9294.png

ذخیره داده را انتخاب کنید و روی " Create " کلیک کنید

43d5be0a0aca6f8.png

9fd7fc7c1462d114.png

روی ذخیره داده کلیک کنید و اسناد، فعالیت و پیکربندی پردازش را بررسی کنید.

872d9142615e90c9.png

تکمیل واردات حدود 5-10 دقیقه طول می کشد.

d9739a4af2244e03.png

گزینه های Parsing و Chunking

شما می توانید تجزیه محتوا را به روش های زیر کنترل کنید:

  • تجزیه کننده دیجیتال تجزیه کننده دیجیتال به طور پیش فرض برای همه انواع فایل روشن است مگر اینکه نوع تجزیه کننده متفاوتی مشخص شده باشد. اگر تجزیه‌کننده پیش‌فرض دیگری برای ذخیره‌سازی داده‌ها مشخص نشده باشد یا اگر تجزیه‌کننده مشخص‌شده از نوع فایل یک سند دریافت‌شده پشتیبانی نکند، تجزیه‌کننده دیجیتال اسناد دریافت‌شده را پردازش می‌کند.
  • تجزیه OCR برای فایل های PDF . پیش نمایش عمومی اگر قصد دارید فایل‌های پی‌دی‌اف اسکن شده یا پی‌دی‌اف‌های حاوی متن داخل تصاویر را آپلود کنید، می‌توانید تجزیه‌کننده OCR را برای بهبود فهرست‌سازی PDF روشن کنید. درباره تجزیه OCR برای فایل های PDF رجوع کنید.
  • تجزیه کننده چیدمان پیش نمایش عمومی اگر می‌خواهید از Vertex AI Search برای RAG استفاده کنید، تجزیه‌کننده طرح‌بندی فایل‌های HTML، PDF یا DOCX را روشن کنید. برای اطلاعات در مورد این تجزیه کننده و نحوه روشن کردن آن ، به اسناد تکه برای RAG مراجعه کنید.

درباره تجزیه و تجزیه اسناد بیشتر بدانید.

پیکربندی ابزار

به تب با پیکربندی ابزارها برگردید.

مرورگر را بازخوانی کنید و " pdf-docs " را از منوی کشویی Unstructured انتخاب کنید.

71323e788b35ca66.png

پیکربندی زمین

برای نام شرکت " Google " را تایپ کنید.

تنظیمات Payload - " Include snippets in the response payload " را علامت بزنید

b0cb701d13ad4264.png

روی " Save " کلیک کنید.

91a546957bdfe029.png

7535b85cfc7febe6.png

پیکربندی دستورالعمل های عامل

به پیکربندی نماینده بازگردید.

افزودن دستورالعمل جدید:

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

9b9548497ddaccbd.png

ذخیره پیکربندی

یک مثال برای ابزار PDF-Docs ایجاد کنید

به تب Examples بروید. یک مثال جدید ایجاد کنید.

استفاده از اقدامات " + ":

4da93695907c97ad.png

"ورودی کاربر" را اضافه کنید:

What are the main capabilities?

"استفاده از ابزار" را اضافه کنید.

  • ابزار و اقدام: " pdf-docs "

ورودی (RequestBody)

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

خروجی ابزار:

{
  "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"
    }
  ]
}

افزودن "پاسخ نماینده"

Detailed answer about main capabilities. 

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

مثال پیکربندی شده:

2968363e05f3325e.png

پیکربندی فراخوانی ابزار:

658316bb29ac352d.png

پیکربندی را با ارسال یک سوال به Agent در شبیه ساز تست کنید.

سوال:

What are the 10 steps in the exec guide?

5b2329c494ad0d17.png

" Agent " را انتخاب کرده و روی " Save example " کلیک کنید.

e79c86aa04a9572f.png

یک نام " user-question-flow " وارد کنید و ذخیره کنید.

پاسخ عامل را قالب بندی کنید و پیوند به سند pdf را از بخش خروجی ابزار اضافه کنید.

50f2bcee082ac38d.png

مثال را ذخیره کنید.

به شبیه ساز برگردید و روی " Replay conversation " کلیک کنید. قالب پاسخ به روز شده را بررسی کنید.

8db40e424f448a2d.png

یه سوال دیگه بپرس:

What are the main capabilities in the exec guide?

6f103fdac8ec4cda.png

منبع سند PDF

5b3e6d2ceda99247.png

سوال:

What should I consider when evaluating projects?

ec7e0f5884772385.png

منبع سند PDF

57a0d331aa91f04b.png

سوال:

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

7a18ba3ca0fe90c5.png

منبع سند PDF

b4d07e6e7d9adc00.png

10. عوامل از پیش ساخته شده

Agents از پیش ساخته شده را از منوی سمت چپ کاوش کنید.

5720dc5343aede65.png

یکی از عوامل را انتخاب کنید و آن را مستقر کنید. تنظیمات، دستورالعمل ها و ابزارهای Agent را کاوش کنید.

2a3db1129b5a1461.png

11. تبریک!

تبریک می گویم، شما آزمایشگاه را تمام کردید!

آنچه ما پوشش داده ایم:

  • نحوه استقرار برنامه Cloud Run برای ادغام با API های Gemini
  • نحوه ایجاد و استقرار Vertex AI Agent
  • چگونه یکپارچه سازی Slack را برای Agent اضافه کنیم
  • نحوه پیکربندی ذخیره داده برای پرسش و پاسخ از طریق اسناد PDF

بعدش چیه:

پاک کن

برای جلوگیری از تحمیل هزینه به حساب Google Cloud خود برای منابع استفاده شده در این آموزش، یا پروژه حاوی منابع را حذف کنید یا پروژه را نگه دارید و منابع فردی را حذف کنید.

حذف پروژه

ساده ترین راه برای حذف صورتحساب، حذف پروژه ای است که برای آموزش ایجاد کرده اید.

©2024 Google LLC همه حقوق محفوظ است. Google و لوگوی Google علائم تجاری Google LLC هستند. همه نام‌های شرکت و محصولات دیگر ممکن است علائم تجاری شرکت‌های مربوطه باشند که با آنها مرتبط هستند.