Skip to main content

your_chat_bot — cloud AI Agent

This is the classic TuyaOpen AI + IoT project. The focus here is the cloud IoT / AI Agent development flow inside the IDE.

Two development modes

ModeSuited forSteps
Basic (recommended for beginners)New to TuyaOpen or AIUse the official default PID directly (feature and agent configuration already done).
AdvancedBuilding your own product1. Create a PID · 2. Create an Agent · 3. Bind the Agent to the PID.

This practice uses Basic mode — fast for beginners and a real taste of three-ends-in-one.

Step 1: Create a project from an example

  1. Click Demos in the IDE sidebar, choose AI voice chatbot, and click Create project.

  2. Select Tuya T5AI and the Tuya T5AI-Board, plus the 3.5-inch LCD touch screen (optional).

    Examples gallery — AI voice chatbot
    Examples gallery — AI voice chatbot

  3. Follow the prompt to grab the OEM example PID. This opens the Tuya Developer Platform in your browser. For what a PID is, see PID.

    OEM example PID — jump to the developer platform
    OEM example PID — jump to the developer platform

  4. Click Copy product, fill in a product name and model number, and confirm.

    Copy product dialog
    Copy product dialog

  5. Copy the PID on the left.

    Copy the PID on the left
    Copy the PID on the left

  6. Back in TuyaOpen IDE, paste the PID and click Next to create the project.

    Paste the PID and create the project in the IDE
    Paste the PID and create the project in the IDE

note

Why copy? Copying quickly produces a product with the same features as the default PID. For AI + IoT products it also copies the Agent already bound to that product.

Step 2: Build and flash

  1. In Cloud IoT/Agent Dev you can see that the cloud product is now bound.

    Cloud IoT / Agent page — product bound
    Cloud IoT / Agent page — product bound

  2. Open Project Details and build and flash. At the bottom of the page you can see the Vibe Coding hardware view and all pin states.

    Project Details — Vibe Coding hardware view
    Project Details — Vibe Coding hardware view

  3. After flashing succeeds, the touch screen lights up.

Step 3: Authorize the device

The license key (UUID + AuthKey) is the credential a device uses to reach the cloud, obtained from the Tuya IoT Platform.

  1. For the concept of license keys and how to get them, see TuyaOpen license keys and the authorization guide. For this practice, claim two free license keys first. Back on the Tuya Developer Platform, open AI Products → Product Development to see the OEM example product from step 1.

    OEM example product in the developer platform
    OEM example product in the developer platform

  2. Click Continue development on the right.

    Continue development on the platform
    Continue development on the platform

  3. Under the Hardware Development tab, in the selected cloud-access hardware section, click Get 2 Free Licenses.

    Get 2 Free Licenses button
    Get 2 Free Licenses button

    License keys claimed
    License keys claimed

    License key list detail
    License key list detail

  4. Download the license key list.

    Download the license key list
    Download the license key list

  5. Enter the license keys in the IDE's Licenses panel (Key Management).

    IDE license key manager
    IDE license key manager

  6. Use AI to write the license key to the device.

    AI writes the license key to the device
    AI writes the license key to the device

Step 4: Pair the device

  1. Follow the official device network configuration steps to pair the device.

  2. Once paired, you can switch the AI Agent you talk to from the mini-app panel.

    Switch AI Agent from the mini-app panel
    Switch AI Agent from the mini-app panel

  3. Double-tap the board KEY button to switch conversation mode. The current project supports the wake words "你好涂鸦" / "Hey Tuya".

info

Going further — building your own Agent (Advanced mode): see the Agent Development Guide.

Next step

You have a cloud-connected device. Continue with Practice 3: mini-app panel — build the phone control panel for it.