Basic Examples for StepDP Versions >= 0.9.0

This project contains some code examples that show how to build a dialog system with StepDP. For some examples, there are more detailed descriptions in the StepDP documentation (only accessible from DFKI network / VPN). The respective links are provided below. The following examples are currently available:

• HelloWorldExample: Most basic example, which shows how to define simple dialog rules (http://stepdp.sb.dfki.de/stepdp/rules/simple_rule/).
• PatternConditionExample: Shows how to define slightly more advanced conditions for dialog rules (http://stepdp.sb.dfki.de/stepdp/rules/pattern_condition/).
• DeclarativeTypeBasedFusionExample: Shows how to define fusion rules (http://stepdp.sb.dfki.de/stepdp/rules/declarative_type_based_fusion/).
• StateChartExample: Shows how to use statecharts (http://stepdp.sb.dfki.de/stepdp/statechart/).
• KBExample: An example of a dialog system using knowledge base objects. For more information on how to add knowledge base instances to the blackboard, refer to http://stepdp.sb.dfki.de/stepdp/kb/#how-to-add-kb-instances-to-the-blackboard.

How to run the examples

The application.yaml file specifies which example is executed. Per default, it selects the HelloWorldExample. To select a different example, e.g. the PatternConditionExample, replace

dialog:
  name: basic_examples.HelloWorldExample

with

dialog:
  name: basic_examples.PatternConditionExample

To run the selected example, simply run the Main class in your IDE.

While running an example, you can send input in JSON format to StepDP via its Debug Web UI, which runs on port 50000. The corresponding tab is called "Blackboard Input". For each code example, example JSON inputs should be available in the drop-down list:

Here's an overview of which example JSON inputs to select for which example:

• HelloWorldExample:
  • "add greeting"
• PatternConditionExample:
  • "add bring intent with pizza" or
  • "add bring intent with water"
• DeclarativeTypeBasedFusionExample:
  • "add bring intent" and additionally
  • "add pizza"
• StateChartExample:
  • "add greeting" and then
  • "add goodbye"
• KBExample:
  • "add tv" (in KB Token drop-down) to get information about a tv
  • "add tv order intent" to order a tv
  • Note: Since the UUID is created randomly for each run, you need to insert the UUIDs on your own. The examples that use reference by name work without adjustment.

Of course, you can also create your own JSON inputs or vary the ones that are provided to experiment a little. Just make sure that they comply with the semantic tree defined in the corresponding code example (or extend the semantic tree yourself).