DocsICP FilingConsole
Documentation

Skill management

Updated at:
Copy as MD
Product
My Favorites

This topic describes the skills used for Voice Service integration. It covers basic concepts and how to create and manage skills.

Overview

To enable voice control for your products across different voice platforms, you must use skills. Skills link accounts and configure protocol transformations. The skills used for the Cloud Intelligence App and private brand apps differ as follows:

  • Public skills for the Cloud Intelligence App

    There are two public skills for the Cloud Intelligence App: Cloud Intelligence (Public Alexa Skill) and Cloud Intelligence (Public Google Home Skill).

    If you use the Cloud Intelligence App, you can use these two public skills directly without creating new ones. You can edit the OAuth authorization information for these skills.

    Note You must use the Cloud Intelligence App to use these public skills. For more information about billing, see Billing for Cloud Intelligence App templates.

    The names of these public skills cannot be changed. This is also the name that appears on third-party voice platforms. To use a skill exclusive to your brand, you must create a custom skill for your private brand app.

  • Custom skills for private brand apps

    Independent Software Vendors (ISVs) must create and edit custom skills for their private brand apps. For detailed steps, see Create a skill.

Create a skill

  1. Log on to the IoT Platform console. In the navigation pane on the left, choose Operation Center > Voice Service to open the Voice Service management page.
  2. On the Skill List page, click Create Skill to open the skill creation page.
  3. Enter the basic information for the skill, and then click Next.

    The following table describes the basic information parameters and provides examples.

    Term Description Example
    Skill Name The name of the skill on the IoT Platform. Enter a name for the skill. test
    Voice Platform The voice platform to which the skill connects. Select one from the drop-down list. Google
    Configured Project The project where the skill is configured. This is used to attach the skill to products within the project. Select a project from the drop-down list. Test Project
    Associated app The app to associate with the skill. Select an app to attach from the drop-down list.
    Note You can only associate private apps created in a private brand project. The Cloud Intelligence App can use the public skills directly.
    		In-house application
  4. Click Configure on Platform to navigate to the third-party voice platform. On the platform, configure, authenticate, and publish the skill. After you complete the configuration on the third-party platform, enter the information in the configuration fields in the console. Confirm that the information is correct, and then click Next.
    Note Skills created on the IoT Platform are mainly used to link accounts with third-party voice platforms. Based on the voice platform you selected in the previous step, clicking Configure on Platform redirects you to the third-party platform to configure, authenticate, and publish the skill. For detailed instructions for third-party platforms, see the following:
    • If you chose to connect to the Amazon Alexa voice platform, enter the skill information as described in the following table to attach the skill.
      Term Description Example
      OAuth Authorization Settings The callback uses OAuth authorization. Enter the three Redirect URLs from the Account Linking section of your Alexa Skill. https://layla.amazon.com/api/skill/link/MB****CTIMCLT
      appToAppRedirectUrls Corresponds to the Your Redirect URLs configuration item on the Account Linking page of your Alexa skill. https://pitangui.amazon.com/api/skill/link/MB****CTIMCLT
      Customer Service Email This email is displayed on the help page for Alexa skill account linking. Enter a contact email. a***@example.net
      Alexa Client Id The Client ID generated by the Alexa platform on the Permissions page in the Alexa Skills Kit console. amzn1.application-oa2-client.40****1c6a354fefa851e1d36c9e4cd6
      Alexa Client Secret The Client Secret generated by the Alexa platform on the Permissions page in the Alexa Skills Kit console. f666310a23651d4852dd6870b3ba54d29e815f05e659a4ee85058483****63b6
      Alexa Skill Id The skill ID generated when you create the skill in the Alexa Skills Kit console. amzn1.ask.skill.3be38fae-e2a1-4825-8291-4b28****b959
    • If you chose to connect to the Google Home voice platform, enter the skill information as described in the following table to attach the skill.
      Term Description Example
      OAuth Authorization Settings The callback uses OAuth authorization. Enter the Project ID of your Google Action. 111111111****1
      Push Proxy Account Settings The service account under the developer project created in Google. The platform will use this service account as a proxy to sync information with Google Home Graph. Enter the service account. user****@example.com
      Customer Service Email This email is displayed on the help page for Google skill account linking. Enter a contact email. a***@example.net
  5. Purchase and enable the Voice Service.

    If you have not enabled the custom skill development service, click Purchase. On the purchase page, purchase and enable the corresponding custom skill development service. For more information about the fees for the custom skill service, see Service billing.

    Important The service that you purchase and enable in this step is the custom skill voice service. This service is billed per use. The custom skill service can only be purchased through this process.

    Confirm the specifications of the Voice Service you are purchasing, and then click Confirm Purchase to enable the third-party voice service.

    The specifications and fees for the custom skill voice service are as follows:

    • Google Home skill customization
    • Amazon Alexa skill customization
    Note After the purchase is successful, return to the skill creation page. You can click Refresh to update the service activation status.
  6. Experience and publish

    After you complete the preceding steps, download and log on to the private app in which the skill is configured. Then, attach the skill within your private app.

  7. Click Finish to create the skill on the IoT Platform.

Manage skills

After you create and publish a skill, you can go to the Skill List page to open the skill management page. On this page, you can view and edit the skill's configuration information and manage the products attached to the skill.

  1. On the Skill List page, find the published skill that you want to manage and click Manage to open the skill management page.
  2. On the skill management page, you can view the basic information of the published skill. You can also click Edit to edit the OAuth authorization information.
  3. To attach new products to the skill, click Attach Product on the Skill Management page. Then, select and configure the product information. For more information, see Product management.
  4. For products that are already attached, click Manage to edit their information and perform other related operations.