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

Предпосылки

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

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

В этом кратком руководстве вы сделаете следующее:

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

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

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

  1. Откройте консоль разработчика бизнес-коммуникаций .
  2. В разделе Деловые сообщения щелкните Создать учетную запись партнера .

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

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

  4. Прочтите и примите Условия предоставления услуг для деловых сообщений .

  5. Щелкните Создать .

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

Теперь у вас есть доступ к API-интерфейсам Business Messages и Business Communications.

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

  1. На домашней странице консоли разработчика Business Communications щелкните Параметры учетной записи партнера .
  2. На левой панели навигации нажмите Сервисный аккаунт .

  3. Щелкните Создать ключ , затем щелкните Создать .

    Ваш браузер загружает ключ сервисной учетной записи. Храните его в безопасном месте. Этот ключ понадобится вам позже для развертывания веб-приложения и доступа к API-интерфейсам Business Messages и Business Communications в будущем.

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

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

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

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

Изучите возможности с помощью бота Business Messages Helper Bot

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

Бот-помощник позволяет

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

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

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

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

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

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

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

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

Отключить бота-помощника

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

Чтобы отключить бота-помощника,

  1. Откройте консоль разработчика бизнес-коммуникаций .
  2. Выберите своего агента.
  3. На левой навигационной панели нажмите Интеграции .
  4. Для бота-помощника нажмите «Отключить ».

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

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

В этом руководстве вы развернете 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 Console .

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

  2. Щелкните Создать проект .

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

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

  4. Щелкните Создать .

  5. Щелкните Меню .

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

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

  8. Создайте новую учетную запись для выставления счетов или добавьте в проект существующую учетную запись для выставления счетов. Ознакомьтесь с возможностями программы Google Cloud Free , чтобы узнать о способах оплаты.

Развертывание образца Echo Bot

  1. Установите интерфейс командной строки 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

    Джава

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

    питон

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

    Джава

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

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

    питон

    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-адреса веб-перехватчика Business Messages щелкните Настроить .

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

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

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

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

    Когда Business Messages проверит ваш веб-перехватчик, диалоговое окно закроется.

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

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

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

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

  1. Откройте консоль разработчика бизнес-коммуникаций .
  2. На левой панели навигации щелкните Информация об агенте .

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

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

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

Начать разговор

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

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

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

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

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

Приветственное сообщение вашего агента приветствует вас. На этом этапе вы можете взаимодействовать с Эхо-ботом. Он повторяет сообщения, которые вы отправляете обратно к вам. Кроме того, вы можете вызывать расширенные функции, отправляя определенные строки: «карусель», «карта», «фишки».

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

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