Skip to content

XiaoAI Skill Configuration Guide

XiaoAI Open Platform: https://developers.xiaoai.mi.com/ (use the same account as the Xiaomi IoT platform) XiaoAI App: download from app stores XiaoAI integration help: https://developers.xiaoai.mi.com/documents/introduction

Integration Flow

  1. Create a skill on the XiaoAI Open Platform
  2. Configure XiaoAI voice settings on the private cloud platform
  3. Configure cloud-to-cloud services on the XiaoAI Open Platform
  4. Configure skill utterances on the XiaoAI Open Platform
  5. Test the skill in the XiaoAI Open Platform web console
  6. Test the skill with a XiaoAI speaker
  7. Publish and go live

Start Integration

Create a Skill on the XiaoAI Open Platform

Create a skill on the XiaoAI Open Platform and note the Skill IDimage-20240708173450639

Select Custom Skillimage-20240708181632122image-20240708181643514image-20240708181651978

Return to the skill list and copy the Skill ID for the next step;image-20240708181659557

Configure XiaoAI Voice Control on the Private Cloud Platform

Open product details, switch to the Voice Control tab. You will see the speaker platforms supported by the platform. Today we integrate XiaoAI—scroll down to find the XiaoAI configuration; image-20240708184929923 Brand name, device type, and product model can be filled as needed, but the Skill ID must be obtained from the skill information on the XiaoAI Open Platform;image-20240708185800705

image-20240708185809781

Configure Skill Utterances on the XiaoAI Open Platform

Go to My Skills, expand skill details, and click Edit for the corresponding version; image-20240708185924677

Configure intents image-20240708185935072

First add system intents Note: the welcome intent and the fallback (not understood) intent need to be configured with your custom intents; image-20240708185945621image-20240708185951203

Configure custom intents image-20240708190110710

image-20240708190116998

image-20240708190122599

Configure XiaoAI Open Platform Services (Cloud-to-Cloud)

Obtain the server addresses from the Ubases IoT platform. For the command gateway, use the XiaoAI-specific endpoint whose path ends in xiaoaiIoTGateWay; do not reuse a Tmall Genie or other voice-platform gateway. image-20240708190244225

Test the Skill in the XiaoAI Open Platform Web Console

Go to device debugging. Xiaomi provides a web test tool. First enter your wake word. Finding an available skill wake word is difficult because it must be unique across the network, so you may not get the name you want; image-20240708190850002

Enter the wake word; the speaker returns your configured welcome intent; image-20240708190906678

Next, say your configured on/off intent, for example “turn on the switch of device xxx” If everything goes well, you should see activity in the cloud logs, and successful testers will find their device has turned on;

Test the Skill with a XiaoAI Speaker

For real-device testing, see the following image-20240708190925683

Say to XiaoAI:

  • XiaoAI
  • Enter developer mode
  • Open Buck Humidifier (this example name was used because many preferred names were already taken)
  • Turn on the switch of device xxxx;

Publish and Go Live

Process description: XiaoAI Open Platform (mi.com) Brief summary: Ensure your intent configuration is complete (welcome intent, fallback intent, exit intent, and custom intents), finish testing, and send the test report to the Xiaomi email address (xiaoai@xiaomi.com)

Released under the MIT License. Build Time 2026-09-11 14:52:23