文档首页/ 安全云脑 SecMaster/ API参考/ 安全云脑 API V1/ 安全大模型/ 安全问题的对话 - ExecuteConversation
更新时间:2026-09-30 GMT+08:00
分享

安全问题的对话 - ExecuteConversation

功能介绍

安全问题的对话

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项。

URI

POST /v1/{project_id}/security-llm-conductor/agent/conversation

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

项目ID,用于明确项目归属。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释:

用户Token,通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

Content-Type

是

String

参数解释:

请求体的内容类型,用于指定请求体的媒体类型

约束限制:

不涉及

取值范围:

  • application/json;charset=UTF-8:普通API请求的类型

默认取值:

不涉及

表3 请求Body参数

参数

是否必选

参数类型

描述

agent_id

否

String

参数解释:

智能体ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

content

否

String

参数解释:

消息内容

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

content_type

否

String

参数解释:

消息类型,text:文本

约束限制:

不涉及

取值范围:

  • text:文本

默认取值:

不涉及

conversation_id

否

String

参数解释:

会话ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

model

否

String

参数解释:

模型名称

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

stream

否

Boolean

参数解释:

是否流式输出

约束限制:

不涉及

取值范围:

  • true:流式输出

  • false:非流式输出

默认取值:

false

instruction

否

String

参数解释:

系统提示词

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

auto_save_history

否

Boolean

参数解释:

是否保存本次对话记录,默认true

约束限制:

不涉及

取值范围:

  • true:保存本次对话记录

  • false:不保存本次对话记录

默认取值:

true

workspace_id

否

String

参数解释:

工作空间ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

extend_params

否

String

参数解释:

扩展参数,json字符串

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

content

String

参数解释:

接口输出正文内容

取值范围:

不涉及

content_type

String

参数解释:

返回对象类型,比如调用过程,模型输出text、progress

取值范围:

  • text:文本

event_time

String

参数解释:

时间字段UTC格式

取值范围:

不涉及

message_id

String

参数解释:

消息ID

取值范围:

不涉及

conversation_id

String

参数解释:

会话ID

取值范围:

不涉及

event

String

参数解释:

事件类型,可选值:start/generate/ping/task-executing/searching/thinking/thinking-cmpl/exception/done/finish

取值范围:

  • start:开始

  • generate:生成

  • ping:心跳

  • task-executing:任务执行中

  • searching:搜索中

  • thinking:思考中

  • thinking-cmpl:思考完成

  • exception:异常

  • done:完成

  • finish:结束

additional_info

String

参数解释:

扩展参数,json字符串

取值范围:

不涉及

状态码:400

表5 响应Body参数

参数

参数类型

描述

code

String

参数解释:

错误码

取值范围:

不涉及

message

String

参数解释:

错误描述

取值范围:

不涉及

状态码:500

表6 响应Body参数

参数

参数类型

描述

code

String

参数解释:

错误码

取值范围:

不涉及

message

String

参数解释:

错误描述

取值范围:

不涉及

请求示例

无

响应示例

无

状态码

状态码

描述

200

请求成功

400

请求参数有误

500

请求失败

错误码

请参见错误码。

相关文档