查询指定安全运营Agent会话的元数据、状态、配置和历史摘要信息。
接口说明
查询指定安全运营 Agent 会话。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST /api/v1/copilot/conversation/get HTTP/1.1
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| RegionId |
string |
否 |
威胁分析的数据管理中心所在地。您需要根据资产所在地域,选择管理中心所在地。取值:
|
cn-hangzhou |
| Lang |
string |
否 |
返回消息的语言类型。取值:
|
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 |
可见性,可选值:
|
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****"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。