Skill - Orchestration

 

Skill Type

Base Conversation

Overview

This Orchestration Skill gives the Digital Person the ability to integrate with custom code to connect to any other NLP service or implement your own conversation logic, using an orchestration server. This skill opens up the flexibility for the users to use Orchestration server in conjunction with other out-of-the-box skills (outside of a Base Conversation Skill Type).

A popular combination is using a custom NLP integration through the Orchestration server and using a Generative conversation (fallback) skill.

Orchestration Skill

Configuration

In DDNA Studio under the Manage Conversation and Skills section, add the Orchestration Skill as a Base conversation. The Orchestration section within the Project Form details the steps required to successfully link an orchestration server along with a way to access the Orchestration template to get started quicker.

Go to the Orchestration section in the DDNA Studio project form, and fill in the orchestration server url details (for local development set the “I’m developing locally” option, or use an app such as ngrok or localtunnel to get a url to your locally running server, example command with localtunnel: lt --port 6060 --subdomain orchtest ).

When using the “I’m developing locally” option, make sure you use http instead of https, and also specify the port where the server is running, for example: http://localhost:6060 . You will also need to enter your public IP address (you can google “what’s my IP), for example: 186.190.187.48/0

Node.js Template for Orchestration Server

You can quickly get started with this sample code, https://github.com/soulmachines/orchestration-nodejs
Please reference the developer docs for more information about the websocket messaging formats.