addPanelAgentCustomRole(params: AddPanelAgentCustomRoleParams)

Requires:
@tuya-miniapp/cloud-api≥1.0.6

Description

Create a custom role.

Parameters

ParameterTypeRequiredDescription
YesRequest body

Return Value

Type: Promise<string>
AddPanelAgentCustomRoleResult (see type definitions and minituya return parameters for field meanings)

Examples

Request example

import { addPanelAgentCustomRole } from '@tuya-miniapp/cloud-api';

const params = {
  devId: 'your_device_id',
  roleName: 'Smart Assistant Xiaomei',
  roleDesc: 'A gentle and caring smart assistant',
  roleIntroduce: "I'm Xiaomei, your dedicated smart assistant. Glad to serve you!",
  roleVariables: {
    personality: 'friendly',
    expertise: 'general',
  },
  roleImgUrl: 'https://example.com/avatar.jpg',
  useLangCode: 'zh-CN',
  useTimbreId: 'timbre_001',
  useLlmId: '1001',
  speed: '1.0',
  tone: 'gentle',
};

addPanelAgentCustomRole(params)
  .then(result => {
    console.log('Created successfully, role ID:', result);
  })
  .catch(error => {
    console.error('Failed to create custom role:', error);
  });

Response example

"role_custom_12345"