设置知识标签
设置知识标签
说明
在知识库中，用户可以对每一条知识设置知识标签。在点击设置知识标签以及选择知识标签时，系统都会返回知识标签列表，用户可以在知识标签列表中选择需要的知识标签。
请求参数
| 名称 |
类型 |
必选 |
中文名 |
说明 |
| Content-Type |
string |
是 |
内容类型 |
固定值：application/json |
| AgentId |
string |
是 |
机器人id |
|
| tenantId |
string |
是 |
租户id |
|
| token |
string |
是 |
API KEY |
集成-API-API Key处获取。
详细获取方式参考：准备工作 |
Param参数
| 名称 |
类型 |
必选 |
中文名 |
说明 |
| pn |
int |
否 |
当前页码 |
默认为1 |
| ps |
int |
否 |
每页展示的记录数量 |
默认为10 |
| keyword |
string |
否 |
关键字 |
搜索标签时，输入的关键字 |
| orderBy |
string |
否 |
排序字段 |
根据什么字段排序，默认为更新时间 |
| order |
string |
否 |
排序方式 |
升降序，默认降序 |
Body参数
| 名称 |
类型 |
必填 |
中文名 |
说明 |
| labelValueIds |
list |
否 |
知识标签ID |
|
| labelIds |
list |
否 |
|
|
响应参数
| 名称 |
类型 |
必填 |
中文名 |
说明 |
| time |
integer |
是 |
时间 |
1717036810964 |
| data |
object |
是 |
数据 |
数据对象，详见 data 子数据 |
| code |
integer |
是 |
状态码 |
200 |
| msg |
string |
是 |
状态信息 |
OK |
data 子数据
| 名称 |
类型 |
必填 |
中文名 |
说明 |
| list |
list[list] |
是 |
知识标签列表 |
知识标签列表，详见 list 子数据 |
| pn |
int |
否 |
当前页码 |
默认值为0 |
| ps |
int |
否 |
每页展示的记录数量 |
默认值为0 |
| total |
int |
否 |
总数 |
默认值为0 |
| refresh |
boolean |
否 |
是否需要刷新 |
默认为false |
list 子数据
| 名称 |
类型 |
必填 |
中文名 |
说明 |
| id |
string |
是 |
标签id |
|
| name |
string |
是 |
标签名称 |
|
| nameEn |
string |
是 |
英文名称 |
|
| tenantId |
string |
是 |
租户id |
|
| lastEditUserId |
string |
是 |
最近编辑用户id |
|
| lastEditUserName |
string |
是 |
最近编辑用户名称 |
|
| created |
string |
是 |
创建时间 |
|
| updated |
string |
是 |
最近一次更新时间 |
|
| valueList |
list[valueList] |
是 |
标签值列表 |
详见 valueList 子数据 |
valueList 子数据
| 名称 |
类型 |
必填 |
中文名 |
说明 |
| id |
string |
是 |
标签值id |
|
| name |
string |
是 |
标签值名称 |
|
| tenantId |
string |
是 |
租户id |
|
| knowledgeLabelId |
string |
是 |
标签id |
|
| created |
string |
是 |
创建时间 |
|
| updated |
string |
是 |
最近一次更新时间 |
|
请求示例
curl --location 'https://keyue-test.cloud.baidu.com/open/v1/api/v2/knowledge/label/list' \
--header 'AgentId: 84bd789d-0961-44af-b54c-8163d011a0b3' \
--header 'tenantId: 3156952326602753' \
--header 'token: 7f3894e7-01d8-4e2e-88d0-ef437ffd3f63' \
--header 'Content-Type: application/json' \
--data '{"labelValueIds":["c0682073-c869-49b8-96c3-24007b2909bb"]}'
响应示例
{
"time": 1731911333429,
"data": {
"list": [
{
"id": "74cfcbed-4a8f-4540-a1f9-499d3a51c586",
"name": "wddwdwwdwd",
"nameEn": "l",
"tenantId": "3156952326602753",
"lastEditUserId": "cf7d9692703d45d1b5517a30ab3efa53",
"lastEditUserName": "pnstest5",
"created": "2024-10-22 11:32:37",
"updated": "2024-10-22 11:55:17",
"valueList": [
{
"id": "15d997b4-b270-415a-9f46-252d99c472f0",
"name": "dwdwdwdwdwdw",
"tenantId": "3156952326602753",
"knowledgeLabelId": "74cfcbed-4a8f-4540-a1f9-499d3a51c586",
"updated": "2024-10-22 11:55:17",
"created": "2024-10-22 11:32:37"
}
]
}
],
"ps": 0,
"pn": 0,
"total": 0,
"refresh": false
},
"code": 200,
"msg": "OK"
}
![]()
