Confusing Documentation in Dialogflow CX

[karl-gardner]

Hello,

I am trying to understand the evaluation order of a parameter form filling of a particular page. According to the following piece of documentation it says that if no reprompt handler is defined in a parameter form filling then it will just repeat with the initial prompt that was used:

https://cloud.google.com/dialogflow/cx/docs/concept/parameter#form-reprompt

However, in the following piece of documentation it states this as the evaluation order for event handlers:

https://cloud.google.com/dialogflow/cx/docs/concept/handler#eval

"3. Event handlers are evaluated in this order:

1. Parameter-level: Event handlers applied to the current page's form parameter that the agent is currently attempting to fill (reprompt handlers), in the order supplied.
2. Page-level: Event handlers applied to the current page, in the order supplied.
3. Flow-level: Event handlers applied to the active flow, in the order supplied."
   
   Thus, it's stating that first the parameter-level event handler will be called, then the page-level, then the flow-level event handler defined in the start page. This is different from the documentation piece stated earlier that states that if no reprompt event handler is defined it will repeat itself. This documentation is saying that it will go back to page-level and then flow-level. Essentially, I am trying to use a flow-level event handler defined in the no-match-default event handler in the start page but when current form parameter is being filled it just repeats itself. Does anyone understand those two pieces of documentation?

[xavidop]

Hi, 

The order of evaluation is what is it specified here: https://cloud.google.com/dialogflow/cx/docs/concept/handler#eval

If you are using data stores, this is the order of evaluation:

[karl-gardner]

Hello @xavidop,

As parameter form filling is not a "state handler" I am confused where the form filling is in the evaluation order: 

https://cloud.google.com/dialogflow/cx/docs/concept/handler#eval

I have set up an example to display this. I have 3 pages of Start Page, Customer Start, and Continue. In the Customer Start I have a form parameter fill and prompt of "give me a number". Then I have a route that has a "true" condition that goes to a Continue page and says "I am continuing":
Here is the Customer Start Parameter Form Fill:

And here is the Continue page:

I am now testing it and it seems to just skip over the parameter form filling in the Customer Start page:

It seems like it evaluates all the routes before the parameter form filling? Also, in your diagram for the order of evaluation it says "Parameter input while form filling" happens first, however it seems like it's skipped in this case.

Karl

[xavidop]

yeah, I think you are right, what I would suggest is to set the parameter to be required and do the transition if everything is fulfilled. Here is an example that I had:

you can find that agent example here: https://github.com/xavidop/dialogflow-cx-webhook-pokedex

let me know if that helps!

Best,

Xavi

[karl-gardner]

@xavidopI don't think I explained this properly sorry. I am restarting a new thread

[xavidop]

I see what you mean.

You have to set the parameter to null when transitioning to re-trigger the parameter fulfilling:

[karl-gardner]

@xavidop Thanks! I put the full problem scenario that I am having in a different forum.