GetCopilotConversation - 获取安全运营Agent会话

更新时间:
复制 MD 格式

查询指定安全运营Agent会话的元数据、状态、配置和历史摘要信息。

接口说明

查询指定安全运营 Agent 会话。

调试

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

调试

授权信息

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

请求语法

POST /api/v1/copilot/conversation/get HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

RegionId

string

否

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

  • cn-hangzhou:资产属于中国内地与中国香港,选择该项。

  • ap-southeast-1:资产属于海外地域,选择该项。

cn-hangzhou

Lang

string

否

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

  • zh(默认):中文。

  • en:英文。

zh

TraceId

string

否

调用链 id,用于精确查询调用信息。

550e8400e29b41d4a71644665544****

ConversationId

string

是

会话 ID

54b6c969-4b75-47be-9f43-71f88aeb****

返回参数

名称

类型

描述

示例值

object

响应

ApiVersion

string

接口版本

v1.2

Conversation

object

对话文本 id

ConversationId

string

会话 ID

54b6c969-4b75-47be-9f43-71f88aeb****

Title

string

会话标题

安全事件调查

Status

string

状态

active

Visibility

string

可见性,可选值:

  • PUBLIC:公开

  • PRIVATE:私有

1

CreatedAt

string

该字段为空

2026-04-29T02:07:24Z

UpdatedAt

string

更新日期

2026-06-09T10:27:35

Model

string

模型标识

qwen3.7-max

ThinkingMode

string

深度思考配置

false

PlanMode

string

是否开启计划,可选[disable, enable, force],默认值是 enable

enabled

ProjectId

string

项目 ID

project-incident-****

Feedback

integer

反馈。

1

ScheduledTaskId

string

定时任务的 ID,由系统生成,全局唯一。

task-e34f770da4f04f6db21c2819****

LastTurnId

string

最近对话轮次 ID

dc18b894-19a3-45ee-8768-a59478e0****

ConversationSummary

string

会话摘要

已完成告警与网络日志的初步关联分析。

SummaryVersion

integer

会话摘要版本号

2

RequestId

string

请求 ID

6276D891-*****-55B2-87B9-74D413F7****

示例

正常返回示例

JSON格式

{
  "ApiVersion": "v1.2",
  "Conversation": {
    "ConversationId": "54b6c969-4b75-47be-9f43-71f88aeb****",
    "Title": "安全事件调查",
    "Status": "active",
    "Visibility": "1",
    "CreatedAt": "2026-04-29T02:07:24Z",
    "UpdatedAt": "2026-06-09T10:27:35",
    "Model": "qwen3.7-max",
    "ThinkingMode": "false",
    "PlanMode": "enabled",
    "ProjectId": "project-incident-****",
    "Feedback": 1,
    "ScheduledTaskId": "task-e34f770da4f04f6db21c2819****",
    "LastTurnId": "dc18b894-19a3-45ee-8768-a59478e0****",
    "ConversationSummary": "已完成告警与网络日志的初步关联分析。",
    "SummaryVersion": 2
  },
  "RequestId": "6276D891-*****-55B2-87B9-74D413F7****"
}

错误码

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

变更历史

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