火山引擎怎么把工具执行结果交回模型_火山引擎工具调用结果回传教程

酷明君_1516

酷明君_1516

2026-10-27

183人浏览

原创

必须将tool_output字段精准注入响应体,否则模型卡在“等待工具返回”;需先查taskId状态,status=2才回传taskResult原始字符串,且续写请求不可启用stream。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

火山引擎怎么把工具执行结果交回模型_火山引擎工具调用结果回传教程

火山引擎工具调用完成后,模型无法自动感知执行结果,必须通过显式结构将tool_output字段精准注入响应体,否则大模型会卡在“等待工具返回”状态而无法生成最终回复。

确认工具调用已成功触发

调用VideoProjectCreateToolTask等工具接口后,必须先获取taskId,再用该taskId调用VideoProjectGetToolTask查询执行状态。只有当返回data.toolTask.taskStatus = 2(表示执行完成)时,才可进入结果回传阶段。若status为0或1,说明工具尚未运行或正在执行,此时强行回传会导致模型接收空结果。

检查返回的taskResult字段是否为非空JSON字符串——它不是对象,而是被序列化后的字符串,例如:{"videoUrl":"https://xxx.mp4","duration":128}。这是火山引擎工具服务的固定格式,【必须原样保留双引号和转义字符,不可解析后再重序列化】。

构造符合Responses API规范的tool_output结构

在向Responses API发起下一轮请求(即带工具结果的续写请求)时,需在messages数组末尾追加一条role=“tool”的消息。

这条消息必须包含三个字段:tool_call_id(与原始user消息中tool_calls数组对应项的id一致)、name(与原始调用的工具名完全相同)、tool_output(就是上一步拿到的taskResult原始字符串)。

火山引擎
火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

下载

示例:
{"role":"tool","tool_call_id":"call_abc123","name":"VideoProjectRender","tool_output":"{\"videoUrl\":\"https://xxx.mp4\",\"duration\":128}"}

发送带tool_output的续写请求

将构造好的messages数组(含原始user消息、assistant的tool_calls、以及新增的tool消息)整体作为新请求的body,POST到Responses API端点。

注意:此请求【不能携带stream=true参数】,因为工具结果回传必须等待模型完整消化后再输出最终响应,流式模式下会因分块截断导致tool_output丢失或解析失败。

若使用OpenClaw CLI,执行命令时需显式禁用流式:openclaw chat --no-stream --model volcengine/skylark2-pro-4k -m "user:渲染视频" -t "VideoProjectRender" -o '{"videoUrl":"https://xxx.mp4","duration":128}'。

相关专题

更多
GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

0

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

0

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

0

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

0

10

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

2026.11.17

0

11

SQLAlchemy ORM 模型怎么写
SQLAlchemy ORM 模型怎么写

SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。

2026.11.17

0

16

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

160

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

120

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

100

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程