Table of Contents | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
Dialogflow
Entity for number of ingredients and number of recipe steps
While implementing the previous capability we only implemented three features that can be used to filter recipes on. To make our addFilter intent more useful and allow a user to make requests about more recipe features, we need to add more training phrases that can capture what a user wants in Dialogflow. For each type of recipe feature that we want to add, however, we need to also add all of the values of such a feature as entity entries. There is, however, one relatively cheap way to add a new feature that makes use of the system entities of Dialogflow. We can use, for example, the @sys.number entity for implementing feature requests related to the number of ingredients. For example, you can add phrases like “A recipe with less than 10 ingredients” to cater to users looking for simpler recipes. Remember to annotate the number of ingredients in each phrase with the @sys.number system entity so Dialogflow can correctly identify and extract this parameter. And, just as important, you should specify a parameter name such as nrOfIngredients for the parameter Dialogflow should extract. Your new entry in the table in the Actions and parameters section should look as follows:
...
In a similar vein, you can should add phrases about the number of recipe instruction steps such as “I’m looking for a recipe with less than 8 steps”, and the number of servings of a recipe. Use a parameter name such as nrOfStepsas parameter names nrSteps and servings. This will make sure the MARBEL agent will receive filters of the filter nrOfStepsform nrSteps=8
and servings=4
and store that in the its conversational memory. Finally, also annotate for recipe duration for a parameter called duration but instead of @sys.number use the @sys.duration system entity of Dialogflow.
Extracting multipe features from a single user expression
Another way to improve your Dialogflow agent is to enable a user to include multiple requests in a single user expression. You can achieve this simply by including many more phrases such as “I’d like a Chinese recipe with less than 8 ingredients”. This will ensure that your conversational agent can recognize multiple filter requests.
Prolog and Patterns
Retrieving the (number of) ingredients and recipe steps
...
Using the rules for ingredients/2
and steps/2
, you should now be able to define rules for nrOfIngredients(RecipeID, N)
and nrOfStepsnrSteps(RecipeID, N)
that return the number of ingredients and instruction steps, respectively, by computing the length of the list of ingredients and steps.
...
Note |
---|
It is very important to make sure that values are of the right type. The values that Dialogflow returns are often atoms or strings. Comparing strings to numbers using the < operator, for example, will result in a Type error in SWI Prolog that will terminate the MARBEL agent. To avoid such issues, we therefore always need to make sure that values that must be numbers (because they match with @sys.number entity type in Dialogflow) are converted to numbers again in Prolog. There are predicates defined for this purpose in the |
Now add a similar rule that applies a filter for the nrOfSteps nrSteps feature; your Training phrases should dictate how to read the constraint. I.e., if your phrase says “less than N recipe steps” than you should write code that implements the filter to mean exactly that.
Add a similar rule that applies a filter for the servings feature. You probably want to make sure that a recipe has exactly the right number of servings that the user asked for.
Finally, add a rule that applies a filter for the duration feature. This feature is a bit more tricky and you should take the warning above about data types to heart. However, most of the work has already been done for you in the
dialog_update.mod2g
file in a step called Pre-process parameters of intent. In this step, the duration values received from Dialogflow are transformed to minutes (numbers) using theduration_to_min
predicate defined in theutils.pl
file. This means that to define the rule for filtering, you simply need to look up the time it takes to cook a recipe in the database (specified in minutes), and compare that value with the maximum duration that the user specified.
Visuals
Extend the recipe confirmation page
The You should extend the initial version of the recipe confirmation page that we created for Capability 2: Request a Recommendation should be extended now and also show the recipe instruction and ingredient details. The main requirement is that the page now also will show the recipe instructions, the ingredient list with quantities, the duration, and number of servings. Use the Prolog rules you created for recipeStepssteps(RecipeID, StepsListStepList)
and ingredients(RecipeID, IngredientList)
to retrieve these the first two from the recipe database . Then add these to two new cards that you add to the page for showing these recipe details.
Retrieve the following information by putting the appropriate predicates in the places indicated in the rule by comments and by using the variable names indicated below.
We need to retrieve the chosen recipe from memory. Find the necessary predicate and name that variable ‘Recipe’.
The previous step retrieves the Recipe ID, but we also need the recipe name. Use a variable called ‘Name’ for this.
Retrieve the time needed to complete the recipe in a variable named ‘Minutes’.
Retrieve the number of servings in a variable called ‘Persons’.
To retrieve a list of the recipe steps and a list of ingredients, you will need two additional predicates in
recipe_selection.pl
.The first of the two predicates is a rule that returns a list of ingredients
ingredients(RecipeID, IngredientList) :-
Implement a rule in
recipe_selection.pl
calledrecipeSteps(RecipeID, StepsList) :-
to retrieve a list of the recipe steps without changing their order. There is no repetition, so this predicate does not need to remove duplicates. Your rule for retrieving the steps needs to use the accompanying rule given belowgetStepString
in your goal of the built-in Prolog predicate, so your goal should look as follows:RecipeID^getStepString(RecipeID, Step)
.Code Block getStepString(RecipeID, String) :- step(RecipeID, NrStep, StepSentence), to_upper_case(StepSentence, StepSentenceUpper), atomic_list_concat(['Step ', NrStep, ': ', StepSentenceUpper], String). %, '.'
Go back to
html.pl
and toa50recipeConfirm
Save the recipe steps as ‘Steps’
Save the list of ingredients as ‘Ingredients’
Ask for recipes with 5 ingredients and see if you receive the following answer.
...
Extend
Extend your agent to be able to filter by the maximum number of steps in a recipe, recipe duration, and number of servings in a recipe. The process is quite similar to that of the filtering by maximum number of ingredients.
Test it Out
Check if the recipe on the a50 recipe confirm page fulfills the criteria you chose and the time/2
and servings/2
predicates for the last two. Add the duration and servings to the card that already was created for this page. Add two new https://www.w3schools.com/bootstrap4/bootstrap_cards.asp to the page for showing the recipe instructions and list of ingredients. You may also want to add the feature requests to the recipe confirmation page, but we leave this design choice up to you. You definitely may want to put more work in the styling of the content and the layout of this page to make it look appealing.
Test it Out
Make sure to test that all filters introduced for this capability work. To test the new filters, ask, for example, for recipes with less than 5 ingredients and check whether you see the following:
...
For the recipe confirmation page, check if the recipe on that page fulfills the feature requests you made for the number of steps, number of servings, and duration. Make sure all 3 filters work, which should be shown on that page.
Info |
---|
All done? Proceed with https://socialrobotics.atlassian.net/wiki/spaces/PM2/pages/2216001572/BuildingDesigning+and+Developing+Your+Agent#Agent-Capability-6%3A7%3A-Filter-Recipes-by-Exclusion-Recipe-Categorical-CharacteristicDietary-Restrictions |