# API 变更日志

记录每次接口变更，包括新增 / 修改 / 废弃 / 移除。

## 2026-10-29

### 变更

- **智能体运行**: [`POST /api/agent/run/async`](/api/agent-run/agentRunAsync.md) — 新增请求级maxInputTokens输入预算，最小65536且不超过模型输入上限；摘要使用独立预算，重试恢复沿用，新请求不继承

### fixed

- **智能体运行**: [`POST /api/agent/run/async`](/api/agent-run/agentRunAsync.md) — 保留原JSON接口文档并补充JOSE协议、示例和错误码；不支持的Content-Type仍返回400 Media type not supported，加密会话续接提示使用英文
- **智能体运行**: [`POST /api/agent/run/addSupplementaryInput`](/api/agent-run/agentRunAddSupplementaryInput.md) — 保留原JSON接口文档并补充JOSE协议、示例和错误码；不支持的Content-Type仍返回400 Media type not supported

## 2026-10-22

### 新增

- **智能体管理与设定**: [`POST /api/agent/updateImageModel`](/api/agent/agentUpdateImageModel.md)

### 变更

- **智能体管理与设定**: [`GET /api/agent/detail`](/api/agent/agentDetail.md) — 详情响应新增图片理解模型 imageModelName

### fixed

- **智能体运行**: [`POST /api/agent/run/async`](/api/agent-run/agentRunAsync.md) — 加密请求超限返回413，不支持的Content-Encoding返回415，错误提示使用稳定英文标识；普通JSON续接已加密会话返回409
- **智能体运行**: [`POST /api/agent/run/addSupplementaryInput`](/api/agent-run/agentRunAddSupplementaryInput.md) — 加密请求超限返回413，不支持的Content-Encoding返回415，错误提示使用稳定英文标识

## 2026-10-21

### 新增

- **会话管理**: [`POST /api/session/backgroundTasks/delete`](/api/session/sessionTerminateBackgroundTask.md) — 新增后台任务停止入口，按具体执行ID停止，保留历史结果，重复停止返回现有终态

### 变更

- **智能体运行**: [`POST /api/agent/run/async`](/api/agent-run/agentRunAsync.md) — 同一接口新增application/jose（dj-jwe-v1）请求体，保留原JSON参数和响应；补充输入须与原运行传输模式一致
- **智能体运行**: [`POST /api/agent/run/addSupplementaryInput`](/api/agent-run/agentRunAddSupplementaryInput.md) — 同一接口新增application/jose（dj-jwe-v1）补充输入，必须与原运行模式一致，保留原JSON参数和响应

## 2026-10-20

### 新增

- **会话管理**: [`GET /api/session/message-parts`](/api/session/sessionListMessageParts.md) — 增加显式summary分页模式，默认完整数组及存量参数保持兼容，支持授权子会话
- **会话管理**: [`GET /api/session/message-part-detail`](/api/session/sessionGetMessagePartDetail.md) — 增加消息部件详情读取，校验当前主体及会话归属，过滤隐藏部件及内部字段

### 变更

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

## 2026-10-15

### 新增

- **会话管理**: [`GET /api/session/backgroundTasks/detail`](/api/session/sessionGetBackgroundTaskDetail.md) — 新增会话后台任务关键进展查询

### 变更

- **会话管理**: [`GET /api/session/backgroundTasks`](/api/session/sessionListBackgroundTasks.md) — 后台任务列表保留已完成、失败和取消的运行记录，支持刷新后查看执行明细
- **会话管理**: [`GET /api/session/backgroundTasks/detail`](/api/session/sessionGetBackgroundTaskDetail.md) — 执行明细默认返回最近10步，使用beforeStep游标每次加载更早10步；保留每一步的完整内容
- **会话管理**: [`GET /api/session/backgroundTasks/detail`](/api/session/sessionGetBackgroundTaskDetail.md) — 后台任务详情增加本次运行的完整思考、正文、工具调用参数与结果，保留原摘要字段

## 2026-10-14

### 新增

- **会话管理**: [`GET /api/session/backgroundTasks`](/api/session/sessionListBackgroundTasks.md) — 新增会话后台任务查询

### 变更

- **身份主体**: [`POST /api/principal/create`](/api/principal/principalCreate.md) — 创建身份主体不再自动开通存储空间，可在需要时主动开通或创建项目

## 2026-10-13

### 变更

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

## 2026-10-10

### 新增

- **会话管理**: [`POST /api/session/feedback/submit`](/api/session/sessionSubmitFeedback.md) — 新增会话反馈提交接口，支持用户对整个会话或单条消息留下文字反馈

## 2026-10-09

### 变更

- **配额管控**: [`GET /api/tokenBudget/getQuotaStatus`](/api/token-budget/tokenBudgetGetQuotaStatus.md) — 响应新增 scopeAgents，返回作用域覆盖的全部智能体；传共享作用域内任一智能体ID均可查到该共享账户；scopeAgentId、agentName 标记废弃

### fixed

- **配额管控**: [`GET /api/tokenBudget/listScopedQuotaStatus`](/api/token-budget/tokenBudgetListScopedQuotaStatus.md) — 修复一组智能体共享的作用域账户未出现在列表中的问题；每项新增 scopeAgents 返回覆盖的全部智能体

## 2026-10-08

### 变更

- **配额管控**: [`POST /api/tokenBudget/bindPolicy`](/api/token-budget/tokenBudgetBindPolicy.md) — 请求新增 scopeAgentIds 列表，支持一组智能体共享配额作用域；原 scopeAgentId 标记废弃，与 scopeAgentIds 互斥

## 2026-09-22

### 变更

- **智能体运行**: [`POST /api/agent/run/async`](/api/agent-run/agentRunAsync.md) — 新增 vaultIds 参数，隐式创建会话时校验应用空间密钥归属并绑定密钥
- **会话管理**: [`POST /api/session/create`](/api/session/sessionCreate.md) — 新增 vaultIds 参数，创建会话时校验应用空间密钥归属并绑定密钥

## 2026-09-18

### 新增

- **会话管理**: [`GET /api/session/contextUsage`](/api/session/sessionContextUsage.md) — 新增会话上下文占用查询，历史会话无快照时自动估算

### 变更

- **智能体运行**: [`GET /api/agent/run/stream`](/api/agent-run/agentRunStreamEvents.md) — SSE完成及失败事件新增可选usage，包含运行轮数和回答Token汇总
- **会话管理**: [`GET /api/session/messages`](/api/session/sessionListMessages.md) — 历史消息新增可选stepCount，提供与运行上限计数一致的轮数快照

### 移除

- **会话管理**: [`GET /api/session/messages`](/api/session/sessionListMessages.md) — 历史消息不再返回运行轮数stepCount，Token用量字段保持不变

## 2026-09-17

### 新增

- **用量观测**: [`GET /api/usage/agentRanking`](/api/usage/usageGetAgentRanking.md) — 接口上线，支持按智能体维度查看Token消耗、缓存命中率与消耗占比
- **配额管控**: [`GET /api/tokenBudget/listScopedQuotaStatus`](/api/token-budget/tokenBudgetListScopedQuotaStatus.md)
- **配额管控**: [`POST /api/tokenBudget/resetQuotaUsage`](/api/token-budget/tokenBudgetResetQuotaUsage.md) — 接口上线，支持通过API立即清零主体某配额账户的本期已用量

### 变更

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

## 2026-09-16

### 新增

- **会话调用分析**: [`GET /api/sessionAnalysis/sessionDetail`](/api/session-analysis/sessionAnalysisGetSessionDetail.md) — 开放当前主体的会话调用分析与压缩下载
- **会话调用分析**: [`GET /api/sessionAnalysis/sessionDetail`](/api/session-analysis/sessionAnalysisGetSessionDetail.md) — 新增会话执行时间线
- **会话调用分析**: [`GET /api/sessionAnalysis/messageTrace`](/api/session-analysis/sessionAnalysisGetMessageTrace.md) — 开放当前主体的会话调用分析与压缩下载
- **会话调用分析**: [`GET /api/sessionAnalysis/messageTrace`](/api/session-analysis/sessionAnalysisGetMessageTrace.md) — 新增消息执行与调用元数据
- **会话调用分析**: [`GET /api/sessionAnalysis/llmRequestDetail`](/api/session-analysis/sessionAnalysisGetLlmRequestDetail.md) — 开放当前主体的会话调用分析与压缩下载
- **会话调用分析**: [`GET /api/sessionAnalysis/llmRequestDetail`](/api/session-analysis/sessionAnalysisGetLlmRequestDetail.md) — 新增单份原始请求查看
- **会话调用分析**: [`GET /api/sessionAnalysis/downloadLlmRequests`](/api/session-analysis/sessionAnalysisDownloadLlmRequests.md) — 开放当前主体的会话调用分析与压缩下载
- **会话调用分析**: [`GET /api/sessionAnalysis/downloadLlmRequests`](/api/session-analysis/sessionAnalysisDownloadLlmRequests.md) — 新增单份或单消息压缩下载

### 变更

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

## 2026-09-14

### 新增

- **知识文档**: [`GET /api/knowledge/library/list`](/api/knowledge/knowledgeLibraryList.md) — 知识库列表新增 scope=principal，可按当前应用空间和 X-Principal-Id 查询 owner 知识库
- **项目**: [`POST /api/project/create`](/api/project/projectCreate.md) — 项目及项目会话模块上线
- **项目**: [`POST /api/project/create`](/api/project/projectCreate.md)
- **项目**: [`GET /api/project/list`](/api/project/projectList.md) — 项目及项目会话模块上线
- **项目**: [`GET /api/project/list`](/api/project/projectList.md)
- **项目**: [`GET /api/project/detail`](/api/project/projectDetail.md) — 项目及项目会话模块上线
- **项目**: [`GET /api/project/detail`](/api/project/projectDetail.md)
- **项目**: [`POST /api/project/updateName`](/api/project/projectUpdateName.md) — 项目及项目会话模块上线
- **项目**: [`POST /api/project/updateName`](/api/project/projectUpdateName.md)
- **项目**: [`DELETE /api/project/delete`](/api/project/projectDelete.md) — 项目及项目会话模块上线
- **项目**: [`DELETE /api/project/delete`](/api/project/projectDelete.md)
- **项目**: [`GET /api/project/session/list`](/api/project/projectSessionList.md) — 项目及项目会话模块上线
- **项目**: [`GET /api/project/session/list`](/api/project/projectSessionList.md)

## 2026-09-12

### 变更

- **智能体运行**: [`GET /api/agent/run/messages`](/api/agent-run/agentRunGetMessages.md) — 新增运行开始时间startedAt和结束时间completedAt，均为Unix毫秒时间戳；空时间字段省略，调用方应以status判断运行是否结束

## 2026-09-11

### 新增

- **智能体运行**: [`POST /api/agent/run/async`](/api/agent-run/agentRunAsync.md) — 新增 virtualTools 参数（客户端展示工具），模型可产出结构化渲染指令交由调用方终端渲染图表、卡片等界面元素；服务端不执行调用方代码，调用内容从既有 SSE 的 TOOL_CALL_GENERATING、TOOL_START、TOOL_COMPLETED 事件获取，渲染结果无需回传。请求级生效、不被会话与后续运行继承，单次最多16项，定义不合法时整次请求失败；不传时行为不变
- **定时任务**: [`POST /api/agent/schedule/importExecution`](/api/agent-schedule/scheduleTaskImportExecution.md) — 新增迁移历史运行记录接口，可把已迁入的历史对话登记为已有定时任务的历史执行记录，补齐迁移后任务的执行历史；接口不调用模型、不触发任务、不改变调度计划，按本地助手消息幂等

### 变更

- **智能体运行**: [`GET /api/agent/run/stream`](/api/agent-run/agentRunStreamEvents.md) — 事件流文档新增两节：一是 virtualTools 客户端展示工具的渲染指令如何从既有 TOOL_CALL_GENERATING、TOOL_START、TOOL_COMPLETED 事件消费（不新增事件类型）；二是迁移进来的历史运行（triggerSource 为 imported）没有事件流，订阅返回 409 冲突而非空流。原生运行的事件流行为不变
- **智能体运行**: [`POST /api/agent/run/suspendTask`](/api/agent-run/agentRunSuspendTask.md) — 迁移进来的历史运行（triggerSource 为 imported）不支持挂起，调用返回 409 冲突；原生运行行为不变
- **智能体运行**: [`POST /api/agent/run/resumeTask`](/api/agent-run/agentRunResumeTask.md) — 迁移进来的历史运行（triggerSource 为 imported）不支持恢复，调用返回 409 冲突；原生运行行为不变
- **智能体运行**: [`POST /api/agent/run/terminateTask`](/api/agent-run/agentRunTerminateTask.md) — 迁移进来的历史运行（triggerSource 为 imported）不支持终止，调用返回 409 冲突；原生运行行为不变
- **智能体运行**: [`POST /api/agent/run/retryTask`](/api/agent-run/agentRunRetryTask.md) — 迁移进来的历史运行（triggerSource 为 imported）不支持重试，调用返回 409 冲突；原生运行重试时沿用原请求快照中的 virtualTools 定义，无需重传
- **智能体运行**: [`POST /api/agent/run/addSupplementaryInput`](/api/agent-run/agentRunAddSupplementaryInput.md) — 迁移进来的历史运行（triggerSource 为 imported）不支持补充输入，调用返回 409 冲突；原生运行行为不变
- **智能体运行**: [`POST /api/agent/run/removeSupplementaryInput`](/api/agent-run/agentRunRemoveSupplementaryInput.md) — 迁移进来的历史运行（triggerSource 为 imported）不支持移除补充输入，调用返回 409 冲突；原生运行行为不变
- **智能体运行**: [`GET /api/agent/run/previewSupplementaryInput`](/api/agent-run/agentRunPreviewSupplementaryInput.md) — 迁移进来的历史运行（triggerSource 为 imported）不支持预览补充输入队列，调用返回 409 冲突；原生运行行为不变
- **会话管理**: [`POST /api/session/importTrace`](/api/session/sessionImportTrace.md) — 响应新增messageMappings，返回本次实际导入的每轮对话与本地消息ID（turnIndex、userMessageId、assistantMessageId）的映射，用于把导入的对话关联到定时任务历史运行；原有字段语义不变
- **会话管理**: [`POST /api/session/importQaPair`](/api/session/sessionImportQaPair.md) — 响应新增messageMappings，返回本次导入这一轮对话的本地消息ID（turnIndex、userMessageId、assistantMessageId），用于把导入的对话关联到定时任务历史运行；原有字段语义不变
- **定时任务**: [`GET /api/agent/schedule/executionHistory`](/api/agent-schedule/scheduleTaskExecutionHistory.md) — 通过「迁移历史运行记录」接口登记的历史运行也会出现在执行历史中，按其 createdAt 参与排序；这类记录只读，不支持挂起、恢复、终止、重试、补充输入和订阅事件流

## 2026-09-10

### 新增

- **项目存储空间**: [`GET /api/storageSpace/status`](/api/storage-space/storageSpaceStatus.md) — 项目存储空间状态与开通模块上线
- **项目存储空间**: [`GET /api/storageSpace/status`](/api/storage-space/storageSpaceStatus.md)
- **项目存储空间**: [`POST /api/storageSpace/ensure`](/api/storage-space/storageSpaceEnsure.md) — 项目存储空间状态与开通模块上线
- **项目存储空间**: [`POST /api/storageSpace/ensure`](/api/storage-space/storageSpaceEnsure.md)

## 2026-09-08

### 新增

- **定时任务**: [`POST /api/agent/schedule/create`](/api/agent-schedule/scheduleTaskCreate.md) — 新增 createdAt 参数，迁移存量任务时可保留源端创建时间；该参数仅覆盖任务的创建时间，不参与调度计算，不传时行为与此前一致

### 变更

- **定时任务**: [`POST /api/agent/schedule/create`](/api/agent-schedule/scheduleTaskCreate.md) — 不兼容变更：响应中 triggerConfig 内的 executeTime、startTime 由 UTC 的 ISO-8601 调整为北京时间 yyyy-MM-dd HH:mm:ss，与 nextExecutionTime、createdAt 口径对齐；解析该字段时间的调用方需调整解析逻辑
- **定时任务**: [`GET /api/agent/schedule/list`](/api/agent-schedule/scheduleTaskList.md) — 不兼容变更：列表每项 triggerConfig 内的 executeTime、startTime 由 UTC 的 ISO-8601 调整为北京时间 yyyy-MM-dd HH:mm:ss；解析该字段时间的调用方需调整解析逻辑
- **定时任务**: [`GET /api/agent/schedule/detail`](/api/agent-schedule/scheduleTaskDetail.md) — 不兼容变更：嵌套的 task.triggerConfig 内的 executeTime、startTime 由 UTC 的 ISO-8601 调整为北京时间 yyyy-MM-dd HH:mm:ss；一次性任务执行完毕后 nextExecutionTime 为空，可由该字段回显原定执行时间
- **定时任务**: [`POST /api/agent/schedule/update`](/api/agent-schedule/scheduleTaskUpdate.md) — 不兼容变更：响应中 triggerConfig 内的 executeTime、startTime 由 UTC 的 ISO-8601 调整为北京时间 yyyy-MM-dd HH:mm:ss；解析该字段时间的调用方需调整解析逻辑

## 2026-09-07

### 变更

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

## 2026-09-05

### 变更

- **免登接入(SSO)**: [`POST /api/sso/createTicket`](/api/sso/ssoCreateTicket.md) — 新增可选参数 homeUrl，用于用户登出后返回客户自有系统

## 2026-09-04

### 变更

- **配额管控**: [`GET /api/tokenBudget/listPolicies`](/api/token-budget/tokenBudgetListPolicies.md) — 策略列表改为按应用隔离，仅返回分配给当前应用的策略
- **配额管控**: [`POST /api/tokenBudget/bindPolicy`](/api/token-budget/tokenBudgetBindPolicy.md) — 新增策略归属校验，绑定未分配给当前应用的策略将返回 403
- **配额管控**: [`POST /api/tokenBudget/unbindPolicy`](/api/token-budget/tokenBudgetUnbindPolicy.md) — 新增策略归属校验，主体当前绑定的策略未分配给当前应用时返回 403
- **配额管控**: [`POST /api/tokenBudget/grantTopup`](/api/token-budget/tokenBudgetGrantTopup.md) — 新增策略归属校验，主体当前绑定的策略未分配给当前应用时返回 403
- **配额管控**: [`POST /api/tokenBudget/revokeTopup`](/api/token-budget/tokenBudgetRevokeTopup.md) — 新增策略归属校验，主体当前绑定的策略未分配给当前应用时返回 403

## 2026-09-03

### 新增

- **用量观测**: [`GET /api/usage/modelRanking`](/api/usage/usageGetModelRanking.md) — 接口上线，支持按模型维度查看Token消耗、缓存命中率与消耗占比
- **免登接入(SSO)**: [`POST /api/sso/createTicket`](/api/sso/ssoCreateTicket.md) — SSO免登模块上线
- **免登接入(SSO)**: [`POST /api/sso/createTicket`](/api/sso/ssoCreateTicket.md)
- **免登接入(SSO)**: [`GET /api/sso/login`](/api/sso/ssoLogin.md) — SSO免登模块上线
- **免登接入(SSO)**: [`GET /api/sso/login`](/api/sso/ssoLogin.md)

### 变更

- **外部服务(Finx)**: [`POST /api/agent/finx/createMcpService`](/api/agent-finx/finxCreateMcpService.md) — 完善文档：补全 mcpConfig 的字段清单、默认值、auth 鉴权配置写法与 JSON 样例，并说明保存时的连通性测试行为
- **外部服务(Finx)**: [`POST /api/agent/finx/createHttpService`](/api/agent-finx/finxCreateHttpService.md) — 完善文档：补全 httpConfig（baseUrl / auth / serviceEndpoint）与 parameterSchema 的字段清单、默认值与 JSON 样例，并说明保存时不做连通性测试
- **外部服务(Finx)**: [`POST /api/agent/finx/execute`](/api/agent-finx/finxExecute.md) — 完善文档：补全 command 的命令格式、--help 用法与完整调用样例
- **外部服务(Finx)**: [`POST /api/agent/finx/getAuthSchema`](/api/agent-finx/finxGetAuthSchema.md) — 完善文档：说明响应 fields[].key 与 saveAuthCredential 的 credentials 键名一一对应，以及各鉴权类型对应的字段命名规则
- **外部服务(Finx)**: [`POST /api/agent/finx/saveAuthCredential`](/api/agent-finx/finxSaveAuthCredential.md) — 完善文档：补全调用流程、增量更新语义、credentials 的 key 命名规则与各鉴权类型的提交样例
- **外部服务(Finx)**: [`POST /api/agent/finx/createMcpService/stream`](/api/agent-finx/finxCreateMcpServiceStream.md) — 完善文档：明确请求体与非流式的 createMcpService 完全一致，mcpConfig 参数说明以该接口为准
- **外部服务(Finx)**: [`POST /api/agent/finx/importMcpService/stream`](/api/agent-finx/finxImportMcpServiceStream.md) — 完善文档：明确请求体与非流式的 importMcpService 完全一致，mcpServers 参数说明以该接口为准
- **外部服务(Finx)**: [`POST /api/agent/finx/createHttpService/stream`](/api/agent-finx/finxCreateHttpServiceStream.md) — 完善文档：明确请求体与非流式的 createHttpService 完全一致，httpConfig 参数说明以该接口为准

### fixed

- **外部服务(Finx)**: [`POST /api/agent/finx/updateMcpService`](/api/agent-finx/finxUpdateMcpService.md) — 修正文档：mcpConfig.auth 实为与原配置合并（非全量覆盖），auth 下鉴权类型的键名为 type（此前误写为 authType）；并补充脱敏值回传、customHeaderKeys / queryParamKeys 的使用说明与样例
- **外部服务(Finx)**: [`POST /api/agent/finx/importMcpService`](/api/agent-finx/finxImportMcpService.md) — 修正文档：mcpServers 下的 type 为选填（缺省按 streamable-http 尝试并在失败时自动换协议重试），此前误标为必填；并补充 headers 与鉴权类型的映射规则
- **外部服务(Finx)**: [`POST /api/agent/finx/updateHttpService`](/api/agent-finx/finxUpdateHttpService.md) — 修正文档：httpConfig.auth 下鉴权类型的键名为 type（此前误写为 authType），resultEventName 默认值为 tool_observation（此前误写为 ToolObservation）；并补充脱敏值回传规则与完整样例
- **外部服务(Finx)**: [`GET /api/agent/finx/getServiceDetail`](/api/agent-finx/finxGetServiceDetail.md) — 修正文档：serviceEndpoint.resultEventName 默认值为 tool_observation（此前误写为 ToolObservation）；并说明响应侧 authType 与请求侧 auth.type 的键名差异
- **外部服务(Finx)**: [`GET /api/agent/finx/getToolDetail`](/api/agent-finx/finxGetToolDetail.md) — 修正文档：httpEndpoint.resultEventName 默认值为 tool_observation（此前误写为 ToolObservation）
- **外部服务(Finx)**: [`POST /api/agent/finx/createTool`](/api/agent-finx/finxCreateTool.md) — 修正文档：httpEndpoint.resultEventName 默认值为 tool_observation（此前误写为 ToolObservation）；并补充 inheritAuth、端点级 auth 字段与 parameterSchema 的完整说明与样例
- **外部服务(Finx)**: [`POST /api/agent/finx/updateTool`](/api/agent-finx/finxUpdateTool.md) — 修正文档：httpEndpoint.resultEventName 默认值为 tool_observation（此前误写为 ToolObservation）；并补充说明本接口不支持配置 inheritAuth 与端点级 auth

## 2026-09-01

### 变更

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

## 2026-08-28

### 新增

- **定时任务**: [`POST /api/agent/schedule/batchUpdateStatusByTaskIds`](/api/agent-schedule/scheduleTaskBatchUpdateStatusByTaskIds.md) — 新增按多个任务ID批量启用或暂停定时任务的接口；共用响应体新增 notFoundTaskIds 字段，按智能体批量更新时该字段恒为空数组

### 变更

- **附件管理**: [`GET /api/agent/attachment/getByMessage`](/api/agent-attachment/agentAttachmentGetByMessage.md) — 返回的附件信息新增 pureFileName 字段，为剥离目录后的纯文件名；fileName 行为不变，展示文件名建议改用 pureFileName
- **知识文档**: [`GET /api/knowledge/library/list`](/api/knowledge/knowledgeLibraryList.md) — app 模式下返回范围由 X-Principal-Id 名下放宽到整个应用空间（X-App-Id）；新增可选入参 creatorType 供收窄；响应新增 creatorType/creatorId/appId；keyword 改为匹配创建时登记的知识库名称，内核改名后需等同步
- **知识文档**: [`POST /api/knowledge/library/rebuild`](/api/knowledge/knowledgeLibraryRebuild.md) — 可操作范围由 X-Principal-Id 名下放宽到整个应用空间（X-App-Id）
- **知识文档**: [`POST /api/knowledge/library/delete`](/api/knowledge/knowledgeLibraryDelete.md) — 可操作范围由 X-Principal-Id 名下放宽到整个应用空间（X-App-Id）；in-use 提示的 agents 新增 appId/appName/crossAppSpace 字段，跨应用空间的引用会被标注
- **知识文档**: [`GET /api/knowledge/document/list`](/api/knowledge/knowledgeDocumentList.md) — 可操作范围由 X-Principal-Id 名下放宽到整个应用空间（X-App-Id）
- **知识文档**: [`GET /api/knowledge/document/tree`](/api/knowledge/knowledgeDocumentGetTree.md) — 可操作范围由 X-Principal-Id 名下放宽到整个应用空间（X-App-Id）；补齐归属校验，修复此前任意 documentId 可读的越权问题
- **知识文档**: [`GET /api/knowledge/document/nodeContent`](/api/knowledge/knowledgeDocumentNodeContent.md) — 可操作范围由 X-Principal-Id 名下放宽到整个应用空间（X-App-Id）
- **知识文档**: [`GET /api/knowledge/document/download`](/api/knowledge/knowledgeDocumentDownload.md) — 可操作范围由 X-Principal-Id 名下放宽到整个应用空间（X-App-Id）
- **知识文档**: [`POST /api/knowledge/document/upload`](/api/knowledge/knowledgeDocumentUpload.md) — 可操作范围由 X-Principal-Id 名下放宽到整个应用空间（X-App-Id）
- **知识文档**: [`POST /api/knowledge/document/import`](/api/knowledge/knowledgeDocumentImport.md) — 可操作范围由 X-Principal-Id 名下放宽到整个应用空间（X-App-Id）
- **知识文档**: [`POST /api/knowledge/document/importTable`](/api/knowledge/knowledgeDocumentImportTable.md) — 可操作范围由 X-Principal-Id 名下放宽到整个应用空间（X-App-Id）
- **知识文档**: [`POST /api/knowledge/document/rebuild`](/api/knowledge/knowledgeDocumentRebuild.md) — 可操作范围由 X-Principal-Id 名下放宽到整个应用空间（X-App-Id）
- **知识文档**: [`POST /api/knowledge/document/delete`](/api/knowledge/knowledgeDocumentDelete.md) — 可操作范围由 X-Principal-Id 名下放宽到整个应用空间（X-App-Id）
- **知识文档**: [`POST /api/knowledge/library/update`](/api/knowledge/knowledgeLibraryUpdate.md) — 可操作范围由 X-Principal-Id 名下放宽到整个应用空间（X-App-Id）
- **会话管理**: [`GET /api/session/messages`](/api/session/sessionListMessages.md) — 返回消息的 attachments 新增 pureFileName 字段，为剥离目录后的纯文件名；fileName 行为不变，展示文件名建议改用 pureFileName

## 2026-08-27

### 变更

- **配额管控**: [`GET /api/tokenBudget/getQuotaStatus`](/api/token-budget/tokenBudgetGetQuotaStatus.md) — 新增 limited 字段，供用户控制台判断当前登录用户是否需要展示Token额度

## 2026-08-26

### 新增

- **配额管控**: [`GET /api/tokenBudget/listPolicies`](/api/token-budget/tokenBudgetListPolicies.md) — 接口上线，支持调用方在绑定策略前查询可用的配额策略及 policyId

### 变更

- **会话管理**: [`GET /api/session/list`](/api/session/sessionList.md) — 新增可选参数 triggerSourceTypeList 支持按触发来源类型过滤

## 2026-08-25

### 变更

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

## 2026-08-24

### 新增

- **配额管控**: [`GET /api/tokenBudget/getQuotaStatus`](/api/token-budget/tokenBudgetGetQuotaStatus.md) — 配额管控模块上线
- **配额管控**: [`GET /api/tokenBudget/getQuotaStatus`](/api/token-budget/tokenBudgetGetQuotaStatus.md)
- **配额管控**: [`GET /api/tokenBudget/listScopedQuotaStatus`](/api/token-budget/tokenBudgetListScopedQuotaStatus.md) — 配额管控模块上线
- **配额管控**: [`GET /api/tokenBudget/listTopups`](/api/token-budget/tokenBudgetListTopups.md) — 配额管控模块上线
- **配额管控**: [`GET /api/tokenBudget/listTopups`](/api/token-budget/tokenBudgetListTopups.md)
- **配额管控**: [`GET /api/tokenBudget/listPolicies`](/api/token-budget/tokenBudgetListPolicies.md) — 配额管控模块上线
- **配额管控**: [`POST /api/tokenBudget/bindPolicy`](/api/token-budget/tokenBudgetBindPolicy.md) — 配额管控模块上线
- **配额管控**: [`POST /api/tokenBudget/bindPolicy`](/api/token-budget/tokenBudgetBindPolicy.md)
- **配额管控**: [`POST /api/tokenBudget/unbindPolicy`](/api/token-budget/tokenBudgetUnbindPolicy.md) — 配额管控模块上线
- **配额管控**: [`POST /api/tokenBudget/unbindPolicy`](/api/token-budget/tokenBudgetUnbindPolicy.md)
- **配额管控**: [`POST /api/tokenBudget/grantTopup`](/api/token-budget/tokenBudgetGrantTopup.md) — 配额管控模块上线
- **配额管控**: [`POST /api/tokenBudget/grantTopup`](/api/token-budget/tokenBudgetGrantTopup.md)
- **配额管控**: [`POST /api/tokenBudget/revokeTopup`](/api/token-budget/tokenBudgetRevokeTopup.md) — 配额管控模块上线
- **配额管控**: [`POST /api/tokenBudget/revokeTopup`](/api/token-budget/tokenBudgetRevokeTopup.md)
- **配额管控**: [`POST /api/tokenBudget/resetQuotaUsage`](/api/token-budget/tokenBudgetResetQuotaUsage.md) — 配额管控模块上线

## 2026-08-21

### 新增

- **定时任务**: [`POST /api/agent/schedule/batchUpdateStatusByAgentIds`](/api/agent-schedule/scheduleTaskBatchUpdateStatusByAgentIds.md) — 新增按多个智能体批量启用或暂停定时任务的接口

### 变更

- **智能体运行**: [`POST /api/agent/run/async`](/api/agent-run/agentRunAsync.md) — thinkingBudget最小有效预算由1024调整为1；低于1时由内核修正为1，精确预算仍表示开启思考并限制长度
- **应用成员**: [`GET /api/member/list`](/api/member/memberList.md) — 接口正式对外公开，功能与响应结构无变化

## 2026-08-20

### 变更

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

## 2026-08-19

### 变更

- **智能体管理与设定**: [`GET /api/agent/detail`](/api/agent/agentDetail.md) — 详情响应新增向用户提问能力开关
- **智能体管理与设定**: [`POST /api/agent/updateFeatureSettings`](/api/agent/agentUpdateFeatureSettings.md) — 新增向用户提问能力开关
- **智能体运行**: [`POST /api/agent/run/async`](/api/agent-run/agentRunAsync.md) — capabilityConfig新增Finx服务白名单和黑名单。非空白名单采用白名单模式且优先于黑名单；空集合或不传时沿用智能体配置

## 2026-08-18

### 新增

- **用户问题交互**: [`GET /api/humanQuestions/pending`](/api/human-questions/humanQuestionListPending.md) — 用户问题交互模块上线
- **用户问题交互**: [`GET /api/humanQuestions/pending`](/api/human-questions/humanQuestionListPending.md)
- **用户问题交互**: [`POST /api/humanQuestions/resolve`](/api/human-questions/humanQuestionResolve.md) — 用户问题交互模块上线
- **用户问题交互**: [`POST /api/humanQuestions/resolve`](/api/human-questions/humanQuestionResolve.md)
- **用户问题交互**: [`POST /api/humanQuestions/cancel`](/api/human-questions/humanQuestionCancel.md) — 用户问题交互模块上线
- **用户问题交互**: [`POST /api/humanQuestions/cancel`](/api/human-questions/humanQuestionCancel.md)

## 2026-08-14

### 变更

- **外部服务(Finx)**: [`POST /api/agent/finx/importMcpService`](/api/agent-finx/finxImportMcpService.md) — 完善 mcpServers 参数文档；mcpServers 只允许包含一个服务配置的校验前置到入参校验，多个服务时返回中文错误提示

## 2026-08-12

### 新增

- **智能体运行**: [`GET /api/agent/run/messages`](/api/agent-run/agentRunGetMessages.md) — 新增运行问答消息查询接口，一次调用返回单次运行的用户输入与智能体最终回复文本

## 2026-08-11

### 新增

- **知识文档**: [`GET /api/knowledge/document/nodeContent`](/api/knowledge/knowledgeDocumentNodeContent.md) — 新增获取文档节点原文接口

### fixed

- **会话管理**: [`POST /api/session/search`](/api/session/sessionSearch.md) — 修复应用模式下缺失 X-Principal-Id 请求头时返回500的问题，现返回400并提示补充请求头

## 2026-08-08

### 新增

- **用量观测**: [`GET /api/usage/summary`](/api/usage/usageGetSummary.md) — 用量观测模块上线
- **用量观测**: [`GET /api/usage/summary`](/api/usage/usageGetSummary.md)
- **用量观测**: [`GET /api/usage/modelRanking`](/api/usage/usageGetModelRanking.md) — 用量观测模块上线
- **用量观测**: [`GET /api/usage/agentRanking`](/api/usage/usageGetAgentRanking.md) — 用量观测模块上线

## 2026-08-07

### fixed

- **工作台**: [`POST /api/workbench/feed/trigger`](/api/workbench/workbenchTriggerFeed.md) — 修复生成任务未携带租户作用域配置导致模型服务配置加载错误的问题

## 2026-08-03

### 变更

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

## 2026-07-30

### 变更

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

## 2026-07-28

### 新增

- **应用成员**: [`GET /api/member/list`](/api/member/memberList.md) — 应用成员管理模块上线
- **应用成员**: [`GET /api/member/list`](/api/member/memberList.md)

### 变更

- **会话管理**: [`POST /api/session/search`](/api/session/sessionSearch.md) — 搜索结果新增 requestId、userMessageId、assistantMessageId 字段，用于跳转定位代表消息

## 2026-07-27

### 新增

- **会话管理**: [`POST /api/session/importTrace`](/api/session/sessionImportTrace.md) — 新增完整OpenAI messages轨迹文件导入能力
- **会话管理**: [`POST /api/session/importQaPair`](/api/session/sessionImportQaPair.md) — 新增简单一问一答历史会话导入能力

## 2026-07-24

### 变更

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

## 2026-07-23

### 新增

- **智能体管理与设定**: [`PUT /api/agent/updateDefinition`](/api/agent/agentUpdateDefinition.md) — 新增仅更新智能体名称和描述的基本定义接口
- **智能体管理与设定**: [`GET /api/agent/deleteCheck`](/api/agent/agentDeleteCheck.md) — 新增智能体删除前检查接口
- **智能体管理与设定**: [`DELETE /api/agent/delete`](/api/agent/agentDelete.md) — 新增智能体标准软删除接口
- **入驻千问(Qwen Onboarding)**: [`POST /api/qwen-onboarding/update`](/api/qwen-onboarding/qwenOnboardingUpdate.md) — 千问入驻配置管理模块上线
- **入驻千问(Qwen Onboarding)**: [`POST /api/qwen-onboarding/update`](/api/qwen-onboarding/qwenOnboardingUpdate.md)
- **入驻千问(Qwen Onboarding)**: [`POST /api/qwen-onboarding/delete`](/api/qwen-onboarding/qwenOnboardingDelete.md) — 千问入驻配置管理模块上线
- **入驻千问(Qwen Onboarding)**: [`POST /api/qwen-onboarding/delete`](/api/qwen-onboarding/qwenOnboardingDelete.md)
- **入驻千问(Qwen Onboarding)**: [`POST /api/qwen-onboarding/brand/update`](/api/qwen-onboarding/qwenOnboardingBrandUpdate.md) — 千问入驻配置管理模块上线
- **入驻千问(Qwen Onboarding)**: [`POST /api/qwen-onboarding/brand/update`](/api/qwen-onboarding/qwenOnboardingBrandUpdate.md)
- **入驻千问(Qwen Onboarding)**: [`POST /api/qwen-onboarding/bind`](/api/qwen-onboarding/qwenOnboardingBind.md) — 千问入驻配置管理模块上线
- **入驻千问(Qwen Onboarding)**: [`POST /api/qwen-onboarding/bind`](/api/qwen-onboarding/qwenOnboardingBind.md)
- **入驻千问(Qwen Onboarding)**: [`GET /api/qwen-onboarding/list`](/api/qwen-onboarding/qwenOnboardingList.md) — 千问入驻配置管理模块上线
- **入驻千问(Qwen Onboarding)**: [`GET /api/qwen-onboarding/list`](/api/qwen-onboarding/qwenOnboardingList.md)
- **入驻千问(Qwen Onboarding)**: [`GET /api/qwen-onboarding/agent-card/preview`](/api/qwen-onboarding/qwenOnboardingAgentCardPreview.md) — 千问入驻配置管理模块上线
- **入驻千问(Qwen Onboarding)**: [`GET /api/qwen-onboarding/agent-card/preview`](/api/qwen-onboarding/qwenOnboardingAgentCardPreview.md)

### 变更

- **智能体管理与设定**: [`POST /api/agent/create`](/api/agent/agentCreate.md) — 身份定义改为随创建请求一次性写入，避免创建后补写失败

## 2026-07-22

### 变更

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

## 2026-07-20

### 新增

- **附件管理**: [`POST /api/agent/attachment/uploadByUrl`](/api/agent-attachment/agentAttachmentUploadByUrl.md) — 新增HTTPS URL附件导入能力，支持通过bizKey或sessionId关联会话

### 变更

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

## 2026-07-14

### 变更

- **智能体管理与设定**: [`GET /api/agent/detail`](/api/agent/agentDetail.md) — 详情响应新增联网搜索和网页读取能力开关
- **智能体管理与设定**: [`POST /api/agent/updateFeatureSettings`](/api/agent/agentUpdateFeatureSettings.md) — 新增联网搜索和网页读取能力开关
- **行业专家**: [`GET /api/hub/agent/list`](/api/hub-agent/agentHubList.md) — 按registryType拆分官方推荐和我的市场，仅返回所选市场中的已发布专家，并返回该市场可用标签

## 2026-07-13

### fixed

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

## 2026-07-10

### 变更

- **智能体技能**: [`POST /api/agent/skill/installFromHub`](/api/agent-skill/agentSkillInstallFromHub.md) — 安装切换为共享业务目录并增加requestId幂等控制
- **行业专家**: [`GET /api/hub/agent/list`](/api/hub-agent/agentHubList.md) — 智能体市场切换为共享业务目录，同时支持官方资产与当前应用自定义资产
- **行业专家**: [`POST /api/hub/agent/apply`](/api/hub-agent/agentHubApply.md) — 智能体市场切换为共享业务目录，同时支持官方资产与当前应用自定义资产
- **行业专家**: [`POST /api/hub/agent/apply`](/api/hub-agent/agentHubApply.md) — 安装切换为共享业务目录并增加requestId幂等控制

### fixed

- **外部服务(Finx)**: [`GET /api/agent/finx/listMarketServices`](/api/agent-finx/finxListMarketServices.md) — agentId 改为必填；enabled 始终表示当前智能体的实际启用状态，与 listServices 保持一致；市场服务列表范围不变

## 2026-07-09

### 新增

- **外部服务(Finx)**: [`GET /api/agent/finx/listMarketServices`](/api/agent-finx/finxListMarketServices.md)
- **外部服务(Finx)**: [`GET /api/agent/finx/listCategories`](/api/agent-finx/finxListCategories.md)

### 变更

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

## 2026-07-08

### 新增

- **身份主体**: [`POST /api/principal/update`](/api/principal/principalUpdate.md) — 新增修改身份主体名称和描述接口

## 2026-07-07

### 变更

- **智能体运行**: [`POST /api/agent/run/async`](/api/agent-run/agentRunAsync.md) — 新增 reasoningEffort、thinkingBudget 参数，提供更精细的推理思考控制能力。enableThinking 参数已废弃，请迁移至 reasoningEffort；不传新参数时行为不变

## 2026-07-05

### 变更

- **智能体运行**: [`POST /api/agent/run/async`](/api/agent-run/agentRunAsync.md) — 新增 supportedOutputFormats 参数，调用方可声明终端渲染能力（如传入 echarts 后模型在分析型任务中会输出 echarts 代码块），不传时行为不变

## 2026-07-04

### 变更

- **智能体运行**: [`GET /api/agent/run/stream`](/api/agent-run/agentRunStreamEvents.md) — 事件流新增 TOOL_CALL_GENERATING 事件类型，实时透传工具调用参数的生成过程（早于 TOOL_START），前端按 toolCallId 拼接 arguments 增量即可逐字展示参数生成

## 2026-07-02

### 新增

- **智能体管理与设定**: [`GET /api/agent/models`](/api/agent/agentListModels.md)

### 变更

- **智能体管理与设定**: [`GET /api/agent/models`](/api/agent/agentListModels.md) — 支持可选传入 agentId 并返回建议预选模型 selectedModelName

## 2026-06-26

### 变更

- **附件管理**: [`GET /api/agent/attachment/download`](/api/agent-attachment/agentAttachmentDownload.md) — 明确 principalId 为必传参数，调用方需在请求头中传递 X-Principal-Id

## 2026-06-23

### 变更

- **智能体运行**: [`POST /api/agent/run/async`](/api/agent-run/agentRunAsync.md) — 新增 runtimeVariables 运行时变量参数，调用方可传入键值对供智能体技能和工具在运行期间读取
- **外部服务(Finx)**: [`POST /api/agent/finx/updateHttpService`](/api/agent-finx/finxUpdateHttpService.md) — httpConfig.serviceEndpoint 新增 streaming 和 resultEventName 可选配置项
- **外部服务(Finx)**: [`GET /api/agent/finx/getServiceDetail`](/api/agent-finx/finxGetServiceDetail.md) — HTTP服务详情的 serviceEndpoint 新增 streaming 和 resultEventName 字段
- **外部服务(Finx)**: [`GET /api/agent/finx/getToolDetail`](/api/agent-finx/finxGetToolDetail.md) — httpEndpoint 响应新增 streaming 和 resultEventName 字段，支持 SSE 流式工具配置
- **外部服务(Finx)**: [`POST /api/agent/finx/createTool`](/api/agent-finx/finxCreateTool.md) — httpEndpoint 新增 streaming 和 resultEventName 可选配置项
- **外部服务(Finx)**: [`POST /api/agent/finx/updateTool`](/api/agent-finx/finxUpdateTool.md) — httpEndpoint 新增 streaming 和 resultEventName 可选配置项

## 2026-06-21

### 新增

- **智能体管理与设定**: [`POST /api/agent/toggleKnowledgeLibrary`](/api/agent/agentToggleKnowledgeLibrary.md) — 接口上线，从「智能体知识库关联」分组迁移至此

## 2026-06-20

### 新增

- **智能体技能**: [`POST /api/agent/skill/changeType`](/api/agent-skill/agentSkillChangeType.md) — 新增技能类型变更接口，支持将自定义技能（CUSTOM）转换为系统技能（SYSTEM），或反向转换。内置系统技能不可转换；转为 SYSTEM 时若与内置技能同名会被拒绝
- **定时任务**: [`POST /api/agent/schedule/upsertTaskPolicy`](/api/agent-schedule/scheduleTaskUpsertTaskPolicy.md) — 新增定时任务执行策略配置接口
- **定时任务**: [`GET /api/agent/schedule/getTaskPolicy`](/api/agent-schedule/scheduleTaskGetTaskPolicy.md) — 新增定时任务执行策略查询接口

### 变更

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

## 2026-06-17

### 变更

- **智能体技能**: [`POST /api/agent/skill/toggleEnabled`](/api/agent-skill/agentSkillToggleEnabled.md) — 支持 PRINCIPAL 技能隔离模式，通过当前身份自动定位用户自定义技能进行启停
- **定时任务**: [`GET /api/agent/schedule/executionHistory`](/api/agent-schedule/scheduleTaskExecutionHistory.md) — taskId 由必传改为可选，不传时查询该用户所有定时任务的执行记录；返回记录新增 taskId、taskName、sessionId 字段

## 2026-06-16

### 变更

- **智能体管理与设定**: [`GET /api/agent/skills`](/api/agent/agentListSkills.md) — 支持可选传递 X-Principal-Id，按身份主体过滤技能数据

## 2026-06-15

### 新增

- **知识文档**: [`POST /api/knowledge/library/update`](/api/knowledge/knowledgeLibraryUpdate.md)
- **会话管理**: [`GET /api/session/trajectory`](/api/session/sessionGetTrajectory.md) — 新增会话轨迹查询接口，支持 pruned / includeLastResponse 控制裁切语义

## 2026-06-11

### 变更

- **工作台**: [`POST /api/workbench/feed/trigger`](/api/workbench/workbenchTriggerFeed.md) — 工作台 Feed 缓存过期策略改为每日 07:00 / 12:00 / 17:00 / 20:00（Asia/Shanghai）固定刷新
- **工作台**: [`GET /api/workbench/feed/poll`](/api/workbench/workbenchPollFeed.md) — 工作台 Feed 缓存过期策略改为每日 07:00 / 12:00 / 17:00 / 20:00（Asia/Shanghai）固定刷新

## 2026-06-10

### 新增

- **知识文档**: [`GET /api/knowledge/library/list`](/api/knowledge/knowledgeLibraryList.md) — 知识文档模块上线
- **知识文档**: [`GET /api/knowledge/library/list`](/api/knowledge/knowledgeLibraryList.md)
- **知识文档**: [`POST /api/knowledge/library/create`](/api/knowledge/knowledgeLibraryCreate.md) — 知识文档模块上线
- **知识文档**: [`POST /api/knowledge/library/create`](/api/knowledge/knowledgeLibraryCreate.md)
- **知识文档**: [`POST /api/knowledge/library/rebuild`](/api/knowledge/knowledgeLibraryRebuild.md) — 知识文档模块上线
- **知识文档**: [`POST /api/knowledge/library/rebuild`](/api/knowledge/knowledgeLibraryRebuild.md)
- **知识文档**: [`POST /api/knowledge/library/delete`](/api/knowledge/knowledgeLibraryDelete.md) — 知识文档模块上线
- **知识文档**: [`POST /api/knowledge/library/delete`](/api/knowledge/knowledgeLibraryDelete.md)
- **知识文档**: [`GET /api/knowledge/document/list`](/api/knowledge/knowledgeDocumentList.md) — 知识文档模块上线
- **知识文档**: [`GET /api/knowledge/document/list`](/api/knowledge/knowledgeDocumentList.md)
- **知识文档**: [`GET /api/knowledge/document/tree`](/api/knowledge/knowledgeDocumentGetTree.md) — 知识文档模块上线
- **知识文档**: [`GET /api/knowledge/document/tree`](/api/knowledge/knowledgeDocumentGetTree.md)
- **知识文档**: [`GET /api/knowledge/document/nodeContent`](/api/knowledge/knowledgeDocumentNodeContent.md) — 知识文档模块上线
- **知识文档**: [`GET /api/knowledge/document/download`](/api/knowledge/knowledgeDocumentDownload.md) — 知识文档模块上线
- **知识文档**: [`GET /api/knowledge/document/download`](/api/knowledge/knowledgeDocumentDownload.md)
- **知识文档**: [`POST /api/knowledge/document/upload`](/api/knowledge/knowledgeDocumentUpload.md) — 知识文档模块上线
- **知识文档**: [`POST /api/knowledge/document/upload`](/api/knowledge/knowledgeDocumentUpload.md)
- **知识文档**: [`POST /api/knowledge/document/parseTableStructure`](/api/knowledge/knowledgeDocumentParseTableStructure.md) — 知识文档模块上线
- **知识文档**: [`POST /api/knowledge/document/parseTableStructure`](/api/knowledge/knowledgeDocumentParseTableStructure.md)
- **知识文档**: [`POST /api/knowledge/document/import`](/api/knowledge/knowledgeDocumentImport.md) — 知识文档模块上线
- **知识文档**: [`POST /api/knowledge/document/import`](/api/knowledge/knowledgeDocumentImport.md)
- **知识文档**: [`POST /api/knowledge/document/importTable`](/api/knowledge/knowledgeDocumentImportTable.md) — 知识文档模块上线
- **知识文档**: [`POST /api/knowledge/document/importTable`](/api/knowledge/knowledgeDocumentImportTable.md)
- **知识文档**: [`POST /api/knowledge/document/rebuild`](/api/knowledge/knowledgeDocumentRebuild.md) — 知识文档模块上线
- **知识文档**: [`POST /api/knowledge/document/rebuild`](/api/knowledge/knowledgeDocumentRebuild.md)
- **知识文档**: [`POST /api/knowledge/document/delete`](/api/knowledge/knowledgeDocumentDelete.md) — 知识文档模块上线
- **知识文档**: [`POST /api/knowledge/document/delete`](/api/knowledge/knowledgeDocumentDelete.md)
- **知识文档**: [`POST /api/knowledge/library/update`](/api/knowledge/knowledgeLibraryUpdate.md) — 知识文档模块上线

### 变更

- **智能体运行**: [`GET /api/agent/run/stream`](/api/agent-run/agentRunStreamEvents.md) — 事件流新增 AGENT_STATUS 事件类型，承载运行期瞬时状态信号（LLM限流/网络重试等），不再混入 TEXT_DELTA
- **智能体运行**: [`GET /api/agent/run/stream`](/api/agent-run/agentRunStreamEvents.md) — 稳定性和安全性提升。
- **智能体运行**: [`POST /api/agent/run/addSupplementaryInput`](/api/agent-run/agentRunAddSupplementaryInput.md) — 稳定性和安全性提升。
- **智能体运行**: [`POST /api/agent/run/removeSupplementaryInput`](/api/agent-run/agentRunRemoveSupplementaryInput.md) — 稳定性和安全性提升。
- **智能体运行**: [`GET /api/agent/run/previewSupplementaryInput`](/api/agent-run/agentRunPreviewSupplementaryInput.md) — 稳定性和安全性提升。

## 2026-06-05

### 新增

- **外部服务(Finx)**: [`POST /api/agent/finx/updateMcpService`](/api/agent-finx/finxUpdateMcpService.md)
- **外部服务(Finx)**: [`POST /api/agent/finx/updateHttpService`](/api/agent-finx/finxUpdateHttpService.md)
- **外部服务(Finx)**: [`GET /api/agent/finx/getServiceDetail`](/api/agent-finx/finxGetServiceDetail.md)
- **外部服务(Finx)**: [`POST /api/agent/finx/updateTool`](/api/agent-finx/finxUpdateTool.md)
- **外部服务(Finx)**: [`POST /api/agent/finx/deleteTool`](/api/agent-finx/finxDeleteTool.md)

### 变更

- **外部服务(Finx)**: [`GET /api/agent/finx/listTools`](/api/agent-finx/finxListTools.md) — 响应新增 toolId 字段（HTTP类型有值，MCP为null）和 type 字段，标识工具所属服务类型（HTTP/MCP/BUILTIN）
- **外部服务(Finx)**: [`GET /api/agent/finx/getToolDetail`](/api/agent-finx/finxGetToolDetail.md) — 响应新增 toolId 字段（HTTP类型有值，MCP为null）、type 字段和 httpEndpoint 对象（仅HTTP类型工具），包含method/path/contentType/timeout/queryParams

## 2026-06-02

### 新增

- **会话管理**: [`POST /api/session/fork`](/api/session/sessionFork.md)

### 变更

- **会话管理**: [`GET /api/session/list`](/api/session/sessionList.md) — 新增状态过滤参数 statusFilter

## 2026-06-01

### 新增

- **智能体管理与设定**: [`POST /api/agent/updateIdentity`](/api/agent/agentUpdateIdentity.md)
- **身份定义版本**: [`GET /api/agent/identity/versions`](/api/agent-identity/agentIdentityListVersions.md) — 智能体身份定义版本管理模块上线
- **身份定义版本**: [`GET /api/agent/identity/versions`](/api/agent-identity/agentIdentityListVersions.md)
- **身份定义版本**: [`GET /api/agent/identity/versionDetail`](/api/agent-identity/agentIdentityGetVersionDetail.md) — 智能体身份定义版本管理模块上线
- **身份定义版本**: [`GET /api/agent/identity/versionDetail`](/api/agent-identity/agentIdentityGetVersionDetail.md)
- **身份定义版本**: [`POST /api/agent/identity/restoreVersion`](/api/agent-identity/agentIdentityRestoreVersion.md) — 智能体身份定义版本管理模块上线
- **身份定义版本**: [`POST /api/agent/identity/restoreVersion`](/api/agent-identity/agentIdentityRestoreVersion.md)

### 变更

- **智能体管理与设定**: [`POST /api/agent/create`](/api/agent/agentCreate.md) — 创建时支持传入 agentIdentity 参数设置身份定义

## 2026-05-29

### 新增

- **附件管理**: [`GET /api/agent/attachment/getBySession`](/api/agent-attachment/agentAttachmentGetBySession.md)

## 2026-05-22

### 新增

- **外部服务(Finx)**: [`GET /api/agent/finx/listTools`](/api/agent-finx/finxListTools.md)
- **外部服务(Finx)**: [`GET /api/agent/finx/getToolDetail`](/api/agent-finx/finxGetToolDetail.md)

## 2026-05-18

### 新增

- **智能体管理与设定**: [`POST /api/agent/updateModelConfig`](/api/agent/agentUpdateModelConfig.md)

## 2026-05-14

### 新增

- **会话管理**: [`POST /api/session/create`](/api/session/sessionCreate.md)
- **会话管理**: [`PUT /api/session/updateTitle`](/api/session/sessionUpdateTitle.md)

## 2026-05-13

### 变更

- **智能体运行**: [`POST /api/agent/run/async`](/api/agent-run/agentRunAsync.md) — 新增 visible 可见性控制参数

## 2026-05-12

### 新增

- **会话管理**: [`DELETE /api/session/delete`](/api/session/sessionDelete.md)
- **定时任务**: [`POST /api/agent/schedule/update`](/api/agent-schedule/scheduleTaskUpdate.md)
- **定时任务**: [`POST /api/agent/schedule/delete`](/api/agent-schedule/scheduleTaskDelete.md)

### 变更

- **会话管理**: [`GET /api/session/detail`](/api/session/sessionGetDetail.md) — 新增 bizKey 查询方式，与 sessionId 二选一

## 2026-05-11

### 新增

- **定时任务**: [`POST /api/agent/schedule/create`](/api/agent-schedule/scheduleTaskCreate.md) — 定时任务管理模块上线
- **定时任务**: [`POST /api/agent/schedule/create`](/api/agent-schedule/scheduleTaskCreate.md)
- **定时任务**: [`GET /api/agent/schedule/list`](/api/agent-schedule/scheduleTaskList.md) — 定时任务管理模块上线
- **定时任务**: [`GET /api/agent/schedule/list`](/api/agent-schedule/scheduleTaskList.md)
- **定时任务**: [`GET /api/agent/schedule/detail`](/api/agent-schedule/scheduleTaskDetail.md) — 定时任务管理模块上线
- **定时任务**: [`GET /api/agent/schedule/detail`](/api/agent-schedule/scheduleTaskDetail.md)
- **定时任务**: [`POST /api/agent/schedule/update`](/api/agent-schedule/scheduleTaskUpdate.md) — 定时任务管理模块上线
- **定时任务**: [`POST /api/agent/schedule/disable`](/api/agent-schedule/scheduleTaskDisable.md) — 定时任务管理模块上线
- **定时任务**: [`POST /api/agent/schedule/disable`](/api/agent-schedule/scheduleTaskDisable.md)
- **定时任务**: [`POST /api/agent/schedule/enable`](/api/agent-schedule/scheduleTaskEnable.md) — 定时任务管理模块上线
- **定时任务**: [`POST /api/agent/schedule/enable`](/api/agent-schedule/scheduleTaskEnable.md)
- **定时任务**: [`POST /api/agent/schedule/batchUpdateStatusByAgentIds`](/api/agent-schedule/scheduleTaskBatchUpdateStatusByAgentIds.md) — 定时任务管理模块上线
- **定时任务**: [`POST /api/agent/schedule/batchUpdateStatusByTaskIds`](/api/agent-schedule/scheduleTaskBatchUpdateStatusByTaskIds.md) — 定时任务管理模块上线
- **定时任务**: [`POST /api/agent/schedule/triggerNow`](/api/agent-schedule/scheduleTaskTriggerNow.md) — 定时任务管理模块上线
- **定时任务**: [`POST /api/agent/schedule/triggerNow`](/api/agent-schedule/scheduleTaskTriggerNow.md)
- **定时任务**: [`POST /api/agent/schedule/delete`](/api/agent-schedule/scheduleTaskDelete.md) — 定时任务管理模块上线
- **定时任务**: [`GET /api/agent/schedule/executionHistory`](/api/agent-schedule/scheduleTaskExecutionHistory.md) — 定时任务管理模块上线
- **定时任务**: [`GET /api/agent/schedule/executionHistory`](/api/agent-schedule/scheduleTaskExecutionHistory.md)
- **定时任务**: [`POST /api/agent/schedule/importExecution`](/api/agent-schedule/scheduleTaskImportExecution.md) — 定时任务管理模块上线
- **定时任务**: [`POST /api/agent/schedule/upsertTaskPolicy`](/api/agent-schedule/scheduleTaskUpsertTaskPolicy.md) — 定时任务管理模块上线
- **定时任务**: [`GET /api/agent/schedule/getTaskPolicy`](/api/agent-schedule/scheduleTaskGetTaskPolicy.md) — 定时任务管理模块上线

## 2026-05-09

### 新增

- **身份主体**: [`POST /api/principal/create`](/api/principal/principalCreate.md) — 身份主体管理模块上线
- **身份主体**: [`POST /api/principal/create`](/api/principal/principalCreate.md)
- **身份主体**: [`POST /api/principal/update`](/api/principal/principalUpdate.md) — 身份主体管理模块上线
- **身份主体**: [`GET /api/principal/list`](/api/principal/principalList.md) — 身份主体管理模块上线
- **身份主体**: [`GET /api/principal/list`](/api/principal/principalList.md)
- **身份主体**: [`DELETE /api/principal/delete`](/api/principal/principalDelete.md) — 身份主体管理模块上线
- **身份主体**: [`DELETE /api/principal/delete`](/api/principal/principalDelete.md)

## 2026-05-08

### 新增

- **附件管理**: [`GET /api/agent/attachment/preview`](/api/agent-attachment/agentAttachmentPreview.md)
- **附件管理**: [`GET /api/agent/attachment/getByMessage`](/api/agent-attachment/agentAttachmentGetByMessage.md)

## 2026-05-07

### 新增

- **权限规则**: [`POST /api/security/permission/createRule`](/api/security-permission/permissionRuleCreate.md) — 权限规则管理模块上线
- **权限规则**: [`POST /api/security/permission/createRule`](/api/security-permission/permissionRuleCreate.md)
- **权限规则**: [`POST /api/security/permission/batchCreateRules`](/api/security-permission/permissionRuleBatchCreate.md) — 权限规则管理模块上线
- **权限规则**: [`POST /api/security/permission/batchCreateRules`](/api/security-permission/permissionRuleBatchCreate.md)
- **权限规则**: [`GET /api/security/permission/listRules`](/api/security-permission/permissionRuleList.md) — 权限规则管理模块上线
- **权限规则**: [`GET /api/security/permission/listRules`](/api/security-permission/permissionRuleList.md)
- **权限规则**: [`POST /api/security/permission/updateRule`](/api/security-permission/permissionRuleUpdate.md) — 权限规则管理模块上线
- **权限规则**: [`POST /api/security/permission/updateRule`](/api/security-permission/permissionRuleUpdate.md)
- **权限规则**: [`POST /api/security/permission/deleteRule`](/api/security-permission/permissionRuleDelete.md) — 权限规则管理模块上线
- **权限规则**: [`POST /api/security/permission/deleteRule`](/api/security-permission/permissionRuleDelete.md)
- **权限规则**: [`POST /api/security/permission/generateRule`](/api/security-permission/permissionRuleGenerate.md) — 权限规则管理模块上线
- **权限规则**: [`POST /api/security/permission/generateRule`](/api/security-permission/permissionRuleGenerate.md)
- **权限规则**: [`GET /api/security/permission/pollGenerateRule`](/api/security-permission/permissionRulePollGenerate.md) — 权限规则管理模块上线
- **权限规则**: [`GET /api/security/permission/pollGenerateRule`](/api/security-permission/permissionRulePollGenerate.md)
- **权限规则**: [`GET /api/security/permission/listTemplates`](/api/security-permission/permissionTemplateList.md) — 权限规则管理模块上线
- **权限规则**: [`GET /api/security/permission/listTemplates`](/api/security-permission/permissionTemplateList.md)
- **权限规则**: [`GET /api/security/permission/getTemplateDetail`](/api/security-permission/permissionTemplateGetDetail.md) — 权限规则管理模块上线
- **权限规则**: [`GET /api/security/permission/getTemplateDetail`](/api/security-permission/permissionTemplateGetDetail.md)
- **权限规则**: [`POST /api/security/permission/applyTemplate`](/api/security-permission/permissionTemplateApply.md) — 权限规则管理模块上线
- **权限规则**: [`POST /api/security/permission/applyTemplate`](/api/security-permission/permissionTemplateApply.md)
- **用户记忆**: [`GET /api/memory/getLatestContext`](/api/memory/memoryGetLatestContext.md) — 用户记忆管理模块上线
- **用户记忆**: [`GET /api/memory/getLatestContext`](/api/memory/memoryGetLatestContext.md)
- **用户记忆**: [`POST /api/memory/updateContext`](/api/memory/memoryUpdateContext.md) — 用户记忆管理模块上线
- **用户记忆**: [`POST /api/memory/updateContext`](/api/memory/memoryUpdateContext.md)
- **用户记忆**: [`GET /api/memory/listContextVersions`](/api/memory/memoryListContextVersions.md) — 用户记忆管理模块上线
- **用户记忆**: [`GET /api/memory/listContextVersions`](/api/memory/memoryListContextVersions.md)
- **用户记忆**: [`GET /api/memory/getContextVersion`](/api/memory/memoryGetContextVersion.md) — 用户记忆管理模块上线
- **用户记忆**: [`GET /api/memory/getContextVersion`](/api/memory/memoryGetContextVersion.md)
- **用户记忆**: [`POST /api/memory/restoreContextVersion`](/api/memory/memoryRestoreContextVersion.md) — 用户记忆管理模块上线
- **用户记忆**: [`POST /api/memory/restoreContextVersion`](/api/memory/memoryRestoreContextVersion.md)

## 2026-05-05

### 新增

- **灵魂设定版本**: [`GET /api/agent/soul/versions`](/api/agent-soul/agentSoulListVersions.md) — Soul版本管理模块上线
- **灵魂设定版本**: [`GET /api/agent/soul/versions`](/api/agent-soul/agentSoulListVersions.md)
- **灵魂设定版本**: [`GET /api/agent/soul/versionDetail`](/api/agent-soul/agentSoulGetVersionDetail.md) — Soul版本管理模块上线
- **灵魂设定版本**: [`GET /api/agent/soul/versionDetail`](/api/agent-soul/agentSoulGetVersionDetail.md)
- **灵魂设定版本**: [`POST /api/agent/soul/restoreVersion`](/api/agent-soul/agentSoulRestoreVersion.md) — Soul版本管理模块上线
- **灵魂设定版本**: [`POST /api/agent/soul/restoreVersion`](/api/agent-soul/agentSoulRestoreVersion.md)
- **智能体技能**: [`GET /api/agent/skill/detail`](/api/agent-skill/agentSkillDetail.md) — 智能体技能管理模块上线
- **智能体技能**: [`GET /api/agent/skill/detail`](/api/agent-skill/agentSkillDetail.md)
- **智能体技能**: [`POST /api/agent/skill/importFromZip`](/api/agent-skill/agentSkillImportFromZip.md) — 智能体技能管理模块上线
- **智能体技能**: [`POST /api/agent/skill/importFromZip`](/api/agent-skill/agentSkillImportFromZip.md)
- **智能体技能**: [`POST /api/agent/skill/installFromHub`](/api/agent-skill/agentSkillInstallFromHub.md) — 智能体技能管理模块上线
- **智能体技能**: [`POST /api/agent/skill/installFromHub`](/api/agent-skill/agentSkillInstallFromHub.md)
- **智能体技能**: [`GET /api/agent/skill/download`](/api/agent-skill/agentSkillDownload.md) — 智能体技能管理模块上线
- **智能体技能**: [`GET /api/agent/skill/download`](/api/agent-skill/agentSkillDownload.md)
- **智能体技能**: [`POST /api/agent/skill/toggleEnabled`](/api/agent-skill/agentSkillToggleEnabled.md) — 智能体技能管理模块上线
- **智能体技能**: [`POST /api/agent/skill/toggleEnabled`](/api/agent-skill/agentSkillToggleEnabled.md)
- **智能体技能**: [`POST /api/agent/skill/changeType`](/api/agent-skill/agentSkillChangeType.md) — 智能体技能管理模块上线
- **智能体技能**: [`POST /api/agent/skill/delete`](/api/agent-skill/agentSkillDelete.md) — 智能体技能管理模块上线
- **智能体技能**: [`POST /api/agent/skill/delete`](/api/agent-skill/agentSkillDelete.md)
- **工作台**: [`POST /api/workbench/feed/trigger`](/api/workbench/workbenchTriggerFeed.md) — 工作台模块上线
- **工作台**: [`POST /api/workbench/feed/trigger`](/api/workbench/workbenchTriggerFeed.md)
- **工作台**: [`GET /api/workbench/feed/poll`](/api/workbench/workbenchPollFeed.md) — 工作台模块上线
- **工作台**: [`GET /api/workbench/feed/poll`](/api/workbench/workbenchPollFeed.md)
- **外部服务(Finx)**: [`POST /api/agent/finx/importMcpService`](/api/agent-finx/finxImportMcpService.md)
- **外部服务(Finx)**: [`POST /api/agent/finx/createMcpService/stream`](/api/agent-finx/finxCreateMcpServiceStream.md)
- **外部服务(Finx)**: [`POST /api/agent/finx/importMcpService/stream`](/api/agent-finx/finxImportMcpServiceStream.md)
- **外部服务(Finx)**: [`POST /api/agent/finx/createHttpService/stream`](/api/agent-finx/finxCreateHttpServiceStream.md)

## 2026-04-30

### 新增

- **附件管理**: [`POST /api/agent/attachment/fork`](/api/agent-attachment/agentAttachmentFork.md)

## 2026-04-29

### 新增

- **外部服务(Finx)**: [`POST /api/agent/finx/createMcpService`](/api/agent-finx/finxCreateMcpService.md) — 外部服务(Finx)管理模块上线
- **外部服务(Finx)**: [`POST /api/agent/finx/createMcpService`](/api/agent-finx/finxCreateMcpService.md)
- **外部服务(Finx)**: [`POST /api/agent/finx/updateMcpService`](/api/agent-finx/finxUpdateMcpService.md) — 外部服务(Finx)管理模块上线
- **外部服务(Finx)**: [`POST /api/agent/finx/importMcpService`](/api/agent-finx/finxImportMcpService.md) — 外部服务(Finx)管理模块上线
- **外部服务(Finx)**: [`POST /api/agent/finx/createHttpService`](/api/agent-finx/finxCreateHttpService.md) — 外部服务(Finx)管理模块上线
- **外部服务(Finx)**: [`POST /api/agent/finx/createHttpService`](/api/agent-finx/finxCreateHttpService.md)
- **外部服务(Finx)**: [`POST /api/agent/finx/updateHttpService`](/api/agent-finx/finxUpdateHttpService.md) — 外部服务(Finx)管理模块上线
- **外部服务(Finx)**: [`GET /api/agent/finx/listServices`](/api/agent-finx/finxListServices.md) — 外部服务(Finx)管理模块上线
- **外部服务(Finx)**: [`GET /api/agent/finx/listServices`](/api/agent-finx/finxListServices.md)
- **外部服务(Finx)**: [`GET /api/agent/finx/listMarketServices`](/api/agent-finx/finxListMarketServices.md) — 外部服务(Finx)管理模块上线
- **外部服务(Finx)**: [`GET /api/agent/finx/getServiceDetail`](/api/agent-finx/finxGetServiceDetail.md) — 外部服务(Finx)管理模块上线
- **外部服务(Finx)**: [`GET /api/agent/finx/listCategories`](/api/agent-finx/finxListCategories.md) — 外部服务(Finx)管理模块上线
- **外部服务(Finx)**: [`GET /api/agent/finx/listTools`](/api/agent-finx/finxListTools.md) — 外部服务(Finx)管理模块上线
- **外部服务(Finx)**: [`GET /api/agent/finx/getToolDetail`](/api/agent-finx/finxGetToolDetail.md) — 外部服务(Finx)管理模块上线
- **外部服务(Finx)**: [`POST /api/agent/finx/createTool`](/api/agent-finx/finxCreateTool.md) — 外部服务(Finx)管理模块上线
- **外部服务(Finx)**: [`POST /api/agent/finx/createTool`](/api/agent-finx/finxCreateTool.md)
- **外部服务(Finx)**: [`POST /api/agent/finx/updateTool`](/api/agent-finx/finxUpdateTool.md) — 外部服务(Finx)管理模块上线
- **外部服务(Finx)**: [`POST /api/agent/finx/deleteTool`](/api/agent-finx/finxDeleteTool.md) — 外部服务(Finx)管理模块上线
- **外部服务(Finx)**: [`POST /api/agent/finx/execute`](/api/agent-finx/finxExecute.md) — 外部服务(Finx)管理模块上线
- **外部服务(Finx)**: [`POST /api/agent/finx/execute`](/api/agent-finx/finxExecute.md)
- **外部服务(Finx)**: [`POST /api/agent/finx/deleteService`](/api/agent-finx/finxDeleteService.md) — 外部服务(Finx)管理模块上线
- **外部服务(Finx)**: [`POST /api/agent/finx/deleteService`](/api/agent-finx/finxDeleteService.md)
- **外部服务(Finx)**: [`POST /api/agent/finx/toggleServiceEnabled`](/api/agent-finx/finxToggleServiceEnabled.md) — 外部服务(Finx)管理模块上线
- **外部服务(Finx)**: [`POST /api/agent/finx/toggleServiceEnabled`](/api/agent-finx/finxToggleServiceEnabled.md)
- **外部服务(Finx)**: [`POST /api/agent/finx/getAuthSchema`](/api/agent-finx/finxGetAuthSchema.md) — 外部服务(Finx)管理模块上线
- **外部服务(Finx)**: [`POST /api/agent/finx/getAuthSchema`](/api/agent-finx/finxGetAuthSchema.md)
- **外部服务(Finx)**: [`POST /api/agent/finx/saveAuthCredential`](/api/agent-finx/finxSaveAuthCredential.md) — 外部服务(Finx)管理模块上线
- **外部服务(Finx)**: [`POST /api/agent/finx/saveAuthCredential`](/api/agent-finx/finxSaveAuthCredential.md)
- **外部服务(Finx)**: [`POST /api/agent/finx/createMcpService/stream`](/api/agent-finx/finxCreateMcpServiceStream.md) — 外部服务(Finx)管理模块上线
- **外部服务(Finx)**: [`POST /api/agent/finx/importMcpService/stream`](/api/agent-finx/finxImportMcpServiceStream.md) — 外部服务(Finx)管理模块上线
- **外部服务(Finx)**: [`POST /api/agent/finx/createHttpService/stream`](/api/agent-finx/finxCreateHttpServiceStream.md) — 外部服务(Finx)管理模块上线
- **静态资源**: [`GET /api/static/avatar`](/api/agent-static/staticGetHubAvatar.md)

## 2026-04-28

### 新增

- **智能体管理与设定**: [`POST /api/agent/updateFeatureSettings`](/api/agent/agentUpdateFeatureSettings.md)

## 2026-04-24

### 新增

- **权限确认**: [`POST /api/permissionAsk/resolveAsk`](/api/permission-ask/permissionAskResolve.md) — 权限确认管理模块上线
- **权限确认**: [`POST /api/permissionAsk/resolveAsk`](/api/permission-ask/permissionAskResolve.md)
- **权限确认**: [`GET /api/permissionAsk/pendingAsks`](/api/permission-ask/permissionAskListPending.md) — 权限确认管理模块上线
- **权限确认**: [`GET /api/permissionAsk/pendingAsks`](/api/permission-ask/permissionAskListPending.md)

## 2026-04-22

### 新增

- **智能体管理与设定**: [`POST /api/agent/create`](/api/agent/agentCreate.md) — 智能体管理与设定模块上线
- **智能体管理与设定**: [`POST /api/agent/create`](/api/agent/agentCreate.md)
- **智能体管理与设定**: [`GET /api/agent/detail`](/api/agent/agentDetail.md) — 智能体管理与设定模块上线
- **智能体管理与设定**: [`GET /api/agent/detail`](/api/agent/agentDetail.md)
- **智能体管理与设定**: [`GET /api/agent/list`](/api/agent/agentList.md) — 智能体管理与设定模块上线
- **智能体管理与设定**: [`GET /api/agent/list`](/api/agent/agentList.md)
- **智能体管理与设定**: [`POST /api/agent/updateBasicInfo`](/api/agent/agentUpdateBasicInfo.md) — 智能体管理与设定模块上线
- **智能体管理与设定**: [`POST /api/agent/updateBasicInfo`](/api/agent/agentUpdateBasicInfo.md)
- **智能体管理与设定**: [`PUT /api/agent/updateDefinition`](/api/agent/agentUpdateDefinition.md) — 智能体管理与设定模块上线
- **智能体管理与设定**: [`POST /api/agent/updateIdentity`](/api/agent/agentUpdateIdentity.md) — 智能体管理与设定模块上线
- **智能体管理与设定**: [`POST /api/agent/updateAvatar`](/api/agent/agentUpdateAvatar.md) — 智能体管理与设定模块上线
- **智能体管理与设定**: [`POST /api/agent/updateAvatar`](/api/agent/agentUpdateAvatar.md)
- **智能体管理与设定**: [`POST /api/agent/updateModelConfig`](/api/agent/agentUpdateModelConfig.md) — 智能体管理与设定模块上线
- **智能体管理与设定**: [`POST /api/agent/updateImageModel`](/api/agent/agentUpdateImageModel.md) — 智能体管理与设定模块上线
- **智能体管理与设定**: [`GET /api/agent/models`](/api/agent/agentListModels.md) — 智能体管理与设定模块上线
- **智能体管理与设定**: [`POST /api/agent/updateFeatureSettings`](/api/agent/agentUpdateFeatureSettings.md) — 智能体管理与设定模块上线
- **智能体管理与设定**: [`POST /api/agent/updateSkillScope`](/api/agent/agentUpdateSkillScope.md) — 智能体管理与设定模块上线
- **智能体管理与设定**: [`GET /api/agent/skills`](/api/agent/agentListSkills.md) — 智能体管理与设定模块上线
- **智能体管理与设定**: [`GET /api/agent/skills`](/api/agent/agentListSkills.md)
- **智能体管理与设定**: [`GET /api/agent/availableSkills`](/api/agent/agentListAvailableSkills.md) — 智能体管理与设定模块上线
- **智能体管理与设定**: [`GET /api/agent/availableSkills`](/api/agent/agentListAvailableSkills.md)
- **智能体管理与设定**: [`POST /api/agent/toggleKnowledgeLibrary`](/api/agent/agentToggleKnowledgeLibrary.md) — 智能体管理与设定模块上线
- **智能体管理与设定**: [`POST /api/agent/avatar/generate`](/api/agent/agentGenerateAvatar.md) — 智能体管理与设定模块上线
- **智能体管理与设定**: [`POST /api/agent/avatar/generate`](/api/agent/agentGenerateAvatar.md)
- **智能体管理与设定**: [`GET /api/agent/deleteCheck`](/api/agent/agentDeleteCheck.md) — 智能体管理与设定模块上线
- **智能体管理与设定**: [`DELETE /api/agent/delete`](/api/agent/agentDelete.md) — 智能体管理与设定模块上线
- **附件管理**: [`POST /api/agent/attachment/upload`](/api/agent-attachment/agentAttachmentUpload.md) — 附件管理模块上线
- **附件管理**: [`POST /api/agent/attachment/upload`](/api/agent-attachment/agentAttachmentUpload.md)
- **附件管理**: [`POST /api/agent/attachment/uploadByUrl`](/api/agent-attachment/agentAttachmentUploadByUrl.md) — 附件管理模块上线
- **附件管理**: [`GET /api/agent/attachment/download`](/api/agent-attachment/agentAttachmentDownload.md) — 附件管理模块上线
- **附件管理**: [`GET /api/agent/attachment/download`](/api/agent-attachment/agentAttachmentDownload.md)
- **附件管理**: [`GET /api/agent/attachment/info`](/api/agent-attachment/agentAttachmentGetInfo.md) — 附件管理模块上线
- **附件管理**: [`GET /api/agent/attachment/info`](/api/agent-attachment/agentAttachmentGetInfo.md)
- **附件管理**: [`GET /api/agent/attachment/preview`](/api/agent-attachment/agentAttachmentPreview.md) — 附件管理模块上线
- **附件管理**: [`GET /api/agent/attachment/recentBySession`](/api/agent-attachment/agentAttachmentListRecentBySession.md) — 附件管理模块上线
- **附件管理**: [`GET /api/agent/attachment/recentBySession`](/api/agent-attachment/agentAttachmentListRecentBySession.md)
- **附件管理**: [`GET /api/agent/attachment/getBySession`](/api/agent-attachment/agentAttachmentGetBySession.md) — 附件管理模块上线
- **附件管理**: [`GET /api/agent/attachment/getByMessage`](/api/agent-attachment/agentAttachmentGetByMessage.md) — 附件管理模块上线
- **附件管理**: [`POST /api/agent/attachment/fork`](/api/agent-attachment/agentAttachmentFork.md) — 附件管理模块上线
- **智能体运行**: [`POST /api/agent/run/async`](/api/agent-run/agentRunAsync.md) — 智能体运行模块上线
- **智能体运行**: [`POST /api/agent/run/async`](/api/agent-run/agentRunAsync.md)
- **智能体运行**: [`GET /api/agent/run/stream`](/api/agent-run/agentRunStreamEvents.md) — 智能体运行模块上线
- **智能体运行**: [`GET /api/agent/run/stream`](/api/agent-run/agentRunStreamEvents.md)
- **智能体运行**: [`GET /api/agent/run/listTasks`](/api/agent-run/agentRunListTasks.md) — 智能体运行模块上线
- **智能体运行**: [`GET /api/agent/run/listTasks`](/api/agent-run/agentRunListTasks.md)
- **智能体运行**: [`GET /api/agent/run/getTask`](/api/agent-run/agentRunGetTask.md) — 智能体运行模块上线
- **智能体运行**: [`GET /api/agent/run/getTask`](/api/agent-run/agentRunGetTask.md)
- **智能体运行**: [`GET /api/agent/run/messages`](/api/agent-run/agentRunGetMessages.md) — 智能体运行模块上线
- **智能体运行**: [`GET /api/agent/run/pendingTasks`](/api/agent-run/agentRunListPendingTasks.md) — 智能体运行模块上线
- **智能体运行**: [`GET /api/agent/run/pendingTasks`](/api/agent-run/agentRunListPendingTasks.md)
- **智能体运行**: [`GET /api/agent/run/countTasks`](/api/agent-run/agentRunCountTasks.md) — 智能体运行模块上线
- **智能体运行**: [`GET /api/agent/run/countTasks`](/api/agent-run/agentRunCountTasks.md)
- **智能体运行**: [`POST /api/agent/run/suspendTask`](/api/agent-run/agentRunSuspendTask.md) — 智能体运行模块上线
- **智能体运行**: [`POST /api/agent/run/suspendTask`](/api/agent-run/agentRunSuspendTask.md)
- **智能体运行**: [`POST /api/agent/run/resumeTask`](/api/agent-run/agentRunResumeTask.md) — 智能体运行模块上线
- **智能体运行**: [`POST /api/agent/run/resumeTask`](/api/agent-run/agentRunResumeTask.md)
- **智能体运行**: [`POST /api/agent/run/terminateTask`](/api/agent-run/agentRunTerminateTask.md) — 智能体运行模块上线
- **智能体运行**: [`POST /api/agent/run/terminateTask`](/api/agent-run/agentRunTerminateTask.md)
- **智能体运行**: [`POST /api/agent/run/retryTask`](/api/agent-run/agentRunRetryTask.md) — 智能体运行模块上线
- **智能体运行**: [`POST /api/agent/run/retryTask`](/api/agent-run/agentRunRetryTask.md)
- **智能体运行**: [`POST /api/agent/run/addSupplementaryInput`](/api/agent-run/agentRunAddSupplementaryInput.md) — 智能体运行模块上线
- **智能体运行**: [`POST /api/agent/run/addSupplementaryInput`](/api/agent-run/agentRunAddSupplementaryInput.md)
- **智能体运行**: [`POST /api/agent/run/removeSupplementaryInput`](/api/agent-run/agentRunRemoveSupplementaryInput.md) — 智能体运行模块上线
- **智能体运行**: [`POST /api/agent/run/removeSupplementaryInput`](/api/agent-run/agentRunRemoveSupplementaryInput.md)
- **智能体运行**: [`GET /api/agent/run/previewSupplementaryInput`](/api/agent-run/agentRunPreviewSupplementaryInput.md) — 智能体运行模块上线
- **智能体运行**: [`GET /api/agent/run/previewSupplementaryInput`](/api/agent-run/agentRunPreviewSupplementaryInput.md)
- **会话管理**: [`POST /api/session/create`](/api/session/sessionCreate.md) — 会话管理模块上线
- **会话管理**: [`GET /api/session/detail`](/api/session/sessionGetDetail.md) — 会话管理模块上线
- **会话管理**: [`GET /api/session/detail`](/api/session/sessionGetDetail.md)
- **会话管理**: [`GET /api/session/contextUsage`](/api/session/sessionContextUsage.md) — 会话管理模块上线
- **会话管理**: [`GET /api/session/backgroundTasks`](/api/session/sessionListBackgroundTasks.md) — 会话管理模块上线
- **会话管理**: [`GET /api/session/backgroundTasks/detail`](/api/session/sessionGetBackgroundTaskDetail.md) — 会话管理模块上线
- **会话管理**: [`POST /api/session/backgroundTasks/delete`](/api/session/sessionTerminateBackgroundTask.md) — 会话管理模块上线
- **会话管理**: [`GET /api/session/list`](/api/session/sessionList.md) — 会话管理模块上线
- **会话管理**: [`GET /api/session/list`](/api/session/sessionList.md)
- **会话管理**: [`POST /api/session/search`](/api/session/sessionSearch.md) — 会话管理模块上线
- **会话管理**: [`GET /api/session/messages`](/api/session/sessionListMessages.md) — 会话管理模块上线
- **会话管理**: [`GET /api/session/messages`](/api/session/sessionListMessages.md)
- **会话管理**: [`GET /api/session/message-parts`](/api/session/sessionListMessageParts.md) — 会话管理模块上线
- **会话管理**: [`PUT /api/session/updateTitle`](/api/session/sessionUpdateTitle.md) — 会话管理模块上线
- **会话管理**: [`POST /api/session/fork`](/api/session/sessionFork.md) — 会话管理模块上线
- **会话管理**: [`POST /api/session/feedback/submit`](/api/session/sessionSubmitFeedback.md) — 会话管理模块上线
- **会话管理**: [`GET /api/session/trajectory`](/api/session/sessionGetTrajectory.md) — 会话管理模块上线
- **会话管理**: [`POST /api/session/importTrace`](/api/session/sessionImportTrace.md) — 会话管理模块上线
- **会话管理**: [`POST /api/session/importQaPair`](/api/session/sessionImportQaPair.md) — 会话管理模块上线
- **会话管理**: [`DELETE /api/session/delete`](/api/session/sessionDelete.md) — 会话管理模块上线
- **会话管理**: [`GET /api/session/message-part-detail`](/api/session/sessionGetMessagePartDetail.md) — 会话管理模块上线
- **静态资源**: [`GET /api/static/agent/avatar`](/api/agent-static/staticGetAgentAvatar.md) — 静态资源代理模块上线
- **静态资源**: [`GET /api/static/agent/avatar`](/api/agent-static/staticGetAgentAvatar.md)
- **静态资源**: [`GET /api/static/avatar`](/api/agent-static/staticGetHubAvatar.md) — 静态资源代理模块上线
- **静态资源**: [`GET /api/static/temp`](/api/agent-static/staticGetTempResource.md) — 静态资源代理模块上线
- **静态资源**: [`GET /api/static/temp`](/api/agent-static/staticGetTempResource.md)
- **斜杠命令**: [`GET /api/agent/command/list`](/api/agent-command/commandList.md) — 斜杠命令模块上线
- **斜杠命令**: [`GET /api/agent/command/list`](/api/agent-command/commandList.md)
- **行业专家**: [`GET /api/hub/agent/list`](/api/hub-agent/agentHubList.md) — 智能体市场模块上线
- **行业专家**: [`GET /api/hub/agent/list`](/api/hub-agent/agentHubList.md)
- **行业专家**: [`POST /api/hub/agent/apply`](/api/hub-agent/agentHubApply.md) — 智能体市场模块上线
- **行业专家**: [`POST /api/hub/agent/apply`](/api/hub-agent/agentHubApply.md)