启用规则标签
更新时间:2026-11-17
概述
调用接口,可启用当前租户草稿机器人下的自定义规则标签(V2),将父标签状态设为启用。
本接口只启用父标签,保留各子规则原有启用状态。父标签和对应子规则均启用时,该子规则才参与匹配;同一标签下任意一条启用子规则满足即可命中该标签。
URL
https://aiob-open.baidu.com/api/v1/robot/label/rule/enable
HTTP Method
POST
请求参数
HEADER
| 参数名称 | 是否必须 | 说明 | 示例 |
|---|---|---|---|
| Authorization | 是 | 参考“生成认证Token”文档获取完整的 OpenAPI Token,原样传入,不加 Bearer 前缀。 | cc-api-auth-v2/your_token |
| Content-Type | 是 | 请求体采用 JSON 格式。 | application/json |
PARAM
以下参数通过 JSON 请求体传入。
| 参数名称 | 是否必须 | 参数类型 | 说明 | 示例 |
|---|---|---|---|---|
| robotId | 是 | String | 当前租户的草稿机器人 ID,不能为空,且须与标签所属机器人一致。线上机器人 ID 不会自动转换为草稿 ID。 | "11111111-1111-4111-8111-111111111111" |
| id | 是 | String | 待启用的标签 ID,从创建、列表或详情接口返回中取得。不是子规则 ID。 | "22222222-2222-4222-8222-222222222222" |
说明:
- 操作范围由 Authorization 所属租户确定。机器人或标签不存在、已删除、不属于当前租户,或机器人不是草稿时,启用失败;标签须属于传入的 robotId。
- 请求只需 robotId 和 id,无需传入 status、version、tenantId 或子规则列表。接口路径已表示启用操作,不通过本接口修改名称、备注或规则条件。
- 从禁用切换为启用时,标签下启用子规则最多为 5 条,按子规则 status=1 计数,禁用子规则不计入。超过上限时启用失败,业务码为 4002007;恰好 5 条可以启用。
- 标签没有子规则,或所有子规则均禁用时,也可以启用父标签,但此时不会命中该标签。本接口不会把禁用子规则一并启用。
- 机器人和标签均有效且归属一致时,标签已启用的重复请求直接返回成功,不重复写入状态,也不重复增加版本号。
- 父标签实际从禁用变为启用后,标签配置 version 加 1,子规则的状态、条件及 version 保持原值。后续修改标签前,应重新查询当前配置,使用最新标签 version,不继续使用启用前的旧值。
- 本接口只保存草稿标签的启用状态,不执行机器人发布,也不自动修改关联线上机器人的标签。草稿尚未发布时,正式外呼继续使用原线上配置;等待缓存刷新不能替代发布。需要线上使用该配置时,请通过现有机器人发布流程操作。
- 可通过“查询单个规则标签”核对父标签 status=1 及最新 version,通过“测试规则标签”验证草稿的已保存配置。详情查询和规则测试读取指定机器人已保存的标签配置,无需等待通话运行时的规则缓存刷新;正式外呼是否命中不能作为本次草稿启用是否保存成功的判断依据。
响应参数
公共响应字段:
| 字段名称 | 数据类型 | 说明 |
|---|---|---|
| requestId | string | 请求标识,用于定位请求。 |
| time | long | 响应时间戳,单位为毫秒。 |
| code | int | 业务结果码,200 表示成功,包括标签已经处于启用状态的情况。 |
| msg | string | 处理结果说明。 |
| data | object / null | 无业务数据,不返回标签详情。空值形式沿用公共响应封装,调用方无需读取其具体内容。 |
本接口不返回启用后的标签对象。需要确认最新状态或版本号时,使用本次请求中的 robotId 和 id 查询标签详情。
请求示例
Text
1POST https://aiob-open.baidu.com/api/v1/robot/label/rule/enable
JSON
1{
2 "robotId": "11111111-1111-4111-8111-111111111111",
3 "id": "22222222-2222-4222-8222-222222222222"
4}
robotId、id 需替换为当前租户的实际草稿机器人 ID 及该机器人下的标签 ID。请求头中的 your_token 需替换为实际 Token。
返回示例
以下示例以空对象展示 data,本接口无需解析该字段;根据 code=200 判断本次启用成功或标签已启用。
JSON
1{
2 "requestId": "example-request-id",
3 "time": 1794787200000,
4 "code": 200,
5 "msg": "OK",
6 "data": {}
7}
评价此篇文章
