Create and Manage Skills
- Chitra Borker (Deactivated)
- Simon Friend
You can now create and manage skills for users within your organization. The purpose of creating a skill is to register it on the Soul Machines Platform. Any user with an owner, support, or editor role, can create skills, and anyone in the organization can edit Skill definitions regardless of whether they created them.
You will be able to create only a PRIVATE skill. This means that the Skill is only available to users in the organization. For any skill that needs to be made PUBLIC, meaning that it can be used by other organizations using DDNA Studio, you must contact Soul Machines for review and approval.
Â
Manage Skills
To access the Skills page, go to the settings icon at the top right corner of the page and select Manage Skills.
The Manage Skills page shows a list of all the skills created in the organization with a short description. The Usage column indicates the number of projects using the skill.
Create Skill
First, you would need to build a skill using one of the options below and then create the skill definition using the Digital DNA Studio UI. The Skill definition refers to the skill-definition.json, which defines the settings for the Skill.
Build your skills using one of the option below:
From the Manage Skill screen, click New Skill to create a new Skill definition.
The Skill definition editor is pre-populated with a basic skill definition which you would need to edit based on your requirements. Refer to the Soul Machines Skill API Definition for all the available options. The editor provides basic JSON validation.
Sample Skill Definition
{
"name": "Example Skill Format(string)",
"summary": "This skill is created for demonstration purposes(string)",
"description": "This skill is created for demonstration purposes (string)",
"isPublic": "false | true (boolean)",
"status": "ACTIVE| DELETED | INACTIVE | REVIEW (enum)",
"serviceProvider": "DIALOGFLOW | DIALOGFLOW_CX | WATSON | LUIS | ORCHESTRATION_SERVER | SKILL_API (enum)",
"ownerId": "auth0|******* (optional string)",
"organizationId": "Organization ID of Owner (optional number)",
"endpointInitialize": "https://test.com?state=initialize (url)",
"endpointSession": "https://test.com?state=session (url)",
"endpointExecute": "https://test.com?state=execute (url)",
"endpointEndSession": "https://test.com?state=end_session (url)",
"endpointEndProject": "https://test.com?state=end_project (url)",
"endpointMatchIntent": "https://test.com?state=match_intent (url)",
"config": {
"matchType": "PHRASE | CUSTOM | FALLBACK (enum)",
"skillType": "DEFAULT | INTENT_MATCHER | PRE_PROCESS | POST_PROCESS | PRE_POST_PROCESS | BASE_CORPUS (enum)",
"exitPhrase": ".*",
"configMeta": [
{
"name": "Configuration details that can be viewed and/or edited by DDNA Studio project creators",
"type": "TEXT | PASSWORD | NUMBER | SELECT | BOOLEAN",
"label": "Description of the configuration option",
"required": "false | true (boolean)",
"placeholder": "A short hint that describes the expected value for the input field (e.g. a sample value or a short description of the expected format).",
"defaultValue": "The default pre-configured value for the input field. This value can be updated by the user as required."
}
],
"privateConfig": [
{
"name": "Configuration details that cannot be viewed or edited by DDNA Studio project creators",
"value": ""
}
],
"examplePhrases": [
{
"lang": "en",
"value": "Skill: Hi I'm Viola. How's your day going?"
},
{
"lang": "en",
"value": "User: Hi I'm good thanks."
},
{
"lang": "en",
"value": "Skill: That's great to hear. Welcome to Soul Machines. I can help answer questions about Soul Machines as well as our products and services. So what would you like to know about us?"
}
],
"privacyAndTerms": [
{
"links": [
{
"name": "Privacy Policy",
"value": "https://www.soulmachines.com/privacy-policy/"
},
]
"organization": "Soul Machines"
}
]
}
}Skill endpoints must be publicly access and not require authentication
Â
Â
Â
Access your Skill
Once you create a skill, you can access it via Conversation & Skills > Browse options.
Base conversations created appear under All Conversations.
Â
All other types of Skills appear under All Skills. You will be able to navigate to all skills once you configure the base conversation.
Â
Â
Contents