safety-eval-service/docs/安全岛AI会话-openapi.json

1774 lines
53 KiB
JSON
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

{
"info": {
"title": "安全岛",
"description": "",
"version": "1.0.0"
},
"openapi": "3.0.0",
"components": {
"schemas": {
"java.lang.Throwable": {
"type": "object",
"required": [],
"properties": {
"backtrace": {
"type": "object",
"description": "Native code saves some indication of the stack backtrace in this slot."
},
"cause": {
"type": "object",
"description": "The throwable that caused this throwable to get thrown, or null if this throwable was not caused by another throwable, or if the causative throwable is unknown. If this field is equal to this throwable itself, it indicates that the cause of this throwable has not yet been initialized. "
},
"suppressedExceptions": {
"type": "array",
"items": {
"type": "object"
},
"description": "The list of suppressed exceptions, as returned by . The list is initialized to a zero-element unmodifiable sentinel list. When a serialized Throwable is read in, if the field points to a zero-element list, the field is reset to the sentinel value. "
},
"detailMessage": {
"type": "string",
"default": "",
"description": "Specific details about the Throwable. For example, for , this contains the name of the file that could not be found. "
},
"stackTrace": {
"type": "array",
"items": {
"type": "object",
"properties": {
"fileName": {
"type": "string",
"default": ""
},
"lineNumber": {
"type": "integer",
"default": 1
},
"methodName": {
"type": "string",
"default": ""
},
"declaringClass": {
"type": "string",
"default": ""
}
},
"required": []
},
"description": "The stack trace, as returned by . The field is initialized to a zero-length array. A value of this field indicates subsequent calls to and will be be no-ops. "
}
},
"description": "The"
},
"com.zcloud.basic.info.dto.clientobject.TEnterpriseTaskFillRecordCO": {
"type": "object",
"required": [],
"properties": {
"submitPersonId": {
"type": "integer",
"default": 1,
"description": "提交人ID"
},
"taskSeq": {
"type": "string",
"default": "",
"description": "任务序号(冗余)"
},
"submitPersonName": {
"type": "string",
"default": "",
"description": "提交人姓名"
},
"extValues": {
"type": "object",
"required": [
"KEY"
],
"properties": {
"KEY": {
"type": "object"
}
}
},
"orgId": {
"type": "integer",
"default": 1,
"description": "机构id"
},
"updateId": {
"type": "integer",
"default": 1,
"description": "更新人"
},
"instanceId": {
"type": "integer",
"default": 1,
"description": "任务实例ID"
},
"fillType": {
"type": "string",
"default": "",
"description": "填报方式codeFORM-固定表DATA_TABLE-数据表ATTACHMENT-附件PDF-PDFWORD-Word"
},
"id": {
"type": "integer",
"default": 1,
"description": "主键"
},
"attachmentId": {
"type": "integer",
"default": 1,
"description": "附件ID关联已有附件表"
},
"attachmentUrl": {
"type": "string",
"default": "",
"description": "附件URL附件上传时"
},
"isMakeup": {
"type": "integer",
"default": 1,
"description": "是否补录0-否1-是"
},
"makeupReason": {
"type": "string",
"default": "",
"description": "补录原因"
},
"updateTime": {
"type": "string",
"default": "",
"description": "更新时间"
},
"deleteEnum": {
"type": "string",
"default": "",
"description": "删除状态FALSE-未删除TRUE-已删除"
},
"env": {
"type": "string",
"default": "",
"description": "环境"
},
"version": {
"type": "integer",
"default": 1,
"description": "乐观锁"
},
"updateName": {
"type": "string",
"default": "",
"description": "修改人名称"
},
"submitTime": {
"type": "string",
"default": "",
"description": "提交时间"
},
"createTime": {
"type": "string",
"default": "",
"description": "创建时间"
},
"schemaId": {
"type": "integer",
"default": 1,
"description": "填报结构ID关联t_fill_schema表单/数据表/固定表使用)"
},
"createId": {
"type": "integer",
"default": 1,
"description": "创建人"
},
"tenantId": {
"type": "integer",
"default": 1,
"description": "租户id"
},
"fillContent": {
"type": "string",
"default": "",
"description": "填报内容JSON表单数据或数据表的行数据"
},
"attachmentName": {
"type": "string",
"default": "",
"description": "附件名称"
},
"enterpriseId": {
"type": "integer",
"default": 1,
"description": "企业ID"
},
"createName": {
"type": "string",
"default": "",
"description": "创建人姓名"
},
"remarks": {
"type": "string",
"default": "",
"description": "描述"
},
"fillTypeName": {
"type": "string",
"default": "",
"description": "填报方式名称"
}
},
"description": "web-client"
},
"java.lang.StackTraceElement": {
"type": "object",
"required": [],
"properties": {
"fileName": {
"type": "string",
"default": ""
},
"methodName": {
"type": "string",
"default": ""
},
"lineNumber": {
"type": "integer",
"default": 1
},
"declaringClass": {
"type": "string",
"default": ""
}
}
},
"com.zcloud.basic.info.dto.TEnterpriseTaskFillRecordAddCmd": {
"type": "object",
"required": [
"attachmentUrl",
"submitPersonId",
"taskSeq",
"isMakeup",
"makeupReason",
"submitPersonName",
"instanceId",
"submitTime",
"fillType",
"schemaId",
"fillContent",
"attachmentName",
"enterpriseId",
"fillText",
"attachmentId",
"fillTypeName"
],
"properties": {
"attachmentUrl": {
"type": "string",
"default": "",
"description": "附件URL附件上传时"
},
"submitPersonId": {
"type": "integer",
"default": 1,
"description": "提交人ID"
},
"taskSeq": {
"type": "string",
"default": "",
"description": "任务序号(冗余)"
},
"isMakeup": {
"type": "integer",
"default": 1,
"description": "是否补录0-否1-是"
},
"makeupReason": {
"type": "string",
"default": "",
"description": "补录原因"
},
"submitPersonName": {
"type": "string",
"default": "",
"description": "提交人姓名"
},
"extValues": {
"type": "object",
"required": [
"KEY"
],
"properties": {
"KEY": {
"type": "object"
}
}
},
"instanceId": {
"type": "integer",
"default": 1,
"description": "任务实例ID"
},
"submitTime": {
"type": "string",
"default": "",
"description": "提交时间"
},
"fillType": {
"type": "string",
"default": "",
"description": "填报方式codeFORM-固定表DATA_TABLE-数据表ATTACHMENT-附件PDF-PDFWORD-Word"
},
"schemaId": {
"type": "integer",
"default": 1,
"description": "填报结构ID关联t_fill_schema表单/数据表/固定表使用)"
},
"fillContent": {
"type": "string",
"default": "",
"description": "填报内容JSON表单数据或数据表的行数据"
},
"attachmentName": {
"type": "string",
"default": "",
"description": "附件名称"
},
"enterpriseId": {
"type": "integer",
"default": 1,
"description": "企业ID"
},
"fillText": {
"type": "string",
"default": "",
"description": "填报文本"
},
"attachmentId": {
"type": "integer",
"default": 1,
"description": "附件ID关联已有附件表"
},
"fillTypeName": {
"type": "string",
"default": "",
"description": "填报方式名称"
}
},
"description": "web-client"
},
"com.alibaba.cola.dto.SingleResponse<com.zcloud.basic.info.dto.clientobject.TEnterpriseTaskFillRecordCO>": {
"type": "object",
"required": [],
"properties": {
"exception": {
"type": "object",
"properties": {
"cause": {
"type": "object",
"properties": {
"cause": {
"type": "object",
"description": "The throwable that caused this throwable to get thrown, or null if this throwable was not caused by another throwable, or if the causative throwable is unknown. If this field is equal to this throwable itself, it indicates that the cause of this throwable has not yet been initialized. "
},
"backtrace": {
"type": "object",
"description": "Native code saves some indication of the stack backtrace in this slot."
},
"stackTrace": {
"type": "array",
"items": {
"type": "object",
"properties": {
"fileName": {
"type": "string",
"default": ""
},
"lineNumber": {
"type": "integer",
"default": 1
},
"methodName": {
"type": "string",
"default": ""
},
"declaringClass": {
"type": "string",
"default": ""
}
},
"required": []
},
"description": "The stack trace, as returned by . The field is initialized to a zero-length array. A value of this field indicates subsequent calls to and will be be no-ops. "
},
"detailMessage": {
"type": "string",
"default": "",
"description": "Specific details about the Throwable. For example, for , this contains the name of the file that could not be found. "
},
"suppressedExceptions": {
"type": "array",
"items": {
"type": "object"
},
"description": "The list of suppressed exceptions, as returned by . The list is initialized to a zero-element unmodifiable sentinel list. When a serialized Throwable is read in, if the field points to a zero-element list, the field is reset to the sentinel value. "
}
},
"required": []
},
"backtrace": {
"type": "object"
},
"stackTrace": {
"type": "array",
"items": {
"type": "object",
"properties": {
"fileName": {
"type": "string",
"default": ""
},
"lineNumber": {
"type": "integer",
"default": 1
},
"methodName": {
"type": "string",
"default": ""
},
"declaringClass": {
"type": "string",
"default": ""
}
},
"required": []
}
},
"detailMessage": {
"type": "string",
"default": ""
},
"suppressedExceptions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cause": {
"type": "object",
"description": "The throwable that caused this throwable to get thrown, or null if this throwable was not caused by another throwable, or if the causative throwable is unknown. If this field is equal to this throwable itself, it indicates that the cause of this throwable has not yet been initialized. "
},
"backtrace": {
"type": "object",
"description": "Native code saves some indication of the stack backtrace in this slot."
},
"stackTrace": {
"type": "array",
"items": {
"type": "object",
"properties": {
"fileName": {
"type": "string",
"default": ""
},
"lineNumber": {
"type": "integer",
"default": 1
},
"methodName": {
"type": "string",
"default": ""
},
"declaringClass": {
"type": "string",
"default": ""
}
},
"required": []
},
"description": "The stack trace, as returned by . The field is initialized to a zero-length array. A value of this field indicates subsequent calls to and will be be no-ops. "
},
"detailMessage": {
"type": "string",
"default": "",
"description": "Specific details about the Throwable. For example, for , this contains the name of the file that could not be found. "
},
"suppressedExceptions": {
"type": "array",
"items": {
"type": "object"
},
"description": "The list of suppressed exceptions, as returned by . The list is initialized to a zero-element unmodifiable sentinel list. When a serialized Throwable is read in, if the field points to a zero-element list, the field is reset to the sentinel value. "
}
},
"required": []
}
}
},
"required": []
},
"traceId": {
"type": "string",
"default": ""
},
"data": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"default": 1,
"description": "主键"
},
"env": {
"type": "string",
"default": "",
"description": "环境"
},
"orgId": {
"type": "integer",
"default": 1,
"description": "机构id"
},
"remarks": {
"type": "string",
"default": "",
"description": "描述"
},
"taskSeq": {
"type": "string",
"default": "",
"description": "任务序号(冗余)"
},
"version": {
"type": "integer",
"default": 1,
"description": "乐观锁"
},
"createId": {
"type": "integer",
"default": 1,
"description": "创建人"
},
"fillType": {
"type": "string",
"default": "",
"description": "填报方式codeFORM-固定表DATA_TABLE-数据表ATTACHMENT-附件PDF-PDFWORD-Word"
},
"isMakeup": {
"type": "integer",
"default": 1,
"description": "是否补录0-否1-是"
},
"schemaId": {
"type": "integer",
"default": 1,
"description": "填报结构ID关联t_fill_schema表单/数据表/固定表使用)"
},
"tenantId": {
"type": "integer",
"default": 1,
"description": "租户id"
},
"updateId": {
"type": "integer",
"default": 1,
"description": "更新人"
},
"extValues": {
"type": "object",
"required": [
"KEY"
],
"properties": {
"KEY": {
"type": "object"
}
},
"x-schema-orders": [
"KEY"
]
},
"createName": {
"type": "string",
"default": "",
"description": "创建人姓名"
},
"createTime": {
"type": "string",
"default": "",
"description": "创建时间"
},
"deleteEnum": {
"type": "string",
"default": "",
"description": "删除状态FALSE-未删除TRUE-已删除"
},
"instanceId": {
"type": "integer",
"default": 1,
"description": "任务实例ID"
},
"submitTime": {
"type": "string",
"default": "",
"description": "提交时间"
},
"updateName": {
"type": "string",
"default": "",
"description": "修改人名称"
},
"updateTime": {
"type": "string",
"default": "",
"description": "更新时间"
},
"fillContent": {
"type": "string",
"default": "",
"description": "填报内容JSON表单数据或数据表的行数据"
},
"attachmentId": {
"type": "integer",
"default": 1,
"description": "附件ID关联已有附件表"
},
"enterpriseId": {
"type": "integer",
"default": 1,
"description": "企业ID"
},
"fillTypeName": {
"type": "string",
"default": "",
"description": "填报方式名称"
},
"makeupReason": {
"type": "string",
"default": "",
"description": "补录原因"
},
"attachmentUrl": {
"type": "string",
"default": "",
"description": "附件URL附件上传时"
},
"attachmentName": {
"type": "string",
"default": "",
"description": "附件名称"
},
"submitPersonId": {
"type": "integer",
"default": 1,
"description": "提交人ID"
},
"submitPersonName": {
"type": "string",
"default": "",
"description": "提交人姓名"
}
},
"required": []
},
"success": {
"type": "boolean",
"default": true
},
"errCode": {
"type": "string",
"default": ""
},
"extValues": {
"type": "object",
"required": [
"KEY"
],
"properties": {
"KEY": {
"type": "object"
}
}
},
"errMessage": {
"type": "string",
"default": ""
}
}
},
"java.lang.Exception": {
"type": "object",
"required": [],
"properties": {
"backtrace": {
"type": "object"
},
"cause": {
"type": "object",
"properties": {
"cause": {
"type": "object",
"description": "The throwable that caused this throwable to get thrown, or null if this throwable was not caused by another throwable, or if the causative throwable is unknown. If this field is equal to this throwable itself, it indicates that the cause of this throwable has not yet been initialized. "
},
"backtrace": {
"type": "object",
"description": "Native code saves some indication of the stack backtrace in this slot."
},
"stackTrace": {
"type": "array",
"items": {
"type": "object",
"properties": {
"fileName": {
"type": "string",
"default": ""
},
"lineNumber": {
"type": "integer",
"default": 1
},
"methodName": {
"type": "string",
"default": ""
},
"declaringClass": {
"type": "string",
"default": ""
}
},
"required": []
},
"description": "The stack trace, as returned by . The field is initialized to a zero-length array. A value of this field indicates subsequent calls to and will be be no-ops. "
},
"detailMessage": {
"type": "string",
"default": "",
"description": "Specific details about the Throwable. For example, for , this contains the name of the file that could not be found. "
},
"suppressedExceptions": {
"type": "array",
"items": {
"type": "object"
},
"description": "The list of suppressed exceptions, as returned by . The list is initialized to a zero-element unmodifiable sentinel list. When a serialized Throwable is read in, if the field points to a zero-element list, the field is reset to the sentinel value. "
}
},
"required": []
},
"suppressedExceptions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cause": {
"type": "object",
"description": "The throwable that caused this throwable to get thrown, or null if this throwable was not caused by another throwable, or if the causative throwable is unknown. If this field is equal to this throwable itself, it indicates that the cause of this throwable has not yet been initialized. "
},
"backtrace": {
"type": "object",
"description": "Native code saves some indication of the stack backtrace in this slot."
},
"stackTrace": {
"type": "array",
"items": {
"type": "object",
"properties": {
"fileName": {
"type": "string",
"default": ""
},
"lineNumber": {
"type": "integer",
"default": 1
},
"methodName": {
"type": "string",
"default": ""
},
"declaringClass": {
"type": "string",
"default": ""
}
},
"required": []
},
"description": "The stack trace, as returned by . The field is initialized to a zero-length array. A value of this field indicates subsequent calls to and will be be no-ops. "
},
"detailMessage": {
"type": "string",
"default": "",
"description": "Specific details about the Throwable. For example, for , this contains the name of the file that could not be found. "
},
"suppressedExceptions": {
"type": "array",
"items": {
"type": "object"
},
"description": "The list of suppressed exceptions, as returned by . The list is initialized to a zero-element unmodifiable sentinel list. When a serialized Throwable is read in, if the field points to a zero-element list, the field is reset to the sentinel value. "
}
},
"required": []
}
},
"detailMessage": {
"type": "string",
"default": ""
},
"stackTrace": {
"type": "array",
"items": {
"type": "object",
"properties": {
"fileName": {
"type": "string",
"default": ""
},
"lineNumber": {
"type": "integer",
"default": 1
},
"methodName": {
"type": "string",
"default": ""
},
"declaringClass": {
"type": "string",
"default": ""
}
},
"required": []
}
}
},
"description": "The class"
}
}
},
"tags": [
{
"name": "AI会话",
"description": "AI会话创建、消息保存与会话记录查询接口",
"x-type": "folder",
"x-url": "",
"x-target-id": "19ff8d18312"
},
{
"name": "APP",
"description": "",
"x-type": "folder",
"x-url": "",
"x-target-id": "2eecefc5f0c056"
}
],
"paths": {
"/knowledge/openapi/v1/agent/chat": {
"post": {
"x-target-id": "32935bc3b2a1ca",
"x-protocol": "http",
"summary": "ai对话 流式对话",
"description": "",
"tags": [
"APP/AI会话"
],
"x-mock-server-enable": 1,
"x-mark-id": "1",
"x-updated-at": "2026-08-20T09:10:42+08:00",
"x-updated-user-name": "王轩",
"parameters": [
{
"name": "Ai-App-Id",
"in": "header",
"description": "",
"required": true,
"example": "knowledge-platform",
"schema": {
"type": "string"
}
},
{
"name": "Ai-Token",
"in": "header",
"description": "",
"required": true,
"example": "SAI_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object"
},
"example": "{\r\n \"agentId\": 88,\r\n \"openId\": \"cd31e20033d346eaa3282f6c54bc8aa8\",\r\n \"conversationId\": \"4432b8f8-a303-46ea-bc6a-afc98388db9d\",\r\n \"attachments\":[{\"resourceId\":425,\"type\":\"DOCUMENT\"}],\r\n \"content\": \"这是什么内容\"\r\n}"
}
}
},
"responses": {
"200": {
"description": "成功",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {}
},
"example": ""
}
}
},
"404": {
"description": "失败",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {}
},
"example": ""
}
}
}
}
}
},
"/knowledge/openapi/v1/user/register": {
"post": {
"x-target-id": "3a84aa18b2a132",
"x-protocol": "http",
"summary": "用户获权",
"description": "",
"tags": [
"APP/AI会话"
],
"x-mock-server-enable": 1,
"x-mark-id": "1",
"x-updated-at": "2026-08-20T09:10:30+08:00",
"x-updated-user-name": "王轩",
"parameters": [
{
"name": "Ai-App-Id",
"in": "header",
"description": "",
"required": true,
"example": "knowledge-platform",
"schema": {
"type": "string"
}
},
{
"name": "Ai-Token",
"in": "header",
"description": "",
"required": true,
"example": "SAI_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object"
},
"example": "{\r\n \"externalId\": \"userid\",\r\n \"nickname\": \"王轩\",\r\n \"tenantId\": \"2085284119127707648\"\r\n}"
}
}
},
"responses": {
"200": {
"description": "成功",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {}
},
"example": ""
}
}
},
"404": {
"description": "失败",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {}
},
"example": ""
}
}
}
}
}
},
"/knowledge/openapi/v1/agent/conversations": {
"get": {
"x-target-id": "3a86f99b32a168",
"x-protocol": "http",
"summary": "查询ai会话列表",
"description": "",
"tags": [
"APP/AI会话"
],
"x-mock-server-enable": 1,
"x-mark-id": "1",
"x-updated-at": "2026-08-20T09:10:17+08:00",
"x-updated-user-name": "王轩",
"parameters": [
{
"name": "agentId",
"in": "query",
"description": "",
"required": true,
"example": "87",
"schema": {
"type": "string"
}
},
{
"name": "openId",
"in": "query",
"description": "",
"required": true,
"example": "cd31e20033d346eaa3282f6c54bc8aa8",
"schema": {
"type": "string"
}
},
{
"name": "page",
"in": "query",
"description": "",
"required": true,
"example": "1",
"schema": {
"type": "string"
}
},
{
"name": "size",
"in": "query",
"description": "",
"required": true,
"example": "10",
"schema": {
"type": "string"
}
},
{
"name": "Ai-App-Id",
"in": "header",
"description": "",
"required": true,
"example": "knowledge-platform",
"schema": {
"type": "string"
}
},
{
"name": "Ai-Token",
"in": "header",
"description": "",
"required": true,
"example": "SAI_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "成功",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {}
},
"example": ""
}
}
},
"404": {
"description": "失败",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {}
},
"example": ""
}
}
}
}
},
"post": {
"x-target-id": "3b50b4f472a3b4",
"x-protocol": "http",
"summary": "创建会话",
"description": "",
"tags": [
"APP/AI会话"
],
"x-mock-server-enable": 1,
"x-mark-id": "1",
"x-updated-at": "2026-08-20T09:10:51+08:00",
"x-updated-user-name": "王轩",
"parameters": [
{
"name": "Ai-App-Id",
"in": "header",
"description": "",
"required": true,
"example": "knowledge-platform",
"schema": {
"type": "string"
}
},
{
"name": "Ai-Token",
"in": "header",
"description": "",
"required": true,
"example": "SAI_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object"
},
"example": "{\r\n \"agentId\": 87,\r\n \"openId\": \"cd31e20033d346eaa3282f6c54bc8aa8\",\r\n \"title\":\"\"\r\n}"
}
}
},
"responses": {
"200": {
"description": "成功",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {}
},
"example": ""
}
}
},
"404": {
"description": "失败",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {}
},
"example": ""
}
}
}
}
},
"delete": {
"x-target-id": "3b50e252b2a3b6",
"x-protocol": "http",
"summary": "删除指定会话",
"description": "",
"tags": [
"APP/AI会话"
],
"x-mock-server-enable": 1,
"x-mark-id": "1",
"x-updated-at": "2026-08-20T09:10:54+08:00",
"x-updated-user-name": "王轩",
"parameters": [
{
"name": "conversationId",
"in": "query",
"description": "",
"required": true,
"example": "xxx",
"schema": {
"type": "string"
}
},
{
"name": "openId",
"in": "query",
"description": "",
"required": true,
"example": "",
"schema": {
"type": "string"
}
},
{
"name": "agentId",
"in": "query",
"description": "",
"required": true,
"example": "",
"schema": {
"type": "string"
}
},
{
"name": "Ai-App-Id",
"in": "header",
"description": "",
"required": true,
"example": "knowledge-platform",
"schema": {
"type": "string"
}
},
{
"name": "Ai-Token",
"in": "header",
"description": "",
"required": true,
"example": "SAI_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object"
},
"example": "{\r\n \"agentId\": 87,\r\n \"openId\": \"cd31e20033d346eaa3282f6c54bc8aa8\",\r\n \"conversationId\":\"\"\r\n}"
}
}
},
"responses": {
"200": {
"description": "成功",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {}
},
"example": ""
}
}
},
"404": {
"description": "失败",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {}
},
"example": ""
}
}
}
}
},
"put": {
"x-target-id": "3b51f45232a43a",
"x-protocol": "http",
"summary": "修改会话标题",
"description": "",
"tags": [
"APP/AI会话"
],
"x-mock-server-enable": 1,
"x-mark-id": "1",
"x-updated-at": "2026-08-20T09:10:55+08:00",
"x-updated-user-name": "王轩",
"parameters": [
{
"name": "conversationId",
"in": "query",
"description": "",
"required": true,
"example": "xxx",
"schema": {
"type": "string"
}
},
{
"name": "openId",
"in": "query",
"description": "",
"required": true,
"example": "",
"schema": {
"type": "string"
}
},
{
"name": "agentId",
"in": "query",
"description": "",
"required": true,
"example": "",
"schema": {
"type": "string"
}
},
{
"name": "Ai-App-Id",
"in": "header",
"description": "",
"required": true,
"example": "knowledge-platform",
"schema": {
"type": "string"
}
},
{
"name": "Ai-Token",
"in": "header",
"description": "",
"required": true,
"example": "SAI_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object"
},
"example": "{\r\n \"agentId\": 87,\r\n \"openId\": \"cd31e20033d346eaa3282f6c54bc8aa8\",\r\n \"conversationId\":\"4432b8f8-a303-46ea-bc6a-afc98388db9d\",\r\n \"title\":\"你好\"\r\n}"
}
}
},
"responses": {
"200": {
"description": "成功",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {}
},
"example": ""
}
}
},
"404": {
"description": "失败",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {}
},
"example": ""
}
}
}
}
}
},
"/knowledge/openapi/v1/agent/conversations/messages": {
"get": {
"x-target-id": "3a883f1972a249",
"x-protocol": "http",
"summary": "查询ai会话消息历史",
"description": "",
"tags": [
"APP/AI会话"
],
"x-mock-server-enable": 1,
"x-mark-id": "1",
"x-updated-at": "2026-08-20T09:10:45+08:00",
"x-updated-user-name": "王轩",
"parameters": [
{
"name": "agentId",
"in": "query",
"description": "",
"required": true,
"example": "87",
"schema": {
"type": "string"
}
},
{
"name": "openId",
"in": "query",
"description": "",
"required": true,
"example": "cd31e20033d346eaa3282f6c54bc8aa8",
"schema": {
"type": "string"
}
},
{
"name": "page",
"in": "query",
"description": "",
"required": true,
"example": "1",
"schema": {
"type": "string"
}
},
{
"name": "size",
"in": "query",
"description": "",
"required": true,
"example": "10",
"schema": {
"type": "string"
}
},
{
"name": "conversationId",
"in": "query",
"description": "",
"required": true,
"example": "4432b8f8-a303-46ea-bc6a-afc98388db9d",
"schema": {
"type": "string"
}
},
{
"name": "Ai-App-Id",
"in": "header",
"description": "",
"required": true,
"example": "knowledge-platform",
"schema": {
"type": "string"
}
},
{
"name": "Ai-Token",
"in": "header",
"description": "",
"required": true,
"example": "SAI_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "成功",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {}
},
"example": ""
}
}
},
"404": {
"description": "失败",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {}
},
"example": ""
}
}
}
}
}
},
"/knowledge/openapi/v1/agent/attachment/upload": {
"post": {
"x-target-id": "3a890006b2a2a8",
"x-protocol": "http",
"summary": "上传附件",
"description": "",
"tags": [
"APP/AI会话"
],
"x-mock-server-enable": 1,
"x-mark-id": "1",
"x-updated-at": "2026-08-20T09:10:47+08:00",
"x-updated-user-name": "王轩",
"parameters": [
{
"name": "Ai-App-Id",
"in": "header",
"description": "",
"required": true,
"example": "knowledge-platform",
"schema": {
"type": "string"
}
},
{
"name": "Ai-Token",
"in": "header",
"description": "",
"required": true,
"example": "SAI_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"type": "object",
"properties": {
"openId": {
"type": "string",
"description": "",
"example": "cd31e20033d346eaa3282f6c54bc8aa8"
},
"type": {
"type": "string",
"description": "IMAGE 走图片处理其他类型DOCUMENT/AUDIO 等)统一按文档存储。不传默认按非图片处理",
"example": "DOCUMENT"
},
"file": {
"type": "string",
"description": "",
"example": "C:\\Users\\Administrator\\Desktop\\6khj(1).doc",
"format": "binary"
}
},
"required": [
"openId",
"type",
"file"
]
}
}
}
},
"responses": {
"200": {
"description": "成功",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {}
},
"example": ""
}
}
},
"404": {
"description": "失败",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {}
},
"example": ""
}
}
}
}
}
},
"/knowledge/openapi/v1/agents": {
"get": {
"x-target-id": "3b54ed3a72a4de",
"x-protocol": "http",
"summary": "智能体列表",
"description": "",
"tags": [
"APP/AI会话"
],
"x-mock-server-enable": 1,
"x-mark-id": "1",
"x-updated-at": "2026-08-20T09:11:04+08:00",
"x-updated-user-name": "王轩",
"parameters": [
{
"name": "page",
"in": "query",
"description": "",
"required": true,
"example": "1",
"schema": {
"type": "string"
}
},
{
"name": "size",
"in": "query",
"description": "",
"required": true,
"example": "50",
"schema": {
"type": "string"
}
},
{
"name": "Ai-App-Id",
"in": "header",
"description": "",
"required": true,
"example": "knowledge-platform",
"schema": {
"type": "string"
}
},
{
"name": "Ai-Token",
"in": "header",
"description": "",
"required": true,
"example": "SAI_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object"
},
"example": "{\r\n \"agentId\": 87,\r\n \"openId\": \"cd31e20033d346eaa3282f6c54bc8aa8\",\r\n \"conversationId\":\"4432b8f8-a303-46ea-bc6a-afc98388db9d\",\r\n \"title\":\"你好\"\r\n}"
}
}
},
"responses": {
"200": {
"description": "成功",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {}
},
"example": ""
}
}
},
"404": {
"description": "失败",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {}
},
"example": ""
}
}
}
}
}
},
"/knowledge/openapi/v1/agent": {
"get": {
"x-target-id": "3b5534feb2a564",
"x-protocol": "http",
"summary": "智能体详情",
"description": "",
"tags": [
"APP/AI会话"
],
"x-mock-server-enable": 1,
"x-mark-id": "1",
"x-updated-at": "2026-08-20T09:11:05+08:00",
"x-updated-user-name": "王轩",
"parameters": [
{
"name": "agentId",
"in": "query",
"description": "",
"required": true,
"example": "88",
"schema": {
"type": "string"
}
},
{
"name": "Ai-App-Id",
"in": "header",
"description": "",
"required": true,
"example": "knowledge-platform",
"schema": {
"type": "string"
}
},
{
"name": "Ai-Token",
"in": "header",
"description": "",
"required": true,
"example": "SAI_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object"
},
"example": "{\r\n \"agentId\": 87,\r\n \"openId\": \"cd31e20033d346eaa3282f6c54bc8aa8\",\r\n \"conversationId\":\"4432b8f8-a303-46ea-bc6a-afc98388db9d\",\r\n \"title\":\"你好\"\r\n}"
}
}
},
"responses": {
"200": {
"description": "成功",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {}
},
"example": ""
}
}
},
"404": {
"description": "失败",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {}
},
"example": ""
}
}
}
}
}
}
},
"servers": [
{
"url": "https://gbs-gateway.qhdsafety.com",
"description": "安全岛 AI 会话网关"
}
]
}