CreateCopilotChat - 发起安全运营Agent流式对话

更新时间:
复制 MD 格式

发送一轮安全运营Agent消息并通过SSE返回事件流;首轮可在同一请求中隐式创建会话。

接口说明

向安全运营 Agent 会话发送消息并以 SSE 事件流返回结果。

调试

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

调试

授权信息

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

请求语法

POST /api/v1/copilot/chat/completions/create 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****

ClientMessageId

string

是

客户端消息 ID

366932fb-9a83-4a2d-94dd-c925b35f****

RouteTarget

string

否

运行目标路由标识

security-agent-route-****

ReplaceTurnId

string

否

被替换的对话轮次 ID

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

Messages

array<object>

是

消息列表

object

否

消息项

Role

string

否

消息角色

user

Content

string

否

消息内容

请调查最近一小时的异常登录活动。

Stream

boolean

否

流式响应开关

true

Source

string

否

请求来源

console

ClientConversationId

string

否

客户端会话 ID

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

CreateConversation

object

否

会话创建配置

Title

string

否

会话标题

安全事件调查

Model

string

否

模型标识

qwen3.7-max

ThinkingMode

string

否

深度思考配置

enabled

PlanMode

string

否

规划配置

enabled

ProjectId

string

否

安全项目 ID

project-incident-****

Model

string

否

模型标识

qwen3.7-max

ThinkingMode

string

否

深度思考配置

enabled

PlanMode

string

否

规划配置

enabled

ProjectId

string

否

安全项目 ID

project-incident-****

返回参数

名称

类型

描述

示例值

string

SSE 事件流

data:{"seq":1,"method":"lifecycle","params":{"namespace":[],"timestamp":1,"data":{"event":"started","graph_name":"security-agent","run_id":"root-1","parent_run_id":null}}}

示例

正常返回示例

JSON格式

"data:{\"seq\":1,\"method\":\"lifecycle\",\"params\":{\"namespace\":[],\"timestamp\":1,\"data\":{\"event\":\"started\",\"graph_name\":\"security-agent\",\"run_id\":\"root-1\",\"parent_run_id\":null}}}\n\n"

错误码

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

变更历史

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