APIs
Getting StartedREST API BasicsComplianceWebhooksWebex APIs
Admin
Calling
Contact Center
Devices
imiconnect
Meetings
Messaging
Webex Assistant Skills
Full API Reference
API Changelog

Webex Assistant Skills Guide Developer Portal Guide

The Developer Portal is a tool for Skills developers to manage and maintain their Skills in a simple way. This tool works on top of the Assistant Skills service, so it removes the need of having to use REST requests in order to create, update and manage Skills.

This tool is not intended for organization administrators to provide their users access to a given Skill. That functionality is available in Control Hub. This tool is for developers only, so they can have access to all the Skills they develop in a single place.

The Developer Portal URL is: https://skills-developer.intelligence.webex.com We'll go through the following topics in this guide, which will explain how to use this tool):

anchorOverview
anchor

When you first go into the Developer Portal, you'll land at the Overview page. This page offers a high level overview of what Skills are and what they can do.

Overview Page

anchorLog In
anchor

Once you enter the tool, the first step you should take is to log in. For that, you can use the Log In button in the top-right corner:

Log in

In the next few sections, we'll be working on the Developer tab. Once logged in, go into the Developer section.

anchorCreating a Skill
anchor

Creating a Skill is very simple, simply click on the Create New Skill button:

Create Skill Button

You will now be presented with a form that you need to complete in order to register the Skill:

Create Skill Form

The details you need to fill in are the following:

  • Name: The official name of the Skill.
  • Description: An optional description of what this Skill does.
  • Home Page: An optional URL to a website with more information about the Skill.
  • Suggested Invocation Names: Optional keywords used to identify this Skill. These are suggestions for when organization administrators register your Skill.
  • Languages: The list of languages that your Skill can support.
  • URL: Address to invoke this Skill.
  • Contact Email: Email of who should be contacted with inquires about the Skill.
  • Secret: Private string used by the Assistant Service to identify itself to the Skill. This string is configured in the application code.
  • Public Key: A RSA public key needed to securely communicate between the Assistant Skills Service and the Skill.

Fill in all the fields with your Skill details above. When ready, click the OK button.

Create Skill

anchorLooking at your Skills
anchor

Once you have created at least one Skill, you will see your Skills listed in the Developer section as follows:

Skills List

You will see 6 columns for each of the Skills you have. We have already mentioned a few of them in the Creating a Skill section. The ones we didn't cover are:

  • Public: An indicator showing if the Skill has been made public for broader use.
  • Last Active Time: Last time the Skill was invoked (if available).
  • Actions: This column contains 2 buttons Edit and Delete, which we explore in upcoming sections.

If you happen to have an error in one of the form fields (they all have different requirements), the tool will highlight the field in red and will tell you what the error is. Here's an example:

Skill Create Error

anchorEditing a Skill
anchor

Let's say that now we want to edit a Skill we already created. To do that, we click on the Edit button of the specific Skill we want to update:

Skill Edit Button

This will open a drawer from the right where we can see 2 tabs: Skill and Registration. We are going to work on the Skill tab in this section:

Skill Tab

Initially you will see all the details of your Skill listed there. If you want to make modifications, click on the blue Edit button:

Skill Blue Edit Button

You will now see a form where you can edit all the details about your Skill. As an example, we have added a new suggested invocation name to our sample Skill:

Skill Edit Form

We can now save the changes by clicking the OK button at the bottom of the form:

Skill Edit OK Button

We should now see the updated Skill:

Skill Updated

anchorLooking at a Registration
anchor

With right drawer open, click on the Registration tab. This will display the registration details for the Skill:

Registration Tab

You are looking at the developer registration associated with your Skill. For a developer registration, you can customize the invocation names that are used when you, the Skill developer, try to invoke the Skill. Please note that these are separate from the Suggested Invocation Names in the Skill. Suggested Invocation Names are only suggestions for the admins on which invocation names they can use when registering your Skill, but these suggestions are not used for invocation until added to a registration.

anchorEditing a Registration
anchor

You can edit a registration to update the invocation names by clicking on the blue Edit button in the Registration tab:

Registration Edit Button

After clicking that button, you should see the registration edit form:

Registration Edit Form

In our example, we have added the invocation names light switch and light control to our registration, to match the Suggested Invocation Names. Normally, the process would be a bit different. You would add invocation names to your registration first in order to test them, and then, if you think they can help other people use your Skill better, you would add these to the Suggested Invocation Names of the Skill.

Commonly, new invocation names can be added as fixes for Automatic Speech Recognition (ASR) errors. If the Skill name you chose, often gets mistranscribed, you can add the common mistrasncription as an invocation name. For example, if your Skill is named "How To", but ASR keeps mistranscribing your Skill name as "How Two" or "How Too", you can add those additional names as invocation names. Additionally, you can also add new invocation names if you find your Skill name has some synonyms you think people would use commonly.

You can save the changes by clicking the OK button:

Registration Edit OK Button

After that, you should see the registration has been updated:

Registration Updated

anchorDeleting a Skill
anchor

Deleting a Skill is very simple. Simply click the Delete icon for the Skill you want to delete:

Skill Delete Button

You should see a confirmation dialogue. Click Delete in order to delete the Skill:

Skill Delete Confirmation

You should see the Skill has been deleted:

Skill Deleted