WorkBuddy 新增8个定时任务API:企业怎么接
腾讯云官方 WorkBuddy Enterprise API 更新历史显示,2026年11月3日新增8个定时任务接口,11月4日再增3个会话产物接口,11月13日补齐访问令牌出参。本文拆企业怎么把智能体接进现有系统。
2026-11-14 10:32:22 · 主编:刘立永2026年11月3日,腾讯云官方《WorkBuddy Enterprise 更新历史》第7次发布一次性新增8个定时任务接口,11月4日第8次发布新增3个会话产物接口,11月13日第9次发布为 DescribeUserAccessToken 补上 AccessToken、TokenType、ExpiresIn 三个出参。三次发布均可在官方文档逐条核对,指向同一件事:企业不必只靠客户端点按钮,可以用 API 把智能体接进自己的业务系统。
一、8个定时任务接口:把到点干活搬进业务系统
第7次发布(2026-11-03)新增的8个接口覆盖定时任务完整生命周期:CreateScheduledTask 创建、ModifyScheduledTask 修改、DeleteScheduledTask 删除、TriggerScheduledTask 立即触发、DescribeScheduledTask 查详情、DescribeScheduledTaskList 查列表,以及 DescribeScheduledTaskLog 与 DescribeScheduledTaskLogList 查运行日志;同步新增7个数据结构(AgentConfig、DeliveryTarget、Header、ScheduledTaskLogStats、ScheduledTaskLogSummary、ScheduledTaskSummary、TargetOptions)。其中 DeliveryTarget 与 TargetOptions 说明任务结果可指定投递目标,而不只是弹一条通知。对做系统集成的一方,这比客户端里的「定时任务」按钮更关键:月结提醒、日报汇总、单据巡检这类动作,可由 ERP 或 OA 的既有流程触发,再把结果回写。
二、产物与令牌:结果能取走,身份能核验
第8次发布(2026-11-04)新增 DeleteSessionArtifactList、DescribeSessionArtifactDownloadUrl、DescribeSessionArtifactList 三个接口,对应会话产物的列举、下载与删除;第9次发布(2026-11-13)在 DescribeUserAccessToken 出参里补上 AccessToken、TokenType、ExpiresIn,令牌从此有明确类型与有效期字段。前者解决「AI 生成的文件怎么进我的系统」,后者解决「调用方是谁、凭证何时过期」。两处都不是界面功能,而是二次开发的接缝。此前的第6次发布(2026-10-28)还给 DescribeMessageEventList 增加 SubAgentId 入参,给 MessageEventToolCall 补上 ExpertId、ParentToolCallId 等六个成员,多智能体调用链的可追溯性在持续补强。
三、版本号别记混:三条线是并行的
管理员要留意:官方客户端更新日志里,11月最高版本仍是 5.11.0(2026-11-03,标注灰度中),其中定时任务升级为支持立即运行、编辑、重命名、删除与启停;企业控制台发版线是 5.30.0(2026-11-03),含定时任务聚合页与可观测中心企业级自主开通;而本文的 API 更新历史按「第几次发布」计数,不用语义化版本号,页面最近更新时间为 2026-11-13。三者是同一能力的三个层面——客户端给人用,控制台给管理员配,API 给系统对接,升级台账上必须分开记,别把 5.11.0、5.30.0 和接口发布次数混成一个版本。
四、给中小企业的三条建议
第一,先接一个只读场景。别一上来就用 API 写业务数据,先用 TriggerScheduledTask 跑一次日报汇总、把产物取回归档,观察两周稳定性再谈回写——这与我们给山东客户做用友、金蝶、管家婆接口对接时先做查询类、后做写入类的顺序一致。
第二,把令牌与运行日志纳进现有运维。ExpiresIn 意味着凭证会过期,续期与失败重试要写进监控;运行日志接口对应原有系统的操作留痕要求,别只留客户端截图。
第三,没有开发团队就先用客户端。8个接口的价值要有系统可接才成立;若企业只有几套标准财务软件、没有自研系统,控制台的定时任务聚合页与用量治理更划算。
参考来源:
1. 腾讯云官方《WorkBuddy Enterprise 更新历史》,最近更新 2026-11-13:https://cloud.tencent.com/document/api/1831/138591
2. 腾讯云官方《WorkBuddy Enterprise 5.30.0 版本》,2026-11-03:https://cloud.tencent.com/document/product/1831/140565
3. WorkBuddy 官方《更新日志·5.11.0 版本发布》,2026-11-03(灰度中):https://www.codebuddy.cn/docs/workbuddy/Changelog