CancelCopilotTurn - 取消安全运营Agent对话轮次

更新时间:
复制 MD 格式

请求取消指定安全运营Agent对话轮次,并返回取消请求处理后的轮次状态。

接口说明

取消指定安全运营 Agent 对话轮次。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

POST /api/v1/copilot/turn/cancel HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

RegionId

string

否

威胁分析的数据管理中心所在地。您需要根据资产所在地域,选择管理中心所在地。取值:

  • cn-hangzhou:资产属于中国内地。

  • ap-southeast-1:资产属于海外地域。

cn-hangzhou

Lang

string

否

返回消息的语言类型。取值:

  • zh(默认):中文。

  • en:英文。

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****"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。