Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

You can now create , register, 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 from in the organization can add/ edit Skill definitions even if they did not create regardless of whether they created them.

You will be able to create /register only a only PRIVATE skill. This means that the Skill is only available to users in the organization. If you need to make For any skill that needs to be made PUBLIC meaning allowing , meaning that it can be used by other organizations using DDNA studio to use itStudio, you must contact Soul Machines for a 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 refers to indicates the number of projects using the skill.

Create Skill

Build Your Skill

Build the skill you desire 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 optionsoption below:

Register Skill

Click From the Manage Skill screen, click New Skill on the Skills page to create a new Skill definition. The purpose of this process is to register your skill on the Soul Machines Platform.

Image Added

The Skill definition editor is prefilled 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

Code Block
languagejson
{
    "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.
Image Removed
soulmachines.com/privacy-policy/"
                    },
                ]
                "organization": "Soul Machines"
            }
        ]

    }
}

Access your Skill

Once you create a skill, you can access them 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

Table of Contents
minLevel1
maxLevel7