{"openapi":"3.1.0","info":{"title":"FastGPT API","version":"0.1.0","description":"FastGPT API 文档"},"servers":[{"url":"/api"}],"x-tagGroups":[{"name":"我的应用/工具管理","tags":["通用应用管理","MCP 工具管理","应用权限"]},{"name":"Agent 应用","tags":["Agent 日志","发布渠道"]},{"name":"AI 相关","tags":["AI技能管理"]},{"name":"对话","tags":["门户页配置","对话页面通用"]},{"name":"对话管理","tags":["历史记录管理","对话操作","对话反馈"]},{"name":"知识库","tags":["集合"]},{"name":"插件系统","tags":["工具标签","团队插件管理"]},{"name":"用户体系","tags":["用户通知","订单","优惠券"]},{"name":"通用-核心功能","tags":["AI 通用 接口"]},{"name":"通用-辅助功能","tags":["自定义域名","APIKey"]},{"name":"管理员-插件管理","tags":["管理员插件管理","插件市场","管理员系统工具管理"]},{"name":"系统接口","tags":["辅助助手"]}],"paths":{"/core/app/logs/getLogKeys":{"get":{"summary":"获取应用日志键","description":"获取应用的日志键列表","tags":["Agent 日志"],"parameters":[{"in":"query","name":"appId","schema":{"example":"68ad85a7463006c963799a05","description":"应用 ID","type":"string"},"required":true,"description":"应用 ID"}],"responses":{"200":{"description":"成功获取应用日志键","content":{"application/json":{"schema":{"type":"object","properties":{"logKeys":{"example":[{"key":"source","enable":true},{"key":"createdTime","enable":true}],"description":"日志键","default":[],"type":"array","items":{"type":"object","properties":{"key":{"type":"string","enum":["source","user","title","sessionId","createdTime","lastConversationTime","messageCount","feedback","customFeedback","annotatedCount","points","responseTime","errorCount","region","versionName"]},"enable":{"type":"boolean"}},"required":["key","enable"],"additionalProperties":false}}},"required":["logKeys"],"additionalProperties":false}}}}}}},"/core/app/logs/updateLogKeys":{"post":{"summary":"更新应用日志键","description":"更新应用的日志键列表","tags":["Agent 日志"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"appId":{"example":"68ad85a7463006c963799a05","description":"应用 ID","type":"string"},"logKeys":{"example":[{"key":"source","enable":true}],"description":"日志键","type":"array","items":{"type":"object","properties":{"key":{"type":"string","enum":["source","user","title","sessionId","createdTime","lastConversationTime","messageCount","feedback","customFeedback","annotatedCount","points","responseTime","errorCount","region","versionName"]},"enable":{"type":"boolean"}},"required":["key","enable"]}}},"required":["appId","logKeys"]}}}},"responses":{"200":{"description":"成功更新应用日志键","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}}}}},"/core/app/logs/list":{"post":{"summary":"获取应用日志列表","description":"分页获取应用的对话日志列表，支持按时间范围、来源、用户等条件筛选","tags":["Agent 日志"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"pageSize":{"description":"每页条数","anyOf":[{"type":"number"},{"type":"string"}]},"offset":{"description":"偏移量(与页码二选一)","anyOf":[{"type":"number"},{"type":"string"}]},"pageNum":{"description":"页码(与偏移量二选一)","anyOf":[{"type":"number"},{"type":"string"}]},"feedbackType":{"example":"good","description":"反馈类型：all-全部记录，has_feedback-包含反馈，good-包含赞，bad-包含踩","type":"string","enum":["all","has_feedback","good","bad"]},"unreadOnly":{"example":false,"description":"是否仅显示未读反馈（当 feedbackType 为 all 时忽略）","type":"boolean"},"errorFilter":{"example":"has_error","description":"报错筛选：all-全部记录，has_error-仅看报错","type":"string","enum":["all","has_error"]},"appId":{"example":"68ad85a7463006c963799a05","description":"应用 ID","type":"string"},"dateStart":{"example":"2024-01-01T00:00:00.000Z","description":"开始时间","anyOf":[{"type":"string"},{"type":"string"}]},"dateEnd":{"example":"2024-12-31T23:59:59.999Z","description":"结束时间","anyOf":[{"type":"string"},{"type":"string"}]},"sources":{"example":["api","online"],"description":"对话来源筛选","type":"array","items":{"type":"string","enum":["test","online","share","api","cronJob","team","feishu","official_account","wecom","mcp"]}},"tmbIds":{"example":["tmb123","tmb456"],"description":"团队成员 ID 列表","type":"array","items":{"type":"string"}},"outLinkUids":{"example":["user123","user456"],"description":"外部用户 ID 列表","type":"array","items":{"type":"string"}},"chatSearch":{"example":"hello","description":"对话内容搜索关键词","type":"string"}},"required":["appId","dateStart","dateEnd"]}}}},"responses":{"200":{"description":"成功获取应用日志列表","content":{"application/json":{"schema":{"example":{"total":100,"list":[]},"description":"应用对话日志列表","type":"object","properties":{"total":{"example":100,"description":"总记录数","type":"number"},"list":{"type":"array","items":{"type":"object","properties":{"_id":{"example":"68ad85a7463006c963799a05","description":"对话日志 ID","type":"string"},"chatId":{"example":"chat123","description":"对话 ID","type":"string"},"title":{"example":"用户对话","description":"对话标题","anyOf":[{"type":"string"},{"type":"null"}]},"customTitle":{"example":"自定义标题","description":"自定义对话标题","anyOf":[{"type":"string"},{"type":"null"}]},"source":{"example":"api","description":"对话来源","type":"string","enum":["test","online","share","api","cronJob","team","feishu","official_account","wecom","mcp"]},"sourceName":{"example":"API调用","description":"来源名称","anyOf":[{"type":"string"},{"type":"null"}]},"updateTime":{"example":"2024-01-01T00:30:00.000Z","description":"更新时间","type":"string"},"createTime":{"example":"2024-01-01T00:00:00.000Z","description":"创建时间","anyOf":[{"type":"string"},{"type":"null"}]},"messageCount":{"example":10,"description":"消息数量","anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"userGoodFeedbackCount":{"example":3,"description":"好评反馈数量","anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"userBadFeedbackCount":{"example":1,"description":"差评反馈数量","anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"customFeedbacksCount":{"example":2,"description":"自定义反馈数量","anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"markCount":{"example":0,"description":"标记数量","anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"averageResponseTime":{"example":1500,"description":"平均响应时间(毫秒)","anyOf":[{"type":"number"},{"type":"null"}]},"errorCount":{"example":0,"description":"错误次数","anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"totalPoints":{"example":150.5,"description":"总积分消耗","anyOf":[{"type":"number"},{"type":"null"}]},"outLinkUid":{"example":"outLink123","description":"外链用户 ID","anyOf":[{"type":"string"},{"type":"null"}]},"tmbId":{"example":"tmb123","description":"团队成员 ID","anyOf":[{"type":"string"},{"type":"null"}]},"sourceMember":{"description":"来源成员信息","anyOf":[{"type":"object","properties":{"name":{"example":"张三","description":"成员名称","type":"string"},"avatar":{"description":"成员头像","anyOf":[{"type":"string"},{"type":"null"}]},"status":{"example":"active","description":"成员状态","type":"string","enum":["active","leave","forbidden"]}},"required":["name","status"],"additionalProperties":false},{"type":"null"}]},"versionName":{"example":"v1.0.0","description":"版本名称","anyOf":[{"type":"string"},{"type":"null"}]},"originIp":{"example":"192.168.1.1","description":"原始 IP 地址","anyOf":[{"type":"string"},{"type":"null"}]},"region":{"example":"中国","description":"区域","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["_id","chatId","source","updateTime"],"additionalProperties":false}}},"required":["total","list"],"additionalProperties":false}}}}}}},"/core/app/logs/exportLogs":{"post":{"summary":"导出应用日志","description":"导出应用的对话日志为 CSV 文件，支持自定义导出字段和筛选条件","tags":["Agent 日志"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"feedbackType":{"example":"good","description":"反馈类型：all-全部记录，has_feedback-包含反馈，good-包含赞，bad-包含踩","type":"string","enum":["all","has_feedback","good","bad"]},"unreadOnly":{"example":false,"description":"是否仅显示未读反馈（当 feedbackType 为 all 时忽略）","type":"boolean"},"errorFilter":{"example":"has_error","description":"报错筛选：all-全部记录，has_error-仅看报错","type":"string","enum":["all","has_error"]},"appId":{"example":"68ad85a7463006c963799a05","description":"应用 ID","type":"string"},"dateStart":{"example":"2024-01-01T00:00:00.000Z","description":"开始时间","anyOf":[{"type":"string"},{"type":"string"}]},"dateEnd":{"example":"2024-12-31T23:59:59.999Z","description":"结束时间","anyOf":[{"type":"string"},{"type":"string"}]},"sources":{"example":["api","online"],"description":"对话来源筛选","type":"array","items":{"type":"string","enum":["test","online","share","api","cronJob","team","feishu","official_account","wecom","mcp"]}},"tmbIds":{"example":["tmb123","tmb456"],"description":"团队成员 ID 列表","type":"array","items":{"type":"string"}},"outLinkUids":{"example":["user123","user456"],"description":"外部用户 ID 列表","type":"array","items":{"type":"string"}},"chatSearch":{"example":"hello","description":"对话内容搜索关键词","type":"string"},"title":{"example":"chat logs","description":"标题","type":"string"},"sourcesMap":{"example":{"api":{"label":"API"},"online":{"label":"在线"}},"description":"来源映射","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"label":{"type":"string"}},"required":["label"]}},"logKeys":{"example":["source","createdTime"],"description":"日志键","type":"array","items":{"type":"string","enum":["source","user","title","sessionId","createdTime","lastConversationTime","messageCount","feedback","customFeedback","annotatedCount","points","responseTime","errorCount","region","versionName"]}}},"required":["appId","dateStart","dateEnd","title","sourcesMap","logKeys"]}}}},"responses":{"200":{"description":"成功导出应用日志，返回 CSV 文件","content":{"text/csv":{"schema":{"type":"string"}}}}}}},"/proApi/core/app/logs/getTotalData":{"get":{"summary":"获取应用总体数据统计","description":"获取应用的总体数据统计，包括总用户数、总对话数、总积分消耗","tags":["Agent 日志"],"parameters":[{"in":"query","name":"appId","schema":{"example":"68ad85a7463006c963799a05","description":"应用 ID","type":"string"},"required":true,"description":"应用 ID"}],"responses":{"200":{"description":"成功获取应用总体数据","content":{"application/json":{"schema":{"type":"object","properties":{"totalUsers":{"example":1000,"description":"总用户数","type":"number"},"totalChats":{"example":5000,"description":"总对话数","type":"number"},"totalPoints":{"example":15000,"description":"总积分消耗","type":"number"}},"required":["totalUsers","totalChats","totalPoints"],"additionalProperties":false}}}}}}},"/proApi/core/app/logs/getChartData":{"post":{"summary":"获取应用图表数据","description":"获取应用的图表统计数据，包括用户数据、对话数据、应用数据的时序统计","tags":["Agent 日志"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"appId":{"example":"68ad85a7463006c963799a05","description":"应用 ID","type":"string"},"dateStart":{"example":"2024-01-01T00:00:00.000Z","description":"开始日期","type":"string"},"dateEnd":{"example":"2024-12-31T23:59:59.999Z","description":"结束日期","type":"string"},"source":{"example":["api","online"],"description":"对话来源筛选","type":"array","items":{"type":"string","enum":["test","online","share","api","cronJob","team","feishu","official_account","wecom","mcp"]}},"offset":{"example":1,"description":"时区偏移量","type":"number"},"userTimespan":{"example":"day","description":"用户数据时间跨度","type":"string","enum":["day","week","month","quarter"]},"chatTimespan":{"example":"day","description":"对话数据时间跨度","type":"string","enum":["day","week","month","quarter"]},"appTimespan":{"example":"day","description":"应用数据时间跨度","type":"string","enum":["day","week","month","quarter"]}},"required":["appId","dateStart","dateEnd","offset","userTimespan","chatTimespan","appTimespan"]}}}},"responses":{"200":{"description":"成功获取应用图表数据","content":{"application/json":{"schema":{"type":"object","properties":{"userData":{"description":"用户统计数据","type":"array","items":{"type":"object","properties":{"timestamp":{"example":1704067200,"description":"时间戳","type":"number"},"summary":{"type":"object","properties":{"userCount":{"example":100,"description":"用户总数","type":"number"},"newUserCount":{"example":30,"description":"新用户数","type":"number"},"retentionUserCount":{"example":70,"description":"留存用户数","type":"number"},"points":{"example":1500,"description":"积分消耗","type":"number"},"sourceCountMap":{"example":{"api":50,"web":30,"mobile":20},"description":"各来源用户数量","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"required":["userCount","newUserCount","retentionUserCount","points","sourceCountMap"],"additionalProperties":false}},"required":["timestamp","summary"],"additionalProperties":false}},"chatData":{"description":"对话统计数据","type":"array","items":{"type":"object","properties":{"timestamp":{"example":1704067200,"description":"时间戳","type":"number"},"summary":{"type":"object","properties":{"chatItemCount":{"example":500,"description":"对话项目总数","type":"number"},"chatCount":{"example":100,"description":"对话会话总数","type":"number"},"errorCount":{"example":5,"description":"错误次数","type":"number"},"points":{"example":800,"description":"积分消耗","type":"number"}},"required":["chatItemCount","chatCount","errorCount","points"],"additionalProperties":false}},"required":["timestamp","summary"],"additionalProperties":false}},"appData":{"description":"应用统计数据","type":"array","items":{"type":"object","properties":{"timestamp":{"example":1704067200,"description":"时间戳","type":"number"},"summary":{"type":"object","properties":{"goodFeedBackCount":{"example":25,"description":"好评反馈数量","type":"number"},"badFeedBackCount":{"example":3,"description":"差评反馈数量","type":"number"},"chatCount":{"example":100,"description":"对话数量","type":"number"},"totalResponseTime":{"example":120000,"description":"总响应时间(毫秒)","type":"number"}},"required":["goodFeedBackCount","badFeedBackCount","chatCount","totalResponseTime"],"additionalProperties":false}},"required":["timestamp","summary"],"additionalProperties":false}}},"required":["userData","chatData","appData"],"additionalProperties":false}}}}}}},"/core/app/logs/getUsers":{"post":{"summary":"获取日志用户列表","description":"获取应用日志中的用户列表，包括外链用户和团队成员，按对话数量排序","tags":["Agent 日志"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"appId":{"example":"68ad85a7463006c963799a05","description":"应用 ID","type":"string"},"dateStart":{"example":"2024-01-01T00:00:00.000Z","description":"开始时间","type":"string"},"dateEnd":{"example":"2024-12-31T23:59:59.999Z","description":"结束时间","type":"string"},"searchKey":{"example":"user","description":"搜索用户名","type":"string"},"sources":{"example":["online","share"],"description":"来源筛选","type":"array","items":{"type":"string"}}},"required":["appId","dateStart","dateEnd"]}}}},"responses":{"200":{"description":"成功获取日志用户列表","content":{"application/json":{"schema":{"type":"object","properties":{"list":{"description":"使用者列表","type":"array","items":{"type":"object","properties":{"outLinkUid":{"example":"outLink123","description":"外链用户 ID","anyOf":[{"type":"string"},{"type":"null"}]},"tmbId":{"example":"tmb123","description":"团队成员 ID","anyOf":[{"type":"string"},{"type":"null"}]},"name":{"example":"用户名","description":"用户名称","type":"string"},"avatar":{"example":"https://example.com/avatar.png","description":"头像","type":"string"},"count":{"example":10,"description":"对话数量","type":"number"}},"required":["outLinkUid","tmbId","name","count"],"additionalProperties":false}}},"required":["list"],"additionalProperties":false}}}}}}},"/api/support/outLink/playground/config":{"get":{"summary":"获取门户配置","description":"获取指定应用的门户聊天界面的可见性配置，包括节点状态、响应详情、全文显示和原始来源显示的设置","tags":["发布渠道"],"parameters":[{"in":"query","name":"appId","schema":{"example":"68ad85a7463006c963799a05","description":"应用 ID","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"required":true,"description":"应用 ID"}],"responses":{"200":{"description":"成功返回门户配置","content":{"application/json":{"schema":{"type":"object","properties":{"showRunningStatus":{"example":true,"description":"是否显示运行状态","type":"boolean"},"showCite":{"example":true,"description":"是否显示引用","type":"boolean"},"showFullText":{"example":true,"description":"是否显示全文","type":"boolean"},"canDownloadSource":{"example":true,"description":"是否可下载来源","type":"boolean"}},"required":["showRunningStatus","showCite","showFullText","canDownloadSource"],"additionalProperties":false}}}},"400":{"description":"请求参数错误","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"number","const":500},"statusText":{"type":"string","const":"Invalid Params"},"message":{"type":"string"},"data":{"type":"null"}},"required":["code","statusText","message","data"],"additionalProperties":false}}}},"401":{"description":"用户未授权","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"number","const":401},"statusText":{"type":"string","const":"unAuthorization"},"message":{"type":"string"},"data":{"type":"null"}},"required":["code","statusText","message","data"],"additionalProperties":false}}}}}}},"/api/support/outLink/playground/update":{"post":{"summary":"更新门户配置","description":"更新指定应用的门户聊天界面的可见性配置，包括节点状态、响应详情、全文显示和原始来源显示的设置。如果配置不存在则创建新配置","tags":["发布渠道"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"appId":{"example":"68ad85a7463006c963799a05","description":"应用 ID","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"showRunningStatus":{"example":true,"description":"是否显示运行状态","type":"boolean"},"showCite":{"example":true,"description":"是否显示引用","type":"boolean"},"showFullText":{"example":true,"description":"是否显示全文","type":"boolean"},"canDownloadSource":{"example":true,"description":"是否可下载来源","type":"boolean"}},"required":["appId","showRunningStatus","showCite","showFullText","canDownloadSource"]}}}},"responses":{"200":{"description":"成功更新门户配置","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"请求参数错误","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"number","const":500},"statusText":{"type":"string","const":"Invalid Params"},"message":{"type":"string"},"data":{"type":"null"}},"required":["code","statusText","message","data"],"additionalProperties":false}}}},"401":{"description":"用户未授权","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"number","const":401},"statusText":{"type":"string","const":"unAuthorization"},"message":{"type":"string"},"data":{"type":"null"}},"required":["code","statusText","message","data"],"additionalProperties":false}}}}}}},"/core/app/create":{"post":{"summary":"创建应用","description":"创建应用或文件夹","tags":["通用应用管理"],"requestBody":{"content":{"application/json":{"schema":{"example":{"name":"新应用","type":"simple","modules":[],"edges":[],"parentId":"68ad85a7463006c963799a05"},"type":"object","properties":{"parentId":{"example":"68ad85a7463006c963799a05","description":"父级应用/文件夹 ID","anyOf":[{"type":"string"},{"type":"null"}]},"name":{"example":"新应用","description":"应用名称","type":"string","minLength":1},"avatar":{"example":"https://example.com/avatar.png","description":"应用头像","type":"string"},"intro":{"example":"应用介绍","description":"应用介绍","type":"string"},"type":{"example":"advanced","description":"应用类型","type":"string","enum":["folder","toolFolder","simple","chatAgent","advanced","plugin","toolSet","httpToolSet","hidden","tool","httpPlugin"]},"modules":{"example":[],"description":"应用节点配置","type":"array","items":{"type":"object","properties":{"parentNodeId":{"type":"string"},"flowNodeType":{"type":"string","enum":["emptyNode","userGuide","pluginConfig","globalVariable","comment","workflowStart","chatNode","datasetSearchNode","datasetConcatNode","answerNode","classifyQuestion","contentExtract","httpRequest468","pluginInput","pluginOutput","cfr","agent","tools","stopTool","toolParams","lafModule","ifElseNode","variableUpdate","code","textEditor","customFeedback","readFiles","userSelect","loop","loopStart","loopEnd","formInput","tool","toolSet","appModule","pluginModule","app"]},"abandon":{"type":"boolean"},"avatar":{"type":"string"},"avatarLinear":{"type":"string"},"colorSchema":{"type":"string","enum":["pink","blue","blueLight","blueDark","orange","purple","teal","green","greenLight","indigo","coral","lime","violet","violetDeep","yellowGreen","lafTeal","skyBlue","salmon","gray"]},"name":{"type":"string"},"intro":{"type":"string"},"toolDescription":{"type":"string"},"showStatus":{"type":"boolean"},"version":{"type":"string"},"versionLabel":{"type":"string"},"isLatestVersion":{"type":"boolean"},"catchError":{"type":"boolean"},"inputs":{"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","enum":["welcomeText","switch","history","text","questionGuide","tts","whisper","variables","scheduleTrigger","chatInputGuide","autoExecute","instruction","userChatInput","inputFiles","agents","model","systemPrompt","description","system_anyInput","system_textareaInput","system_addInputParam","system_forbid_stream","system_header_secret","system_input_config","maxContext","temperature","maxToken","aiSettings","isResponseAnswerText","aiChatQuoteRole","quoteTemplate","quotePrompt","quoteQA","aiChatVision","stringQuoteText","aiChatReasoning","aiChatTopP","aiChatStopSign","aiChatResponseFormat","aiChatJsonSchema","agent_selectedTools","agent_datasetParams","skills","datasets","similarity","limit","searchMode","embeddingWeight","usingReRank","rerankWeight","rerankModel","datasetSearchUsingExtensionQuery","datasetSearchExtensionModel","datasetSearchExtensionBg","collectionFilterMatch","authTmbId","datasetDeepSearch","datasetDeepSearchModel","datasetDeepSearchMaxTimes","datasetDeepSearchBg","system_datasetQuoteList","content","extractKeys","system_httpReqUrl","system_httpHeader","system_httpMethod","system_httpParams","system_httpJsonBody","system_httpFormBody","system_httpContentType","system_httpTimeout","url","app","pluginId","pluginStart","condition","ifElseList","updateList","code","codeType","fileUrlList","userSelectOptions","loopInputArray","childrenNodeIdList","nodeWidth","nodeHeight","loopNodeInputHeight","loopStartInput","loopStartIndex","loopEndInput","userInputForms","commentText","commentSize","system_toolData","system_toolSetData"]},{"type":"string"}]},"label":{"type":"string"},"valueType":{"type":"string","enum":["string","number","boolean","object","arrayString","arrayNumber","arrayBoolean","arrayObject","arrayAny","any","chatHistory","datasetQuote","dynamic","selectDataset","selectApp"]},"required":{"type":"boolean"},"defaultValue":{},"referencePlaceholder":{"type":"string"},"isRichText":{"type":"boolean"},"placeholder":{"type":"string"},"maxLength":{"type":"number"},"minLength":{"type":"number"},"list":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"string"}},"required":["label","value"]}},"markList":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"number"}},"required":["label","value"]}},"step":{"type":"number"},"max":{"type":"number"},"min":{"type":"number"},"precision":{"type":"number"},"llmModelType":{"type":"string","enum":["all","classify","extractFields","toolCall"]},"canSelectFile":{"type":"boolean"},"canSelectImg":{"type":"boolean"},"canSelectVideo":{"type":"boolean"},"canSelectAudio":{"type":"boolean"},"canSelectCustomFileExtension":{"type":"boolean"},"customFileExtensionList":{"type":"array","items":{"type":"string"}},"canLocalUpload":{"type":"boolean"},"canUrlUpload":{"type":"boolean"},"maxFiles":{"type":"number"},"timeGranularity":{"type":"string","enum":["day","hour","minute","second"]},"timeRangeStart":{"type":"string"},"timeRangeEnd":{"type":"string"},"datasetOptions":{"type":"array","items":{"type":"object","properties":{"datasetId":{"type":"string"},"avatar":{"type":"string"},"name":{"type":"string"},"vectorModel":{"type":"object","properties":{"model":{"type":"string"}},"required":["model"]}},"required":["datasetId","avatar","name","vectorModel"]}},"customInputConfig":{"type":"object","properties":{"selectValueTypeList":{"type":"array","items":{"type":"string","enum":["string","number","boolean","object","arrayString","arrayNumber","arrayBoolean","arrayObject","arrayAny","any","chatHistory","datasetQuote","dynamic","selectDataset","selectApp"]}},"showDefaultValue":{"type":"boolean"},"showDescription":{"type":"boolean"}}},"enums":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"label":{"type":"string"}},"required":["value","label"]}},"selectedTypeIndex":{"type":"number"},"renderTypeList":{"type":"array","items":{"type":"string","enum":["reference","input","textarea","numberInput","switch","select","multipleSelect","JSONEditor","addInputParam","customVariable","selectApp","selectLLMModel","settingLLMModel","selectDataset","selectDatasetParamsModal","settingDatasetQuotePrompt","hidden","custom","fileSelect","timePointSelect","timeRangeSelect","password"]}},"valueDesc":{"type":"string"},"value":{},"debugLabel":{"type":"string"},"description":{"type":"string"},"toolDescription":{"type":"string"},"enum":{"type":"string"},"inputList":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"description":{"type":"string"},"required":{"type":"boolean"},"inputType":{"type":"string","enum":["input","numberInput","secret","switch","select"]},"value":{"description":"密钥值类型，value 为明文，secret 为密文，如果了 value 则优先使用 value。","example":{"value":"1234567890","secret":""},"type":"object","properties":{"value":{"type":"string"},"secret":{"type":"string"}}},"list":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"string"}},"required":["label","value"]}}},"required":["key","label","inputType"]}},"canEdit":{"type":"boolean"},"isPro":{"type":"boolean"},"isToolOutput":{"type":"boolean"},"deprecated":{"type":"boolean"}},"required":["key","label","renderTypeList"]}},"outputs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"key":{"anyOf":[{"type":"string","enum":["userChatInput","history","answerText","reasoningText","success","failed","system_text","system_addOutputParam","system_rawResponse","system_error","system_error_text","userFiles","quoteQA","cqResult","fields","system_resultTrue","system_resultFalse","selectedTools","httpRawResponse","pluginStart","ifElseResult","selectResult","loopArray","loopStartInput","loopStartIndex","formInputResult","fileTitle","error"]},{"type":"string"}]},"type":{"type":"string","enum":["hidden","error","source","static","dynamic"]},"valueType":{"type":"string","enum":["string","number","boolean","object","arrayString","arrayNumber","arrayBoolean","arrayObject","arrayAny","any","chatHistory","datasetQuote","dynamic","selectDataset","selectApp"]},"valueDesc":{"type":"string"},"value":{},"label":{"type":"string"},"description":{"type":"string"},"defaultValue":{},"required":{"type":"boolean"},"invalid":{"type":"boolean"},"invalidCondition":{"type":"string","description":"Function placeholder; not represented in JSON payloads"},"customFieldConfig":{"type":"object","properties":{"selectValueTypeList":{"type":"array","items":{"type":"string","enum":["string","number","boolean","object","arrayString","arrayNumber","arrayBoolean","arrayObject","arrayAny","any","chatHistory","datasetQuote","dynamic","selectDataset","selectApp"]}},"showDefaultValue":{"type":"boolean"},"showDescription":{"type":"boolean"}}},"deprecated":{"type":"boolean"}},"required":["id","key","type"]}},"pluginId":{"type":"string"},"isFolder":{"type":"boolean"},"pluginData":{"type":"object","properties":{"diagram":{"type":"string"},"userGuide":{"type":"string"},"courseUrl":{"type":"string"},"name":{"type":"string"},"avatar":{"type":"string"},"error":{"type":"string"},"status":{"anyOf":[{"type":"number","const":1},{"type":"number","const":2},{"type":"number","const":3}]}}},"toolConfig":{"type":"object","properties":{"mcpToolSet":{"type":"object","properties":{"toolId":{"type":"string"},"url":{"type":"string"},"headerSecret":{"description":"存储密钥值类型，key 为密钥名称，value 为密钥值。","example":{"Authorization":{"value":"1234567890","secret":""}},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"description":"密钥值类型，value 为明文，secret 为密文，如果了 value 则优先使用 value。","example":{"value":"1234567890","secret":""},"type":"object","properties":{"value":{"type":"string"},"secret":{"type":"string"}}}},"toolList":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"inputSchema":{"type":"object","properties":{"type":{},"properties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"description":{"type":"string"},"x-tool-description":{"type":"string"},"type":{},"enum":{"type":"array","items":{"type":"string"}},"minimum":{"type":"number"},"maximum":{"type":"number"},"items":{}},"required":["type"]}},"required":{"type":"array","items":{"type":"string"}}}}},"required":["name","description","inputSchema"]}}},"required":["toolId","url","toolList"]},"mcpTool":{"type":"object","properties":{"toolId":{"type":"string"}},"required":["toolId"]},"systemTool":{"type":"object","properties":{"toolId":{"type":"string"}},"required":["toolId"]},"systemToolSet":{"type":"object","properties":{"toolId":{"type":"string"},"toolList":{"type":"array","items":{"type":"object","properties":{"toolId":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"}},"required":["toolId","name","description"]}}},"required":["toolId","toolList"]},"httpToolSet":{"type":"object","properties":{"toolList":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"inputSchema":{"type":"object","properties":{"type":{},"properties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"description":{"type":"string"},"x-tool-description":{"type":"string"},"type":{},"enum":{"type":"array","items":{"type":"string"}},"minimum":{"type":"number"},"maximum":{"type":"number"},"items":{}},"required":["type"]}},"required":{"type":"array","items":{"type":"string"}}}},"outputSchema":{"type":"object","properties":{"type":{},"properties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"description":{"type":"string"},"x-tool-description":{"type":"string"},"type":{},"enum":{"type":"array","items":{"type":"string"}},"minimum":{"type":"number"},"maximum":{"type":"number"},"items":{}},"required":["type"]}},"required":{"type":"array","items":{"type":"string"}}}},"path":{"type":"string"},"method":{"type":"string"},"staticParams":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"]}},"staticHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"]}},"staticBody":{"type":"object","properties":{"type":{"type":"string","enum":["none","form-data","x-www-form-urlencoded","json","xml","raw-text"]},"content":{"type":"string"},"formData":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"]}}},"required":["type"]},"headerSecret":{"description":"存储密钥值类型，key 为密钥名称，value 为密钥值。","example":{"Authorization":{"value":"1234567890","secret":""}},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"description":"密钥值类型，value 为明文，secret 为密文，如果了 value 则优先使用 value。","example":{"value":"1234567890","secret":""},"type":"object","properties":{"value":{"type":"string"},"secret":{"type":"string"}}}}},"required":["name","description","inputSchema","outputSchema","path","method"]}},"baseUrl":{"type":"string"},"apiSchemaStr":{"type":"string"},"customHeaders":{"type":"string"},"headerSecret":{"description":"存储密钥值类型，key 为密钥名称，value 为密钥值。","example":{"Authorization":{"value":"1234567890","secret":""}},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"description":"密钥值类型，value 为明文，secret 为密文，如果了 value 则优先使用 value。","example":{"value":"1234567890","secret":""},"type":"object","properties":{"value":{"type":"string"},"secret":{"type":"string"}}}}},"required":["toolList"]},"httpTool":{"type":"object","properties":{"toolId":{"type":"string"}},"required":["toolId"]}}},"currentCost":{"type":"number"},"systemKeyCost":{"type":"number"},"hasTokenFee":{"type":"boolean"},"hasSystemSecret":{"type":"boolean"},"nodeId":{"type":"string"},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"]}},"required":["flowNodeType","name","inputs","outputs","nodeId"]}},"edges":{"example":[],"description":"应用连线","type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"sourceHandle":{"type":"string"},"target":{"type":"string"},"targetHandle":{"type":"string"}},"required":["source","sourceHandle","target","targetHandle"]}},"chatConfig":{"description":"聊天配置","type":"object","properties":{"welcomeText":{"type":"string"},"variables":{"type":"array","items":{"type":"object","properties":{"maxFiles":{"type":"number"},"canSelectFile":{"type":"boolean"},"customPdfParse":{"type":"boolean"},"canSelectImg":{"type":"boolean"},"canSelectVideo":{"type":"boolean"},"canSelectAudio":{"type":"boolean"},"canSelectCustomFileExtension":{"type":"boolean"},"customFileExtensionList":{"type":"array","items":{"type":"string"}},"key":{"anyOf":[{"type":"string","enum":["welcomeText","switch","history","text","questionGuide","tts","whisper","variables","scheduleTrigger","chatInputGuide","autoExecute","instruction","userChatInput","inputFiles","agents","model","systemPrompt","description","system_anyInput","system_textareaInput","system_addInputParam","system_forbid_stream","system_header_secret","system_input_config","maxContext","temperature","maxToken","aiSettings","isResponseAnswerText","aiChatQuoteRole","quoteTemplate","quotePrompt","quoteQA","aiChatVision","stringQuoteText","aiChatReasoning","aiChatTopP","aiChatStopSign","aiChatResponseFormat","aiChatJsonSchema","agent_selectedTools","agent_datasetParams","skills","datasets","similarity","limit","searchMode","embeddingWeight","usingReRank","rerankWeight","rerankModel","datasetSearchUsingExtensionQuery","datasetSearchExtensionModel","datasetSearchExtensionBg","collectionFilterMatch","authTmbId","datasetDeepSearch","datasetDeepSearchModel","datasetDeepSearchMaxTimes","datasetDeepSearchBg","system_datasetQuoteList","content","extractKeys","system_httpReqUrl","system_httpHeader","system_httpMethod","system_httpParams","system_httpJsonBody","system_httpFormBody","system_httpContentType","system_httpTimeout","url","app","pluginId","pluginStart","condition","ifElseList","updateList","code","codeType","fileUrlList","userSelectOptions","loopInputArray","childrenNodeIdList","nodeWidth","nodeHeight","loopNodeInputHeight","loopStartInput","loopStartIndex","loopEndInput","userInputForms","commentText","commentSize","system_toolData","system_toolSetData"]},{"type":"string"}]},"label":{"type":"string"},"valueType":{"type":"string","enum":["string","number","boolean","object","arrayString","arrayNumber","arrayBoolean","arrayObject","arrayAny","any","chatHistory","datasetQuote","dynamic","selectDataset","selectApp"]},"required":{"type":"boolean"},"defaultValue":{},"referencePlaceholder":{"type":"string"},"isRichText":{"type":"boolean"},"placeholder":{"type":"string"},"maxLength":{"type":"number"},"minLength":{"type":"number"},"list":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"string"}},"required":["label","value"]}},"markList":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"number"}},"required":["label","value"]}},"step":{"type":"number"},"max":{"type":"number"},"min":{"type":"number"},"precision":{"type":"number"},"llmModelType":{"type":"string","enum":["all","classify","extractFields","toolCall"]},"canLocalUpload":{"type":"boolean"},"canUrlUpload":{"type":"boolean"},"timeGranularity":{"type":"string","enum":["day","hour","minute","second"]},"timeRangeStart":{"type":"string"},"timeRangeEnd":{"type":"string"},"datasetOptions":{"type":"array","items":{"type":"object","properties":{"datasetId":{"type":"string"},"avatar":{"type":"string"},"name":{"type":"string"},"vectorModel":{"type":"object","properties":{"model":{"type":"string"}},"required":["model"]}},"required":["datasetId","avatar","name","vectorModel"]}},"customInputConfig":{"type":"object","properties":{"selectValueTypeList":{"type":"array","items":{"type":"string","enum":["string","number","boolean","object","arrayString","arrayNumber","arrayBoolean","arrayObject","arrayAny","any","chatHistory","datasetQuote","dynamic","selectDataset","selectApp"]}},"showDefaultValue":{"type":"boolean"},"showDescription":{"type":"boolean"}}},"enums":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"label":{"type":"string"}},"required":["value","label"]}},"type":{"type":"string","enum":["input","textarea","numberInput","select","multipleSelect","timePointSelect","timeRangeSelect","switch","password","file","llmSelect","datasetSelect","custom","internal"]},"description":{"type":"string"}},"required":["key","label","type","description"]}},"autoExecute":{"type":"object","properties":{"open":{"type":"boolean"},"defaultPrompt":{"type":"string"}},"required":["open","defaultPrompt"]},"questionGuide":{"type":"object","properties":{"open":{"type":"boolean"},"model":{"type":"string"},"customPrompt":{"type":"string"}},"required":["open"]},"ttsConfig":{"type":"object","properties":{"type":{"type":"string","enum":["none","web","model"]},"model":{"type":"string"},"voice":{"type":"string"},"speed":{"type":"number"}},"required":["type"]},"whisperConfig":{"type":"object","properties":{"open":{"type":"boolean"},"autoSend":{"type":"boolean"},"autoTTSResponse":{"type":"boolean"}},"required":["open","autoSend","autoTTSResponse"]},"scheduledTriggerConfig":{"type":"object","properties":{"cronString":{"type":"string"},"timezone":{"type":"string"},"defaultPrompt":{"type":"string"}},"required":["cronString","timezone","defaultPrompt"]},"chatInputGuide":{"type":"object","properties":{"open":{"type":"boolean"},"customUrl":{"type":"string"}},"required":["open","customUrl"]},"fileSelectConfig":{"type":"object","properties":{"maxFiles":{"type":"number"},"canSelectFile":{"type":"boolean"},"customPdfParse":{"type":"boolean"},"canSelectImg":{"type":"boolean"},"canSelectVideo":{"type":"boolean"},"canSelectAudio":{"type":"boolean"},"canSelectCustomFileExtension":{"type":"boolean"},"customFileExtensionList":{"type":"array","items":{"type":"string"}}}},"instruction":{"type":"string"}}},"templateId":{"example":"template-123","description":"模板 ID","type":"string"},"utmParams":{"description":"UTM 参数","type":"object","properties":{"shortUrlSource":{"type":"string"},"shortUrlMedium":{"type":"string"},"shortUrlContent":{"type":"string"}}}},"required":["name","type","modules"]}}}},"responses":{"200":{"description":"成功创建","content":{"application/json":{"schema":{"example":"68ad85a7463006c963799a05","description":"应用 ID","type":"string","pattern":"^[0-9a-fA-F]{24}$"}}}}}}},"/core/app/getPermission":{"get":{"summary":"获取应用权限","description":"根据应用 ID 获取当前用户对该应用的权限信息","tags":["应用权限"],"parameters":[{"in":"query","name":"appId","schema":{"example":"68ad85a7463006c963799a05","description":"应用 ID","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"required":true,"description":"应用 ID"}],"responses":{"200":{"description":"成功获取应用权限","content":{"application/json":{"schema":{"type":"object","properties":{"hasReadPer":{"description":"是否有读权限","type":"boolean"},"hasWritePer":{"description":"是否有写权限","type":"boolean"},"hasManagePer":{"description":"是否有管理权限","type":"boolean"},"hasReadChatLogPer":{"description":"是否有读取对话日志权限","type":"boolean"},"isOwner":{"description":"是否为所有者","type":"boolean"}},"required":["hasReadPer","hasWritePer","hasManagePer","hasReadChatLogPer","isOwner"],"additionalProperties":false}}}}}}},"/core/app/mcpTools/getTools":{"post":{"summary":"解析 MCP 工具列表","description":"解析 MCP 工具列表","tags":["MCP 工具管理"],"requestBody":{"content":{"application/json":{"schema":{"example":{"url":"https://example.com/mcp","headerSecret":{}},"type":"object","properties":{"url":{"example":"https://example.com/mcp","description":"MCP 服务地址","type":"string"},"headerSecret":{"example":{"Authorization":{"value":"token","secret":"********"}},"description":"请求头密钥","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"description":"密钥值类型，value 为明文，secret 为密文，如果了 value 则优先使用 value。","example":{"value":"1234567890","secret":""},"type":"object","properties":{"value":{"type":"string"},"secret":{"type":"string"}}}}},"required":["url"]}}}},"responses":{"200":{"description":"成功解析 MCP 工具列表","content":{"application/json":{"schema":{"example":[],"description":"MCP 工具配置列表","type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"inputSchema":{"type":"object","properties":{"type":{},"properties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"description":{"type":"string"},"x-tool-description":{"type":"string"},"type":{},"enum":{"type":"array","items":{"type":"string"}},"minimum":{"type":"number"},"maximum":{"type":"number"},"items":{}},"required":["type"],"additionalProperties":false}},"required":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["name","description","inputSchema"],"additionalProperties":false}}}}}}}},"/core/app/mcpTools/runTool":{"post":{"summary":"运行 MCP 工具","description":"运行 MCP 工具","tags":["MCP 工具管理"],"requestBody":{"content":{"application/json":{"schema":{"example":{"url":"https://example.com/mcp","toolName":"search","headerSecret":{},"params":{"query":"hello"}},"type":"object","properties":{"url":{"example":"https://example.com/mcp","description":"MCP 服务地址","type":"string"},"toolName":{"example":"search","description":"工具名称","type":"string"},"headerSecret":{"example":{"Authorization":{"value":"token"}},"description":"请求头密钥","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"description":"密钥值类型，value 为明文，secret 为密文，如果了 value 则优先使用 value。","example":{"value":"1234567890","secret":""},"type":"object","properties":{"value":{"type":"string"},"secret":{"type":"string"}}}},"params":{"example":{"query":"hello"},"description":"工具调用参数","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["url","toolName","params"]}}}},"responses":{"200":{"description":"成功运行 MCP 工具","content":{"application/json":{"schema":{"description":"工具调用结果"}}}}}}},"/core/app/mcpTools/create":{"post":{"summary":"创建 MCP 工具集","description":"创建 MCP 工具集应用","tags":["MCP 工具管理"],"requestBody":{"content":{"application/json":{"schema":{"example":{"name":"MCP 工具集","parentId":"68ad85a7463006c963799a05","url":"https://example.com/mcp","toolList":[]},"type":"object","properties":{"parentId":{"example":"68ad85a7463006c963799a05","description":"父级应用/文件夹 ID","anyOf":[{"type":"string"},{"type":"null"}]},"name":{"example":"新应用","description":"应用名称","type":"string","minLength":1},"avatar":{"example":"https://example.com/avatar.png","description":"应用头像","type":"string"},"intro":{"example":"应用介绍","description":"应用介绍","type":"string"},"templateId":{"example":"template-123","description":"模板 ID","type":"string"},"utmParams":{"description":"UTM 参数","type":"object","properties":{"shortUrlSource":{"type":"string"},"shortUrlMedium":{"type":"string"},"shortUrlContent":{"type":"string"}}},"url":{"example":"https://example.com/mcp","description":"MCP 服务地址","type":"string"},"headerSecret":{"example":{"Authorization":{"value":"token","secret":"********"}},"description":"请求头密钥","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"description":"密钥值类型，value 为明文，secret 为密文，如果了 value 则优先使用 value。","example":{"value":"1234567890","secret":""},"type":"object","properties":{"value":{"type":"string"},"secret":{"type":"string"}}}},"toolList":{"example":[{"name":"search","description":"Search tool","inputSchema":{"type":"object","properties":{}}}],"description":"MCP 工具列表","type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"inputSchema":{"type":"object","properties":{"type":{},"properties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"description":{"type":"string"},"x-tool-description":{"type":"string"},"type":{},"enum":{"type":"array","items":{"type":"string"}},"minimum":{"type":"number"},"maximum":{"type":"number"},"items":{}},"required":["type"]}},"required":{"type":"array","items":{"type":"string"}}}}},"required":["name","description","inputSchema"]}}},"required":["name","url","toolList"]}}}},"responses":{"200":{"description":"成功创建 MCP 工具集","content":{"application/json":{"schema":{"example":"68ad85a7463006c963799a05","description":"应用 ID","type":"string","pattern":"^[0-9a-fA-F]{24}$"}}}}}}},"/core/app/mcpTools/update":{"post":{"summary":"更新 MCP 工具集","description":"更新 MCP 工具集配置","tags":["MCP 工具管理"],"requestBody":{"content":{"application/json":{"schema":{"example":{"appId":"68ad85a7463006c963799a05","url":"https://example.com/mcp","headerSecret":{},"toolList":[]},"type":"object","properties":{"appId":{"example":"68ad85a7463006c963799a05","description":"MCP 工具集 ID","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"url":{"example":"https://example.com/mcp","description":"MCP 服务地址","type":"string"},"headerSecret":{"example":{"Authorization":{"value":"token","secret":"********"}},"description":"请求头密钥","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"description":"密钥值类型，value 为明文，secret 为密文，如果了 value 则优先使用 value。","example":{"value":"1234567890","secret":""},"type":"object","properties":{"value":{"type":"string"},"secret":{"type":"string"}}}},"toolList":{"example":[{"name":"search","description":"Search tool","inputSchema":{"type":"object","properties":{}}}],"description":"MCP 工具列表","type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"inputSchema":{"type":"object","properties":{"type":{},"properties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"description":{"type":"string"},"x-tool-description":{"type":"string"},"type":{},"enum":{"type":"array","items":{"type":"string"}},"minimum":{"type":"number"},"maximum":{"type":"number"},"items":{}},"required":["type"]}},"required":{"type":"array","items":{"type":"string"}}}}},"required":["name","description","inputSchema"]}}},"required":["appId","url","toolList"]}}}},"responses":{"200":{"description":"成功更新 MCP 工具集"}}}},"/core/app/mcpTools/getChildren":{"get":{"summary":"获取 MCP 工具列表","description":"获取 MCP 工具集下的工具列表","tags":["MCP 工具管理"],"parameters":[{"in":"query","name":"id","schema":{"example":"68ad85a7463006c963799a05","description":"MCP 工具集 ID","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"required":true,"description":"MCP 工具集 ID"},{"in":"query","name":"searchKey","schema":{"example":"search","description":"工具名称搜索关键词","type":"string"},"description":"工具名称搜索关键词"}],"responses":{"200":{"description":"成功获取 MCP 工具列表","content":{"application/json":{"schema":{"example":[],"description":"MCP 工具列表","type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"inputSchema":{"type":"object","properties":{"type":{},"properties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"description":{"type":"string"},"x-tool-description":{"type":"string"},"type":{},"enum":{"type":"array","items":{"type":"string"}},"minimum":{"type":"number"},"maximum":{"type":"number"},"items":{}},"required":["type"],"additionalProperties":false}},"required":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"id":{"example":"mcp-68ad85a7463006c963799a05/search","description":"工具 ID","type":"string"},"avatar":{"example":"https://example.com/avatar.png","description":"工具头像","type":"string"}},"required":["name","description","inputSchema","id","avatar"],"additionalProperties":false}}}}}}}},"/proApi/core/chat/setting/detail":{"get":{"summary":"获取门户页设置","description":"获取当前团队的门户页设置，包括 slogan、对话提示、Logo、快捷应用、已选工具和精选应用标签等配置信息","tags":["门户页配置"],"responses":{"200":{"description":"成功返回门户页设置信息","content":{"application/json":{"schema":{"type":"object","properties":{"_id":{"example":"68ee0bd23d17260b7829b137","description":"ObjectId","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"appId":{"example":"68ee0bd23d17260b7829b137","description":"ObjectId","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"teamId":{"example":"68ee0bd23d17260b7829b137","description":"ObjectId","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"slogan":{"example":"你好👋，我是 FastGPT ! 请问有什么可以帮你？","description":"Slogan","type":"string"},"dialogTips":{"example":"你可以问我任何问题","description":"对话提示","type":"string"},"enableHome":{"example":true,"description":"是否启用首页","type":"boolean"},"homeTabTitle":{"example":"FastGPT","description":"首页标签","type":"string"},"wideLogoUrl":{"example":"/api/system/img/avatar/68ad85a7463006c963799a05/79183cf9face95d336816f492409ed29","description":"宽 LOGO","type":"string"},"squareLogoUrl":{"example":"/api/system/img/avatar/68ad85a7463006c963799a05/79183cf9face95d336816f492409ed29","description":"方 LOGO","type":"string"},"selectedTools":{"example":[{"pluginId":"68ad85a7463006c963799a05","inputs":{},"name":"获取当前应用","avatar":"/icon/logo.svg"}],"description":"已选工具列表","type":"array","items":{"type":"object","properties":{"pluginId":{"example":"68ee0bd23d17260b7829b137","description":"ObjectId","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"inputs":{"example":null,"description":"工具输入参数","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"name":{"example":"测试应用","description":"工具名称","type":"string"},"avatar":{"example":"测试应用","description":"工具头像","type":"string"}},"required":["pluginId","inputs","name","avatar"],"additionalProperties":false}},"favouriteTags":{"example":[{"id":"ptqn6v4I","name":"效率"},{"id":"jHLWiqff","name":"学习"}],"description":"精选应用标签列表","type":"array","items":{"type":"object","properties":{"id":{"example":"ptqn6v4I","description":"精选应用标签 ID","type":"string"},"name":{"example":"效率","description":"精选应用标签名称","type":"string"}},"required":["id","name"],"additionalProperties":false}},"quickAppList":{"example":[{"_id":"68ad85a7463006c963799a05","name":"测试应用","avatar":"测试应用"}],"description":"快捷应用列表","type":"array","items":{"type":"object","properties":{"_id":{"example":"68ee0bd23d17260b7829b137","description":"ObjectId","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"name":{"example":"测试应用","description":"快捷应用名称","type":"string"},"avatar":{"example":"测试应用","description":"快捷应用头像","type":"string"}},"required":["_id","name","avatar"],"additionalProperties":false}}},"required":["_id","appId","teamId","selectedTools","favouriteTags","quickAppList"],"additionalProperties":false}}}}}}},"/proApi/core/chat/setting/update":{"post":{"summary":"更新门户页设置","description":"更新团队的门户页设置配置，包括 slogan、对话提示、Logo、快捷应用、已选工具和精选应用标签等信息","tags":["门户页配置"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"_id":{"example":"68ee0bd23d17260b7829b137","description":"ObjectId","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"appId":{"example":"68ee0bd23d17260b7829b137","description":"ObjectId","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"teamId":{"example":"68ee0bd23d17260b7829b137","description":"ObjectId","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"slogan":{"example":"你好👋，我是 FastGPT ! 请问有什么可以帮你？","description":"Slogan","type":"string"},"dialogTips":{"example":"你可以问我任何问题","description":"对话提示","type":"string"},"enableHome":{"example":true,"description":"是否启用首页","type":"boolean"},"homeTabTitle":{"example":"FastGPT","description":"首页标签","type":"string"},"wideLogoUrl":{"example":"/api/system/img/avatar/68ad85a7463006c963799a05/79183cf9face95d336816f492409ed29","description":"宽 LOGO","type":"string"},"squareLogoUrl":{"example":"/api/system/img/avatar/68ad85a7463006c963799a05/79183cf9face95d336816f492409ed29","description":"方 LOGO","type":"string"},"quickAppIds":{"example":["68ad85a7463006c963799a05"],"description":"快捷应用 ID 列表","type":"array","items":{"example":"68ee0bd23d17260b7829b137","description":"ObjectId","type":"string","pattern":"^[0-9a-fA-F]{24}$"}},"selectedTools":{"example":[{"pluginId":"68ad85a7463006c963799a05","inputs":{}}],"description":"已选工具列表","type":"array","items":{"type":"object","properties":{"pluginId":{"example":"68ee0bd23d17260b7829b137","description":"ObjectId","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"inputs":{"example":null,"description":"工具输入参数","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["pluginId","inputs"]}},"favouriteTags":{"example":[{"id":"ptqn6v4I","name":"效率"},{"id":"jHLWiqff","name":"学习"}],"description":"精选应用标签列表","type":"array","items":{"type":"object","properties":{"id":{"example":"ptqn6v4I","description":"精选应用标签 ID","type":"string"},"name":{"example":"效率","description":"精选应用标签名称","type":"string"}},"required":["id","name"]}}}}}}},"responses":{"200":{"description":"成功更新门户页设置","content":{"application/json":{"schema":{"type":"object","properties":{"_id":{"example":"68ee0bd23d17260b7829b137","description":"ObjectId","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"appId":{"example":"68ee0bd23d17260b7829b137","description":"ObjectId","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"teamId":{"example":"68ee0bd23d17260b7829b137","description":"ObjectId","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"slogan":{"example":"你好👋，我是 FastGPT ! 请问有什么可以帮你？","description":"Slogan","type":"string"},"dialogTips":{"example":"你可以问我任何问题","description":"对话提示","type":"string"},"enableHome":{"example":true,"description":"是否启用首页","type":"boolean"},"homeTabTitle":{"example":"FastGPT","description":"首页标签","type":"string"},"wideLogoUrl":{"example":"/api/system/img/avatar/68ad85a7463006c963799a05/79183cf9face95d336816f492409ed29","description":"宽 LOGO","type":"string"},"squareLogoUrl":{"example":"/api/system/img/avatar/68ad85a7463006c963799a05/79183cf9face95d336816f492409ed29","description":"方 LOGO","type":"string"},"selectedTools":{"example":[{"pluginId":"68ad85a7463006c963799a05","inputs":{},"name":"获取当前应用","avatar":"/icon/logo.svg"}],"description":"已选工具列表","type":"array","items":{"type":"object","properties":{"pluginId":{"example":"68ee0bd23d17260b7829b137","description":"ObjectId","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"inputs":{"example":null,"description":"工具输入参数","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"name":{"example":"测试应用","description":"工具名称","type":"string"},"avatar":{"example":"测试应用","description":"工具头像","type":"string"}},"required":["pluginId","inputs","name","avatar"],"additionalProperties":false}},"favouriteTags":{"example":[{"id":"ptqn6v4I","name":"效率"},{"id":"jHLWiqff","name":"学习"}],"description":"精选应用标签列表","type":"array","items":{"type":"object","properties":{"id":{"example":"ptqn6v4I","description":"精选应用标签 ID","type":"string"},"name":{"example":"效率","description":"精选应用标签名称","type":"string"}},"required":["id","name"],"additionalProperties":false}},"quickAppList":{"example":[{"_id":"68ad85a7463006c963799a05","name":"测试应用","avatar":"测试应用"}],"description":"快捷应用列表","type":"array","items":{"type":"object","properties":{"_id":{"example":"68ee0bd23d17260b7829b137","description":"ObjectId","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"name":{"example":"测试应用","description":"快捷应用名称","type":"string"},"avatar":{"example":"测试应用","description":"快捷应用头像","type":"string"}},"required":["_id","name","avatar"],"additionalProperties":false}}},"required":["_id","appId","teamId","selectedTools","favouriteTags","quickAppList"],"additionalProperties":false}}}}}}},"/proApi/core/chat/setting/favourite/list":{"get":{"summary":"获取精选应用列表","description":"获取团队配置的精选应用列表，支持按名称和标签筛选","tags":["门户页配置"],"parameters":[{"in":"query","name":"name","schema":{"example":"测试应用","description":"精选应用名称","type":"string"},"description":"精选应用名称"},{"in":"query","name":"tag","schema":{"example":"效率","description":"精选应用标签","type":"string"},"description":"精选应用标签"}],"responses":{"200":{"description":"成功返回精选应用列表","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"_id":{"example":"68ee0bd23d17260b7829b137","description":"ObjectId","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"teamId":{"example":"68ee0bd23d17260b7829b137","description":"ObjectId","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"appId":{"example":"68ee0bd23d17260b7829b137","description":"ObjectId","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"favouriteTags":{"example":["ptqn6v4I","jHLWiqff"],"description":"精选应用标签","type":"array","items":{"type":"string"}},"order":{"example":1,"description":"排序","type":"number"},"name":{"example":"Jina 网页阅读","description":"精选应用名称","type":"string"},"intro":{"example":"","description":"精选应用简介","type":"string"},"avatar":{"example":"/api/system/img/avatar/68ad85a7463006c963799a05/79183cf9face95d336816f492409ed29","description":"精选应用头像","type":"string"}},"required":["_id","teamId","appId","favouriteTags","order","name"],"additionalProperties":false}}}}}}}},"/proApi/core/chat/setting/favourite/update":{"post":{"summary":"更新精选应用","description":"批量创建或更新精选应用配置，包括应用 ID、标签和排序信息","tags":["门户页配置"],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"appId":{"example":"68ad85a7463006c963799a05","description":"精选应用 ID","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"order":{"example":1,"description":"排序","type":"number"}},"required":["appId","order"]}}}}},"responses":{"200":{"description":"成功更新精选应用","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"_id":{"example":"68ee0bd23d17260b7829b137","description":"ObjectId","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"teamId":{"example":"68ee0bd23d17260b7829b137","description":"ObjectId","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"appId":{"example":"68ee0bd23d17260b7829b137","description":"ObjectId","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"favouriteTags":{"example":["ptqn6v4I","jHLWiqff"],"description":"精选应用标签","type":"array","items":{"type":"string"}},"order":{"example":1,"description":"排序","type":"number"},"name":{"example":"Jina 网页阅读","description":"精选应用名称","type":"string"},"intro":{"example":"","description":"精选应用简介","type":"string"},"avatar":{"example":"/api/system/img/avatar/68ad85a7463006c963799a05/79183cf9face95d336816f492409ed29","description":"精选应用头像","type":"string"}},"required":["_id","teamId","appId","favouriteTags","order","name"],"additionalProperties":false}}}}}}}},"/proApi/core/chat/setting/favourite/order":{"put":{"summary":"更新精选应用排序","description":"批量更新精选应用的显示顺序","tags":["门户页配置"],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"example":"68ad85a7463006c963799a05","description":"精选应用 ID","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"order":{"example":1,"description":"排序","type":"number"}},"required":["id","order"]}}}}},"responses":{"200":{"description":"成功更新精选应用排序","content":{"application/json":{"schema":{"type":"null"}}}}}}},"/proApi/core/chat/setting/favourite/tags":{"put":{"summary":"更新精选应用标签","description":"批量更新精选应用的标签分类","tags":["门户页配置"],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"example":"68ad85a7463006c963799a05","description":"精选应用 ID","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"tags":{"example":["效率","工具"],"description":"精选应用标签","type":"array","items":{"type":"string"}}},"required":["id","tags"]}}}}},"responses":{"200":{"description":"成功更新精选应用标签","content":{"application/json":{"schema":{"type":"null"}}}}}}},"/proApi/core/chat/setting/favourite/delete":{"delete":{"summary":"删除精选应用","description":"根据 ID 删除指定的精选应用配置","tags":["门户页配置"],"parameters":[{"in":"query","name":"id","schema":{"example":"68ee0bd23d17260b7829b137","description":"ObjectId","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"required":true}],"responses":{"200":{"description":"成功删除精选应用","content":{"application/json":{"schema":{"type":"null"}}}}}}},"/core/chat/feedback/updateUserFeedback":{"post":{"summary":"添加/更新用户反馈","description":"用户对消息添加或更新好评/差评反馈","tags":["对话反馈"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"appId":{"example":"68ad85a7463006c963799a05","description":"应用 ID","type":"string","minLength":1},"chatId":{"example":"chat123","description":"对话 ID","type":"string","minLength":1},"dataId":{"example":"data123","description":"消息数据 ID","type":"string","minLength":1},"userGoodFeedback":{"example":"回答很好","description":"用户好评反馈内容","anyOf":[{"type":"string"},{"type":"null"}]},"userBadFeedback":{"example":"回答不准确","description":"用户差评反馈内容","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["appId","chatId","dataId"]}}}},"responses":{"200":{"description":"成功更新用户反馈","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}}}}},"/core/chat/feedback/getFeedbackRecordIds":{"post":{"summary":"获取反馈记录ID列表","description":"根据反馈类型和已读状态，获取符合条件的消息ID列表","tags":["对话反馈"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"appId":{"example":"68ad85a7463006c963799a05","description":"应用 ID","type":"string"},"chatId":{"example":"chat123","description":"对话 ID","type":"string"},"feedbackType":{"example":"has_feedback","description":"反馈类型：has_feedback-所有反馈, good-好评, bad-差评","type":"string","enum":["has_feedback","good","bad"]},"unreadOnly":{"example":false,"description":"是否只返回未读的反馈","type":"boolean"}},"required":["appId","chatId","feedbackType"]}}}},"responses":{"200":{"description":"成功获取反馈记录ID列表","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"example":10,"description":"符合条件的反馈总数","type":"integer","minimum":0,"maximum":9007199254740991},"dataIds":{"example":["data123","data456"],"description":"反馈记录的数据 ID 列表","type":"array","items":{"type":"string"}}},"required":["total","dataIds"],"additionalProperties":false}}}}}}},"/core/chat/feedback/updateFeedbackReadStatus":{"post":{"summary":"应用管理员-更新反馈阅读状态","description":"标记指定消息的反馈为已读或未读状态","tags":["对话反馈"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"appId":{"example":"68ad85a7463006c963799a05","description":"应用 ID","type":"string","minLength":1},"chatId":{"example":"chat123","description":"对话 ID","type":"string","minLength":1},"dataId":{"example":"data123","description":"消息数据 ID","type":"string","minLength":1},"isRead":{"example":true,"description":"是否已读","type":"boolean"}},"required":["appId","chatId","dataId","isRead"]}}}},"responses":{"200":{"description":"成功更新反馈阅读状态","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"example":true,"description":"操作是否成功","type":"boolean"}},"required":["success"],"additionalProperties":false}}}}}}},"/core/chat/feedback/adminUpdate":{"post":{"summary":"应用管理员-标注反馈","description":"管理员为指定消息添加或更新标注反馈，包含数据集关联信息","tags":["对话反馈"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"appId":{"example":"68ad85a7463006c963799a05","description":"应用 ID","type":"string","minLength":1},"chatId":{"example":"chat123","description":"对话 ID","type":"string","minLength":1},"dataId":{"example":"data123","description":"消息数据 ID","type":"string","minLength":1},"datasetId":{"example":"dataset123","description":"数据集 ID","type":"string","minLength":1},"feedbackDataId":{"example":"feedback123","description":"反馈数据 ID","type":"string","minLength":1},"q":{"example":"用户问题","description":"问题内容","type":"string","minLength":1},"a":{"example":"AI 回答","description":"答案内容（可选）","type":"string"}},"required":["appId","chatId","dataId","datasetId","feedbackDataId","q"]}}}},"responses":{"200":{"description":"成功更新管理员反馈标注","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}}}}},"/core/chat/feedback/closeCustom":{"post":{"summary":"应用管理员-关闭自定义反馈","description":"删除或关闭指定索引位置的自定义反馈条目","tags":["对话反馈"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"appId":{"example":"68ad85a7463006c963799a05","description":"应用 ID","type":"string","minLength":1},"chatId":{"example":"chat123","description":"对话 ID","type":"string","minLength":1},"dataId":{"example":"data123","description":"消息数据 ID","type":"string","minLength":1},"index":{"example":0,"description":"自定义反馈的索引位置","type":"integer","minimum":0,"maximum":9007199254740991}},"required":["appId","chatId","dataId","index"]}}}},"responses":{"200":{"description":"成功关闭自定义反馈","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}}}}},"/core/chat/history/getHistories":{"post":{"summary":"获取对话历史列表","description":"分页获取指定应用的对话历史记录","tags":["历史记录管理"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"pageSize":{"description":"每页条数","anyOf":[{"type":"number"},{"type":"string"}]},"offset":{"description":"偏移量(与页码二选一)","anyOf":[{"type":"number"},{"type":"string"}]},"pageNum":{"description":"页码(与偏移量二选一)","anyOf":[{"type":"number"},{"type":"string"}]},"shareId":{"description":"分享链接ID","type":"string"},"outLinkUid":{"description":"外链用户ID","type":"string"},"teamId":{"description":"团队ID","type":"string"},"teamToken":{"description":"团队Token","type":"string"},"appId":{"description":"应用ID","type":"string"},"source":{"description":"对话来源","type":"string","enum":["test","online","share","api","cronJob","team","feishu","official_account","wecom","mcp"]},"startCreateTime":{"description":"创建时间开始","type":"string"},"endCreateTime":{"description":"创建时间结束","type":"string"},"startUpdateTime":{"description":"更新时间开始","type":"string"},"endUpdateTime":{"description":"更新时间结束","type":"string"}}}}}},"responses":{"200":{"description":"成功获取对话历史列表","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"default":0,"type":"number"},"list":{"default":[],"type":"array","items":{"type":"object","properties":{"chatId":{"type":"string"},"updateTime":{"type":"string"},"appId":{"type":"string"},"customTitle":{"type":"string"},"title":{"type":"string"},"top":{"type":"boolean"}},"required":["chatId","updateTime","appId","title"],"additionalProperties":false}}},"required":["total","list"],"additionalProperties":false}}}}}}},"/core/chat/history/updateHistory":{"put":{"summary":"修改对话历史","description":"修改对话历史的标题、自定义标题或置顶状态","tags":["历史记录管理"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"shareId":{"description":"分享链接ID","type":"string"},"outLinkUid":{"description":"外链用户ID","type":"string"},"teamId":{"description":"团队ID","type":"string"},"teamToken":{"description":"团队Token","type":"string"},"appId":{"description":"应用ID","example":"68ee0bd23d17260b7829b137","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"chatId":{"description":"对话ID","type":"string","minLength":1},"title":{"description":"标题","type":"string"},"customTitle":{"description":"自定义标题","type":"string"},"top":{"description":"是否置顶","type":"boolean"}},"required":["appId","chatId"]}}}},"responses":{"200":{"description":"成功修改对话历史"}}}},"/core/chat/history/delHistory":{"delete":{"summary":"删除单个对话历史","description":"软删除指定的单个对话记录","tags":["历史记录管理"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"shareId":{"description":"分享链接ID","type":"string"},"outLinkUid":{"description":"外链用户ID","type":"string"},"teamId":{"description":"团队ID","type":"string"},"teamToken":{"description":"团队Token","type":"string"},"appId":{"description":"应用ID","example":"68ee0bd23d17260b7829b137","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"chatId":{"description":"对话ID","type":"string","minLength":1}},"required":["appId","chatId"]}}}},"responses":{"200":{"description":"成功删除对话"}}}},"/core/chat/history/clearHistories":{"delete":{"summary":"清空应用对话历史","description":"清空指定应用的所有对话记录(软删除)","tags":["历史记录管理"],"parameters":[{"in":"query","name":"shareId","schema":{"description":"分享链接ID","type":"string"},"description":"分享链接ID"},{"in":"query","name":"outLinkUid","schema":{"description":"外链用户ID","type":"string"},"description":"外链用户ID"},{"in":"query","name":"teamId","schema":{"description":"团队ID","type":"string"},"description":"团队ID"},{"in":"query","name":"teamToken","schema":{"description":"团队Token","type":"string"},"description":"团队Token"},{"in":"query","name":"appId","schema":{"description":"应用ID","example":"68ee0bd23d17260b7829b137","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"required":true,"description":"应用ID"}],"responses":{"200":{"description":"成功清空对话历史"}}}},"/core/chat/history/batchDelete":{"post":{"summary":"批量删除对话历史","description":"批量删除指定应用的多个对话记录(真实删除)，需应用日志权限。","tags":["历史记录管理"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"appId":{"example":"68ee0bd23d17260b7829b137","description":"ObjectId","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"chatIds":{"description":"对话ID列表","example":["chat_123456","chat_789012"],"minItems":1,"type":"array","items":{"type":"string","minLength":1}}},"required":["appId","chatIds"]}}}},"responses":{"200":{"description":"成功删除对话"}}}},"/v2/chat/stop":{"post":{"summary":"停止 Agent 运行","description":"优雅停止正在运行的 Agent, 会尝试等待当前节点结束后返回，最长 5s，超过 5s 仍未结束，则会返回成功。\n  LLM 节点，流输出时会同时被终止，但 HTTP 请求节点这种可能长时间运行的，不会被终止。","tags":["对话操作"],"requestBody":{"content":{"application/json":{"schema":{"example":{"appId":"1234567890","chatId":"1234567890","outLinkAuthData":{"shareId":"1234567890","outLinkUid":"1234567890"}},"type":"object","properties":{"appId":{"description":"应用ID","example":"68ee0bd23d17260b7829b137","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"chatId":{"description":"对话ID","type":"string","minLength":1},"outLinkAuthData":{"description":"外链鉴权数据","type":"object","properties":{"shareId":{"description":"分享链接ID","type":"string"},"outLinkUid":{"description":"外链用户ID","type":"string"},"teamId":{"description":"团队ID","type":"string"},"teamToken":{"description":"团队Token","type":"string"}}}},"required":["appId","chatId"]}}}},"responses":{"200":{"description":"成功停止工作流","content":{"application/json":{"schema":{"example":{"success":true},"type":"object","properties":{"success":{"description":"是否成功停止","type":"boolean"}},"required":["success"],"additionalProperties":false}}}}}}},"/core/chat/file/presignChatFilePostUrl":{"post":{"summary":"获取文件上传 URL","description":"获取文件上传 URL","tags":["对话操作"],"requestBody":{"content":{"application/json":{"schema":{"example":{"filename":"1234567890","appId":"1234567890","chatId":"1234567890","outLinkAuthData":{"shareId":"1234567890","outLinkUid":"1234567890"}},"type":"object","properties":{"filename":{"description":"文件名","type":"string","minLength":1},"appId":{"description":"应用ID","example":"68ee0bd23d17260b7829b137","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"chatId":{"description":"对话ID","type":"string","minLength":1},"outLinkAuthData":{"description":"外链鉴权数据","type":"object","properties":{"shareId":{"description":"分享链接ID","type":"string"},"outLinkUid":{"description":"外链用户ID","type":"string"},"teamId":{"description":"团队ID","type":"string"},"teamToken":{"description":"团队Token","type":"string"}}}},"required":["filename","appId","chatId"]}}}},"responses":{"200":{"description":"成功上传对话文件预签名 URL","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","minLength":1},"key":{"type":"string","minLength":1},"headers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"maxSize":{"type":"number","exclusiveMinimum":0}},"required":["url","key","headers"],"additionalProperties":false}}}}}}},"/core/chat/file/presignChatFileGetUrl":{"post":{"summary":"获取文件预览地址","description":"获取文件预览地址","tags":["对话操作"],"requestBody":{"content":{"application/json":{"schema":{"example":{"key":"1234567890","appId":"1234567890","outLinkAuthData":{"shareId":"1234567890","outLinkUid":"1234567890"}},"type":"object","properties":{"key":{"description":"文件key","type":"string","minLength":1},"appId":{"description":"应用ID","example":"68ee0bd23d17260b7829b137","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"outLinkAuthData":{"description":"外链鉴权数据","type":"object","properties":{"shareId":{"description":"分享链接ID","type":"string"},"outLinkUid":{"description":"外链用户ID","type":"string"},"teamId":{"description":"团队ID","type":"string"},"teamToken":{"description":"团队Token","type":"string"}}}},"required":["key","appId"]}}}},"responses":{"200":{"description":"成功获取对话文件预签名 URL","content":{"application/json":{"schema":{"type":"string"}}}}}}},"/core/chat/helperBot/getRecords":{"get":{"summary":"分页获取记录","description":"分页获取记录","tags":["辅助助手"],"parameters":[{"in":"query","name":"pageSize","schema":{"description":"每页条数","anyOf":[{"type":"number"},{"type":"string"}]},"description":"每页条数"},{"in":"query","name":"offset","schema":{"description":"偏移量(与页码二选一)","anyOf":[{"type":"number"},{"type":"string"}]},"description":"偏移量(与页码二选一)"},{"in":"query","name":"pageNum","schema":{"description":"页码(与偏移量二选一)","anyOf":[{"type":"number"},{"type":"string"}]},"description":"页码(与偏移量二选一)"},{"in":"query","name":"type","schema":{"type":"string","enum":["topAgent"]},"required":true},{"in":"query","name":"chatId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"成功返回记录列表","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"default":0,"type":"number"},"list":{"default":[],"type":"array","items":{"allOf":[{"type":"object","properties":{"_id":{"example":"68ee0bd23d17260b7829b137","description":"ObjectId","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"dataId":{"type":"string"},"createTime":{"type":"string"}},"required":["_id","dataId","createTime"],"additionalProperties":false},{"oneOf":[{"type":"object","properties":{"obj":{"type":"string","const":"Human"},"value":{"type":"array","items":{"type":"object","properties":{"text":{"type":"object","properties":{"content":{"type":"string"}},"required":["content"],"additionalProperties":false},"file":{"type":"object","properties":{"type":{"type":"string","enum":["image","file"]},"name":{"type":"string"},"key":{"type":"string"},"url":{"type":"string"}},"required":["type","url"],"additionalProperties":false}},"additionalProperties":false}},"hideInUI":{"type":"boolean"}},"required":["obj","value"],"additionalProperties":false},{"type":"object","properties":{"obj":{"type":"string","const":"System"},"value":{"type":"array","items":{"type":"object","properties":{"text":{"anyOf":[{"type":"object","properties":{"content":{"type":"string"}},"required":["content"],"additionalProperties":false},{"type":"null"}]}},"additionalProperties":false}}},"required":["obj","value"],"additionalProperties":false},{"type":"object","properties":{"obj":{"type":"string","const":"AI"},"value":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"text":{"type":"object","properties":{"content":{"type":"string"}},"required":["content"],"additionalProperties":false}},"required":["text"],"additionalProperties":false},{"type":"object","properties":{"reasoning":{"type":"object","properties":{"content":{"type":"string"}},"required":["content"],"additionalProperties":false}},"required":["reasoning"],"additionalProperties":false},{"type":"object","properties":{"collectionForm":{"type":"object","properties":{"type":{"anyOf":[{"type":"string","const":"userInput"},{"type":"string","const":"agentPlanAskUserForm"}]},"params":{"type":"object","properties":{"description":{"type":"string"},"inputForm":{"type":"array","items":{"type":"object","properties":{"maxFiles":{"type":"number"},"canSelectFile":{"type":"boolean"},"customPdfParse":{"type":"boolean"},"canSelectImg":{"type":"boolean"},"canSelectVideo":{"type":"boolean"},"canSelectAudio":{"type":"boolean"},"canSelectCustomFileExtension":{"type":"boolean"},"customFileExtensionList":{"type":"array","items":{"type":"string"}},"type":{"type":"string","enum":["reference","input","textarea","numberInput","switch","select","multipleSelect","JSONEditor","addInputParam","customVariable","selectApp","selectLLMModel","settingLLMModel","selectDataset","selectDatasetParamsModal","settingDatasetQuotePrompt","hidden","custom","fileSelect","timePointSelect","timeRangeSelect","password"]},"key":{"type":"string"},"label":{"type":"string"},"value":{},"valueType":{"type":"string","enum":["string","number","boolean","object","arrayString","arrayNumber","arrayBoolean","arrayObject","arrayAny","any","chatHistory","datasetQuote","dynamic","selectDataset","selectApp"]},"description":{"type":"string"},"defaultValue":{},"required":{"type":"boolean"},"maxLength":{"type":"number"},"minLength":{"type":"number"},"max":{"type":"number"},"min":{"type":"number"},"list":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"string"}},"required":["label","value"],"additionalProperties":false}}},"required":["type","key","label","value","valueType","required"],"additionalProperties":false}},"submitted":{"type":"boolean"}},"required":["description","inputForm"],"additionalProperties":false}},"required":["type","params"],"additionalProperties":false}},"required":["collectionForm"],"additionalProperties":false},{"type":"object","properties":{"planHint":{"type":"object","properties":{"type":{"type":"string","const":"generation"}},"required":["type"],"additionalProperties":false}},"required":["planHint"],"additionalProperties":false}]}}},"required":["obj","value"],"additionalProperties":false}],"type":"object"}]}}},"required":["total","list"],"additionalProperties":false}}}}}}},"/core/chat/helperBot/deleteRecord":{"delete":{"summary":"删除单组对话","description":"删除单组对话","tags":["辅助助手"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["topAgent"]},"chatId":{"type":"string"},"chatItemId":{"type":"string"}},"required":["type","chatId","chatItemId"]}}}},"responses":{"200":{"description":"成功删除记录","content":{"application/json":{"schema":{}}}}}}},"/core/chat/helperBot/completions":{"post":{"summary":"辅助助手对话接口","description":"辅助助手对话接口","tags":["辅助助手"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"chatId":{"type":"string"},"chatItemId":{"type":"string"},"query":{"type":"string"},"files":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["image","file"]},"key":{"type":"string"},"url":{"type":"string"},"name":{"type":"string"}},"required":["type","key","name"]}},"metadata":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"topAgent"},"data":{"type":"object","properties":{"role":{"anyOf":[{"type":"string"},{"type":"null"}]},"taskObject":{"anyOf":[{"type":"string"},{"type":"null"}]},"systemPrompt":{"anyOf":[{"type":"string"},{"type":"null"}]},"selectedTools":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"selectedDatasets":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"fileUpload":{"anyOf":[{"type":"boolean"},{"type":"null"}]}}}},"required":["type","data"]}],"type":"object"}},"required":["chatId","chatItemId","query","files","metadata"]}}}},"responses":{"200":{"description":"成功返回处理结果","content":{"application/stream+json":{"schema":{}}}}}}},"/core/chat/recentlyUsed":{"get":{"summary":"获取最近使用的应用","description":"获取最近使用的应用","tags":["对话页面通用"],"responses":{"200":{"description":"成功返回最近使用的应用","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"appId":{"description":"应用ID","example":"68ee0bd23d17260b7829b137","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"name":{"description":"应用名称","type":"string","minLength":1},"avatar":{"description":"应用头像","type":"string","minLength":1}},"required":["appId","name","avatar"],"additionalProperties":false}}}}}}}},"/core/dataset/collection/export":{"post":{"summary":"下载集合的所有数据块","description":"下载集合的所有数据块","tags":["集合"],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"description":"通过身份鉴权导出集合","example":{"collectionId":"1234567890"},"type":"object","properties":{"collectionId":{"description":"集合ID","example":"68ee0bd23d17260b7829b137","type":"string","pattern":"^[0-9a-fA-F]{24}$"}},"required":["collectionId"]},{"description":"对话中导出集合，可通过 chatId 等身份信息","example":{"collectionId":"1234567890","appId":"1234567890","chatId":"1234567890","chatItemDataId":"1234567890","chatTime":"2025-12-30T00:00:00.000Z","shareId":"1234567890","outLinkUid":"1234567890"},"type":"object","properties":{"shareId":{"description":"分享链接ID","type":"string"},"outLinkUid":{"description":"外链用户ID","type":"string"},"teamId":{"description":"团队ID","type":"string"},"teamToken":{"description":"团队Token","type":"string"},"collectionId":{"description":"集合ID","example":"68ee0bd23d17260b7829b137","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"appId":{"description":"应用ID","example":"68ee0bd23d17260b7829b137","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"chatId":{"description":"会话ID","example":"68ee0bd23d17260b7829b137","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"chatItemDataId":{"description":"对话ID","type":"string"},"chatTime":{"description":"对话时间","type":"string"}},"required":["collectionId","appId","chatId","chatItemDataId"]}]}}}},"responses":{"200":{"description":"成功导出并下载集合的所有数据块内容"}}}},"/core/plugin/admin/marketplace/installed":{"get":{"summary":"获取系统已安装插件的 ID 列表(管理员视角)","tags":["插件市场"],"parameters":[{"in":"query","name":"type","schema":{"type":"string","enum":["tool"]}}],"responses":{"200":{"description":"获取系统已安装插件的 ID 列表成功","content":{"application/json":{"schema":{"type":"object","properties":{"list":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"name":{},"description":{},"icon":{"type":"string"},"author":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}}},"required":["id","version"],"additionalProperties":false}}},"required":["list"],"additionalProperties":false}}}}}}},"/marketplace/api/tool/list":{"get":{"summary":"获取工具列表","tags":["插件市场"],"parameters":[{"in":"query","name":"pageSize","schema":{"description":"每页条数","anyOf":[{"type":"number"},{"type":"string"}]},"description":"每页条数"},{"in":"query","name":"offset","schema":{"description":"偏移量(与页码二选一)","anyOf":[{"type":"number"},{"type":"string"}]},"description":"偏移量(与页码二选一)"},{"in":"query","name":"pageNum","schema":{"description":"页码(与偏移量二选一)","anyOf":[{"type":"number"},{"type":"string"}]},"description":"页码(与偏移量二选一)"},{"in":"query","name":"searchKey","schema":{"type":"string"}},{"in":"query","name":"tags","schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]}}],"responses":{"200":{"description":"获取市场工具列表成功","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"number"},"list":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":false}}},"required":["total","list"],"additionalProperties":false}}}}}}},"/marketplace/api/tool/detail":{"get":{"summary":"获取单个工具详情","tags":["插件市场"],"parameters":[{"in":"query","name":"toolId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"获取市场工具详情成功","content":{"application/json":{"schema":{"type":"object","properties":{"tools":{"type":"array","items":{"type":"object","properties":{"readme":{"type":"string"}},"additionalProperties":false}}},"required":["tools"],"additionalProperties":false}}}}}}},"/marketplace/api/tool/tags":{"get":{"summary":"获取工具标签","tags":["插件市场"],"responses":{"200":{"description":"获取市场工具标签成功","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"tagId":{"type":"string"},"tagName":{"anyOf":[{"type":"object","properties":{"en":{"type":"string"},"zh-CN":{"type":"string"},"zh-Hant":{"type":"string"}},"required":["en"],"additionalProperties":false},{"type":"string"}]},"tagOrder":{"type":"number"},"isSystem":{"type":"boolean"}},"required":["tagId","tagName","tagOrder","isSystem"],"additionalProperties":false}}}}}}}},"/core/plugin/toolTag/list":{"get":{"summary":"获取工具标签列表","description":"获取所有工具标签列表，按排序顺序返回","tags":["工具标签"],"responses":{"200":{"description":"成功获取工具标签列表","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"tagId":{"type":"string"},"tagName":{"anyOf":[{"type":"object","properties":{"en":{"type":"string"},"zh-CN":{"type":"string"},"zh-Hant":{"type":"string"}},"required":["en"],"additionalProperties":false},{"type":"string"}]},"tagOrder":{"type":"number"},"isSystem":{"type":"boolean"}},"required":["tagId","tagName","tagOrder","isSystem"],"additionalProperties":false}}}}}}}},"/core/plugin/admin/tool/list":{"get":{"summary":"获取系统工具列表","description":"获取系统工具列表，需要系统管理员权限","tags":["管理员系统工具管理"],"parameters":[{"in":"query","name":"parentId","schema":{"anyOf":[{"type":"string"},{"type":"null"}]}}],"responses":{"200":{"description":"成功获取系统工具列表","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"defaultInstalled":{"type":"boolean"},"status":{"default":1,"anyOf":[{"type":"number","const":1},{"type":"number","const":2},{"type":"number","const":3}]},"originCost":{"type":"number"},"currentCost":{"type":"number"},"hasTokenFee":{"type":"boolean"},"systemKeyCost":{"type":"number"},"pluginOrder":{"type":"number"},"id":{"type":"string"},"parentId":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"type":"string"},"intro":{"type":"string"},"author":{"type":"string"},"avatar":{"type":"string"},"tags":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"hasSystemSecret":{"type":"boolean"},"associatedPluginId":{"type":"string"},"isFolder":{"type":"boolean"},"hasSecretInput":{"type":"boolean"}},"required":["status","id","name","hasSecretInput"],"additionalProperties":false}}}}}}}},"/core/plugin/admin/tool/detail":{"get":{"summary":"获取系统工具详情","description":"获取系统工具详情，需要系统管理员权限","tags":["管理员系统工具管理"],"parameters":[{"in":"query","name":"toolId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"成功获取系统工具详情","content":{"application/json":{"schema":{"type":"object","properties":{"defaultInstalled":{"type":"boolean"},"status":{"default":1,"anyOf":[{"type":"number","const":1},{"type":"number","const":2},{"type":"number","const":3}]},"originCost":{"type":"number"},"currentCost":{"type":"number"},"hasTokenFee":{"type":"boolean"},"systemKeyCost":{"type":"number"},"pluginOrder":{"type":"number"},"id":{"type":"string"},"parentId":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"type":"string"},"intro":{"type":"string"},"author":{"type":"string"},"avatar":{"type":"string"},"tags":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"hasSystemSecret":{"type":"boolean"},"associatedPluginId":{"type":"string"},"isFolder":{"type":"boolean"},"userGuide":{"anyOf":[{"type":"string"},{"type":"null"}]},"inputList":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"description":{"type":"string"},"required":{"type":"boolean"},"inputType":{"type":"string","enum":["input","numberInput","secret","switch","select"]},"value":{},"list":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"string"}},"required":["label","value"],"additionalProperties":false}}},"required":["key","label","inputType"],"additionalProperties":false}},"inputListVal":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"childTools":{"type":"array","items":{"type":"object","properties":{"pluginId":{"type":"string"},"name":{"type":"string"},"systemKeyCost":{"type":"number"}},"required":["pluginId","name"],"additionalProperties":false}},"promoteTags":{"description":"对拥有这些 Tag 的用户推荐, 排序到前面","anyOf":[{"type":"array","items":{"type":"string","enum":["wecom"]}},{"type":"null"}]},"hideTags":{"description":"对拥有这些 Tag 的用户隐藏","anyOf":[{"type":"array","items":{"type":"string","enum":["wecom"]}},{"type":"null"}]}},"required":["status","id","name"],"additionalProperties":false}}}}}}},"/core/plugin/admin/tool/update":{"put":{"summary":"更新系统工具","description":"更新系统工具配置，包括基础字段和自定义字段，支持递归更新子配置，需要系统管理员权限","tags":["管理员系统工具管理"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"pluginId":{"type":"string"},"status":{"anyOf":[{"type":"number","const":1},{"type":"number","const":2},{"type":"number","const":3}]},"defaultInstalled":{"type":"boolean"},"originCost":{"type":"number"},"currentCost":{"anyOf":[{"type":"number"},{"type":"null"}]},"systemKeyCost":{"type":"number"},"hasTokenFee":{"type":"boolean"},"inputListVal":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"childTools":{"type":"array","items":{"type":"object","properties":{"pluginId":{"type":"string"},"systemKeyCost":{"type":"number"}},"required":["pluginId"]}},"promoteTags":{"anyOf":[{"type":"array","items":{"type":"string","enum":["wecom"]}},{"type":"null"}]},"hideTags":{"anyOf":[{"type":"array","items":{"type":"string","enum":["wecom"]}},{"type":"null"}]},"name":{"type":"string"},"avatar":{"type":"string"},"intro":{"type":"string"},"tagIds":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"associatedPluginId":{"type":"string"},"userGuide":{"anyOf":[{"type":"string"},{"type":"null"}]},"author":{"type":"string"}},"required":["pluginId"]}}}},"responses":{"200":{"description":"成功更新系统工具","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}}}}},"/core/plugin/admin/tool/updateOrder":{"put":{"summary":"更新系统工具顺序","description":"批量更新系统工具的排序顺序，需要系统管理员权限","tags":["管理员系统工具管理"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"plugins":{"type":"array","items":{"type":"object","properties":{"pluginId":{"type":"string"},"pluginOrder":{"type":"number"}},"required":["pluginId","pluginOrder"]}}},"required":["plugins"]}}}},"responses":{"200":{"description":"成功更新系统工具顺序","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}}}}},"/core/plugin/admin/tool/delete":{"delete":{"summary":"删除系统工具","description":"根据ID删除系统工具，需要系统管理员权限","tags":["管理员系统工具管理"],"parameters":[{"in":"query","name":"toolId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"成功删除系统工具","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}}}}},"/core/plugin/admin/tool/workflow/systemApps":{"post":{"summary":"获取所有系统工具类型应用","description":"获取所有系统工具类型应用，用于选择系统上的应用作为系统工具。需要系统管理员权限","tags":["管理员系统工具管理"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"searchKey":{"type":"string"}}}}}},"responses":{"200":{"description":"成功获取系统工具类型应用","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"_id":{"type":"string"},"avatar":{"type":"string"},"name":{"type":"string"}},"required":["_id","avatar","name"],"additionalProperties":false}}}}}}}},"/core/plugin/admin/tool/workflow/create":{"post":{"summary":"将系统应用设置成系统工具","description":"将系统应用设置成系统工具，需要系统管理员权限","tags":["管理员系统工具管理"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"pluginId":{"type":"string"},"status":{"anyOf":[{"type":"number","const":1},{"type":"number","const":2},{"type":"number","const":3}]},"defaultInstalled":{"type":"boolean"},"originCost":{"type":"number"},"currentCost":{"anyOf":[{"type":"number"},{"type":"null"}]},"systemKeyCost":{"type":"number"},"hasTokenFee":{"type":"boolean"},"inputListVal":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"promoteTags":{"anyOf":[{"type":"array","items":{"type":"string","enum":["wecom"]}},{"type":"null"}]},"hideTags":{"anyOf":[{"type":"array","items":{"type":"string","enum":["wecom"]}},{"type":"null"}]},"name":{"type":"string"},"avatar":{"type":"string"},"intro":{"type":"string"},"tagIds":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"associatedPluginId":{"type":"string"},"userGuide":{"anyOf":[{"type":"string"},{"type":"null"}]},"author":{"type":"string"}},"required":["pluginId"]}}}},"responses":{"200":{"description":"成功将系统应用设置成系统工具","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}}}}},"/core/plugin/toolTag/config/create":{"post":{"summary":"创建工具标签","description":"创建新的工具标签，需要系统管理员权限","tags":["管理员系统工具管理"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"tagName":{"type":"string"}},"required":["tagName"]}}}},"responses":{"200":{"description":"成功创建工具标签","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}}}}},"/core/plugin/toolTag/config/delete":{"delete":{"summary":"删除工具标签","description":"根据标签ID删除工具标签，需要系统管理员权限","tags":["管理员系统工具管理"],"parameters":[{"in":"query","name":"tagId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"成功删除工具标签","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}}}}},"/core/plugin/toolTag/config/update":{"put":{"summary":"更新工具标签","description":"更新工具标签的名称，需要系统管理员权限","tags":["管理员系统工具管理"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"tagId":{"type":"string"},"tagName":{"type":"string"}},"required":["tagId","tagName"]}}}},"responses":{"200":{"description":"成功更新工具标签","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}}}}},"/core/plugin/toolTag/config/updateOrder":{"put":{"summary":"更新工具标签顺序","description":"批量更新工具标签的排序顺序，需要系统管理员权限","tags":["管理员系统工具管理"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"tags":{"type":"array","items":{"type":"object","properties":{"tagId":{"type":"string"},"tagName":{"anyOf":[{"type":"object","properties":{"en":{"type":"string"},"zh-CN":{"type":"string"},"zh-Hant":{"type":"string"}},"required":["en"]},{"type":"string"}]},"tagOrder":{"type":"number"},"isSystem":{"type":"boolean"}},"required":["tagId","tagName","tagOrder","isSystem"]}}},"required":["tags"]}}}},"responses":{"200":{"description":"成功更新工具标签顺序","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}}}}},"/core/plugin/admin/pkg/presign":{"get":{"summary":"获取插件包上传预签名URL","description":"获取插件包上传到存储服务的预签名URL，需要系统管理员权限","tags":["管理员插件管理"],"parameters":[{"in":"query","name":"filename","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"成功获取上传URL","content":{"application/json":{"schema":{"type":"object","properties":{"postURL":{"type":"string"},"formData":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"objectName":{"type":"string"}},"required":["postURL","formData","objectName"],"additionalProperties":false}}}}}}},"/core/plugin/admin/pkg/parse":{"get":{"summary":"解析已上传的插件包","description":"解析已上传的插件包，返回插件包中包含的工具信息，需要系统管理员权限","tags":["管理员插件管理"],"parameters":[{"in":"query","name":"objectName","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"成功解析插件包","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"toolId":{"type":"string"},"name":{"anyOf":[{"type":"object","properties":{"en":{"type":"string"},"zh-CN":{"type":"string"},"zh-Hant":{"type":"string"}},"required":["en"],"additionalProperties":false},{"type":"string"}]},"description":{"type":"object","properties":{"en":{"type":"string"},"zh-CN":{"type":"string"},"zh-Hant":{"type":"string"}},"required":["en"],"additionalProperties":false},"icon":{"type":"string"},"parentId":{"type":"string"},"tags":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]}},"required":["toolId","name","description","icon"],"additionalProperties":false}}}}}}}},"/core/plugin/admin/pkg/confirm":{"post":{"summary":"确认上传插件包","description":"确认上传插件包，将解析的工具添加到系统中，需要系统管理员权限","tags":["管理员插件管理"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"toolIds":{"type":"array","items":{"type":"string"}}},"required":["toolIds"]}}}},"responses":{"200":{"description":"成功确认上传","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}}}}},"/core/plugin/admin/pkg/delete":{"delete":{"summary":"删除插件包","description":"删除指定的插件包工具，需要系统管理员权限","tags":["管理员插件管理"],"parameters":[{"in":"query","name":"toolId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"成功删除插件包","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}}}}},"/core/plugin/admin/installWithUrl":{"post":{"summary":"从URL安装插件","description":"从URL安装插件，需要系统管理员权限","tags":["管理员插件管理"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"downloadUrls":{"type":"array","items":{"type":"string"}}},"required":["downloadUrls"]}}}},"responses":{"200":{"description":"成功安装插件","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}}}}},"/core/plugin/team/list":{"get":{"summary":"获取团队插件列表","description":"获取团队插件列表","tags":["团队插件管理"],"responses":{"200":{"description":"获取团队插件列表成功","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"avatar":{"type":"string"},"name":{"type":"string"},"intro":{"type":"string"},"author":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"status":{"default":1,"anyOf":[{"type":"number","const":1},{"type":"number","const":2},{"type":"number","const":3}]},"installed":{"type":"boolean"},"associatedPluginId":{"type":"string"}},"required":["id","name","status","installed"],"additionalProperties":false}}}}}}}},"/core/plugin/team/toggleInstall":{"post":{"summary":"切换插件安装状态","description":"切换团队插件的安装状态，支持安装或卸载插件","tags":["团队插件管理"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"pluginId":{"type":"string"},"type":{"type":"string","enum":["tool"]},"installed":{"type":"boolean"}},"required":["pluginId","type","installed"]}}}},"responses":{"200":{"description":"请求成功","content":{}}}}},"/core/plugin/team/toolDetail":{"get":{"summary":"获取工具卡片详情","description":"获取工具片详情","tags":["团队插件管理"],"parameters":[{"in":"query","name":"toolId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"获取工具卡片详情成功","content":{"application/json":{"schema":{"type":"object","properties":{"tools":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"intro":{"type":"string"},"icon":{"anyOf":[{"type":"string"},{"type":"null"}]},"readme":{"anyOf":[{"type":"string"},{"type":"null"}]},"versionList":{"type":"array","items":{"type":"object","properties":{"inputs":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"valueType":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["key"],"additionalProperties":false}},"outputs":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"valueType":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["key"],"additionalProperties":false}}},"required":["inputs","outputs"],"additionalProperties":false}}},"required":["name","intro","versionList"],"additionalProperties":false}},"downloadUrl":{"type":"string"}},"required":["tools","downloadUrl"],"additionalProperties":false}}}}}}},"/proApi/support/user/inform/getSystemMsgModal":{"get":{"summary":"获取系统弹窗内容","description":"获取系统消息弹窗的内容","tags":["用户通知"],"responses":{"200":{"description":"成功获取系统弹窗内容","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"description":"弹窗ID","type":"string"},"content":{"description":"弹窗内容","type":"string"}},"required":["id","content"],"additionalProperties":false}}}}}}},"/proApi/support/user/inform/getOperationalAd":{"get":{"summary":"获取运营广告","description":"获取运营广告的图片和链接","tags":["用户通知"],"responses":{"200":{"description":"成功获取运营广告","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"description":"广告ID","type":"string"},"operationalAdImage":{"description":"广告图片URL","type":"string"},"operationalAdLink":{"description":"广告链接","type":"string"}},"required":["id","operationalAdImage","operationalAdLink"],"additionalProperties":false}}}}}}},"/proApi/support/user/inform/getActivityAd":{"get":{"summary":"获取活动广告","description":"获取活动广告的图片和链接","tags":["用户通知"],"responses":{"200":{"description":"成功获取活动广告","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"description":"广告ID","type":"string"},"activityAdImage":{"description":"广告图片URL","type":"string"},"activityAdLink":{"description":"广告链接","type":"string"}},"required":["id","activityAdImage","activityAdLink"],"additionalProperties":false}}}}}}},"/support/wallet/bill/create":{"post":{"summary":"创建订单","description":"创建订单订单，支持标准订阅套餐、额外积分、额外数据集存储三种类型","tags":["订单"],"requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"description":"标准订阅套餐订单创建参数","type":"object","properties":{"type":{"description":"订单类型：标准订阅套餐","type":"string","const":"standSubPlan"},"level":{"description":"标准订阅等级","type":"string","enum":["free","basic","advanced","custom","experience","team","enterprise"]},"subMode":{"description":"订阅周期","type":"string","enum":["month","year"]},"discountCouponId":{"description":"优惠券 ID","type":"string"}},"required":["type","level","subMode"]},{"description":"额外积分订单创建参数","type":"object","properties":{"type":{"description":"订单类型：额外积分","type":"string","const":"extraPoints"},"extraPoints":{"description":"额外积分数量","type":"integer","minimum":0,"maximum":9007199254740991},"month":{"description":"订阅月数","type":"integer","minimum":1,"maximum":12},"discountCouponId":{"description":"优惠券 ID（未使用）","type":"string"}},"required":["type","extraPoints","month"]},{"description":"额外数据集存储订单创建参数","type":"object","properties":{"type":{"description":"订单类型：额外数据集存储","type":"string","const":"extraDatasetSub"},"extraDatasetSize":{"description":"额外数据集大小","type":"integer","minimum":0,"maximum":9007199254740991},"month":{"description":"订阅月数","type":"integer","minimum":1,"maximum":12},"discountCouponId":{"description":"优惠券 ID（未使用）","type":"string"}},"required":["type","extraDatasetSize","month"]}],"type":"object"}}}},"responses":{"200":{"description":"成功创建订单","content":{"application/json":{"schema":{"description":"创建订单响应。企微支付时候，billId 为空","type":"object","properties":{"qrCode":{"description":"支付二维码 URL","type":"string"},"iframeCode":{"description":"支付 iframe 代码","type":"string"},"markdown":{"description":"Markdown 格式的支付信息","type":"string"},"payUrl":{"description":"支付跳转 URL（企微支付）","type":"string"},"metadata":{"description":"支付元数据","anyOf":[{},{"type":"null"}]},"billId":{"description":"订单 ID","example":"68ee0bd23d17260b7829b137","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"readPrice":{"description":"实际支付价格","type":"number","minimum":0},"payment":{"description":"支付方式","type":"string","enum":["balance","wx","alipay","bank","coupon","wecom"]}},"required":["readPrice","payment"],"additionalProperties":false}}}}}}},"/support/wallet/bill/pay/updatePayment":{"post":{"summary":"更新支付方式","description":"为未支付的订单更新支付方式，返回新的支付二维码或链接","tags":["订单"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"billId":{"example":"68ee0bd23d17260b7829b137","description":"ObjectId","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"payWay":{"type":"string","enum":["balance","wx","alipay","bank","coupon","wecom"]}},"required":["billId","payWay"]}}}},"responses":{"200":{"description":"成功更新支付方式","content":{"application/json":{"schema":{"type":"object","properties":{"qrCode":{"description":"支付二维码 URL","type":"string"},"iframeCode":{"description":"支付 iframe 代码","type":"string"},"markdown":{"description":"Markdown 格式的支付信息","type":"string"},"payUrl":{"description":"支付跳转 URL（企微支付）","type":"string"},"metadata":{"description":"支付元数据","anyOf":[{},{"type":"null"}]}},"additionalProperties":false}}}}}}},"/support/wallet/bill/pay/checkPayResult":{"get":{"summary":"检查支付结果","description":"检查订单的支付状态，用于轮询支付结果","tags":["订单"],"parameters":[{"in":"query","name":"payId","schema":{"description":"订单 ID","example":"68ee0bd23d17260b7829b137","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"required":true,"description":"订单 ID"}],"responses":{"200":{"description":"成功获取支付结果","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["SUCCESS","REFUND","NOTPAY","CLOSED"]},"description":{"type":"string"}},"required":["status"],"additionalProperties":false}}}}}}},"/support/wallet/bill/detail":{"get":{"summary":"获取订单详情","description":"根据订单 ID 获取订单详细信息，包括优惠券名称等","tags":["订单"],"parameters":[{"in":"query","name":"billId","schema":{"description":"订单 ID","example":"68ee0bd23d17260b7829b137","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"required":true,"description":"订单 ID"}],"responses":{"200":{"description":"成功获取订单详情","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"_id":{"description":"订单 ID","example":"68ee0bd23d17260b7829b137","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"userId":{"description":"用户 ID","example":"68ee0bd23d17260b7829b137","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"teamId":{"description":"团队 ID","example":"68ee0bd23d17260b7829b137","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"tmbId":{"description":"团队成员 ID","example":"68ee0bd23d17260b7829b137","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"createTime":{"description":"创建时间","type":"string"},"orderId":{"description":"订单 ID","type":"string"},"status":{"description":"订单状态","type":"string","enum":["SUCCESS","REFUND","NOTPAY","CLOSED"]},"type":{"description":"订单类型","type":"string","enum":["balance","standSubPlan","extraDatasetSub","extraPoints"]},"price":{"description":"价格","type":"number"},"couponId":{"description":"优惠券 ID","example":"68ee0bd23d17260b7829b137","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"hasInvoice":{"description":"是否已开发票","type":"boolean"},"metadata":{"description":"元数据","type":"object","properties":{"payWay":{"description":"支付方式","type":"string","enum":["balance","wx","alipay","bank","coupon","wecom"]},"subMode":{"description":"订阅周期","type":"string","enum":["month","year"]},"standSubLevel":{"description":"订阅等级","type":"string","enum":["free","basic","advanced","custom","experience","team","enterprise"]},"month":{"description":"月数","type":"number"},"datasetSize":{"description":"数据集大小","type":"number"},"extraPoints":{"description":"额外积分","type":"number"}},"required":["payWay"],"additionalProperties":false},"refundData":{"description":"退款数据","type":"object","properties":{"amount":{"description":"退款金额","type":"number"},"refundId":{"description":"退款 ID","type":"string"},"refundTime":{"description":"退款时间","type":"string"}},"required":["amount","refundId","refundTime"],"additionalProperties":false},"discountCouponName":{"type":"string"},"couponDetail":{"type":"object","properties":{"key":{"type":"string"},"type":{"type":"string","enum":["bank","activity"]},"subscriptions":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["standard","extraDatasetSize","extraPoints"]},"durationDay":{"type":"number"},"totalPoints":{"type":"number"},"level":{"type":"string","enum":["free","basic","advanced","custom","experience","team","enterprise"]},"extraDatasetSize":{"type":"number"},"customConfig":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["type","durationDay"],"additionalProperties":false}}},"required":["key","type","subscriptions"],"additionalProperties":false}},"required":["_id","userId","teamId","tmbId","createTime","orderId","status","type","price","hasInvoice","metadata"],"additionalProperties":false},{"type":"null"}]}}}}}}},"/support/wallet/bill/list":{"post":{"summary":"获取订单列表","description":"分页获取团队的订单列表，支持按类型筛选","tags":["订单"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"pageSize":{"description":"每页条数","anyOf":[{"type":"number"},{"type":"string"}]},"offset":{"description":"偏移量(与页码二选一)","anyOf":[{"type":"number"},{"type":"string"}]},"pageNum":{"description":"页码(与偏移量二选一)","anyOf":[{"type":"number"},{"type":"string"}]},"type":{"description":"订单类型筛选","type":"string","enum":["balance","standSubPlan","extraDatasetSub","extraPoints"]}}}}}},"responses":{"200":{"description":"成功获取订单列表","content":{"application/json":{"schema":{"type":"object","properties":{"list":{"type":"array","items":{"type":"object","properties":{"_id":{"description":"订单 ID","example":"68ee0bd23d17260b7829b137","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"userId":{"description":"用户 ID","example":"68ee0bd23d17260b7829b137","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"teamId":{"description":"团队 ID","example":"68ee0bd23d17260b7829b137","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"tmbId":{"description":"团队成员 ID","example":"68ee0bd23d17260b7829b137","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"createTime":{"description":"创建时间","type":"string"},"orderId":{"description":"订单 ID","type":"string"},"status":{"description":"订单状态","type":"string","enum":["SUCCESS","REFUND","NOTPAY","CLOSED"]},"type":{"description":"订单类型","type":"string","enum":["balance","standSubPlan","extraDatasetSub","extraPoints"]},"price":{"description":"价格","type":"number"},"couponId":{"description":"优惠券 ID","example":"68ee0bd23d17260b7829b137","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"hasInvoice":{"description":"是否已开发票","type":"boolean"},"metadata":{"description":"元数据","type":"object","properties":{"payWay":{"description":"支付方式","type":"string","enum":["balance","wx","alipay","bank","coupon","wecom"]},"subMode":{"description":"订阅周期","type":"string","enum":["month","year"]},"standSubLevel":{"description":"订阅等级","type":"string","enum":["free","basic","advanced","custom","experience","team","enterprise"]},"month":{"description":"月数","type":"number"},"datasetSize":{"description":"数据集大小","type":"number"},"extraPoints":{"description":"额外积分","type":"number"}},"required":["payWay"],"additionalProperties":false},"refundData":{"description":"退款数据","type":"object","properties":{"amount":{"description":"退款金额","type":"number"},"refundId":{"description":"退款 ID","type":"string"},"refundTime":{"description":"退款时间","type":"string"}},"required":["amount","refundId","refundTime"],"additionalProperties":false},"discountCouponName":{"type":"string"},"couponDetail":{"type":"object","properties":{"key":{"type":"string"},"type":{"type":"string","enum":["bank","activity"]},"subscriptions":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["standard","extraDatasetSize","extraPoints"]},"durationDay":{"type":"number"},"totalPoints":{"type":"number"},"level":{"type":"string","enum":["free","basic","advanced","custom","experience","team","enterprise"]},"extraDatasetSize":{"type":"number"},"customConfig":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["type","durationDay"],"additionalProperties":false}}},"required":["key","type","subscriptions"],"additionalProperties":false}},"required":["_id","userId","teamId","tmbId","createTime","orderId","status","type","price","hasInvoice","metadata"],"additionalProperties":false}},"total":{"description":"总数","type":"number"}},"required":["list","total"],"additionalProperties":false}}}}}}},"/support/wallet/bill/cancel":{"post":{"summary":"取消订单","description":"取消未支付的订单，如果使用了优惠券会自动返还","tags":["订单"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"billId":{"description":"订单 ID","example":"68ee0bd23d17260b7829b137","type":"string","pattern":"^[0-9a-fA-F]{24}$"}},"required":["billId"]}}}},"responses":{"200":{"description":"成功取消订单","content":{"application/json":{"schema":{"type":"null"}}}}}}},"/support/wallet/discountCoupon/list":{"get":{"summary":"获取优惠券列表","description":"获取团队的优惠券列表，包括优惠券状态、使用情况等信息","tags":["优惠券"],"responses":{"200":{"description":"成功获取优惠券列表","content":{"application/json":{"schema":{"description":"优惠券列表","type":"array","items":{"type":"object","properties":{"_id":{"description":"优惠券 ID","example":"68ee0bd23d17260b7829b137","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"teamId":{"description":"团队 ID","example":"68ee0bd23d17260b7829b137","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"type":{"description":"优惠券类型","type":"string","enum":["monthStandardDiscount70","yearStandardDiscount90"]},"startTime":{"description":"生效时间","type":"string"},"expiredTime":{"description":"过期时间","type":"string"},"usedAt":{"description":"使用时间","type":"string"},"createTime":{"description":"创建时间","type":"string"},"name":{"description":"优惠券名称","type":"string"},"description":{"description":"优惠券描述","type":"string"},"discount":{"description":"折扣率","type":"number","minimum":0,"maximum":1},"iconZh":{"description":"中文图标路径","type":"string"},"iconEn":{"description":"英文图标路径","type":"string"},"status":{"description":"优惠券状态","type":"string","enum":["active","used","expired","notStart"]},"billId":{"description":"关联的订单 ID, 被使用后该值存在","example":"68ee0bd23d17260b7829b137","type":"string","pattern":"^[0-9a-fA-F]{24}$"}},"required":["_id","teamId","type","expiredTime","createTime","name","description","discount","iconZh","iconEn","status"],"additionalProperties":false}}}}}}}},"/support/openapi/health":{"get":{"summary":"检查 API Key 是否健康","tags":["APIKey"],"parameters":[{"in":"query","name":"apiKey","schema":{"type":"string","minLength":1},"required":true}],"responses":{"200":{"description":"API Key 可用","content":{"application/json":{"schema":{"type":"object","properties":{"appId":{"description":"如果有关联的应用，会返回应用ID","type":"string"}},"additionalProperties":false}}}},"500":{"description":"ApiKey错误","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","const":"APIKey invalid"}},"required":["message"],"additionalProperties":false}}}}}}},"/proApi/support/customDomain/create":{"post":{"summary":"创建自定义域名","description":"创建一个新的自定义域名配置，需要高级套餐权限。创建后域名会自动部署到 K8s 集群中","tags":["自定义域名"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"example":"chat.example.com","description":"自定义域名","type":"string"},"provider":{"example":"aliyun","description":"DNS 提供商：aliyun, tencent, volcengine","type":"string","enum":["aliyun","tencent","volcengine"]},"cnameDomain":{"example":"lb.example.com","description":"CNAME 目标域名","type":"string"}},"required":["domain","provider","cnameDomain"]}}}},"responses":{"200":{"description":"成功创建自定义域名","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"example":true,"description":"创建是否成功","type":"boolean"}},"required":["success"],"additionalProperties":false}}}}}}},"/proApi/support/customDomain/list":{"get":{"summary":"获取自定义域名列表","description":"获取当前团队的所有自定义域名配置列表","tags":["自定义域名"],"responses":{"200":{"description":"成功获取自定义域名列表","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"teamId":{"type":"string"},"domain":{"type":"string"},"cnameDomain":{"type":"string"},"status":{"type":"string","enum":["active","inactive"]},"verifyFile":{"type":"object","properties":{"path":{"type":"string"},"content":{"type":"string"}},"required":["path","content"],"additionalProperties":false},"provider":{"type":"string","enum":["aliyun","tencent","volcengine"]},"_id":{"example":"68ad85a7463006c963799a05","description":"域名记录 ID","type":"string"}},"required":["teamId","domain","cnameDomain","status","provider"],"additionalProperties":false}}}}}}}},"/proApi/support/customDomain/delete":{"delete":{"summary":"删除自定义域名","description":"删除指定的自定义域名配置，同时会从 K8s 集群中移除相关资源","tags":["自定义域名"],"parameters":[{"in":"query","name":"domain","schema":{"example":"chat.example.com","description":"要删除的域名","type":"string"},"required":true,"description":"要删除的域名"}],"responses":{"200":{"description":"成功删除自定义域名","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"example":true,"description":"删除是否成功","type":"boolean"}},"required":["success"],"additionalProperties":false}}}}}}},"/proApi/support/customDomain/checkDNSResolve":{"post":{"summary":"检查 DNS 解析","description":"检查自定义域名的 CNAME 记录是否正确配置和解析","tags":["自定义域名"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"example":"chat.example.com","description":"要检查的域名","type":"string"},"cnameDomain":{"example":"lb.example.com","description":"CNAME 目标域名","type":"string"}},"required":["domain","cnameDomain"]}}}},"responses":{"200":{"description":"DNS 解析检查结果","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"example":true,"description":"DNS 解析是否成功","type":"boolean"},"message":{"example":"CNAME record not resolved","description":"错误信息","type":"string"}},"required":["success"],"additionalProperties":false}}}}}}},"/proApi/support/customDomain/active":{"post":{"summary":"激活自定义域名","description":"将自定义域名状态设置为激活，并重新部署到 K8s 集群","tags":["自定义域名"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"example":"chat.example.com","description":"要激活的域名","type":"string"}},"required":["domain"]}}}},"responses":{"200":{"description":"成功激活自定义域名","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"example":true,"description":"激活是否成功","type":"boolean"}},"required":["success"],"additionalProperties":false}}}}}}},"/proApi/support/customDomain/updateVerifyFile":{"post":{"summary":"更新域名验证文件","description":"更新域名验证文件配置，用于 SSL 证书验证。更新后会在 K8s 中创建或更新对应的 Ingress","tags":["自定义域名"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"example":"chat.example.com","description":"域名","type":"string"},"path":{"example":"/.well-known/pki-validation/fileauth.txt","description":"验证文件路径","type":"string"},"content":{"example":"202312121234567890abcdef","description":"验证文件内容","type":"string"}},"required":["domain","path","content"]}}}},"responses":{"200":{"description":"成功更新域名验证文件","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"example":true,"description":"更新是否成功","type":"boolean"}},"required":["success"],"additionalProperties":false}}}}}}},"/core/ai/record/getRecord":{"get":{"summary":"获取 LLM 请求追踪记录","description":"根据 requestId 查询 LLM 请求的详细信息,包括请求体和响应内容","tags":["AI 通用 接口"],"parameters":[{"in":"query","name":"requestId","schema":{"example":"V1StGXR8_Z5jdHi6B-myT","description":"LLM 请求追踪 ID","type":"string"},"required":true,"description":"LLM 请求追踪 ID"}],"responses":{"200":{"description":"成功返回 LLM 请求记录","content":{"application/json":{"schema":{"type":"object","properties":{"_id":{"example":"68ee0bd23d17260b7829b137","description":"ObjectId","type":"string","pattern":"^[0-9a-fA-F]{24}$"},"requestId":{"example":"V1StGXR8_Z5jdHi6B-myT","description":"请求追踪 ID","type":"string"},"body":{"description":"LLM 请求体","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"response":{"description":"LLM 响应内容","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createdAt":{"example":"2024-01-01T00:00:00.000Z","description":"创建时间","type":"string"}},"required":["_id","requestId","body","response","createdAt"],"additionalProperties":false}}}}}}}}}