POST/api/workbench/feed/trigger

触发工作台动态内容生成

异步启动生成任务，返回 requestId 用于轮询。缓存结果有效到下一个固定刷新时间点（每日 07:00 / 12:00 / 17:00 / 20:00，Asia/Shanghai），期间直接命中返回。已有运行中任务时返回该任务ID。

请求参数

请求头参数1 个字段

X-Principal-Idintegernullable

身份主体ID（Long类型）。通过API访问时必须传递以标识操作主体；通过页面访问时无需传递。可通过「身份主体」模块的创建接口获取。

Query 参数2 个字段

agentIdintegerrequired

智能体ID

refreshbooleannullable

是否强制刷新缓存

响应

200

httpStatusCodeintegernullable

HTTP状态码

messagestringnullable

响应消息

dataOnboardingFeedTaskResponsenullable

响应数据

successbooleannullable

是否成功

requestIdstringnullable

上游请求ID，用于跨系统链路追踪排查问题

errCodestringnullable

上游错误码，前端可据此做特殊UI处理

查看 Markdown

GET/api/workbench/feed/poll

轮询工作台动态内容生成结果

通过触发接口返回的 requestId 查询生成进度，建议轮询间隔 2~3 秒。仅能查询当前身份主体自己的任务。

不同 status 下返回的字段不同（未赋值的字段不会出现在响应中）：

GENERATING（生成中）：返回 message；若存在上一次的旧结果，会同时携带 staleResult，前端可先行展示，应继续轮询
COMPLETED（已完成）：返回 result（生成结果，内嵌JSON对象，结构见 result 字段说明）和 cacheExpireAt（缓存过期时间），可停止轮询
FAILED（失败）：返回 message 说明失败原因；未找到对应任务、或 requestId 与服务端不一致（已有新的生成任务覆盖）时也返回 FAILED，此时应重新调用触发接口