{ "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": "填报方式code：FORM-固定表，DATA_TABLE-数据表，ATTACHMENT-附件，PDF-PDF，WORD-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": "填报方式code：FORM-固定表，DATA_TABLE-数据表，ATTACHMENT-附件，PDF-PDF，WORD-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": { "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": "填报方式code：FORM-固定表，DATA_TABLE-数据表，ATTACHMENT-附件，PDF-PDF，WORD-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 会话网关" } ] }