Draft documentation for the Dialogue Game Execution Platform (DGEP) API.<\/p>\n
An example available move returned would be: In order to have a dialogue, you will want to do roughly the following steps:<\/p>\n Create a new dialogue: Join the dialogue as in a role e.g.: You can now get the move list: You will then need to do one of these moves, something like: The requested interaction will be performed, and the available move list updated.<\/p>\n","protected":false},"excerpt":{"rendered":" Draft documentation for the Dialogue Game Execution Platform (DGEP) API. \/available returns a list of protocols corresponding to the DGDL+ files that are\u00a0available within the system. For example, this service currently returns a list of nine games: {“dgdl”: [“RPD”, “CB”, “mm”, “IMPACT”, “TDG”, “DC”, “Prakken”, “PPD”, “Lorenzen”]} \/dialogue\/new\/<PROTOCOL> is used to initiate a dialogue according […]<\/p>\n","protected":false},"author":4,"featured_media":0,"parent":96,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-1300","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/www.arg.tech\/index.php\/wp-json\/wp\/v2\/pages\/1300","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.arg.tech\/index.php\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.arg.tech\/index.php\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.arg.tech\/index.php\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/www.arg.tech\/index.php\/wp-json\/wp\/v2\/comments?post=1300"}],"version-history":[{"count":5,"href":"https:\/\/www.arg.tech\/index.php\/wp-json\/wp\/v2\/pages\/1300\/revisions"}],"predecessor-version":[{"id":1610,"href":"https:\/\/www.arg.tech\/index.php\/wp-json\/wp\/v2\/pages\/1300\/revisions\/1610"}],"up":[{"embeddable":true,"href":"https:\/\/www.arg.tech\/index.php\/wp-json\/wp\/v2\/pages\/96"}],"wp:attachment":[{"href":"https:\/\/www.arg.tech\/index.php\/wp-json\/wp\/v2\/media?parent=1300"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
\n{
\n\"aif\": \"{\\\"locutions\\\": [], \\\"nodes\\\": [{\\\"text\\\": \\\"Britain should disarm\\\", \\\"type\\\": \\\"I\\\", \\\"nodeID\\\": 1}, {\\\"text\\\": \\\"$q\\\", \\\"type\\\": \\\"I\\\", \\\"nodeID\\\": 2}, {\\\"text\\\": \\\"YA\\\", \\\"scheme\\\": \\\"Asserting\\\", \\\"type\\\": \\\"YA\\\", \\\"nodeID\\\": 3}, {\\\"text\\\": \\\"L\\\", \\\"type\\\": \\\"L\\\", \\\"nodeID\\\": 4}, {\\\"text\\\": \\\"YA\\\", \\\"scheme\\\": \\\"Asserting\\\", \\\"type\\\": \\\"YA\\\", \\\"nodeID\\\": 5}, {\\\"text\\\": \\\"L\\\", \\\"type\\\": \\\"L\\\", \\\"nodeID\\\": 6}, {\\\"text\\\": \\\"DefaultConflict\\\", \\\"scheme\\\": \\\"DefaultConflict\\\", \\\"type\\\": \\\"CA\\\", \\\"nodeID\\\": 7}, {\\\"text\\\": \\\"YA\\\", \\\"scheme\\\": \\\"Contradicting\\\", \\\"type\\\": \\\"YA\\\", \\\"nodeID\\\": 8}, {\\\"text\\\": \\\"L\\\", \\\"type\\\": \\\"L\\\", \\\"nodeID\\\": 9}], \\\"edges\\\": [{\\\"to\\\": 1, \\\"from\\\": 3}, {\\\"to\\\": 3, \\\"from\\\": 4}, {\\\"to\\\": 2, \\\"from\\\": 5}, {\\\"to\\\": 5, \\\"from\\\": 6}, {\\\"to\\\": 7, \\\"from\\\": 2}, {\\\"to\\\": 1, \\\"from\\\": 7}, {\\\"to\\\": 7, \\\"from\\\": 8}, {\\\"to\\\": 8, \\\"from\\\": 9}]}\",
\n\"reply\": {
\n\"q\": \"$q\",
\n\"p\": \"Britain should disarm\"
\n},
\n\"opener\": \"I disagree with \\\"Britain should disarm\\\" because $q\",
\n\"moveID\": \"DisagreeReason\"
\n}
\n<\/code>
\nHere ‘aif’ is a JSON-AIF representation of the AIF that would represent this move if it were to be made. This is generated by DGEP from the force and target information in the specification. This AIF structure is particularly useful in the case of an artificial participant determining what content to provide for a move based on the content of an existing AIF structure representing their beliefs. The ‘reply’ section is the JSON that the user will return, having replaced any variables ($LETTER) with the content they wish to provide. The opener and moveID are extracted directly from the specification. The moveID is used to make the move and the opener is provided only for the user’s information.<\/li>\n
\nExample Usage<\/strong><\/p>\n
\nGET http:\/\/dgep.url\/dialogue\/new\/PROTOCOL
\nYou will get back a dialogue ID to use in the commands below.<\/p>\n
\nGET http:\/\/dgep.url\/dialogue\/DIALOGUEID\/join\/Initiator
\nThis will give you the participant ID for the Initiator.<\/p>\n
\nGET http:\/\/dgep.url\/dialogue\/DIALOGUEID\/moves
\nThis will give you a list of moves that are available.<\/p>\n
\ncurl -i -X POST -d ‘{“speaker”:”INITIATORID”, “reply”:{“p”:”Britain should disarm”, “target”:PARTICIPANTID}}’ http:\/\/dgep.url\/dialogue\/DIALOGUEID\/interaction\/Question<\/p>\n