使用多声音库为VUI在Dialogflow中配置重复意图 [英] Use multivocal libary to configure repeat intent in Dialogflow for VUI

问题描述

我正在尝试将我的VUI配置为在提示时在Dialogflow中重复一个句子。小故事，我正在帮助开发老年人社交机器人，因此重复句子是非常需要的功能。我刚刚开始这个项目，以前负责此工作的开发人员已经离开并且无法联系到我，而且我也没有Node.js的经验。

我希望使用为此，

Multivocal已经基于此注册了处理程序和配置。

如果您想更改可能的响应，则可以为 multivocal.repeat添加配置。行动。可能看起来像这样：

  const enRepeat = [
很抱歉，让我再试一次。 ，
我说： 
]; 
 
 const config = {
 Local：{
 en：{
 Response：{
 Action.multivocal.repeat：enRepeat 
 } 
} 
} 
} 
  

，然后将其合并

要强调的是-无需为此编写任何代码，只需一些可选配置

I'm trying to configure my VUI to repeat a sentence in Dialogflow when it is prompted for this. Little back story, I am helping develop a social robot for elderly so repeating a sentence is a much needed feature. I just started on this project and the previous developer responsible for this is gone and not reachable, also, I have no experience in Node.js.

I am looking to use the multivocal for this. These are the steps I have done so far:

1. Created an intent called 'Repeat'.
2. Added training phrases for the intent
3. Added 'multivocal.repeat' as an action
4. Enabled webhook call for this intent
5. In Node.js added 'intentMap.set('Repeat', repeat);' to my existing intentMap

// Run the proper function handler based on the matched Dialogflow intent name
  let intentMap = new Map();
  intentMap.set('Game_Rock_Paper_Scissors - Result', game_stone_paper_scissors);
  intentMap.set('Game_Rock_Paper_Scissors - Result - yes', game_stone_paper_scissors_again);
  intentMap.set('Conversation tree', conversation_tree);
  intentMap.set('Question date', question_date);
  intentMap.set('Question time', question_time);
  intentMap.set('Music', music);
  intentMap.set('Repeat', repeat);

Next, under the 'Fulfillment' tab, I want to enter the function inside the Inline Editor 'index.js' tab and make sure in the 'package.json' that the multivocal library is installed and usable. So far, there are a few things in my package.json

  "name": "dialogflowFirebaseFulfillment",
  "description": "This is the default fulfillment for a Dialogflow agents using Cloud Functions for Firebase",
  "version": "0.0.1",
  "private": true,
  "license": "Apache Version 2.0",
  "author": "Google Inc.",
  "engines": {
    "node": "8"
  },
  "scripts": {
    "start": "firebase serve --only functions:dialogflowFirebaseFulfillment",
    "deploy": "firebase deploy --only functions:dialogflowFirebaseFulfillment"
  },
  "dependencies": {
    "actions-on-google": "^2.2.0",
    "firebase-admin": "^5.13.1",
    "firebase-functions": "^2.0.2",
    "dialogflow": "^0.6.0",
    "dialogflow-fulfillment": "^0.5.0"
  }
}

So, how do I install the library? In the Read.me is says 'You can install it using npm install --save multivocal.' But where would I install this? Do I put this somewhere in the index.js or packages.js?

Also, in this example it shows the index.js code to be:

const Color = require('./color.js');
Color.init();

const Multivocal = require('multivocal');
exports.webhook = Multivocal.processFirebaseWebhook;

Should I just add this to the end of my index.js? Or should it be wrapped in a function? Sorry to be so not experienced in this but I hope I explained it clearly.

解决方案

Some answers for using multivocal using the Dialogflow Inline Editor:

How do I include this in the package.json file?

The directions for using npm are if you're writing the fulfillment locally and not using the Editor.

You need to add this line in the dependencies section:

    "multivocal": "^0.14.0"

and Dialogflow / Firebase Cloud Functions will take care of importing the library. You won't need the "actions-on-google", "dialogflow", or "dialogflow-fulfillment" libraries, so the section can look something like this:

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

How do I write my index.js?

The simple example assumes that you can put your configuration and code in a separate file ("color.js" in the example). Since you can't do that with the Inline Editor, the general boilerplate of your code will be something like this:

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

Where do the Intent Handler registration and functions go?

Unlike the dialogflow-fulfillment library, multivocal doesn't use an explicit intentMap. It maintains one itself, so to register an Intent Handler function you would use something like

Multivocal.addIntentHandler( intentName, handlerFunction );

BUT keep in mind that handler functions are also a little different.

What? How are they different?

Multivocal has a lot of things handled through configuration, rather than code. So there is no direct counterpart to the agent.add() function call that you'd have with dialogflow-fulfillment or the actions-on-google library.

Instead, your Intent Handler function should perform any logic, database calls, or whatever to get values that will be used in responses and save them in the Environment. Every Handler should return a Promise that contains the Environment.

You should also set configuration for your Intent - the most common of which is to set the possible "Response" templates. The most simple response templates just include text, and where to insert values from the environment. It is also best practice to prompt the user for what they can do next, so we might setup a "Suffix" template to use by default, or one to use for specific Intents, Actions, or Outents.

So if you had an Intent named "color.favorite", and had a value in the environment called "color" (that your handler may have loaded from a database), the configuration for this response in English may look something like this. It also includes a default suffix to prompt the user what they can do next.

  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."
          ]
        }
      }
    }
  }

and you would register this configuration with

  new Multivocal.Config.Simple( config );

You can (and are expected to) register multiple configurations, although you can combine them in one object. So the Response section above could contain response sections for each of your Intents, by name.

Ok, but how do I handle a "repeat" Intent?

All you need to do is provide an Intent that has its "Action" set to "multivocal.repeat" in the Dialogflow UI and that has the webhook enabled. So something like this would work:

Multivocal already has registered a handler and configuration based on this.

If you want to change the possible responses, you can add configuration for the "multivocal.repeat" Action. Which may look something like this:

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

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

and then either combine this configuration with other configurations you've written, or load it as above.

To emphasize - there is no need for you to write any code for this, just some optional configuration.

这篇关于使用多声音库为VUI在Dialogflow中配置重复意图的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！