Skip to main content
本页汇总托管智能体 API 当前版本发布后的调用方可见变更，与 OpenAPI 规范中的 ChangeLog 保持一致。 破坏性变更只会随新的带日期版本发布。 以下条目均为当前版本内的非破坏性变更，客户端应能容忍新端点、新的可选请求字段、新的响应字段与响应头、响应侧枚举新值。

​
2026-09-07

  • 资源 ID 字段不再声明 pattern 格式约束。ID 历来是不透明字符串，已声明的 pattern 并未覆盖平台实际签发的全部格式。此前按这些 pattern 校验 ID 的客户端应移除该校验。
  • GET /v1/environments 新增 official_only 查询参数，用于仅列出平台提供的官方环境。默认值为 false。
  • SessionErrorPayload 新增可选的 mcp_server_name 字段：mcp_connection_failed 与 mcp_authentication_failed 携带受影响 MCP server 的声明名，客户端可直接链接到对应凭据，无需解析 message。其他错误类型及本次变更前写入的事件不含该字段。
  • SessionErrorType 为即将落地的 MCP runtime 错误分类预留 mcp_connection_failed 与 mcp_authentication_failed 两个值。会话现在在 MCP server 初始连接或工具调用阶段失败时发出这两个值（不可达，或明确 401 经凭据刷新与一次重试仍未恢复）。平台侧刷新失败（网络、锁、DB、回写）只记服务端日志，不发出。
  • 错误响应现在一致遵循文档约定的 error.type 与 error.param 规则。JSON 类型或校验失败的字段返回 invalid_parameter_error，param 携带从请求根开始的完整点路径（如 config.networking.type、tools.mcp_server_name）；union 字段的误用（缺失或未知 discriminator、携带其他 variant 的负载）指向 union 字段自身的路径（如 model、items.auth）；请求级错误仍是不带 param 的 invalid_request_error。此前部分字段级错误被误报为 invalid_request_error 或使用不完整路径。缺少必填 data 字段的 user.message 事件与低于契约下限的 activity.min_changed_sessions 现在会被拒绝，不再被接受。

​
2026-09-06

  • listTriggers 新增 agent_id 查询参数，按所属 Agent 筛选触发器。

​
2026-09-05

  • listMemoryStores 与 listMemories 的返回顺序由按创建时间升序改为最新在前。
  • GET /v1/agents 新增 official_only 查询参数，用于仅列出平台提供的官方智能体。默认值为 false。

​
2026-09-04

  • kimi-api-version 请求头现在以可选 header 参数的形式在每个操作上显式声明。/v1/files* 之外未携带该请求头将被拒绝并返回 400 invalid_request_error；在 /v1/files* 上缺省时选择兼容格式。请求行为不变。
  • 事件流响应现在声明其 Cache-Control: no-cache 与 X-Accel-Buffering: no 响应头。这两个响应头一直都会发送，本次仅新增契约声明。
  • 共享 429 响应现在声明 Retry-After 响应头，仅当 error.type 为 rate_limit_reached_error 时携带。该响应头一直都会发送，本次仅新增契约声明。

​
2026-09-03

  • 将 batch 用途的文件绑定到会话，现在返回 400 failed_precondition_error，而不是 404 resource_not_found_error。batch 文件本来就不支持绑定，本次仅变更错误类型。
  • EnvironmentProxy 新增可选的 route_all：设置后全部出站主机默认经环境代理转发，hosts 可为空名单。平台内部接口仍绕过代理；limited 下白名单不再生效，可达性由该代理自行决定。