查询单个规则标签
更新时间:2026-11-17
概述
调用接口,可按机器人 ID 和标签 ID,读取当前租户一个自定义规则标签(V2)的当前配置,包含该标签的子规则和已保存的匹配条件。
data 直接返回单个标签对象,与“查询规则标签列表”中单个列表项的结构一致,不是分页结果。适合已知标签 ID 时查询配置,或在编辑前、发生版本冲突后重新读取配置和版本号。刚取得完整列表项时,无需固定再调用一次本接口。
URL
https://aiob-open.baidu.com/api/v1/robot/label/rule/detail
HTTP Method
GET
请求参数
HEADER
| 参数名称 | 是否必须 | 说明 | 示例 |
|---|---|---|---|
| Authorization | 是 | 参考“生成认证Token”文档获取完整的 OpenAPI Token,原样传入,不加 Bearer 前缀。 | cc-api-auth-v2/your_token |
PARAM
以下参数通过 URL 查询参数传入,无需请求体。
| 参数名称 | 是否必须 | 参数类型 | 说明 | 示例 |
|---|---|---|---|---|
| robotId | 是 | String | 标签所属的当前租户机器人 ID,不能为空。按该机器人 ID 校验标签归属,不自动转换草稿或线上 ID。 | 11111111-1111-4111-8111-111111111111 |
| id | 是 | String | 要查询的标签 ID,不能为空。可从标签列表项或创建结果的 id 字段取得;不是子规则 ID。 | 22222222-2222-4222-8222-222222222222 |
说明:
- 查询范围由 Authorization 所属租户、robotId 和标签 id 共同确定。robotId 和 id 均不能省略、传空字符串或全空白。
- 机器人或标签不存在、已删除、不属于当前租户,或标签不属于传入的 robotId 时,返回失败,不以空标签对象表示查询成功。
- robotId 与标签 id 必须对应同一个机器人记录,不能混用草稿标签 ID 与线上机器人 ID。需要修改草稿规则时,应查询草稿机器人对应的标签。
- 启用和禁用的标签均可查询,返回内容包含其启用和禁用的子规则。本接口只读取配置,不执行规则匹配。
- 本接口读取指定标签的当前配置,不提供分页、名称筛选或按 version 查询历史配置的能力。
响应参数
公共响应字段:
| 字段名称 | 数据类型 | 说明 |
|---|---|---|
| requestId | string | 请求标识,用于定位请求。 |
| time | long | 响应时间戳,单位为毫秒。 |
| code | int | 业务结果码,200 表示成功。 |
| msg | string | 处理结果说明。 |
| data | object | 单个规则标签的当前配置,字段见下表。 |
data 字段(标签对象):
| 字段名称 | 数据类型 | 说明 |
|---|---|---|
| id | string | 标签 ID,后续修改、启用、禁用或删除该标签时使用。 |
| name | string | 标签名称。 |
| remark | string | 标签备注,可能为空。 |
| status | int | 标签启用状态:0 禁用,1 启用。标签启停使用专用接口操作。 |
| version | int | 标签配置版本号。修改该标签时原样带回,用于防止旧配置覆盖他人的修改;不是机器人发布版本。 |
| rules | array<object> |
该标签下的子规则列表,无子规则时为空数组。每个子规则的字段见下表。 |
子规则对象字段(rules 中的每个元素):
| 字段名称 | 数据类型 | 说明 |
|---|---|---|
| id | string | 子规则 ID,修改已有子规则时使用。不能作为本接口请求中的标签 id。 |
| status | int | 本条子规则的启用状态:0 禁用,1 启用。 |
| version | int | 本条子规则的配置版本号,修改已有子规则时原样带回;与标签自身的 version 分别使用。 |
| labelRuleVO | object | 本条子规则保存的匹配条件,业务字段见下表。 |
标签和子规则均为启用状态时,该子规则才参与匹配。同一标签下多条启用子规则中,任意一条满足即可命中该标签;relation 只控制单条子规则内部各条件的组合关系。
labelRuleVO 字段:
| 字段名称 | 数据类型 | 说明 |
|---|---|---|
| relation | string | 本条子规则内各条件的组合关系:AND 表示全部满足,OR 表示任一满足。 |
| durationExpress | object | 通话时长条件,单位为秒,比较值为整数。 |
| talkingTurnExpress | object | 机器人回复次数条件,比较值为十进制整数字符串。 |
| voiceTalkingTurnExpress | object | 用户回复次数条件,比较值为十进制整数字符串。 |
| callTimesExpress | object | 拨打次数条件,比较值为十进制整数字符串。 |
| connectedTimesExpress | object | 接通次数条件,比较值为十进制整数字符串。 |
| callStatusExpress | object | 接听状态条件,比较值为整数:0 未接听,1 已接听。 |
| callStatusDetailExpress | object | 最终通话状态条件,compareValues 保存状态编码,例如 answered 表示已接听。 |
| hangupExpress | object | 挂断方条件,比较值为整数:0 机器人挂断,1 管理员挂断,2 用户挂断,3 振铃挂断。 |
| artificialExpress | object | 转人工结果条件,比较值为整数:0 未发起,1 成功,-1 失败。 |
| collectInfoExpresses | array<object> |
采集内容匹配条件,每项通过 compareValues 保存比较文本。 |
| modelLabelExpresses | array<object> |
模型标签匹配条件,每项通过 compareValues 保存比较文本,例如“意向:高”。 |
上述条件对象中的主要业务字段:
| 字段名称 | 数据类型 | 说明 |
|---|---|---|
| operator | string | 已保存的比较方式,例如 EQUALS、GTE、BETWEEN、IN、NOT_IN,适用方式由条件类型决定。 |
| compareValue | int 或 string | 单值比较的目标值;BETWEEN 时为区间下界。数值类型见对应条件的说明。 |
| compareValueMax | int 或 string | BETWEEN 区间的上界,区间包含上下界;类型与 compareValue 一致,其他比较方式下可能为空。 |
| compareValues | array<string> |
最终通话状态、采集内容和模型标签等多值条件使用的比较值列表。 |
未配置的条件字段可能为空。只做查询时可忽略 version;修改标签或已有子规则时,分别带回对应版本号,不自行递增。
修改时需按修改接口组装请求,不能将整个 data 对象原样提交。父标签 status 需省略或传 null;标签启停请使用启用或禁用接口。调用方需保留本次请求中的 robotId,后续操作仍需使用。
请求示例
Text
1GET https://aiob-open.baidu.com/api/v1/robot/label/rule/detail?robotId=11111111-1111-4111-8111-111111111111&id=22222222-2222-4222-8222-222222222222
示例中的 robotId 和 id 需分别替换为当前租户的实际机器人 ID 及该机器人下的标签 ID。请求头中的 your_token 需替换为实际 Token。
返回示例
以下示例返回一个标签,该标签包含一条启用的子规则,条件为“通话时长不少于 30 秒”。条件对象仅展示已配置的主要业务字段。
JSON
1{
2 "requestId": "example-request-id",
3 "time": 1794787200000,
4 "code": 200,
5 "msg": "OK",
6 "data": {
7 "id": "22222222-2222-4222-8222-222222222222",
8 "name": "通话时长达标",
9 "remark": "通话时长不少于30秒",
10 "status": 1,
11 "version": 0,
12 "rules": [
13 {
14 "id": "33333333-3333-4333-8333-333333333333",
15 "status": 1,
16 "version": 0,
17 "labelRuleVO": {
18 "relation": "AND",
19 "durationExpress": {
20 "operator": "GTE",
21 "compareValue": 30
22 }
23 }
24 }
25 ]
26 }
27}
评价此篇文章
