Initialize Role Binding

initializePanelAgentRoleBinding(params: InitializePanelAgentRoleBindingParams)

Requires:

@tuya-miniapp/cloud-api≥1.0.6

Description

Initialize role-agent binding.

Parameters

Parameter	Type	Required	Description
		Yes	Request body

Return Value

Type: Promise<PanelAgentRoleDetail>

InitializePanelAgentRoleBindingResult (see type definitions and minituya response parameters for field meanings)

Referenced Types

typePanelAgentRoleDetail

Property	Type	Description
`roleId`	string	Role ID
`roleName`	string	Role name
`roleDesc`	string	Role description
`roleIntroduce`	string	Role description
`roleImgUrl`	string	Role image
`useLangCode`	string	Role language code
`useLangName`	string	Role language name
`useTimbreId`	string	Voice used by the role
`isUserCloneTimbre`	boolean	Whether it is a custom cloned voice
`useTimbreName`	string	Name of the voice used by the role
`useTimbreSupportLangs`	string	Languages supported by the role's voice, separated by commas
`useTimbreSupportLangList`	string[]	List of languages supported by the role's voice
`useTimbreTags`	string[]	Role tags
`useLlmId`	string	Role language model
`useLlmName`	string	Role language model name
`inBind`	boolean	Whether bound
`memoryInfo`	string	Memory
`speed`	number	Voice speed
`tone`	number	Voice tone
`templateId`	string	Template ID
`bindRoleType`	number	Type of bound role
`lastTextAnswer`	string	Most recent reply text
`llmSupportFuncTags`	string	Function tags supported by the language model, separated by commas

Examples

Request example

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

const params = {
  devId: 'your_device_id',
};

initializePanelAgentRoleBinding(params)
  .then(result => {
    console.log('Initialization result:', result);
  })
  .catch(error => {
    console.error('Failed to initialize binding relationship:', error);
  });

Response example

{
  "roleId": "role_initialized_001",
  "roleName": "Initialized smart assistant",
  "roleDesc": "Default smart assistant initialized by the system",
  "roleIntroduce": "I am the smart assistant initialized by the system for you",
  "roleImgUrl": "https://example.com/default_avatar.jpg",
  "useLangCode": "zh-CN",
  "useLangName": "Chinese (Simplified)",
  "useTimbreId": "timbre_default_001",
  "isUserCloneTimbre": false,
  "useTimbreName": "Default timbre",
  "useTimbreSupportLangs": "zh-CN",
  "useTimbreSupportLangList": ["zh-CN"],
  "useTimbreTags": ["Default", "Initial"],
  "useLlmId": "1001",
  "useLlmName": "GPT-3.5-turbo",
  "inBind": true,
  "memoryInfo": "Initialization memory info",
  "speed": 1.0,
  "tone": 0.5,
  "templateId": "default_template",
  "bindRoleType": 2,
  "lastTextAnswer": "Hello, I am your smart assistant. Glad to serve you!",
  "llmSupportFuncTags": "text"
}