发送一轮安全运营Agent消息并通过SSE返回事件流;首轮可在同一请求中隐式创建会话。
接口说明
向安全运营 Agent 会话发送消息并以 SSE 事件流返回结果。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST /api/v1/copilot/chat/completions/create HTTP/1.1
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| RegionId |
string |
否 |
威胁分析的数据管理中心所在地。您需要根据资产所在地域,选择管理中心所在地。取值:
|
cn-hangzhou |
| Lang |
string |
否 |
返回消息的语言类型。取值:
|
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"
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。