Создайте приложение Google Chat Dialogflow CX, которое понимает естественный язык и отвечает на него.

На этой странице объясняется, как создать приложение Google Chat, которое может понимать естественный язык и отвечать на него, используя Dialogflow . В этом руководстве используется Dialogflow CX , который имеет прямую интеграцию с Google Chat. Вы также можете использовать Dialogflow ES для создания приложения Google Chat Dialogflow ES, следуя руководству Dialogflow ES Google Chat .

Например, рассмотрим приложение чата, которое помогает людям арендовать автомобили. Пользователь может написать: «Я хотел бы арендовать автомобиль». Приложение чата может ответить вопросом типа «Где вы хотите забрать автомобиль?» который начинает человеческий разговор с пользователем, в котором приложение чата одновременно понимает и отвечает человеческой речью при бронировании аренды автомобиля.

Это всего лишь один пример. Приложения Dialogflow Chat полезны во всех видах взаимодействия. Если для этого требуется естественная человеческая речь, требуется приложение Dialogflow Chat. Готовые агенты помогут вам быстро приступить к работе и продемонстрируют возможности Dialogflow, например:

• Забронировать авиабилеты
• Записаться на прием к врачу
• Заказать доставку еды
• Отвечайте на вопросы о каталоге розничной продукции, например, доступны ли товары в других цветах.

Цели

• Настройте свою среду.
• Создайте и разверните агент Dialogflow CX.
• Создайте и разверните приложение чата на базе агента Dialogflow CX.
• Протестируйте приложение Чат.

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

• Аккаунт Google Workspace для бизнеса или предприятия с доступом к Google Chat .
• Проект Google Cloud с включенной оплатой. Чтобы проверить, включена ли оплата для существующего проекта, см. раздел Проверка статуса выставления счетов ваших проектов . Инструкции по созданию проекта и настройке оплаты см. в разделе Создание проекта Google Cloud .

Архитектура

На следующей схеме показана архитектура приложения Chat, созданного с помощью Dialogflow:

На предыдущей диаграмме пользователь, взаимодействующий с приложением Dialogflow Chat, имеет следующий поток информации:

1. Пользователь отправляет сообщение в Chat в приложение Chat либо в прямом сообщении, либо в чат-группе.
2. Виртуальный агент Dialogflow, расположенный в Google Cloud, получает и обрабатывает сообщение для получения ответа.
3. При желании, используя вебхук Dialogflow , агент Dialogflow может взаимодействовать с внешними сторонними сервисами, такими как система управления проектами или инструмент для продажи билетов.
4. Агент Dialogflow отправляет ответ обратно в службу приложения Chat.
5. Ответ доставляется в чат.

Настройте среду

1. В консоли Google Cloud включите API Google Chat и API Dialogflow.

   Включите API

2. Убедитесь, что вы включаете API в правильном облачном проекте, затем нажмите «Далее» .

3. Убедитесь, что вы включаете правильные API, затем нажмите « Включить» .

Создайте агент Dialogflow CX

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

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

Вот как создать агент Dialogflow CX:

1. В консоли Dialogflow CX откройте консоль Dialogflow CX. Нажмите Меню > Dialogflow CX menu

   Перейдите в консоль Dialogflow CX.

2. Выберите проект Google Cloud. Чтобы найти свой проект, вам может потребоваться нажать «Все» , а затем выполнить поиск.

3. Теперь у вас есть возможность выбрать готовый агент или создать свой собственный. Если вы предпочитаете подробно изучить настройку агента позже, выберите один из готовых агентов , которые также помогут узнать, на что способны агенты.

   Чтобы выбрать готовый агент, выполните следующие действия:

   1. Щелкните Использовать готовые агенты .

   2. Выберите готовый агент. Для этого руководства выберите Путешествие: прокат автомобилей .

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

   3. Нажмите Импортировать как агента .

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

   1. Нажмите Создать агента .
   2. Выберите «Создать автоматически» , чтобы создать агент хранилища данных , или выберите «Создать свой» , чтобы создать агенты других типов.

   Подробное описание процесса создания агента см. в разделе Создание агента Dialogflow CX .

4. Настройте основные параметры агента:

   1. В поле «Отображаемое имя» введите отображаемое имя.
   2. Выберите желаемое местоположение . Если вы хотите изменить дополнительные настройки местоположения , нажмите «Изменить» .
   3. Выберите предпочитаемый часовой пояс.
   4. Выберите язык по умолчанию для вашего агента. Вы не можете изменить язык по умолчанию для агента после создания.

5. Нажмите Создать . Dialogflow CX начинает создание агента, а затем отображает поток запуска агента по умолчанию.

6. При необходимости настройте агента. Подробное описание процесса настройки агента см. в разделе Создание агента Dialogflow CX .

7. Рекомендуется протестировать агент:

   1. Нажмите Агент тестирования .
   2. Выберите Агент тестирования в среде .
   3. В разделе «Среда» выберите «Черновик» .
   4. В разделе «Поток» выберите «Начать поток по умолчанию» .
   5. В разделе «Страница» выберите «Начальная страница» .
   6. На панели «Поговорить с агентом» введите Hello и нажмите Enter . Агент отвечает, представляясь.
   7. Завершите тест, проведя образец тестового разговора .

8. Агент Dialogflow CX создан. Вернитесь в консоль Dialogflow CX. Нажмите Меню > Dialogflow CX menu

   Перейдите в консоль Dialogflow CX.

9. В разделе «Агенты» нажмите more_vert > Копировать имя . Сохраните это имя, так как вы будете использовать его при настройке приложения Chat.

Создайте приложение чата и подключите его к агенту Dialogflow.

После создания агента Dialogflow CX выполните следующие действия, чтобы превратить его в приложение чата:

1. В консоли Google Cloud перейдите к Google Chat API. Найдите «Google Chat API» и нажмите «Google Chat API» , затем нажмите «Управление» .

   Перейти к API чата

2. Нажмите «Конфигурация» и настройте приложение «Чат»:

   1. В поле «Имя приложения» введите Dialogflow App .
   2. В URL-адресе аватара введите https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png .
   3. В поле «Описание» введите Responds to real human conversation .
   4. В разделе «Функциональность» выберите «Получать сообщения 1:1» и «Присоединяться к группам и групповым беседам» .
   5. В разделе «Настройки подключения » выберите «Dialogflow» .
   6. В настройках Dialogflow выберите Dialogflow CX .
   7. В поле «Имя ресурса агента или среды» вставьте имя агента Dialogflow CX, которое вы скопировали в конце раздела «Создание агента Dialogflow CX» .
   8. Сделайте это приложение чата доступным для определенных людей и групп в вашем домене и введите свой адрес электронной почты.
   9. В разделе «Журналы» выберите «Записывать ошибки в журнал» .

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

Приложение Chat готово получать сообщения в Chat и отвечать на них.

Протестируйте приложение Чат

Протестируйте приложение Dialogflow CX Chat, отправив ему сообщение в Google Chat.

1. Откройте Google Chat, используя учетную запись Google Workspace, которую вы указали при добавлении себя в качестве доверенного тестировщика.

   Перейти в чат Google

2. Нажмите add новый чат» .
3. В поле «Добавить 1 или несколько человек» введите название вашего приложения чата.

4. Выберите приложение чата из результатов. Откроется прямое сообщение.

5. В новом прямом сообщении с приложением введите Hello и нажмите enter .

   Приложение Dialogflow Chat отвечает, представляясь.

6. Завершите тест, проведя образец тестового разговора .

Пример тестового разговора

Чтобы протестировать приложение Dialogflow CX Chat в консоли Dialogflow CX или в Google Chat, проведите следующий диалог. Объяснение поможет вам понять, как агент Dialogflow CX интерпретирует естественный язык пользователя и выдает собственный ответ на естественном языке на каждом этапе разговора. Этот пример разговора основан на предварительно созданном агенте под названием «Путешествия: прокат автомобилей» .

Отправка карточных сообщений из Dialogflow

Dialogflow может отвечать текстовыми сообщениями или карточками . Чтобы ответить сообщением с карточкой, укажите его в качестве пользовательской полезной нагрузки при выполнении .

Следующий JSON показывает, как отправить карточное сообщение в качестве пользовательской полезной нагрузки при выполнении:

{
  'cardsV2': [{
    'cardId': 'createCardMessage',
    'card': {
      'header': {
        'title': 'A card message!',
        'subtitle': 'Sent from Dialogflow',
        'imageUrl': 'https://developers.google.com/chat/images/chat-product-icon.png',
        'imageType': 'CIRCLE'
      },
      'sections': [
        {
          'widgets': [
            {
              'buttonList': {
                'buttons': [
                  {
                    'text': 'Read the docs!',
                    'onClick': {
                      'openLink': {
                        'url': 'https://developers.google.com/workspace/chat'
                      }
                    }
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  }]
}

Ограничения и соображения

• События взаимодействия в чате имеют ограниченную поддержку и некоторые соображения:
  • Поддерживаются следующие типы событий взаимодействия :
    • MESSAGE
    • ADDED_TO_SPACE
    • CARD_CLICKED
  • Для событий MESSAGE или ADDED_TO_SPACE входные данные запроса, отправляемые агенту Dialogflow, соответствуют значению поля argumentText в сообщении чата. Если сообщение содержит косую черту , вместо нее используется значение text поля.
  • Для событий CARD_CLICKED входные данные запроса, отправляемые агенту Dialogflow, форматируются как CARD_CLICKED.functionName , где functionName соответствует значению function поля объекта Action , прикрепленного к элементу интерактивной карты (например, кнопке).
  • Полные полезные данные JSON каждого события взаимодействия в чате отправляются в Dialogflow в качестве настраиваемых полезных данных в параметре запроса, и к ним можно получить доступ с помощью веб-перехватчика Dialogflow, запросив значение поля WebhookRequest.payload .
• Рекомендации по реагированию на команды слэша и получению данных из карточек или диалогов :
  • Когда приложения Dialogflow Chat получают сообщение с косой чертой, входные данные запроса содержат только значение text поля. text поле начинается с имени команды косой черты (например, /command ), которую можно использовать для настройки намерения агента Dialogflow обнаруживать команду косой черты.
  • Если агенту Dialogflow необходимо обработать полезные данные JSON события взаимодействия в чате , он может сделать это с помощью веб-перехватчика Dialogflow для проверки настраиваемых полезных данных в параметре запроса.
  • Чтобы отобразить диалоговое окно от агента Dialogflow, ответьте одной пользовательской полезной нагрузкой JSON, которая включает сообщение, содержащее ответ на действие DIALOG .
  • Для обработки данных, вводимых с карточек, агент Dialogflow может обнаруживать намерения, начинающиеся с текста CARD_CLICKED , и отвечать одной пользовательской полезной нагрузкой JSON, содержащей соответствующее действие .
• Предварительный просмотр ссылок не поддерживается.
• Если агент Dialogflow отвечает только одним сообщением, оно отправляется в Google Chat синхронно. Если агент Dialogflow отвечает несколькими сообщениями, все сообщения отправляются в Chat асинхронно путем вызова метода create для ресурса spaces.messages в Chat API один раз для каждого сообщения.
• При использовании интеграции Dialogflow CX с Chat агент Dialogflow и приложение Chat должны быть настроены в одном проекте Google Cloud. Если вам нужно настроить Dialogflow и Chat в разных облачных проектах, вы можете настроить промежуточный сервер для облегчения соединения. Чтобы узнать, как это сделать, см. этот пример интеграции Chat для Dialogflow CX на GitHub.

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

Когда приложение или карточка Google Chat возвращает ошибку, в интерфейсе Chat отображается сообщение «Что-то пошло не так». или «Невозможно обработать ваш запрос». Иногда в пользовательском интерфейсе чата не отображается сообщение об ошибке, но приложение или карточка чата выдает неожиданный результат; например, сообщение с карточкой может не появиться.

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

Очистить

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

1. В консоли Google Cloud перейдите на страницу «Управление ресурсами» . Нажмите Меню > IAM и администрирование > menu ресурсами .

   Зайдите в диспетчер ресурсов

2. В списке проектов выберите проект, который хотите удалить, и нажмите «Удалить delete .
3. В диалоговом окне введите идентификатор проекта и нажмите «Завершить работу», чтобы удалить проект.

Связанные темы

• Dialogflow CX использует подход к разработке агента Dialogflow на основе конечного автомата , который дает вам четкий и явный контроль над диалогом, улучшенное взаимодействие с конечными пользователями и улучшенный рабочий процесс разработки. При создании приложения Dialogflow Chat мы рекомендуем использовать Dialogflow CX.
  • Дополнительные сведения о создании и настройке агентов см. в разделе Агенты Dialogflow CX .
  • Подробное пошаговое руководство по созданию и настройке агентов см. в разделе Создание агента Dialogflow CX .
  • code Codelab: пример создания агента хранилища данных Dialogflow CX см. в приложении Chat из раздела Codelab «Создание приложений для Google Chat с помощью Gemini» .
  • code Codelab: пример создания диалогового агента Dialogflow CX см. в приложении Chat для обратной связи из лаборатории CodeBuild. Создание приложений для Google Chat с помощью Gemini .
• Dialogflow ES — это еще один способ использования Dialogflow с приложением чата.