Finx
点金文档中心
查看 Markdown

变更日志

支持字段：· 输入字段名后按 Tab 补全，输入值后，按空格成为标签

2026

10 月

2026-10-29

变更 1修复 2
变更
  • POST/api/agent/run/async— 新增请求级maxInputTokens输入预算，最小65536且不超过模型输入上限；摘要使用独立预算，重试恢复沿用，新请求不继承
    智能体运行
修复
  • POST/api/agent/run/async— 保留原JSON接口文档并补充JOSE协议、示例和错误码；不支持的Content-Type仍返回400 Media type not supported，加密会话续接提示使用英文
    智能体运行
  • POST/api/agent/run/addSupplementaryInput— 保留原JSON接口文档并补充JOSE协议、示例和错误码；不支持的Content-Type仍返回400 Media type not supported
    智能体运行

2026-10-22

新增 1变更 1修复 2
新增
变更
修复
  • POST/api/agent/run/async— 加密请求超限返回413，不支持的Content-Encoding返回415，错误提示使用稳定英文标识；普通JSON续接已加密会话返回409
    智能体运行
  • POST/api/agent/run/addSupplementaryInput— 加密请求超限返回413，不支持的Content-Encoding返回415，错误提示使用稳定英文标识
    智能体运行

2026-10-21

新增 1变更 2
新增
变更
  • POST/api/agent/run/async— 同一接口新增application/jose（dj-jwe-v1）请求体，保留原JSON参数和响应；补充输入须与原运行传输模式一致
    智能体运行
  • POST/api/agent/run/addSupplementaryInput— 同一接口新增application/jose（dj-jwe-v1）补充输入，必须与原运行模式一致，保留原JSON参数和响应
    智能体运行

2026-10-20

新增 2变更 4
新增
变更
  • POST/api/knowledge/document/parseTableStructure— 新上传文件从服务端记录恢复知识库、原始文件名及稳定文档用量身份；客户端无需重复传入，旧显式参数仍兼容
    知识文档
  • POST/api/knowledge/document/importTable— 从上传记录恢复知识库、文件名和预分析用量身份，兼容旧参数；文档用量身份落库后才提交导入
    知识文档
  • POST/api/agent/run/async— 新增请求级enableSubagent开关，仅显式true允许创建或继续子智能体；不传、null或false均关闭，重试和恢复沿用原值，后续新请求不继承
    智能体运行
  • GET/api/session/messages— 支持授权子会话读取，保留分页参数和响应结构；显式校验文档要求的主体身份
    会话管理

2026-10-15

新增 1变更 3
新增
变更

2026-10-13

变更 20
变更
  • POST/api/agent/toggleKnowledgeLibrary— 启用知识库前向内核登记目标库所属应用与租户计费归属；归属不完整时停止启用，禁用历史绑定不受影响
    智能体管理与设定
  • GET/api/knowledge/library/list— 知识编译改为授权后向内核正向登记目标库归属并受理计费上下文；计费默认开启，目标归属或模型供应商不可用时不启动编译
    知识文档
  • POST/api/knowledge/library/create— 知识编译改为授权后向内核正向登记目标库归属并受理计费上下文；计费默认开启，目标归属或模型供应商不可用时不启动编译
    知识文档
  • POST/api/knowledge/library/rebuild— 知识编译改为授权后向内核正向登记目标库归属并受理计费上下文；计费默认开启，目标归属或模型供应商不可用时不启动编译
    知识文档
  • POST/api/knowledge/library/delete— 知识编译改为授权后向内核正向登记目标库归属并受理计费上下文；计费默认开启，目标归属或模型供应商不可用时不启动编译
    知识文档
  • GET/api/knowledge/document/list— 知识编译改为授权后向内核正向登记目标库归属并受理计费上下文；计费默认开启，目标归属或模型供应商不可用时不启动编译
    知识文档
  • GET/api/knowledge/document/tree— 知识编译改为授权后向内核正向登记目标库归属并受理计费上下文；计费默认开启，目标归属或模型供应商不可用时不启动编译
    知识文档
  • GET/api/knowledge/document/nodeContent— 知识编译改为授权后向内核正向登记目标库归属并受理计费上下文；计费默认开启，目标归属或模型供应商不可用时不启动编译
    知识文档
  • GET/api/knowledge/document/download— 知识编译改为授权后向内核正向登记目标库归属并受理计费上下文；计费默认开启，目标归属或模型供应商不可用时不启动编译
    知识文档
  • POST/api/knowledge/document/upload— 知识编译改为授权后向内核正向登记目标库归属并受理计费上下文；计费默认开启，目标归属或模型供应商不可用时不启动编译
    知识文档
  • POST/api/knowledge/document/parseTableStructure— 知识编译改为授权后向内核正向登记目标库归属并受理计费上下文；计费默认开启，目标归属或模型供应商不可用时不启动编译
    知识文档
  • POST/api/knowledge/document/import— 知识编译改为授权后向内核正向登记目标库归属并受理计费上下文；计费默认开启，目标归属或模型供应商不可用时不启动编译
    知识文档
  • POST/api/knowledge/document/importTable— 知识编译改为授权后向内核正向登记目标库归属并受理计费上下文；计费默认开启，目标归属或模型供应商不可用时不启动编译
    知识文档
  • POST/api/knowledge/document/rebuild— 知识编译改为授权后向内核正向登记目标库归属并受理计费上下文；计费默认开启，目标归属或模型供应商不可用时不启动编译
    知识文档
  • POST/api/knowledge/document/delete— 知识编译改为授权后向内核正向登记目标库归属并受理计费上下文；计费默认开启，目标归属或模型供应商不可用时不启动编译
    知识文档
  • POST/api/knowledge/library/update— 知识编译改为授权后向内核正向登记目标库归属并受理计费上下文；计费默认开启，目标归属或模型供应商不可用时不启动编译
    知识文档
  • POST/api/agent/run/async— 运行前登记本次实际选用知识库的目标应用及租户归属；显式集合仍严格限制当前应用，未传或空集合保留历史跨应用启用规则
    智能体运行
  • POST/api/agent/run/async— 新增 projectId 参数，未指定会话时可隐式创建项目会话
    智能体运行
  • POST/api/session/create— 新增 projectId 参数，统一通过会话接口创建项目会话
    会话管理
  • POST/api/workbench/feed/trigger— 实际启动生成运行前登记已启用知识库的目标归属，并保留认证入口来源；缓存命中不新增登记依赖
    工作台

2026-10-10

新增 1
新增

2026-10-09

变更 1修复 1
变更
  • GET/api/tokenBudget/getQuotaStatus— 响应新增 scopeAgents，返回作用域覆盖的全部智能体；传共享作用域内任一智能体ID均可查到该共享账户；scopeAgentId、agentName 标记废弃
    配额管控
修复

2026-10-08

变更 1
变更
  • POST/api/tokenBudget/bindPolicy— 请求新增 scopeAgentIds 列表，支持一组智能体共享配额作用域；原 scopeAgentId 标记废弃，与 scopeAgentIds 互斥
    配额管控

9 月

2026-09-22

变更 2
变更
  • POST/api/agent/run/async— 新增 vaultIds 参数，隐式创建会话时校验应用空间密钥归属并绑定密钥
    智能体运行
  • POST/api/session/create— 新增 vaultIds 参数，创建会话时校验应用空间密钥归属并绑定密钥
    会话管理

2026-09-18

新增 1变更 2移除 1
新增
变更
  • GET/api/agent/run/stream— SSE完成及失败事件新增可选usage，包含运行轮数和回答Token汇总
    智能体运行
  • GET/api/session/messages— 历史消息新增可选stepCount，提供与运行上限计数一致的轮数快照
    会话管理
移除

2026-09-17

新增 3变更 24
新增
变更
  • POST/api/agent/run/async— virtualTools 新增可选字符串 mockResponse，参数校验通过后作为模拟结果原样返回；省略或null使用默认回执，空字符串保留
    智能体运行
  • POST/api/agent/run/async— 新增请求级 maxSteps 正整数参数，不传默认2000，挂起恢复和失败重试沿用原上限
    智能体运行
  • GET/api/agent/run/stream— 虚拟工具的 TOOL_COMPLETED.output 支持返回请求预设的 mockResponse；未指定时仍返回默认success回执，事件结构不变
    智能体运行
  • GET/api/agent/run/stream— MESSAGE_COMPLETED 新增 finishReason 和 finishMessage；达到上限返回 MAX_STEPS，正常结束返回 STOP，结束提示经合成文本事件展示并保存
    智能体运行
  • GET/api/usage/summary— 页面登录用户查询用量时 principalId 固定为本人，传入他人主体返回 403；新增智能体消耗排行接口
    用量观测
  • GET/api/usage/summary— 页面登录用户的 principalId 固定为本人，传入他人主体返回 403
    用量观测
  • GET/api/usage/modelRanking— 页面登录用户查询用量时 principalId 固定为本人，传入他人主体返回 403；新增智能体消耗排行接口
    用量观测
  • GET/api/usage/modelRanking— 页面登录用户的 principalId 固定为本人，传入他人主体返回 403
    用量观测
  • GET/api/usage/agentRanking— 页面登录用户查询用量时 principalId 固定为本人，传入他人主体返回 403；新增智能体消耗排行接口
    用量观测
  • GET/api/tokenBudget/getQuotaStatus— 支持「用户×智能体」作用域配额账户：各接口新增可选 scopeAgentId，新增作用域账户列表查询
    配额管控
  • GET/api/tokenBudget/getQuotaStatus— 新增可选参数 scopeAgentId，用于查询主体在指定智能体上的作用域账户；响应新增 scopeAgentId、agentName 字段
    配额管控
  • GET/api/tokenBudget/listScopedQuotaStatus— 支持「用户×智能体」作用域配额账户：各接口新增可选 scopeAgentId，新增作用域账户列表查询
    配额管控
  • GET/api/tokenBudget/listTopups— 支持「用户×智能体」作用域配额账户：各接口新增可选 scopeAgentId，新增作用域账户列表查询
    配额管控
  • GET/api/tokenBudget/listTopups— 新增可选参数 scopeAgentId，用于查询作用域账户名下的加油包
    配额管控
  • GET/api/tokenBudget/listPolicies— 支持「用户×智能体」作用域配额账户：各接口新增可选 scopeAgentId，新增作用域账户列表查询
    配额管控
  • POST/api/tokenBudget/bindPolicy— 支持「用户×智能体」作用域配额账户：各接口新增可选 scopeAgentId，新增作用域账户列表查询
    配额管控
  • POST/api/tokenBudget/bindPolicy— 请求新增可选 scopeAgentId，传智能体ID时为主体绑定仅在该智能体上生效的作用域账户
    配额管控
  • POST/api/tokenBudget/unbindPolicy— 支持「用户×智能体」作用域配额账户：各接口新增可选 scopeAgentId，新增作用域账户列表查询
    配额管控
  • POST/api/tokenBudget/unbindPolicy— 新增可选请求体 scopeAgentId，用于只解绑主体在指定智能体上的作用域账户；不传请求体行为不变
    配额管控
  • POST/api/tokenBudget/grantTopup— 支持「用户×智能体」作用域配额账户：各接口新增可选 scopeAgentId，新增作用域账户列表查询
    配额管控
  • POST/api/tokenBudget/grantTopup— 请求新增可选 scopeAgentId，传智能体ID时充入主体在该智能体上的作用域账户
    配额管控
  • POST/api/tokenBudget/revokeTopup— 支持「用户×智能体」作用域配额账户：各接口新增可选 scopeAgentId，新增作用域账户列表查询
    配额管控
  • POST/api/tokenBudget/revokeTopup— 请求新增可选 scopeAgentId，撤销作用域账户的加油包时必须传入与充值时一致的作用域
    配额管控
  • POST/api/tokenBudget/resetQuotaUsage— 支持「用户×智能体」作用域配额账户：各接口新增可选 scopeAgentId，新增作用域账户列表查询
    配额管控

2026-09-16

新增 8变更 11
新增
变更
  • GET/api/session/list— 新增可选参数 includeProjectSessions，默认false仅返回未绑定项目的临时会话，传true返回当前身份主体的全部会话（含项目会话）
    会话管理
  • GET/api/sessionAnalysis/downloadLlmRequests— 消息ZIP中的请求文件改为使用包含步骤、版本或压缩序号的可读名称
    会话调用分析
  • GET/api/sessionAnalysis/downloadLlmRequests— 消息下载清单增加调用类型、步骤号、请求版本、压缩序号和重跑标识
    会话调用分析
  • GET/api/agent/schedule/list— 新增可选agentIds，按任务绑定的智能体批量筛选，与agentId互斥；未传新参数时保留原查询行为
    定时任务
  • GET/api/agent/schedule/executionHistory— 新增可选agentIds，按实际执行智能体批量筛选，与taskId取交集；未传新参数时保留原查询行为
    定时任务
  • POST/api/project/create— 项目改为同步创建并移除项目状态：所有接口响应不再返回 status，创建成功后项目立即可用，列表不再按状态过滤，详情不再用于轮询初始化状态
    项目
  • GET/api/project/list— 项目改为同步创建并移除项目状态：所有接口响应不再返回 status，创建成功后项目立即可用，列表不再按状态过滤，详情不再用于轮询初始化状态
    项目
  • GET/api/project/detail— 项目改为同步创建并移除项目状态：所有接口响应不再返回 status，创建成功后项目立即可用，列表不再按状态过滤，详情不再用于轮询初始化状态
    项目
  • POST/api/project/updateName— 项目改为同步创建并移除项目状态：所有接口响应不再返回 status，创建成功后项目立即可用，列表不再按状态过滤，详情不再用于轮询初始化状态
    项目
  • DELETE/api/project/delete— 项目改为同步创建并移除项目状态：所有接口响应不再返回 status，创建成功后项目立即可用，列表不再按状态过滤，详情不再用于轮询初始化状态
    项目
  • GET/api/project/session/list— 项目改为同步创建并移除项目状态：所有接口响应不再返回 status，创建成功后项目立即可用，列表不再按状态过滤，详情不再用于轮询初始化状态
    项目

2026-09-14

新增 13
新增

2026-09-12

变更 1
变更
  • GET/api/agent/run/messages— 新增运行开始时间startedAt和结束时间completedAt，均为Unix毫秒时间戳；空时间字段省略，调用方应以status判断运行是否结束
    智能体运行

2026-09-11

新增 2变更 11
新增
  • POST/api/agent/run/async— 新增 virtualTools 参数（客户端展示工具），模型可产出结构化渲染指令交由调用方终端渲染图表、卡片等界面元素；服务端不执行调用方代码，调用内容从既有 SSE 的 TOOL_CALL_GENERATING、TOOL_START、TOOL_COMPLETED 事件获取，渲染结果无需回传。请求级生效、不被会话与后续运行继承，单次最多16项，定义不合法时整次请求失败；不传时行为不变
    智能体运行
  • POST/api/agent/schedule/importExecution— 新增迁移历史运行记录接口，可把已迁入的历史对话登记为已有定时任务的历史执行记录，补齐迁移后任务的执行历史；接口不调用模型、不触发任务、不改变调度计划，按本地助手消息幂等
    定时任务
变更
  • GET/api/agent/run/stream— 事件流文档新增两节：一是 virtualTools 客户端展示工具的渲染指令如何从既有 TOOL_CALL_GENERATING、TOOL_START、TOOL_COMPLETED 事件消费（不新增事件类型）；二是迁移进来的历史运行（triggerSource 为 imported）没有事件流，订阅返回 409 冲突而非空流。原生运行的事件流行为不变
    智能体运行
  • POST/api/agent/run/suspendTask— 迁移进来的历史运行（triggerSource 为 imported）不支持挂起，调用返回 409 冲突；原生运行行为不变
    智能体运行
  • POST/api/agent/run/resumeTask— 迁移进来的历史运行（triggerSource 为 imported）不支持恢复，调用返回 409 冲突；原生运行行为不变
    智能体运行
  • POST/api/agent/run/terminateTask— 迁移进来的历史运行（triggerSource 为 imported）不支持终止，调用返回 409 冲突；原生运行行为不变
    智能体运行
  • POST/api/agent/run/retryTask— 迁移进来的历史运行（triggerSource 为 imported）不支持重试，调用返回 409 冲突；原生运行重试时沿用原请求快照中的 virtualTools 定义，无需重传
    智能体运行
  • POST/api/agent/run/addSupplementaryInput— 迁移进来的历史运行（triggerSource 为 imported）不支持补充输入，调用返回 409 冲突；原生运行行为不变
    智能体运行
  • POST/api/agent/run/removeSupplementaryInput— 迁移进来的历史运行（triggerSource 为 imported）不支持移除补充输入，调用返回 409 冲突；原生运行行为不变
    智能体运行
  • GET/api/agent/run/previewSupplementaryInput— 迁移进来的历史运行（triggerSource 为 imported）不支持预览补充输入队列，调用返回 409 冲突；原生运行行为不变
    智能体运行
  • POST/api/session/importTrace— 响应新增messageMappings，返回本次实际导入的每轮对话与本地消息ID（turnIndex、userMessageId、assistantMessageId）的映射，用于把导入的对话关联到定时任务历史运行；原有字段语义不变
    会话管理
  • POST/api/session/importQaPair— 响应新增messageMappings，返回本次导入这一轮对话的本地消息ID（turnIndex、userMessageId、assistantMessageId），用于把导入的对话关联到定时任务历史运行；原有字段语义不变
    会话管理
  • GET/api/agent/schedule/executionHistory— 通过「迁移历史运行记录」接口登记的历史运行也会出现在执行历史中，按其 createdAt 参与排序；这类记录只读，不支持挂起、恢复、终止、重试、补充输入和订阅事件流
    定时任务

2026-09-08

新增 1变更 4
新增
  • POST/api/agent/schedule/create— 新增 createdAt 参数，迁移存量任务时可保留源端创建时间；该参数仅覆盖任务的创建时间，不参与调度计算，不传时行为与此前一致
    定时任务
变更
  • POST/api/agent/schedule/create— 不兼容变更：响应中 triggerConfig 内的 executeTime、startTime 由 UTC 的 ISO-8601 调整为北京时间 yyyy-MM-dd HH:mm:ss，与 nextExecutionTime、createdAt 口径对齐；解析该字段时间的调用方需调整解析逻辑
    定时任务
  • GET/api/agent/schedule/list— 不兼容变更：列表每项 triggerConfig 内的 executeTime、startTime 由 UTC 的 ISO-8601 调整为北京时间 yyyy-MM-dd HH:mm:ss；解析该字段时间的调用方需调整解析逻辑
    定时任务
  • GET/api/agent/schedule/detail— 不兼容变更：嵌套的 task.triggerConfig 内的 executeTime、startTime 由 UTC 的 ISO-8601 调整为北京时间 yyyy-MM-dd HH:mm:ss；一次性任务执行完毕后 nextExecutionTime 为空，可由该字段回显原定执行时间
    定时任务
  • POST/api/agent/schedule/update— 不兼容变更：响应中 triggerConfig 内的 executeTime、startTime 由 UTC 的 ISO-8601 调整为北京时间 yyyy-MM-dd HH:mm:ss；解析该字段时间的调用方需调整解析逻辑
    定时任务

2026-09-07

变更 2
变更
  • POST/api/session/importTrace— 轨迹文件内每条消息支持可选字段messageTime（亦兼容message_time），用于还原历史真实时间线；响应新增firstMessageTime、lastMessageTime；不传时行为与旧版一致
    会话管理
  • POST/api/session/importQaPair— 新增可选参数userMessageTime、assistantMessageTime，用于还原历史真实时间线；响应新增firstMessageTime、lastMessageTime；不传时行为与旧版一致
    会话管理

2026-09-05

变更 1
变更

2026-09-04

变更 5
变更

2026-09-03

新增 5变更 8修复 7
新增
变更
  • POST/api/agent/finx/createMcpService— 完善文档：补全 mcpConfig 的字段清单、默认值、auth 鉴权配置写法与 JSON 样例，并说明保存时的连通性测试行为
    外部服务(Finx)
  • POST/api/agent/finx/createHttpService— 完善文档：补全 httpConfig（baseUrl / auth / serviceEndpoint）与 parameterSchema 的字段清单、默认值与 JSON 样例，并说明保存时不做连通性测试
    外部服务(Finx)
  • POST/api/agent/finx/execute— 完善文档：补全 command 的命令格式、--help 用法与完整调用样例
    外部服务(Finx)
  • POST/api/agent/finx/getAuthSchema— 完善文档：说明响应 fields[].key 与 saveAuthCredential 的 credentials 键名一一对应，以及各鉴权类型对应的字段命名规则
    外部服务(Finx)
  • POST/api/agent/finx/saveAuthCredential— 完善文档：补全调用流程、增量更新语义、credentials 的 key 命名规则与各鉴权类型的提交样例
    外部服务(Finx)
  • POST/api/agent/finx/createMcpService/stream— 完善文档：明确请求体与非流式的 createMcpService 完全一致，mcpConfig 参数说明以该接口为准
    外部服务(Finx)
  • POST/api/agent/finx/importMcpService/stream— 完善文档：明确请求体与非流式的 importMcpService 完全一致，mcpServers 参数说明以该接口为准
    外部服务(Finx)
  • POST/api/agent/finx/createHttpService/stream— 完善文档：明确请求体与非流式的 createHttpService 完全一致，httpConfig 参数说明以该接口为准
    外部服务(Finx)
修复
  • POST/api/agent/finx/updateMcpService— 修正文档：mcpConfig.auth 实为与原配置合并（非全量覆盖），auth 下鉴权类型的键名为 type（此前误写为 authType）；并补充脱敏值回传、customHeaderKeys / queryParamKeys 的使用说明与样例
    外部服务(Finx)
  • POST/api/agent/finx/importMcpService— 修正文档：mcpServers 下的 type 为选填（缺省按 streamable-http 尝试并在失败时自动换协议重试），此前误标为必填；并补充 headers 与鉴权类型的映射规则
    外部服务(Finx)
  • POST/api/agent/finx/updateHttpService— 修正文档：httpConfig.auth 下鉴权类型的键名为 type（此前误写为 authType），resultEventName 默认值为 tool_observation（此前误写为 ToolObservation）；并补充脱敏值回传规则与完整样例
    外部服务(Finx)
  • GET/api/agent/finx/getServiceDetail— 修正文档：serviceEndpoint.resultEventName 默认值为 tool_observation（此前误写为 ToolObservation）；并说明响应侧 authType 与请求侧 auth.type 的键名差异
    外部服务(Finx)
  • GET/api/agent/finx/getToolDetail— 修正文档：httpEndpoint.resultEventName 默认值为 tool_observation（此前误写为 ToolObservation）
    外部服务(Finx)
  • POST/api/agent/finx/createTool— 修正文档：httpEndpoint.resultEventName 默认值为 tool_observation（此前误写为 ToolObservation）；并补充 inheritAuth、端点级 auth 字段与 parameterSchema 的完整说明与样例
    外部服务(Finx)
  • POST/api/agent/finx/updateTool— 修正文档：httpEndpoint.resultEventName 默认值为 tool_observation（此前误写为 ToolObservation）；并补充说明本接口不支持配置 inheritAuth 与端点级 auth
    外部服务(Finx)

2026-09-01

变更 2
变更
  • POST/api/agent/toggleKnowledgeLibrary— 启用知识库时新增同应用空间校验：只允许启用当前应用空间下的知识库，跨应用空间（含跨租户）返回无权访问；禁用（enabled=false）不做该校验，存量跨空间绑定可随时关闭
    智能体管理与设定
  • POST/api/agent/run/async— 新增 knowledgeLibraryIds 参数，可指定本次运行使用的知识库并覆盖智能体已启用集合；不传或空数组时回落智能体已启用集合。传入的知识库必须全部属于当前应用空间，有一个越界则整个请求无权访问，最多 200 个
    智能体运行

8 月

2026-08-28

新增 1变更 15
新增
变更

2026-08-26

新增 1变更 1
新增
变更
  • GET/api/session/list— 新增可选参数 triggerSourceTypeList 支持按触发来源类型过滤
    会话管理

2026-08-25

变更 4
变更
  • GET/api/hub/agent/list— 分页查询与安装接口正式对外公开，支持通过API为应用成员安装预置专家
    行业专家
  • GET/api/hub/agent/list— 接口正式对外公开，功能与响应结构无变化
    行业专家
  • POST/api/hub/agent/apply— 分页查询与安装接口正式对外公开，支持通过API为应用成员安装预置专家
    行业专家
  • POST/api/hub/agent/apply— 接口正式对外公开；幂等键增加身份主体维度，响应收敛为核心字段；为应用成员安装时智能体归属该成员，成员登录页面后可见
    行业专家

2026-08-24

新增 15
新增

2026-08-20

变更 3
变更
  • GET/api/session/list— 新增可选参数 agentIdList 支持多智能体过滤，与 agentId 同时传入时以 agentIdList 为准
    会话管理
  • POST/api/agent/schedule/create— 新增运行时变量、能力限制、模型思考参数和输出格式配置；运行特性随任务固化，未传时保持原有行为
    定时任务
  • POST/api/agent/schedule/update— 新增运行时变量、能力限制、模型思考参数和输出格式配置；运行特性采用整组重建，运行时变量采用增量更新语义
    定时任务

2026-08-19

变更 3
变更

2026-08-14

变更 1
变更
  • POST/api/agent/finx/importMcpService— 完善 mcpServers 参数文档；mcpServers 只允许包含一个服务配置的校验前置到入参校验，多个服务时返回中文错误提示
    外部服务(Finx)

2026-08-12

新增 1
新增
  • GET/api/agent/run/messages— 新增运行问答消息查询接口，一次调用返回单次运行的用户输入与智能体最终回复文本
    智能体运行

2026-08-07

修复 1
修复

2026-08-03

变更 2
变更
  • POST/api/agent/run/async— 思维链参数支持智能体级默认档位：enableThinking 改为可空三态，不传时依次取智能体级默认档位（租户控制台配置）、系统默认 high；显式传入 true/false 仍优先生效。注意行为变化——此前不传 enableThinking 等效于 true（恒按 high 思考），现改为跟随智能体级配置
    智能体运行
  • POST/api/agent/finx/getAuthSchema— 响应新增 guidance 字段（凭证获取指引，纯文本/Markdown，空字符串表示无指引），前端可在凭证填写表单顶部渲染
    外部服务(Finx)

7 月

2026-07-30

变更 3
变更
  • POST/api/agent/run/async— 新增 environmentId 参数，支持指定沙箱环境运行；仅新建会话时生效，且环境必须归属当前租户/应用
    智能体运行
  • POST/api/session/create— 新增 environmentId 参数，支持创建会话时绑定沙箱环境，且环境必须归属当前租户/应用
    会话管理
  • GET/api/session/messages— 新增可选排序参数sortOrder，支持按时间倒序（desc）返回消息，默认asc保持原行为
    会话管理

2026-07-28

新增 2变更 1
新增
变更
  • POST/api/session/search— 搜索结果新增 requestId、userMessageId、assistantMessageId 字段，用于跳转定位代表消息
    会话管理

2026-07-24

变更 1
变更
  • GET/api/agent/run/stream— 事件流文档全量重构：补齐全部19种事件类型、11种数据体结构、AGENT_STATUS状态码表、终态与断线重连语义说明及JSON示例，并在OpenAPI组件中注册AgentEvent事件模型Schema
    智能体运行

2026-07-23

新增 15变更 1
新增
变更
  • POST/api/agent/create— 身份定义改为随创建请求一次性写入，避免创建后补写失败
    智能体管理与设定

2026-07-22

变更 3
变更
  • POST/api/agent/updateModelConfig— 模型名称校验口径与「查询可用模型列表」接口对齐，按租户作用域生效的模型供应商列表校验，列表中可见的模型均可设置
    智能体管理与设定
  • PUT/api/session/updateTitle— 标题更新成功后同步刷新搜索索引，索引同步失败时接口返回错误（可安全重试）
    会话管理
  • DELETE/api/session/delete— 删除成功后同步清除搜索索引，索引同步失败时接口返回错误（可安全重试）
    会话管理

2026-07-20

新增 1变更 5
新增
变更
  • GET/api/agent/models— 模型信息新增inputModalities输入模态字段，支持TEXT、IMAGE、VIDEO；supportVision字段已废弃但暂时保留
    智能体管理与设定
  • POST/api/agent/attachment/upload— 本地大文件改为通过Path流式上传，避免整体加载到内存；附件上传不再自动重试
    附件管理
  • POST/api/agent/run/async— 新增urlAttachments参数，支持异步运行时导入最多10个HTTPS URL附件，可与attachmentIds同时使用
    智能体运行
  • POST/api/agent/run/async— 新增 capabilityConfig 参数，支持按单次运行限制工具和 Skill 白名单、黑名单及总开关；请求配置只能收窄智能体已有能力
    智能体运行
  • GET/api/agent/run/stream— AGENT_STATUS事件新增IMPORTING_ATTACHMENTS状态码，用于提示正在导入URL附件
    智能体运行

2026-07-14

变更 3
变更

2026-07-13

修复 3
修复
  • GET/api/agent/skill/detail— 修复 PRINCIPAL 技能隔离模式下详情查询未传递当前主体ID的问题
    智能体技能
  • GET/api/agent/skill/download— 下载前增加技能归属、智能体访问权限和主体所有权校验，防止仅凭skillId越权下载
    智能体技能
  • POST/api/agent/skill/delete— 修复 PRINCIPAL 技能隔离模式下删除操作未传递当前主体ID的问题
    智能体技能

2026-07-10

变更 4修复 1
变更
修复
  • GET/api/agent/finx/listMarketServices— agentId 改为必填；enabled 始终表示当前智能体的实际启用状态，与 listServices 保持一致；市场服务列表范围不变
    外部服务(Finx)

2026-07-09

新增 2变更 2
新增
变更
  • GET/api/agent/finx/listServices— 服务摘要新增 categories（所属市场分类）和 groups（供应商分组标签）两组标签，每项含 id 和 name；仅全局/市场服务可能有值，智能体专属服务恒为空数组
    外部服务(Finx)
  • GET/api/agent/finx/listMarketServices— 新增 agentId 授权上下文参数；传入后 hasAuth 反映当前用户在该智能体下的授权状态，不传按全局计算
    外部服务(Finx)

2026-07-07

变更 1
变更
  • POST/api/agent/run/async— 新增 reasoningEffort、thinkingBudget 参数，提供更精细的推理思考控制能力。enableThinking 参数已废弃，请迁移至 reasoningEffort；不传新参数时行为不变
    智能体运行

2026-07-05

变更 1
变更
  • POST/api/agent/run/async— 新增 supportedOutputFormats 参数，调用方可声明终端渲染能力（如传入 echarts 后模型在分析型任务中会输出 echarts 代码块），不传时行为不变
    智能体运行

2026-07-04

变更 1
变更
  • GET/api/agent/run/stream— 事件流新增 TOOL_CALL_GENERATING 事件类型，实时透传工具调用参数的生成过程（早于 TOOL_START），前端按 toolCallId 拼接 arguments 增量即可逐字展示参数生成
    智能体运行

2026-07-02

新增 1变更 1
新增
变更
  • GET/api/agent/models— 支持可选传入 agentId 并返回建议预选模型 selectedModelName
    智能体管理与设定

6 月

2026-06-23

变更 6
变更

2026-06-20

新增 3变更 2
新增
变更
  • GET/api/agent/run/stream— AGENT_STATUS 事件新增 CONTEXT_COMPACTING 状态码，智能体在上下文接近容量上限时自动压缩历史，前端可展示相应提示
    智能体运行
  • POST/api/agent/skill/importFromZip— 新增可选参数 skillType，支持将技能导入为 CUSTOM（自定义技能）或 SYSTEM（系统技能），不传时默认为 CUSTOM
    智能体技能

2026-06-17

变更 2
变更

2026-06-16

变更 1
变更
  • GET/api/agent/skills— 支持可选传递 X-Principal-Id，按身份主体过滤技能数据
    智能体管理与设定

2026-06-11

变更 2
变更
  • POST/api/workbench/feed/trigger— 工作台 Feed 缓存过期策略改为每日 07:00 / 12:00 / 17:00 / 20:00（Asia/Shanghai）固定刷新
    工作台
  • GET/api/workbench/feed/poll— 工作台 Feed 缓存过期策略改为每日 07:00 / 12:00 / 17:00 / 20:00（Asia/Shanghai）固定刷新
    工作台

2026-06-10

新增 28变更 5
新增
变更

2026-06-05

新增 5变更 2
新增
变更
  • GET/api/agent/finx/listTools— 响应新增 toolId 字段（HTTP类型有值，MCP为null）和 type 字段，标识工具所属服务类型（HTTP/MCP/BUILTIN）
    外部服务(Finx)
  • GET/api/agent/finx/getToolDetail— 响应新增 toolId 字段（HTTP类型有值，MCP为null）、type 字段和 httpEndpoint 对象（仅HTTP类型工具），包含method/path/contentType/timeout/queryParams
    外部服务(Finx)

2026-06-01

新增 7变更 1
新增
变更
  • POST/api/agent/create— 创建时支持传入 agentIdentity 参数设置身份定义
    智能体管理与设定

5 月

2026-05-11

新增 21
新增

2026-05-07

新增 30
新增

2026-05-05

新增 27
新增

4 月

2026-04-29

新增 32
新增

2026-04-22

新增 98
新增