请求取消指定安全运营Agent对话轮次,并返回取消请求处理后的轮次状态。
接口说明
取消指定安全运营 Agent 对话轮次。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST /api/v1/copilot/turn/cancel HTTP/1.1
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| RegionId |
string |
否 |
威胁分析的数据管理中心所在地。您需要根据资产所在地域,选择管理中心所在地。取值:
|
cn-hangzhou |
| Lang |
string |
否 |
返回消息的语言类型。取值:
|
zh |
| TraceId |
string |
否 |
用于跟踪服务请求。 |
550e8400e29b41d4a71644665544**** |
| ConversationId |
string |
是 |
会话 ID |
54b6c969-4b75-47be-9f43-71f88aeb**** |
| TurnId |
string |
是 |
主键 ID。 |
dc18b894-19a3-45ee-8768-a59478e0**** |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
响应 |
||
| ApiVersion |
string |
API 版本号,"1.0.0"。 |
v1.2 |
| Turn |
object |
安全运营 Agent 对话轮次 |
|
| TurnId |
string |
主键 ID。 |
dc18b894-19a3-45ee-8768-a59478e0**** |
| ClientMessageId |
string |
客户端消息 ID |
366932fb-9a83-4a2d-94dd-c925b35f**** |
| Status |
string |
状态 |
success |
| RetryAllowed |
boolean |
是否允许重试 |
|
| CreatedAt |
string |
创建时间 |
2026-08-23T02:13:49Z |
| ConversationId |
string |
会话 id |
54b6c969-4b75-47be-9f43-71f88aeb**** |
| InputTokens |
integer |
输入使用的 Token 数量 |
1280 |
| OutputTokens |
integer |
输出 Token 数量 |
856 |
| ReasoningTokens |
integer |
当日推理 Token 数量 |
420 |
| ModelId |
string |
模型 ID |
model-**** |
| Feedback |
integer |
返回对话信息 |
1 |
| RequestId |
string |
请求 ID |
9AAA9ED9-78F4-5021-86DC-D51C7511**** |
示例
正常返回示例
JSON格式
{
"ApiVersion": "v1.2",
"Turn": {
"TurnId": "dc18b894-19a3-45ee-8768-a59478e0****",
"ClientMessageId": "366932fb-9a83-4a2d-94dd-c925b35f****",
"Status": "success",
"RetryAllowed": true,
"CreatedAt": "2026-08-23T02:13:49Z",
"ConversationId": "54b6c969-4b75-47be-9f43-71f88aeb****",
"InputTokens": 1280,
"OutputTokens": 856,
"ReasoningTokens": 420,
"ModelId": "model-****",
"Feedback": 1
},
"RequestId": "9AAA9ED9-78F4-5021-86DC-D51C7511****"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。