Создайте своего первого агента

Предварительные требования

Создайте своего агента

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

В этом кратком руководстве вы выполните следующие действия:

  • Зарегистрируйтесь в качестве партнера
  • Создайте бренд и агента.
  • При желании вы можете изучить функции в диалоге с ботом-помощником для бизнес-сообщений.
  • Настройте своего агента для отправки и получения сообщений.

Чтобы создать агента без использования примера, см. раздел «Создание агента» .

Зарегистрируйтесь в качестве партнера

  1. Откройте консоль разработчика Business Communications .
  2. В разделе «Сообщения для бизнеса» нажмите «Создать партнерский аккаунт» .

  3. Введите информацию о вашем партнере:

    Поле Ценить
    Ваше имя Ваше полное имя
    Имя партнера Название вашей организации
    Партнерский сайт Веб-сайт вашей организации
    Область Регион, в котором вы хотите разместить службу деловых сообщений.

  4. Ознакомьтесь с условиями предоставления услуг по отправке деловых сообщений и примите их.

  5. Нажмите «Создать» .

Вы зарегистрированы как партнер Business Messages. Для вас создан новый проект Google Cloud с включенными API Business Messages и Business Communications. У вас нет доступа к этому проекту, и он не будет конфликтовать с вашими существующими проектами Google Cloud.

Теперь вам доступен API для деловых сообщений и деловой коммуникации.

Создайте учетную запись службы

  1. На главной странице консоли разработчика Business Communications нажмите «Настройки партнерской учетной записи» .
  2. В левой панели навигации нажмите «Учетная запись службы» .

  3. Нажмите «Создать ключ» , затем нажмите «Создать» .

    Ваш браузер загружает ключ учетной записи службы. Сохраните его в безопасном месте. Этот ключ понадобится вам позже для развертывания веб-приложения и доступа к API бизнес-сообщений и бизнес-коммуникаций.

Создайте бренд и агента.

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

  1. Откройте консоль разработчика Business Communications и войдите в систему, используя свою учетную запись Google Business Messages.
  2. Нажмите «Создать агента» .
  3. В поле «Тип агента» выберите «Деловые сообщения» .
  4. Введите значения для поля «Название бренда» и «Имя агента» .
  5. Выполните одно из следующих действий:
    • Чтобы начать диалог со своим агентом и ознакомиться с доступными функциями, выберите «Включить вспомогательного бота для бизнес-сообщений» .
    • Чтобы настроить агента и подготовить его к обработке сообщений, снимите флажок «Включить вспомогательного бота для бизнес-сообщений» .
  6. Нажмите «Создать агента» .

Если вы включили вспомогательного бота для бизнес-сообщений, вы можете начать разговор немедленно. В противном случае перейдите к настройке агента для обработки сообщений .

Изучите возможности бота-помощника для бизнес-сообщений.

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

Вспомогательный бот позволяет вам

  • Изучите расширенные возможности
  • Узнайте, как внедрять функции.
  • Найдите ресурсы для настройки агента.

Когда вспомогательный бот включен, он отправляет и получает сообщения для вашего агента; веб-перехватчик не требуется. Вам необходимо отключить вспомогательного бота, прежде чем вы сможете настроить веб-перехватчик или включить обработку сообщений пользователей в Dialogflow .

Начните разговор с ботом-помощником.

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

Для взаимодействия с ботом-помощником выполните следующие действия в этом диалоговом окне:

  1. Получите доступ к тестовым URL-адресам агента. Это можно сделать несколькими способами:

    • Нажмите кнопку Android или iOS . Затем отсканируйте QR-код соответствующим мобильным устройством и нажмите «Запустить» . В качестве альтернативы, нажмите «Скопировать URL для Android» или «Скопировать URL для iOS» , чтобы скопировать тестовый URL агента.
    • Нажмите «Отправить» , чтобы отправить URL-адреса на ваш адрес электронной почты.

  2. Откройте URL-адрес на своем мобильном устройстве. (Для устройств iOS требуется приложение Google Maps .)

Отключите вспомогательного бота.

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

Чтобы отключить вспомогательного бота,

  1. Откройте консоль разработчика Business Communications .
  2. Выберите своего агента.
  3. В левой панели навигации нажмите «Интеграции» .
  4. Чтобы включить вспомогательного бота , нажмите « Отключить» .

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

Настройте свой агент для обработки сообщений.

В этом руководстве вы развернете Echo Bot на платформе Google Cloud Platform (GCP) с веб-перехватчиком, предназначенным для обработки сообщений пользователей.

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

Вам необходимо выполнить следующие шаги:

  • Разверните пример Echo Bot в GCP.
  • Настройте URL-адрес веб-перехватчика для партнерской учетной записи Business Messages.
  • Предоставьте основную информацию о вашем агенте.

По завершении этого руководства ваш агент будет готов отправлять и получать сообщения.

Разверните веб-приложение в GCP.

Business Messages пересылает сообщения от пользователей на веб-перехватчик в вашей инфраструктуре. В этом руководстве вы развернете исходный код примера Echo Bot на предварительно настроенном веб-перехватчике. Если у вас уже есть веб-инфраструктура для приема сообщений, вы можете создать новый веб-перехватчик на этом веб-сервисе, но вам потребуется самостоятельно настроить логику. Подробнее см. раздел «Настройка веб-перехватчика партнерского уровня» .

Создайте облачную среду

Для развертывания примера Echo Bot вам потребуется облачная среда.

Для создания проекта GCP в облачной среде выполните следующие действия:

  1. Откройте окно выбора проекта в консоли Google Cloud .

    Если вы никогда не создавали проект в Google Cloud, вам необходимо принять Условия использования .

  2. Нажмите «Создать проект» .

  3. Введите название и местоположение для вашего нового проекта.

    • Идентификатор вашего проекта генерируется автоматически и отображается под названием вашего проекта.
    • В поле «Местоположение» нажмите «Обзор» , чтобы отобразить возможные места для вашего проекта. Если вы не можете найти свою организацию Google Workspace, значит, вы не вошли в учетную запись Google Workspace. Вы можете создать проект без организации, но некоторые функции будут ограничены. Дополнительную информацию см. в разделе «Преимущества организации» .

  4. Нажмите «Создать» .

  5. Нажмите Меню .

  6. Нажмите «Оплата» .

  7. Нажмите «Привязать платежный аккаунт» .

  8. Создайте новый платежный аккаунт или добавьте существующий платежный аккаунт к проекту. Подробнее о вариантах оплаты см. в разделе «Функции бесплатной программы Google Cloud» .

Разверните пример Echo Bot.

  1. Установите CLI gcloud . Он понадобится вам для развертывания примера кода в Google Cloud.

  2. Скачайте и распакуйте пример Echo Bot ( Node.js , Java , Python ).

  3. Скопируйте загруженный вами JSON-файл с учетными данными, полученный при создании учетной записи службы, в папку ресурсов примера и переименуйте его в "bm-agent-service-account-credentials.json". Путь к этому файлу с учетными данными зависит от загруженного вами примера.

    Node.js 

    ./bm-nodejs-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json

    Java 

    ./bm-java-echo-bot/full_sample/src/main/resources/bm-agent-service-account-credentials.json

    Python 

    ./bm-python-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json

  4. В терминале перейдите в каталог full_sample, в котором находится пример.

  5. Для развертывания примера выполните следующие команды в терминале:

    Node.js 

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

    PROJECT_ID — это идентификатор проекта, созданного вами в разделе «Создание облачной среды» . Идентификатор проекта отображается на панели мониторинга проекта в Google Cloud.

    Java 

    gcloud config set project PROJECT_ID
gcloud app create
mvn appengine:deploy

    PROJECT_ID — это идентификатор проекта, созданного вами в разделе «Создание облачной среды» . Идентификатор проекта отображается на панели мониторинга проекта в Google Cloud.

    Python 

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

    PROJECT_ID — это идентификатор проекта, созданного вами в разделе «Создание облачной среды» . Идентификатор проекта отображается на панели мониторинга проекта в Google Cloud.

  6. Обратите внимание на URL развернутого приложения в выводе последней команды. Это базовый URL вашего веб-перехватчика:

    Deployed service [default] to [https:// PROJECT_ID .appspot.com]

Настройте свой веб-перехватчик

Теперь, когда Echo Bot развернут, вам необходимо указать URL-адрес веб-перехватчика (который вы используете), чтобы начать получать сообщения .

  1. Откройте настройки учетной записи в консоли разработчика Business Communications.
  2. Убедитесь, что выбран правильный партнерский аккаунт.
  3. Для указания URL-адреса веб-перехватчика для бизнес-сообщений нажмите «Настроить» .

  4. В поле URL конечной точки веб-перехватчика введите URL вашего приложения + "/callback".

    Ваша конечная точка будет иметь следующий формат: "https:// PROJECT_ID .appspot.com/callback".

    Эта конечная точка предопределена в логике приложения, развернутого вами в GCP.

  5. В консоли разработчика нажмите «Проверить» .

    После подтверждения вашего веб-перехватчика системой Business Messages диалоговое окно закрывается.

Чтобы настроить веб-перехватчик с помощью API бизнес-коммуникаций, см. Пример: Обновление URL-адреса веб-перехватчика .

Вы можете использовать тестовую среду Business Messages , чтобы проверить, успешно ли ваш веб-хук реагирует на данные, передаваемые через Business Messages.

Введите информацию об агенте

Предоставьте основную информацию для завершения настройки вашего агента.

  1. Откройте консоль разработчика Business Communications .
  2. В левой панели навигации нажмите «Информация об агенте» .

  3. Измените значения по своему усмотрению или воспользуйтесь следующими рекомендациями:

    Поле Ценить
    Приветственное сообщение Добро пожаловать в беседу с Echo Bot!
    Политика конфиденциальности https://policies.google.com/privacy

  4. Нажмите « Сохранить ».

Начните разговор

Для взаимодействия с Echo Bot выполните следующие действия:

  1. Откройте консоль разработчика Business Communications .
  2. В левой панели навигации нажмите «Информация об агенте» .
  3. В разделе «URL-адреса для тестирования агента» нажмите кнопку Android или кнопку iOS .

  4. Отсканируйте QR-код соответствующим мобильным устройством или нажмите «Скопировать URL для Android» или «Скопировать URL для iOS» , чтобы скопировать тестовый URL агента.

    Вы также можете нажать кнопку «Отправить» , чтобы отправить URL-адреса на свой адрес электронной почты.

  5. Откройте URL-адрес на своем мобильном устройстве. (Для устройств iOS требуется приложение Google Maps .)

Вас встречает приветственное сообщение от вашего агента. На этом этапе вы можете взаимодействовать с Echo Bot. Он повторяет отправленные вами сообщения. Кроме того, вы можете активировать расширенные функции, отправляя определенные строки: «carousel», «card», «chips».

Следующие шаги

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