Используйте многоязычную библиотеку для настройки повторного намерения в Dialogflow для VUI

Некоторые ответы на использование многоязычия с помощью встроенного редактора Dialogflow:

Как включить это в package.json файл?

Инструкции по использованию npm: если вы пишете выполнение локально, а не используете Редактор.

Вам нужно добавить эту строку в раздел dependencies:

    "multivocal": "^0.14.0"

а облачные функции Dialogflow / Firebase позаботятся об импорте библиотеки. Вам не понадобятся библиотеки "actions-on-google", "dialogflow" или "dialogflow-fillment", поэтому раздел может выглядеть примерно так:

  "dependencies": {
    "firebase-admin": "^5.13.1",
    "firebase-functions": "^2.0.2",
    "multivocal": "^0.14.0"
  }

Как мне написать свой index.js?

В простом примере предполагается, что вы можете поместить свою конфигурацию и код в отдельный файл (в примере - «color.js»). Поскольку вы не можете сделать это с помощью встроенного редактора, общий шаблон вашего кода будет примерно таким:

// Import the library on the first line, so you can call methods on it to setup your configuration
const Multivocal = require('multivocal');

// Your configuration and code go here

// Setup the webhook as the final line
exports.dialogflowFirebaseFulfillment = Multivocal.processFirebaseWebhook;

Куда делись регистрация и функции обработчика намерений?

В отличие от библиотеки выполнения dialogflow, multivocal не использует явного intentMap. Он поддерживает его сам, поэтому для регистрации функции Intent Handler вы должны использовать что-то вроде

Multivocal.addIntentHandler( intentName, handlerFunction );

НО имейте в виду, что функции обработчиков также немного отличаются.

Что? Чем они отличаются?

Многое в Multivocal решается через конфигурацию, а не через код. Таким образом, нет прямого аналога вызову функции agent.add(), который у вас был бы с dialogflow-executionment или библиотекой actions-on-google.

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

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

Итак, если у вас есть намерение с именем «color.favorite» и значение в среде, называемое «цвет» (которое ваш обработчик мог загрузить из базы данных), конфигурация этого ответа на английском языке может выглядеть примерно так. Он также включает суффикс по умолчанию, подсказывающий пользователю, что им делать дальше.

  const config = {
    Local: {
      en: {
        Response: {
          "Intent.color.favorite": [
              "{{color}} is one of my favorite colors as well.",
              "Oh yes, {{color}} can be quite striking.",
              "I can certainly understand why you like {{color}}."
          ]
        },
        Suffix: {
          Default: [
            "What other color do you like?"
            "Tell me another color."
          ]
        }
      }
    }
  }

и вы должны зарегистрировать эту конфигурацию с помощью

  new Multivocal.Config.Simple( config );

Вы можете (и должны) зарегистрировать несколько конфигураций, хотя вы можете объединить их в один объект. Таким образом, Response раздел выше может содержать разделы ответа для каждого из ваших намерений по имени.

Хорошо, но как мне обработать намерение "повторить"?

Все, что вам нужно, - это предоставить намерение, для которого «Действие» установлено на «multivocal.repeat» в пользовательском интерфейсе Dialogflow, и для которого включен веб-перехватчик. Так что что-то вроде этого будет работать:

Multivocal уже зарегистрировал обработчик и конфигурацию на его основе.

Если вы хотите изменить возможные ответы, вы можете добавить конфигурацию для действия «multivocal.repeat». Это может выглядеть примерно так:

const enRepeat = [
  "Sorry about that, let me try again.",
  "I said:"
];

const config = {
  Local: {
    en: {
      Response: {
        "Action.multivocal.repeat": enRepeat
      }
    }
  }
}

а затем либо объедините эту конфигурацию с другими конфигурациями, которые вы написали, либо загрузите ее, как указано выше.

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