文档中心

云手机

回调结构

任务状态更新回调

任务状态更新回调

回调名称 CallBackUpdateTaskStatus，任务执行状态发生变更时会触发该回调。

回调参数

参数	类型	示例值	描述
AccountId	String	111111****	火山账号 ID。
RunId	String	run-13***	运行 ID。
Event	String	status	回调事件类型，取值： status：任务开始执行、任务成功完成、提交取消、取消完成时触发，即当触发任务状态更新回调时返回此参数。 failed：任务执行异常时、取消链路本身出现异常时触发。 interrupt：任务需要用户补充信息、登录、审批或人工介入时出触发。
Data	Dict	{"Status": 2, "ThreadId": "thread-123"}	按任务状态返回不同字段，参见 Data 字段说明。说明任务已创建（created）时不会返回 Data。任务正在运行（running）、任务取消中（cancelling），返回 Status、ThreadId 字段。任务已完成（completed），返回 Status、ThreadId、Result、StructOutput、TotalSteps、DurationMs 字段。任务已被取消（cancelled），返回 Status、ThreadId、TotalSteps、DurationMs 字段。

Data 字段说明

字段名	类型	示例值	说明
Status	Integer	2	任务状态码，取值： 1：任务已创建（created） 2：任务正在运行（running） 3：任务已完成（completed） 4：任务取消中（cancelling） 5：任务已被取消（cancelled） 6：任务已失败（failed） 7：任务已中断（interrupted）
ThreadId	String	thread_***	线程 ID。
Result	String	-	任务最终执行结果。
TotalSteps	Integer	12	任务的总执行步数。
DurationMs	Integer	12312	任务耗时，单位为毫秒（ms）。
StructOutput	Object	-	用于返回结构化的字符串内容，若未配置 output_schema 则该字段通常为空。

回调示例

最近更新时间：2026.09.30 17:03:09

这个页面对您有帮助吗？

有用

有用

无用

无用