创建一个归属于当前租户和所有者的安全运营Agent会话，并返回会话标识、状态及会话配置。
接口说明
创建安全运营 Agent 会话。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST /api/v1/copilot/conversation/create HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| RegionId |
string |
否 |
威胁分析的数据管理中心所在地。您需要根据资产所在地域，选择管理中心所在地。取值：
|
cn-hangzhou |
| Lang |
string |
否 |
返回消息的语言类型。取值：
|
zh |
| TraceId |
string |
否 |
创建的 span 对象的 trace id |
550e8400e29b41d4a71644665544**** |
| Title |
string |
否 |
会话标题 |
安全事件调查 |
| Model |
string |
否 |
模型标识 |
qwen3.7-max |
| ThinkingMode |
string |
否 |
深度思考配置 |
enabled |
| PlanMode |
string |
否 |
规划配置 |
enabled |
| ProjectId |
string |
否 |
安全项目 ID |
project-incident-**** |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
响应 |
||
| ApiVersion |
string |
API 版本号，"1.0.0"。 |
v1.2 |
| Conversation |
object |
对话时间戳 |
|
| ConversationId |
string |
安全运营 Agent 会话 ID |
54b6c969-4b75-47be-9f43-71f88aeb**** |
| Title |
string |
会话标题 |
安全事件调查 |
| Status |
string |
状态 |
active |
| Visibility |
string |
会话可见性 |
[] |
| CreatedAt |
string |
创建时间 |
2026-01-31T10:10:20Z |
| UpdatedAt |
string |
更新时间 |
2020-11-27 16:02:28 |
| 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**** |
| RequestId |
string |
请求 ID |
6276D891-*****-55B2-87B9-74D413F7**** |
示例
正常返回示例
JSON格式
{
"ApiVersion": "v1.2",
"Conversation": {
"ConversationId": "54b6c969-4b75-47be-9f43-71f88aeb****",
"Title": "安全事件调查",
"Status": "active",
"Visibility": "[]",
"CreatedAt": "2026-01-31T10:10:20Z",
"UpdatedAt": "2020-11-27 16:02:28",
"Model": "qwen3.7-max",
"ThinkingMode": "false",
"PlanMode": "enabled",
"ProjectId": "project-incident-****",
"Feedback": 1,
"ScheduledTaskId": "task-e34f770da4f04f6db21c2819****"
},
"RequestId": "6276D891-*****-55B2-87B9-74D413F7****"
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。