Агент GenAI для контроля качества документации и вызовов API

1. Обзор

В ходе этой лабораторной работы вы создадите агент GenAI, подключите его к приложению Cloud Run и интегрируете агент в рабочую область Slack.

8541c95a7fbc9be7.png

Что вы узнаете

Лаборатория состоит из нескольких основных частей:

  • Разверните приложение Cloud Run для интеграции с API Gemini.
  • Создание и развертывание агента Vertex AI.
  • Интегрируйте агент в 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 Console, чтобы использовать облачные ресурсы/API. Прохождение этой кодовой лаборатории не будет стоить много, если вообще что-то стоить. Чтобы отключить ресурсы и избежать выставления счетов за пределами этого руководства, вы можете удалить созданные вами ресурсы или удалить проект. Новые пользователи Google Cloud имеют право на участие в программе бесплатной пробной версии стоимостью 300 долларов США .

Настройка среды

Откройте чат Близнецов.

e1e9ad314691368a.png

Включите Cloud AI Companion API:

66cb6e561e384bbf.png

Нажмите « Start chatting » и ответьте на один из примеров вопросов или введите собственное приглашение, чтобы попробовать его.

5482c153eef23126.png

Предлагает попробовать:

  • Объясните Cloud Run в 5 ключевых моментах.
  • Вы являетесь менеджером по продукту Google Cloud Run и объясните студенту Cloud Run в 5 коротких ключевых моментах.
  • Вы являетесь менеджером по продукту Google Cloud Run и объясните Cloud Run сертифицированному разработчику Kubernetes в 5 коротких ключевых моментах.
  • Вы являетесь менеджером по продукту Google Cloud Run. Объясните старшему разработчику, когда вы будете использовать Cloud Run, а не GKE, в пяти кратких ключевых моментах.

Ознакомьтесь с Руководством по подсказкам, чтобы узнать больше о написании более эффективных подсказок.

Как Gemini для Google Cloud использует ваши данные

Обязательства Google по конфиденциальности

Google был одним из первых в отрасли, кто опубликовал обязательство по обеспечению конфиденциальности в области искусственного интеллекта и машинного обучения , в котором отражено наше убеждение в том, что клиенты должны иметь высочайший уровень безопасности и контроля над своими данными , хранящимися в облаке.

Данные, которые вы отправляете и получаете

Вопросы, которые вы задаете Gemini, включая любую входную информацию или код, который вы отправляете Gemini для анализа или завершения, называются подсказками. Ответы или дополнения кода, которые вы получаете от Gemini, называются откликами. Gemini не использует ваши подсказки или ответы в качестве данных для обучения своих моделей .

Шифрование подсказок

Когда вы отправляете запросы в Gemini, ваши данные при передаче шифруются и становятся входными данными для базовой модели в Gemini.

Данные программы, генерируемые Gemini

Gemini обучается на собственном коде Google Cloud, а также на выбранном стороннем коде. Вы несете ответственность за безопасность, тестирование и эффективность вашего кода , включая любое завершение, генерацию или анализ кода, которые предлагает вам Gemini.

Узнайте больше, как Google обрабатывает ваши запросы.

3. Варианты проверки подсказок

У вас есть несколько вариантов проверки подсказок.

Vertex AI Studio — это часть платформы Vertex AI от Google Cloud, специально разработанная для упрощения и ускорения разработки и использования генеративных моделей искусственного интеллекта.

Google AI Studio — это веб-инструмент для создания прототипов и экспериментов с быстрым проектированием и API Gemini.

Веб-приложение 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

Включите необходимые службы для использования API-интерфейсов Vertex AI и чата Gemini.

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

Включите необходимые службы для использования API-интерфейсов Vertex AI и чата 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

Нажмите на значок «Gemini», в правом нижнем углу нажмите « Sign-in » и « Select Google Cloud project ».

4a7f4640f66037f.png

8b4405d7366d2cad.png

бд07352707166136.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 для хранения и ссылки на значения токена доступа и ключа API LangChain в 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 в диспетчере секретов.

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

Сохраните токен доступа GitLab в диспетчере секретов.

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

Ответьте Y , чтобы создать репозиторий 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

Попросите Близнецов объяснить команду:

94d5487568b08dd2.png

Просмотрите gcloud run deploy SERVICE_NAME --source=. поток ниже. Узнать больше .

5c122a89dd11822e.png

За кулисами эта команда использует buildpacks Google Cloud и Cloud Build для автоматического создания образов контейнеров из вашего исходного кода без необходимости устанавливать Docker на ваш компьютер или настраивать пакеты сборки или Cloud Build. То есть одна описанная выше команда делает то, что в противном случае потребовало бы команд gcloud builds submit и команд gcloud run deploy .

Если вы предоставили Dockerfile (что мы и сделали в этом репозитории), Cloud Build будет использовать его для создания образов контейнеров, а не полагаться на пакеты сборки для автоматического обнаружения и создания образов контейнеров. Чтобы узнать больше о сборочных пакетах, ознакомьтесь с документацией .

Просмотрите журналы Cloud Build в консоли .

Просмотрите созданный образ Docker в реестре артефактов .

Откройте 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».

b99ae5b6ca1d6340.png

Активировать API

4bf2b240bd51db8.png

Создать приложение агента:

2e50007e454b504.png

Введите «Агент» в поле «Отображаемое имя» и нажмите «Принять и создать».

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

Протестируйте Агента с помощью чата эмулятора справа:

32f49a9791302535.png

Откройте меню «Инструменты» и создайте новый инструмент:

c236b95409dfedc3.png

Выберите OpenAPI в раскрывающемся списке «Тип».

Установить имя инструмента:

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

Перейдите на вкладку «Примеры» и добавьте новый пример:

5b1fb22e49500362.png

Установить отображаемое имя:

jira-project-flow

Используя меню внизу, смоделируйте разговор между пользователем и агентом:

54ffb5e7744a0772.png

14cced6461a65811.png

Конфигурация вызова инструмента:

82af695d2f21c4f0.png

Нажмите «Сохранить и отменить». Вернитесь в эмулятор агента и проверьте поток.

ec137f71bf6075e2.png

f76fd38c32e29f0a.png

Обзор лучших практик для агентов Vertex AI

Настройки агента

564dd5371999a3f1.png

b5b04f282fcee3e8.png

Настройки журналирования

af30487d72c1cfa2.png

Конфигурация модели.

53191049428693c7.png

Интеграция GitGub для отправки и восстановления конфигурации агента.

7170649a9c027857.png

Элементы управления эмулятором агента:

59fd8b2343e89513.png

8. Слабая интеграция

Откройте меню «Интеграции» и нажмите «Подключиться» на плитке 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

Установить в рабочую область:

аа1c2ea1b700c838.png

Выберите канал «#general» и нажмите «Разрешить».

18eba659946fc65f.png

В разделе «Основная информация/Учетные данные приложения» скопируйте «Секрет подписи» и установите его в интеграции со Slack.

31d62babb57e523d.png

bd9f7e3be3b9ea4e.png

Откройте «OAuth и разрешения», скопируйте «Токен пользователя Bot OAuth» и установите его в интеграции со Slack.

e74c7e003c31258.png

Задайте необходимые поля и нажмите «Начать».

Значением « Токена доступа » агента является «Токен OAUth пользователя бота» из Slack .

Значением « Токена подписи » агента является «Секрет подписи» от Slack.

a00d22bdaeed3ab8.png

7e71e37750fd063a.png

Скопируйте «URL-адрес веб-перехватчика» и вернитесь к настройке приложения Slack.

Откройте раздел «Подписки на мероприятия» и вставьте URL-адрес.

a1e7271934c714d9.png

Сохраните изменения.

e6d9b43b3787b6e7.png

Откройте «Slack» и добавьте агента, набрав «@Agent».

Например, добавив приложение с именем «@CX».

72313066707f947b.png

63becbd80824f8d8.png

c98e193062b096f0.png

Попросите у агента краткое описание проекта JIRA.

6edfdb74760548ad.png

9. Вопросы и ответы по PDF-документам

Создать сегмент облачного хранилища

Откройте GCS в облачной консоли: 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 », прокрутите вниз и нажмите « + Data store ».

e20b69db922e37d7.png

Используйте следующие значения:

Название инструмента: pdf-docs

Тип: Data store

Описание: pdf-docs

Нажмите « Save »

c5bc7a2e458213ba.png

Нажмите « Create a data store » внизу страницы.

Нажмите « AGREE », когда вас спросят: «Согласны ли вы, чтобы ваши хранилища данных поиска и разговоров находились в американском регионе?»

Введите « Google » в поле «Указать компанию».

На следующем экране нажмите « CREATE DATA STORE ».

В качестве источника данных выберите « Cloud Storage ».

Подготовьте данные для приема

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

Файлы HTML и TXT должны иметь размер 2,5 МБ или меньше.

Файлы PDF, PPTX и DOCX должны иметь размер 100 МБ или меньше.

Вы можете импортировать до 100 000 файлов одновременно.

Выберите: 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

Параметры синтаксического анализа и фрагментации

Управлять парсингом контента можно следующими способами:

  • Цифровой парсер. Цифровой анализатор включен по умолчанию для всех типов файлов, если не указан другой тип анализатора. Цифровой анализатор обрабатывает вставленные документы, если для хранилища данных не указан другой синтаксический анализатор по умолчанию или если указанный синтаксический анализатор не поддерживает тип файла вставленного документа.
  • OCR-парсинг PDF-файлов . Публичный предварительный просмотр. Если вы планируете загружать отсканированные PDF-файлы или PDF-файлы с текстом внутри изображений, вы можете включить анализатор OCR, чтобы улучшить индексацию PDF-файлов. См . раздел Об анализе OCR для PDF-файлов .
  • Парсер макетов. Публичный предварительный просмотр. Включите анализатор макета для файлов HTML, PDF или DOCX, если вы планируете использовать Vertex AI Search для RAG. См . документы Chunk для RAG для получения информации об этом парсере и о том, как его включить.

Узнайте больше о синтаксическом анализе и фрагментировании документов.

Конфигурация инструмента

Вернитесь на вкладку с настройкой инструментов.

Обновите браузер и выберите « pdf-docs » в раскрывающемся списке «Неструктурированные».

71323e788b35ca66.png

Настроить заземление.

Введите « Google » в качестве названия компании.

Настройки полезной нагрузки — установите флажок « 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

Перейдите на вкладку «Примеры». Создайте новый пример.

Используя действия « + »:

4da93695907c97ad.png

Добавьте «Пользовательский ввод»:

What are the main capabilities?

Добавьте «Использование инструмента».

  • Инструмент и действие: « pdf-docs »

Ввод (тело запроса)

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

Проверьте конфигурацию, отправив вопрос агенту в эмуляторе.

Вопрос:

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. Готовые агенты

Изучите готовые агенты в меню слева.

5720dc5343aede65.png

Выберите один из агентов и разверните его. Изучите настройку, инструкции и инструменты агента.

2a3db1129b5a1461.png

11. Поздравляем!

Поздравляем, вы закончили лабораторную работу!

Что мы рассмотрели:

  • Как развернуть приложение Cloud Run для интеграции с API Gemini
  • Как создать и развернуть агент Vertex AI
  • Как добавить интеграцию Slack для агента
  • Как настроить хранилище данных для вопросов и ответов в документах PDF

Что дальше:

Очистить

Чтобы избежать списания средств с вашей учетной записи Google Cloud за ресурсы, используемые в этом руководстве, либо удалите проект, содержащий ресурсы, либо сохраните проект и удалите отдельные ресурсы.

Удаление проекта

Самый простой способ избавиться от выставления счетов — удалить проект, созданный вами для этого руководства.

© Google LLC, 2024. Все права защищены. Google и логотип Google являются товарными знаками Google LLC. Все остальные названия компаний и продуктов могут быть товарными знаками соответствующих компаний, с которыми они связаны.