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

## getPanelAgentRoleTemplateList

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

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

### 描述

查询角色模板列表。

### 参数

`Params`

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

### 引用对象

##### `interface` GetPanelAgentRoleTemplateListParams

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `devId` | `string` | 设备ID |
| `tagCode` | `string` | 标签 |


### 示例代码

#### 请求示例

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

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

getPanelAgentRoleTemplateList(params)
  .then(result => {
    console.log('角色模板列表:', result);
  })
  .catch(error => {
    console.error('获取角色模板列表失败:', error);
  });
```

#### 返回示例

```json
[
  {
    "templateId": "template_001",
    "roleId": "role_001",
    "roleName": "智能助手",
    "roleDesc": "专业的智能助手",
    "roleImgUrl": "https://example.com/role_avatar.jpg",
    "roleIntroduce": "我是您的专属智能助手",
    "useLangCode": "zh-CN",
    "useLangName": "中文（简体）",
    "useTimbreId": "timbre_001",
    "useTimbreName": "温柔女声",
    "useTimbreSupportLangs": "zh-CN,en-US",
    "useTimbreSupportLangNames": "中文（简体）,English",
    "useLlmId": "1001",
    "useLlmName": "GPT-3.5-turbo",
    "inConversation": false,
    "lastTextAnswer": "",
    "bindStatus": false
  }
]
```