DocsICP FilingConsole
Documentation

Create and manage skills

Updated at:
Copy as MD
Product
My Favorites

This topic describes the skills used for Voice Service integration, including the basic concepts of skills and how to create and manage them.

Background information

If a product created on the IoT Platform needs to be controlled by voice from different voice platforms, you must use a skill to link accounts and configure protocol transformation. This enables cross-platform voice control for the device. The skills used for the Cloud Intelligence app and private-brand apps are different, as described below:

  • Public skills for the Cloud Intelligence app

    There are two public skills for the Cloud Intelligence app: Cloud Intelligence (public Alexa skill for Cloud Intelligence) and Cloud Intelligence (public Google Home skill for Cloud Intelligence).

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

    Note
    • These public skills can be used only with the Cloud Intelligence app.
    • The names of the public skills for the Cloud Intelligence app cannot be changed. This name is also displayed on third-party voice platforms. If you need a skill that is 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 more information, see Create a skill.

Create a skill

  1. Log on to the IoT Platform console.
  2. In the navigation pane, choose Operation Center > Voice Service to go to the Voice Service Management page.
  3. Click Create Skill.
  4. On the Basic Information tab, enter the basic information for the skill, and then click Next.

    The following table describes the basic information for a skill.

    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 that the skill connects to. Select one from the drop-down list. Google
    Configured project The skill must be configured under a project. This binds the skill to the products in that project. Select a project from the drop-down list. Test Project
    Associated App The app to associate with the skill. Select an app from the drop-down list.
    Note Only private-brand apps created in private-brand projects can be associated. The Cloud Intelligence app can directly use the public skills.
    		Private-brand App
  5. On the Configure and Bind tab, click Configure on Platform to go to the third-party voice platform. On the third-party platform, configure, verify, and publish the skill. After you are finished, copy the configuration information back to the console. Confirm that the information is correct and click Next.
    Note The skill that you create on the IoT Platform is primarily used to link accounts with a third-party voice platform. Based on the voice platform that you selected in the previous step, click Configure on Platform to configure, verify, and publish the skill on the third-party platform. For more information about operations on third-party platforms, see the following documents:
    • If you select the Amazon Alexa voice platform, fill in the skill information as described in the following table to bind the skill.
      Term Description Example
      OAuth Authorization Settings The callback uses OAuth. 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 setting on the Account Linking page of the Alexa skill. https://pitangui.amazon.com/api/skill/link/MB****CTIMCLT
      Customer Service Email This email address is displayed on the help page for Alexa skill account linking. Enter a contact email address. a***@example.net
      Alexa Client Id The Client ID generated by the Alexa platform on the Permissions page in the Alexa developer 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 developer console. f666310a23651d4852dd6870b3ba54d29e815f05e659a4ee85058483****63b6
      Alexa Skill Id The skill ID generated when you create the skill in the Alexa developer console. amzn1.ask.skill.3be38fae-e2a1-4825-8291-4b28****b959
    • If you select the Google Home voice platform, fill in the skill information as described in the following table to bind the skill.
      Term Description Example
      OAuth Authorization Settings The callback uses OAuth. Enter the Project ID of your Google Action. 111111111****1
      Push Proxy Account Settings The service account under the developer project you created in Google. The platform uses 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 address is displayed on the help page for Google skill account linking. Enter a contact email address. a***@example.net
  6. On the Activate Service tab, purchase and activate the voice service.

    If the custom skill development service is not activated, click Purchase. On the page that appears, purchase and activate the service. For more information about the fees for the custom skill service, see Service billing.

    Important The service to purchase here is the custom skill voice service. This service is billed based on usage. You can purchase only the custom skill service during this process.

    The purchase process is as follows:

    1. Confirm the voice service specifications and click Confirm Purchase to activate the service.
    2. 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 complete, return to the skill creation page. You can click Refresh to update the service activation status.
  7. On the Test and Publish tab, download and log on to your private-brand app where the skill is configured. Then, bind the skill in your app.
  8. 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. From there, you can open the skill management page to view and edit the skill's configuration and manage its bound products.

  1. In the Skill List, find the skill that you want to manage and click Manage in the Actions column.
  2. On the skill management page, you can view the basic information of the skill. You can also click Edit to change the OAuth authorization information.
  3. To bind new products to the skill, click Bind Product on the Skill Management page. Select and configure the product information. For more information, see Bind and manage products.