---
name: "createPanelAgentRoleFromTemplate"
mode: "kit"
versionRequirements:
  - { name: "@tuya-miniapp/cloud-api", version: "1.0.6" }
---

## createPanelAgentRoleFromTemplate

> [VERSION] @tuya-miniapp/cloud-api >= 1.0.6

> 💡 接口依赖云能力，需在 [小程序开发者平台](https://platform.tuya.com/miniapp/)开发设置 - 云能力 进行授权配置。

### 描述

根据角色模板创建自定义角色。

### 参数

`Params`

| 参数 | 类型 | 必填 | 默认值 | 描述 |
| --- | --- | --- | --- | --- |
| `params` | `CreatePanelAgentRoleFromTemplateParams` | 是 | - | 请求体 |

### 引用对象

##### `interface` CreatePanelAgentRoleFromTemplateParams

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `devId` | `string` | 设备ID |
| `roleId` | `string` | 角色模板/角色ID（根据场景） |
| `roleName` | `string` | 角色名称 |
| `roleDesc` | `string` | 角色描述 |
| `roleIntroduce` | `string` | 角色介绍 |
| `roleVariables` | `Record<string, any>` | 角色变量 |
| `roleImgUrl` | `string` | 角色图像 |
| `useLangCode` | `string` | 角色使用语言 |
| `useTimbreId` | `string` | 角色使用音色 |
| `useLlmId` | `string` | 角色使用语言模型 |
| `memoryInfo` | `string` | 记忆体 |
| `speed` | `string` | 音色速度 |
| `tone` | `string` | 音色语气 |
| `needBind` | `string` | 是否需要绑定 |


### 示例代码

#### 请求示例

```typescript
import { createPanelAgentRoleFromTemplate } from '@tuya-miniapp/cloud-api';

const params = {
  devId: 'your_device_id',
  roleId: 'template_role_001',
  roleName: '基于模板的智能助手',
  roleDesc: '从模板创建的定制助手',
  roleIntroduce: '我是基于模板创建的智能助手',
  roleVariables: {
    customization: 'template_based',
    features: ['smart', 'helpful'],
  },
  roleImgUrl: 'https://example.com/template_avatar.jpg',
  useLangCode: 'zh-CN',
  useTimbreId: 'timbre_001',
  useLlmId: '1001',
  memoryInfo: '从模板继承的记忆信息',
  speed: '1.0',
  tone: '0.8',
  needBind: 'true',
};

createPanelAgentRoleFromTemplate(params)
  .then(result => {
    console.log('创建成功，新角色ID:', result);
  })
  .catch(error => {
    console.error('从模板创建角色失败:', error);
  });
```

#### 返回示例

```json
"role_custom_from_template_12345"
```