腾讯混元API怎么把工具执行结果传回模型

千明酱_3981

千明酱_3981

2026-10-26

849人浏览

原创

需使用【hunyuan-functioncall】模型、sdk≥3.0.1216,构造含tools的messages请求;解析tool_calls后,按id严格匹配插入role="tool"消息,再调用api获取最终回答。

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

腾讯混元api怎么把工具执行结果传回模型

你需要让腾讯混元模型在调用外部工具后,把工具返回的结构化数据正确送回模型继续推理,否则模型无法基于真实结果生成后续回答。

确认模型支持 function call

使用 【hunyuan-functioncall】 模型 ID,不是 hunyuan-pro 或 hunyuan-standard。其他模型不解析 tools 字段,也不会触发 tool_calls 返回,强行传入 tools 会被静默忽略。

检查 SDK 版本是否 ≥ 3.0.1216,旧版本未适配 function call 协议,会抛出 UnknownParameter 错误。

构造带 tools 的请求消息

在 messages 数组末尾添加用户问题,例如:{"role": "user", "content": "查一下北京今天天气怎么样?"}

同时传入 tools 参数,定义函数签名,字段必须包含 type、function.name、function.description、function.parameters(JSON Schema 格式)。

注意:parameters 中的 required 字段必须显式列出必填项,漏写会导致模型无法生成有效 tool_calls 参数。

捕获并解析 tool_calls 响应

发送请求后,响应中若含 choices[0].message.tool_calls 字段,说明模型决定调用工具。

腾讯混元
腾讯混元

腾讯混元是由腾讯公司推出的通用大语言模型与AI助手产品,基于自研的混元大模型体系打造,提供智能问答、内容生成、代码辅助、办公写作、知识检索等能力。用户可以通过网页端、移动端等方式使用,用于学习、工作和内容创作等多种场景。

下载

逐个提取 tool_calls[i].function.name 和 tool_calls[i].function.arguments(字符串),用 json.loads 解析为 dict —— 【arguments 是 JSON 字符串,不是 dict】。

若 arguments 解析失败,说明模型输出格式异常,需丢弃该条响应,不可直接传给下游工具。

把工具结果塞回 messages 继续对话

第一步:将原始 user 消息和 model 的 tool_calls 消息原样保留在 messages 中;

第二步:追加一条 role="tool" 的消息,格式为:{"role": "tool", "tool_call_id": tool_calls[i].id, "content": ''};

第三步:再次调用 API,传入更新后的完整 messages 数组 —— 模型会读取 tool 消息内容,并据此生成最终回答。

注意:tool_call_id 必须与上一轮响应中的 tool_calls[i].id 完全一致,大小写和符号都不能错,否则模型无法关联上下文。

大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!

相关专题

更多
腾讯混元使用教程大全
腾讯混元使用教程大全

从零开始学习腾讯混元,涵盖AI问答、内容创作、资料整理、办公辅助、代码生成、学习应用等场景,通过实战教程帮助用户快速掌握腾讯混元。

2026.06.11

502

10

腾讯混元Prompt大全
腾讯混元Prompt大全

收录腾讯混元热门Prompt模板,涵盖AI写作、办公文档、自媒体运营、电商推广、代码开发、学习教育等场景,帮助用户获得更高质量AI输出结果。

2026.06.11

545

10

腾讯混元开发平台教程
腾讯混元开发平台教程

面向开发者提供腾讯混元开放平台、API调用、SDK接入、智能体开发、Agent构建及企业级AI应用开发教程,帮助快速完成腾讯混元能力集成。

2026.06.11

561

10

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

2026.10.22

20

11

Gradle Wrapper配置教程
Gradle Wrapper配置教程

本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。

2026.10.22

20

10

Golangci-lint检查器使用教程
Golangci-lint检查器使用教程

本专题整理Golangci-lint常用Linters的用途与配置方法,覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查,帮助项目合理选规则。

2026.10.22

20

15

Gradle怎么构建Java项目
Gradle怎么构建Java项目

本专题介绍Gradle Java项目构建方法,涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查,帮助你理解各阶段的任务关系,逐步完成项目构建。

2026.10.22

0

10

PHP时间戳漏洞修复教程
PHP时间戳漏洞修复教程

本专题汇总PHP常见时间戳漏洞,包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等,并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案,帮助开发者快速排查和加固时间相关代码。

2026.10.22

20

25

Golangci-lint配置文件与规则设置
Golangci-lint配置文件与规则设置

本专题聚焦Golangci-lint YAML配置文件,讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置,便于团队统一检查标准。

2026.10.22

20

15

热门下载

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

精品课程

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