{"version":"0.0.0","data":{"0":{"ops":[{"insert":"Function Calling 能使 AI 识别用户说话中的特定意图，并调用您已实现的外部函数，以完成特定任务。例如：查询实时信息（如天气）、操作业务系统、控制 App 硬件功能（播放音乐、关灯、调整音量）等。\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#模型限制","heading":"h2"}},{"insert":"使用限制\n"},{"insert":"模型要求：豆包实时语音模型 3.0（Seeduplex）、具备 Function Calling 能力的火山方舟模型，或具备 Function Calling 能力的第三方大模型。\n"},{"insert":"*","attributes":{"lmkr":"1","tips":"{\"type\":\"warning\",\"isTitle\":true}"}},{"insert":"说明\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1","tips":"{\"type\":\"warning\"}"},"insert":"*"},{"insert":"支持的方舟模型，请参见"},{"attributes":{"hyperlink":"{\"href\":\"https://www.volcengine.com/docs/82379/1330310\",\"linkId\":\"bslFt3van6\"}"},"insert":"模型列表"},{"insert":"。不建议使用 "},{"attributes":{"inlineCode":"true"},"insert":"doubao-seed-1.6-thinking"},{"insert":"，该模型会强制开启思考模式且不可关闭，可能造成较高时延。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1","tips":"{\"type\":\"warning\"}"},"insert":"*"},{"insert":"Seeduplex 原生 Function Calling 仅支持 "},{"attributes":{"inlineCode":"true"},"insert":"S2SConfig.Provider=volcano_duplex"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"S2SConfig.OutputMode=0"},{"insert":"。混合编排模式下，Function Calling 由 "},{"attributes":{"inlineCode":"true"},"insert":"LLMConfig"},{"insert":" 中配置的外挂 LLM 处理。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1","tips":"{\"type\":\"warning\"}"},"insert":"*"},{"insert":"Doubao 1.5 及之前系列的模型，不建议同时使用视觉理解和 Function Calling。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1","tips":"{\"type\":\"warning\"}"},"insert":"*"},{"insert":"如需保留 Function Calling 历史，当前仅火山方舟模型、已开启视觉理解的 OpenAI-like 模型，以及支持 OpenAI-like "},{"attributes":{"inlineCode":"true"},"insert":"tool_calls"},{"insert":" / "},{"attributes":{"inlineCode":"true"},"insert":"tool_call_id"},{"insert":" 消息格式的第三方模型支持。不支持的模型即使配置 "},{"attributes":{"inlineCode":"true"},"insert":"LLMConfig.EnableToolCallHistory"},{"insert":"，也不会保留工具调用历史。\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#工作流程","heading":"h2"}},{"insert":"工作流程\n"},{"insert":"Function Calling 的工作流程涉及以下几个核心角色：\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"LLM"},{"insert":"：负责理解用户意图并决策调用哪个函数。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"系统服务"},{"insert":"：作为技术底座，负责接收您的请求、调用 LLM，并将 LLM 的决策（如函数调用指令）通过回调传递给您的应用程序。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"您的应用程序"},{"insert":"：负责实现和执行具体的本地函数（如查询天气）。\n"},{"insert":"整个流程的核心是 “"},{"insert":"LLM 决策，您的代码执行","attributes":{"bold":"true"}},{"insert":"”。具体实现过程如下：\n"},{"insert":" ","attributes":{"image":"true","isPlugin":"true","uuid":"Q14BlBsyUK","src":"https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/9ff6dc371162414fa9e87a8903a53797","loadingStatus":"success","width":"337","height":"675","scale":"0.49925925925925924"}},{"insert":"\n"},{"attributes":{"lmkr":"1","list":"number1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"准备函数并声明：\n"},{"insert":"*","attributes":{"lmkr":"1","list":"indent1","text-indent":"true"}},{"insert":"在客户端应用程序中，定义好具体的本地函数。调用 "},{"attributes":{"inlineCode":"true"},"insert":"StartVoiceChat"},{"insert":" 接口时，向模型声明您已定义的函数。\n"},{"attributes":{"lmkr":"1","list":"number1","start":"2","origin-start":"2"},"insert":"*"},{"insert":"决策与执行：\n"},{"attributes":{"lmkr":"1","list":"number2","start":"1","origin-start":"1"},"insert":"*"},{"insert":"用户向 AI 提出需要外部能力才能完成的请求（例如：“帮我查询上海的天气”）。\n"},{"attributes":{"lmkr":"1","list":"number2","start":"2","origin-start":"2"},"insert":"*"},{"insert":"大模型识别用户意图，决策需要调用哪个函数，并生成相应的调用指令。\n"},{"attributes":{"lmkr":"1","list":"number2","start":"3","origin-start":"3"},"insert":"*"},{"insert":"系统通过回调下发函数调用指令，告知需要执行的函数与入参（如 "},{"attributes":{"inlineCode":"true"},"insert":"location: \"上海\""},{"insert":"）。使用外挂 LLM 时，系统还会先发送一条函数调用通知；Seeduplex 原生 Function Calling 不发送该预通知。\n"},{"attributes":{"lmkr":"1","list":"number2","start":"4","origin-start":"4"},"insert":"*"},{"insert":"您的应用程序根据 “调用指令” 执行本地函数，获取执行结果并回传给系统。\n"},{"attributes":{"lmkr":"1","list":"number1","start":"3","origin-start":"3"},"insert":"*"},{"insert":"AI 回复：\n"},{"insert":"*","attributes":{"lmkr":"1","list":"indent1","text-indent":"true"}},{"insert":"系统在收到上报的函数执行结果后如何向用户播报，会根据您选择的回传方式进行处理：\n"},{"attributes":{"lmkr":"1","list":"bullet2","start":"1","origin-start":"1"},"insert":"*"},{"insert":"方式 1（直接播放）：\n"},{"attributes":{"lmkr":"1","list":"indent2","text-indent":"true"},"insert":"*"},{"insert":"将函数执行结果直接通过 TTS 转化为语音播放。适用于结果无需润色、或回复内容较长的场景。\n"},{"attributes":{"lmkr":"1","list":"bullet2","start":"1","origin-start":"1"},"insert":"*"},{"insert":"方式 2（经 LLM 处理后播放）：\n"},{"attributes":{"lmkr":"1","list":"indent2","text-indent":"true"},"insert":"*"},{"insert":"将函数执行结果返回给 LLM，由模型进行总结、润色后再通过 TTS 播放。适用于需要对回复进行二次处理的场景。\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#942e1d9a","heading":"h2"}},{"insert":"准备工作\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#准备函数","heading":"h3"}},{"insert":"准备函数\n"},{"insert":"您需要在业务应用程序中，实现需要 AI 调用的具体函数的逻辑。Function Calling 的作用是让模型 “决策” 调用哪个函数并传入什么参数，而函数的执行则完全由您的程序负责。\n"},{"insert":"例如，如果您想实现天气查询，您需要自己实现一个能查询并返回天气信息的函数。\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#确定实现方式","heading":"h3"}},{"insert":"确定实现方式\n"},{"insert":"客户端和服务端可以同时配置，两者回调相互独立。您可以根据实际需求，选择在任一端处理回调逻辑，并忽略另一端即可。\n"},{"insert":" ","attributes":{"zoneType":"Z","aceTable":"rsry744hnudniesh55np1mz1zmz2swctfs cskcck2ke3mn8n1ss7no7dbhw0b4cuj7vb"}},{"insert":"\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#若为第三方大模型","heading":"h3"}},{"insert":"若为第三方大模型\n"},{"insert":"如果您使用第三方 LLM 接入，无论流式或非流式，最终响应必须包含 "},{"insert":"tool_calls","attributes":{"inlineCode":"true"}},{"insert":" 字段，且 "},{"insert":"finish_reason","attributes":{"inlineCode":"true"}},{"insert":" 必须设为 "},{"insert":"\"tool_calls\"","attributes":{"inlineCode":"true"}},{"insert":"。\n"},{"insert":"流式响应示例：","attributes":{"bold":"true"}},{"insert":"\n"},{"insert":" ","attributes":{"type":"codeblock","language":"JSON","zoneId":"pk8Gls3OIh","wrap":"true"}},{"insert":"\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#seeduplex-function-calling","heading":"h2"}},{"insert":"使用 Seeduplex 原生 Function Calling\n"},{"insert":"本节介绍服务端从零接入 Seeduplex 原生 Function Calling 的完整流程。业务函数由您的服务执行，Seeduplex 只负责判断是否调用、选择函数、生成参数，以及根据函数结果组织最终回答。\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#实现业务函数","heading":"h3"}},{"insert":"实现业务函数\n"},{"insert":"先在业务服务中实现准备开放给模型的函数。例如，天气查询函数接收城市名称，返回实时天气数据。函数名和参数需要与后续 "},{"insert":"session.tools","attributes":{"inlineCode":"true"}},{"insert":" 中的声明保持一致。\n"},{"insert":"建议业务服务同时完成以下处理：\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"校验函数名，只允许调用白名单内的函数。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"按 JSON Schema 校验参数，不直接信任模型生成的参数。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"为外部服务调用设置超时、重试和幂等策略。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"将执行失败转换为模型可理解的结果，例如 "},{"attributes":{"inlineCode":"true"},"insert":"查询天气失败，请稍后重试"},{"insert":"，并按正常结果回传。\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#启动对话并声明工具","heading":"h3"}},{"insert":"启动对话并声明工具\n"},{"insert":"调用 "},{"insert":"StartVoiceChat","attributes":{"inlineCode":"true"}},{"insert":" 时完成以下配置：\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"将 "},{"attributes":{"inlineCode":"true"},"insert":"S2SConfig.Provider"},{"insert":" 设为 "},{"attributes":{"inlineCode":"true"},"insert":"volcano_duplex"},{"insert":"。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"将 "},{"attributes":{"inlineCode":"true"},"insert":"S2SConfig.OutputMode"},{"insert":" 设为 "},{"attributes":{"inlineCode":"true"},"insert":"0"},{"insert":"。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"在 "},{"attributes":{"inlineCode":"true"},"insert":"S2SConfig.ProviderParams.session.tools"},{"insert":" 中声明工具。Seeduplex 工具结构中的 "},{"attributes":{"inlineCode":"true"},"insert":"name"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"description"},{"insert":" 和 "},{"attributes":{"inlineCode":"true"},"insert":"parameters"},{"insert":" 直接位于工具对象中，不需要再嵌套一层 "},{"attributes":{"inlineCode":"true"},"insert":"function"},{"insert":"。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"配置 "},{"attributes":{"inlineCode":"true"},"insert":"FunctionCallingConfig.ServerMessageUrl"},{"insert":" 和 "},{"attributes":{"inlineCode":"true"},"insert":"ServerMessageSignature"},{"insert":"，用于接收工具调用指令并校验来源。\n"},{"insert":" ","attributes":{"type":"codeblock","language":"JSON","zoneId":"hfIDhIIQhE","wrap":"true"}},{"insert":"\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#接收并解析工具调用","heading":"h3"}},{"insert":"接收并解析工具调用\n"},{"insert":"用户提出需要外部能力的问题后，Seeduplex 可能生成一个或多个工具调用。RTC 会向 "},{"insert":"ServerMessageUrl","attributes":{"inlineCode":"true"}},{"insert":" 发送 HTTP POST 请求，消息体的 "},{"insert":"Type","attributes":{"inlineCode":"true"}},{"insert":" 为 "},{"insert":"tool_calls","attributes":{"inlineCode":"true"}},{"insert":"。\n"},{"insert":" ","attributes":{"type":"codeblock","language":"JSON","zoneId":"N5jGH5dOhC","wrap":"true"}},{"insert":"\n"},{"insert":"按以下顺序处理回调：\n"},{"attributes":{"lmkr":"1","list":"number1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"比对 "},{"attributes":{"inlineCode":"true"},"insert":"Signature"},{"insert":" 与 "},{"attributes":{"inlineCode":"true"},"insert":"ServerMessageSignature"},{"insert":"，不一致时拒绝请求。\n"},{"attributes":{"lmkr":"1","list":"number1","start":"2","origin-start":"2"},"insert":"*"},{"insert":"将外层 "},{"attributes":{"inlineCode":"true"},"insert":"Message"},{"insert":" 解析为工具调用数组。\n"},{"attributes":{"lmkr":"1","list":"number1","start":"3","origin-start":"3"},"insert":"*"},{"insert":"遍历数组。记录每项的 "},{"attributes":{"inlineCode":"true"},"insert":"id"},{"insert":"，根据 "},{"attributes":{"inlineCode":"true"},"insert":"function.name"},{"insert":" 路由到业务函数。\n"},{"attributes":{"lmkr":"1","list":"number1","start":"4","origin-start":"4"},"insert":"*"},{"insert":"将 "},{"attributes":{"inlineCode":"true"},"insert":"function.arguments"},{"insert":" 再解析一次，得到参数对象，然后校验参数并执行函数。\n"},{"insert":"*","attributes":{"lmkr":"1","tips":"{\"type\":\"warning\",\"isTitle\":true}"}},{"insert":"注意\n"},{"insert":"*","attributes":{"lmkr":"1","tips":"{\"type\":\"warning\"}"}},{"insert":"Seeduplex 原生 Function Calling 不发送 "},{"insert":"Type=information","attributes":{"inlineCode":"true"}},{"insert":" 的函数调用预通知。服务端应以 "},{"insert":"Type=tool_calls","attributes":{"inlineCode":"true"}},{"insert":" 作为开始执行函数的依据。\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#回传每个工具的执行结果","heading":"h3"}},{"insert":"回传每个工具的执行结果\n"},{"insert":"每个工具执行完成后，调用 "},{"insert":"UpdateVoiceChat","attributes":{"inlineCode":"true"}},{"insert":" 回传结果。"},{"insert":"AppId","attributes":{"inlineCode":"true"}},{"insert":"、"},{"insert":"RoomId","attributes":{"inlineCode":"true"}},{"insert":" 和 "},{"insert":"TaskId","attributes":{"inlineCode":"true"}},{"insert":" 必须与启动任务时传给 "},{"insert":"StartVoiceChat","attributes":{"inlineCode":"true"}},{"insert":" 的值一致。回调消息中的 "},{"insert":"TaskID","attributes":{"inlineCode":"true"}},{"insert":" 只用于标识本次 FC 链路，不可作为 "},{"insert":"UpdateVoiceChat.TaskId","attributes":{"inlineCode":"true"}},{"insert":"。\n"},{"insert":" ","attributes":{"type":"codeblock","language":"JSON","zoneId":"nTFSBJ2IDX","wrap":"true"}},{"insert":"\n"},{"insert":"Message","attributes":{"inlineCode":"true"}},{"insert":" 是 JSON 字符串，其中：\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"inlineCode":"true"},"insert":"ToolCallID"},{"insert":"：填写工具调用指令中的 "},{"attributes":{"inlineCode":"true"},"insert":"id"},{"insert":"，必须完全一致。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"inlineCode":"true"},"insert":"Content"},{"insert":"：填写工具执行结果。建议返回简洁、完整且便于模型理解的文本；也可以返回序列化后的结构化数据。\n"},{"insert":"一次 "},{"insert":"tool_calls","attributes":{"inlineCode":"true"}},{"insert":" 回调可能包含多个工具。此时需要保存整组调用，为每个 "},{"insert":"id","attributes":{"inlineCode":"true"}},{"insert":" 分别执行函数并分别调用一次 "},{"insert":"UpdateVoiceChat","attributes":{"inlineCode":"true"}},{"insert":"。RTC 收齐本轮全部工具结果后，才会统一回传给 Seeduplex；模型随后继续生成并播报最终回答。\n"},{"insert":"如果模型根据结果再次发起工具调用，重复“接收回调、执行函数、回传结果”的过程，直到模型直接生成回答。\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#服务端实现","heading":"h2"}},{"insert":"通过服务端实现外挂 LLM Function Calling\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#_1-开启-function-calling-功能调","heading":"h3"}},{"insert":"步骤 1：声明函数并配置回调\n"},{"insert":"在调用 "},{"insert":"StartVoiceChat","attributes":{"inlineCode":"true"}},{"insert":" 接口时，需提供以下配置：\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"inlineCode":"true"},"insert":"LLMConfig.Tools"},{"insert":"：声明您需要模型调用的所有函数。请确保此处声明的每一个函数，您都已在自己的业务代码中实现了对应的逻辑。其中，"},{"attributes":{"inlineCode":"true"},"insert":"parameters"},{"insert":" 需严格遵守JSON Schema规范，详细可参见"},{"attributes":{"hyperlink":"{\"href\":\"https://www.volcengine.com/docs/82379/1262342?lang=zh#4d571c97\",\"linkId\":\"Z7xUTSMDtF\"}"},"insert":"工具函数参数构造规范"},{"insert":"。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"inlineCode":"true"},"insert":"LLMConfig.EnableToolCallHistory"},{"insert":"：可选。设为 "},{"attributes":{"inlineCode":"true"},"insert":"true"},{"insert":" 后，若某轮触发 Function Calling，系统会将该轮的工具调用指令和工具返回结果随该轮历史一起保留，便于模型基于此前工具调用结果继续对话；默认值为 "},{"attributes":{"inlineCode":"true"},"insert":"false"},{"insert":"。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"inlineCode":"true"},"insert":"FunctionCallingConfig"},{"insert":"：\n"},{"attributes":{"lmkr":"1","list":"bullet2","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"inlineCode":"true"},"insert":"ServerMessageUrl"},{"insert":"：您的后端服务地址，用于接收函数调用指令。必须是公网可访问的 URL，且能正确处理无 "},{"attributes":{"inlineCode":"true"},"insert":"Content-Type"},{"insert":" 的 HTTP POST 请求。\n"},{"insert":"*","attributes":{"text-indent":"true","wrapperIndent":"2","lmkr":"1","tips":"{\"type\":\"default\",\"isTitle\":true}"}},{"insert":"说明\n"},{"insert":"*","attributes":{"text-indent":"true","wrapperIndent":"2","lmkr":"1","tips":"{\"type\":\"default\"}"}},{"insert":"对于嵌入式/IoT 等场景，如需在 FC 回调中识别对应的会话或设备，可将业务标识（如 "},{"insert":"TaskId","attributes":{"inlineCode":"true"}},{"insert":"、"},{"insert":"DeviceId","attributes":{"inlineCode":"true"}},{"insert":"）作为 query 参数附加在 "},{"insert":"ServerMessageUrl","attributes":{"inlineCode":"true"}},{"insert":" 中，例如："},{"insert":"\"ServerMessageUrl\": \"https://your-server.com/fc_callback?taskId=yourTaskId&deviceId=xxx\"","attributes":{"inlineCode":"true"}},{"insert":"，服务端直接从请求 URL 的 query 参数中读取即可。\n"},{"attributes":{"lmkr":"1","list":"bullet2","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"inlineCode":"true"},"insert":"ServerMessageSignature"},{"insert":": 自定义认证密钥。此字符串会在回调请求中原样返回，供您在服务端进行来源合法性校验。\n"},{"insert":"*","attributes":{"lmkr":"1","blockquote":"true"}},{"insert":"以下示例展示了如何声明一个名为 "},{"attributes":{"inlineCode":"true"},"insert":"get_current_weather"},{"insert":" 的天气查询函数，并配置回调接收地址。完整参数参见接口文档 "},{"attributes":{"hyperlink":"{\"href\":\"/docs/6348/2123348\",\"linkId\":\"UkwlYLklW4\"}"},"insert":"StartVoiceChat（2025-06-01）"},{"insert":"。\n"},{"insert":" ","attributes":{"type":"codeblock","language":"JSON","zoneId":"lY2clbW21B","wrap":"true"}},{"insert":"\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#步骤-2：处理回调消息","heading":"h3"}},{"insert":"步骤 2：处理回调消息\n"},{"insert":"当外挂 LLM 识别到工具调用意图时，您配置的服务器 URL 会先后收到 2 条与 FC 相关的消息。您需要通过消息体的 "},{"insert":"Type","attributes":{"inlineCode":"true"}},{"insert":" 字段区分这两种消息。Seeduplex 原生 Function Calling 的回调流程参见"},{"insert":"使用 Seeduplex 原生 Function Calling","attributes":{"hyperlink":"{\"href\":\"#seeduplex-function-calling\",\"linkId\":\"S14rpDhRfn\"}"}},{"insert":"。\n"},{"attributes":{"lmkr":"1","list":"number1","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"（可选）播放安抚语"},{"insert":"。\n"},{"insert":"*","attributes":{"lmkr":"1","list":"indent1","text-indent":"true"}},{"insert":"函数执行需要一定时间。在收到函数调用通知后，AI 回复前，可插播安抚语以提升用户体验。\n"},{"attributes":{"lmkr":"1","list":"number2","start":"1","origin-start":"1"},"insert":"*"},{"insert":"获取并解析函数调用通知。\n"},{"attributes":{"lmkr":"1","list":"indent2","text-indent":"true"},"insert":"*"},{"insert":"当 AI 识别到工具调用意图时，你会先收到函数调用通知消息（"},{"attributes":{"inlineCode":"true"},"insert":"Type"},{"insert":" 为 "},{"attributes":{"inlineCode":"true"},"insert":"information"},{"insert":"）。通知消息示例如下：\n"},{"attributes":{"lmkr":"1","list":"indent2","text-indent":"true"},"insert":"*"},{"insert":" ","attributes":{"type":"codeblock","language":"JSON","zoneId":"qgHi0BHbBF","wrap":"true"}},{"insert":"\n"},{"attributes":{"lmkr":"1","list":"indent2","text-indent":"true"},"insert":"*"},{"attributes":{"inlineCode":"true"},"insert":"Message"},{"insert":" 是一个转义 JSON 字符串，使用前需要解析。具体内容如下：\n"},{"attributes":{"lmkr":"1","list":"indent2","text-indent":"true"},"insert":"*"},{"attributes":{"zoneType":"Z","aceTable":"rs8lr5h2nou2wyds9ut6wctqh681wzgd0z cs0l1uj52f3eyrbdj4q0rz8ojdpkg5y8td"},"insert":" "},{"insert":"\n"},{"attributes":{"lmkr":"1","list":"number2","start":"2","origin-start":"2"},"insert":"*"},{"insert":"播放安抚语。\n"},{"attributes":{"lmkr":"1","list":"indent2","text-indent":"true"},"insert":"*"},{"insert":"调用 "},{"attributes":{"inlineCode":"true"},"insert":"UpdateVoiceChat"},{"insert":" 接口播放安抚语，以提升用户体验。\n"},{"attributes":{"lmkr":"1","blockquote":"true","list":"indent2","text-indent":"true"},"insert":"*"},{"insert":"如果安抚语还未播放完，函数结果就已返回，系统会等待安抚语结束后再播报结果。\n"},{"attributes":{"lmkr":"1","list":"indent2","text-indent":"true"},"insert":"*"},{"insert":" ","attributes":{"type":"codeblock","language":"JSON","zoneId":"xXJfdq1Ikr","wrap":"true"}},{"insert":"\n"},{"attributes":{"lmkr":"1","list":"number1","start":"2","origin-start":"2"},"insert":"*"},{"insert":"获取并解析函数调用指令。\n"},{"insert":"*","attributes":{"lmkr":"1","list":"indent1","text-indent":"true"}},{"insert":"紧接着您会收到函数调用指令消息（"},{"attributes":{"inlineCode":"true"},"insert":"Type"},{"insert":" 为 "},{"attributes":{"inlineCode":"true"},"insert":"tool_calls"},{"insert":"），您需要先解析外层 "},{"attributes":{"inlineCode":"true"},"insert":"Message"},{"insert":" 字段，再解析内层 "},{"attributes":{"inlineCode":"true"},"insert":"arguments"},{"insert":" 字段，来获取最终的函数名称和执行参数。\n"},{"insert":"*","attributes":{"lmkr":"1","list":"indent1","text-indent":"true"}},{"insert":"消息示例如下：\n"},{"insert":"*","attributes":{"lmkr":"1","list":"indent1","text-indent":"true"}},{"insert":" ","attributes":{"type":"codeblock","language":"JSON","zoneId":"HBIX3uD3NM","wrap":"true"}},{"insert":"\n"},{"insert":"*","attributes":{"lmkr":"1","list":"indent1","text-indent":"true"}},{"attributes":{"inlineCode":"true"},"insert":"Message"},{"insert":" 字段是一个转义 JSON 字符串，包含内容如下：\n"},{"insert":"*","attributes":{"lmkr":"1","list":"indent1","text-indent":"true"}},{"attributes":{"zoneType":"Z","aceTable":"rsshcithor7ngje9nbvatpszmcodttsi7p cs8877lfir5bbokw1t1c5za7jnqrlov5c6"},"insert":" "},{"insert":"\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#步骤-3：执行外部函数","heading":"h3"}},{"insert":"步骤 3：执行外部函数\n"},{"insert":"获取调用指令信息后，您需要在自己的应用程序中实现：\n"},{"attributes":{"lmkr":"1","list":"number1","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"路由到函数"},{"insert":"：根据 "},{"attributes":{"inlineCode":"true"},"insert":"function.name"},{"insert":" 的值（例如 "},{"attributes":{"inlineCode":"true"},"insert":"\"get_current_weather\""},{"insert":"），调用您在自己代码中已实现的相应函数。\n"},{"attributes":{"lmkr":"1","list":"number1","start":"2","origin-start":"2"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"传递参数"},{"insert":"：将上一步解析出的 "},{"attributes":{"inlineCode":"true"},"insert":"function.arguments"},{"insert":" 中的参数作为入参传递给您的函数。\n"},{"attributes":{"lmkr":"1","list":"number1","start":"3","origin-start":"3"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"获取返回值"},{"insert":"：执行您的函数，并获取其返回结果，这个结果将在下一步中回传。\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#步骤-4：回传函数结果","heading":"h3"}},{"insert":"步骤 4：回传函数结果\n"},{"insert":"调用 "},{"insert":"UpdateVoiceChat","attributes":{"inlineCode":"true"}},{"insert":" 接口将函数执行结果回传给系统，并由 AI 播放。\n"},{"insert":"*","attributes":{"lmkr":"1","blockquote":"true"}},{"insert":"完整参数及说明，参见对应的接口文档："},{"attributes":{"hyperlink":"{\"href\":\"/docs/6348/2123350\",\"linkId\":\"St9qwh6KQJ\"}"},"insert":"UpdateVoiceChat（2025-06-01）"},{"insert":"、"},{"attributes":{"hyperlink":"{\"href\":\"/docs/6348/2011497\",\"linkId\":\"WuA28WzONL\"}"},"insert":"UpdateVoiceChat（2024-12-01）"},{"insert":"。\n"},{"insert":" ","attributes":{"tabsZoneId":"GByVJtA8YJ","doc-tabs":"true","tabs":"true"}},{"insert":"\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#客户端实现","heading":"h2"}},{"insert":"通过客户端实现外挂 LLM Function Calling\n"},{"insert":"本节适用于通过 "},{"insert":"LLMConfig.Tools","attributes":{"inlineCode":"true"}},{"insert":" 使用外挂 LLM Function Calling 的场景。客户端（如 App、Web 页面）接收 Function Calling 的通知和指令，在本地执行函数后将结果发回系统。Seeduplex 原生 Function Calling 请按"},{"insert":"使用 Seeduplex 原生 Function Calling","attributes":{"hyperlink":"{\"href\":\"#seeduplex-function-calling\",\"linkId\":\"Q8QPftt8Zh\"}"}},{"insert":"中的服务端流程接入。\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#步骤-1：声明函数","heading":"h3"}},{"insert":"步骤 1：声明函数\n"},{"insert":"调用 "},{"insert":"StartVoiceChat","attributes":{"inlineCode":"true"}},{"insert":" 接口，配置 "},{"insert":"LLMConfig.Tools","attributes":{"inlineCode":"true"}},{"insert":" 字段来声明您要调用的函数（确保所有函数均已在业务代码中实现）。其中，"},{"insert":"parameters","attributes":{"inlineCode":"true"}},{"insert":" 需严格遵守JSON Schema规范，详细可参见"},{"insert":"工具函数参数构造规范","attributes":{"hyperlink":"{\"href\":\"https://www.volcengine.com/docs/82379/1262342?lang=zh#4d571c97\",\"linkId\":\"CIHSbwrsym\"}"}},{"insert":"。\n"},{"insert":"如需让模型在后续轮次继续参考此前的工具调用结果，可同时配置 "},{"insert":"LLMConfig.EnableToolCallHistory: true","attributes":{"inlineCode":"true"}},{"insert":"。该参数默认值为 "},{"insert":"false","attributes":{"inlineCode":"true"}},{"insert":"。\n"},{"insert":"*","attributes":{"lmkr":"1","blockquote":"true"}},{"insert":"以下示例展示了如何声明一个名为 "},{"attributes":{"inlineCode":"true"},"insert":"get_current_weather"},{"insert":" 的天气查询函数。完整参数参见接口文档 "},{"attributes":{"hyperlink":"{\"href\":\"/docs/6348/2123348\",\"linkId\":\"sx3dD77DbY\"}"},"insert":"StartVoiceChat（2025-06-01）"},{"insert":"。\n"},{"insert":" ","attributes":{"type":"codeblock","language":"JSON","zoneId":"h5PQgB8Lsy","wrap":"true"}},{"insert":"\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#步骤-2：监听回调并处理","heading":"h3"}},{"insert":"步骤 2：监听回调并处理\n"},{"attributes":{"lmkr":"1","list":"number1","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"在客户端监听"},{"insert":" "},{"attributes":{"hyperlink":"{\"href\":\"/docs/6348/70081#IRTCRoomEventHandler-onroombinarymessagereceived\",\"linkId\":\"XXSd7D8hdN\"}"},"insert":"onRoomBinaryMessageReceived"},{"insert":" "},{"attributes":{"bold":"true"},"insert":"回调"},{"insert":"。\n"},{"insert":"*","attributes":{"lmkr":"1","list":"indent1","text-indent":"true"}},{"insert":"当 AI 识别到工具调用意图时，该回调会被先后触发两次，您会收到两条与 Function Calling 相关的二进制消息。您需要解析消息头部的 "},{"attributes":{"inlineCode":"true"},"insert":"magic number"},{"insert":" 来识别并处理这两条消息。\n"},{"attributes":{"lmkr":"1","list":"number1","start":"2","origin-start":"2"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"（可选）播放安抚语"},{"insert":"。\n"},{"insert":"*","attributes":{"lmkr":"1","list":"indent1","text-indent":"true"}},{"insert":"函数执行需要一定时间。在收到函数调用通知后，AI 回复前，可插播安抚语以提升用户体验。\n"},{"attributes":{"lmkr":"1","list":"number2","start":"1","origin-start":"1"},"insert":"*"},{"insert":"获取函数调用通知。\n"},{"attributes":{"lmkr":"1","list":"indent2","text-indent":"true"},"insert":"*"},{"insert":"当 AI 识别到工具调用意图时，你先会收到函数调用通知消息 "},{"attributes":{"inlineCode":"true"},"insert":"message"},{"insert":"（magic number 为 info），该消息为二进制格式，收到消息后需解析该字段。"},{"attributes":{"inlineCode":"true"},"insert":"message"},{"insert":" 格式和解析示例如下：\n"},{"attributes":{"lmkr":"1","list":"indent2","text-indent":"true"},"insert":"*"},{"insert":" ","attributes":{"image":"true","isPlugin":"true","uuid":"eawgjS6IdW","src":"https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/6d518e9d23d046168f5c58e3aac02586","loadingStatus":"success","width":"252","height":"216","scale":"1.1666666666666667"}},{"insert":"\n"},{"attributes":{"lmkr":"1","list":"indent2","text-indent":"true"},"insert":"*"},{"attributes":{"zoneType":"Z","aceTable":"rsmgt628p0rqt5yvlahafsw0mw71r94ygr cskazyldnlyvv2mhdq7lz7a1envyj6i61a"},"insert":" "},{"insert":"\n"},{"insert":"*","attributes":{"lmkr":"1","list":"indent1","text-indent":"true"}},{"attributes":{"inlineCode":"true"},"insert":"message"},{"insert":" 解析示例：\n"},{"insert":"*","attributes":{"lmkr":"1","list":"indent1","text-indent":"true"}},{"insert":" ","attributes":{"tabsZoneId":"VFGHHoDqUW","doc-tabs":"true","tabs":"true"}},{"insert":"\n"},{"attributes":{"lmkr":"1","list":"number2","start":"2","origin-start":"2"},"insert":"*"},{"insert":"（可选）播放安抚语。\n"},{"attributes":{"lmkr":"1","list":"indent2","text-indent":"true"},"insert":"*"},{"insert":"函数执行需要一定时间。在收到函数调用通知后，可立即调用 "},{"attributes":{"hyperlink":"{\"href\":\"/docs/6348/70080#RTSRoom-senduserbinarymessage\",\"linkId\":\"LpGQEBGeJI\"}"},"insert":"sendUserBinaryMessage"},{"insert":" 接口发送一条控制消息，让 AI 播放安抚语。\n"},{"attributes":{"lmkr":"1","blockquote":"true","list":"indent2","text-indent":"true"},"insert":"*"},{"insert":"如果安抚语还未播放完，函数结果就已返回，系统会等待安抚语结束后再播报结果。\n"},{"attributes":{"lmkr":"1","list":"bullet3","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"inlineCode":"true"},"insert":"userId"},{"insert":"：AI 的标识 ID（对应 "},{"attributes":{"inlineCode":"true"},"insert":"AgentConfig.UserId"},{"insert":"）。\n"},{"attributes":{"lmkr":"1","list":"bullet3","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"inlineCode":"true"},"insert":"buffer"},{"insert":"：传入安抚语内容。需遵循以下格式：\n"},{"attributes":{"lmkr":"1","list":"indent3","text-indent":"true"},"insert":"*"},{"insert":" ","attributes":{"image":"true","isPlugin":"true","uuid":"AQHUpE2vDX","src":"https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_6938c15a149ab250b2dd784df71d6190.jpg","loadingStatus":"success","width":"365","height":"313","scale":"1.1661341853035143"}},{"insert":"\n"},{"attributes":{"lmkr":"1","list":"indent3","text-indent":"true"},"insert":"*"},{"attributes":{"zoneType":"Z","aceTable":"rswaavjhvc3t6tn9d11pik9wd7jd6otvz2 csu8qa0m0d6gdsafbdh2sucrk0f754qmft"},"insert":" "},{"insert":"\n"},{"insert":"*","attributes":{"lmkr":"1","list":"indent1","text-indent":"true"}},{"insert":"安抚语传入示例：\n"},{"insert":"*","attributes":{"lmkr":"1","list":"indent1","text-indent":"true"}},{"insert":" ","attributes":{"tabsZoneId":"B6GUwcARgU","doc-tabs":"true","tabs":"true"}},{"insert":"\n"},{"attributes":{"lmkr":"1","list":"number1","start":"3","origin-start":"3"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"获取函数调用指令"},{"insert":"。\n"},{"insert":"*","attributes":{"lmkr":"1","list":"indent1","text-indent":"true"}},{"insert":"收到调用通知后，您会收到函数调用指令消息（"},{"attributes":{"inlineCode":"true"},"insert":"magic number"},{"insert":" 为 "},{"attributes":{"inlineCode":"true"},"insert":"tool"},{"insert":"）。您需要解析 "},{"attributes":{"inlineCode":"true"},"insert":"message"},{"insert":"，获取执行函数所需的具体参数。"},{"attributes":{"inlineCode":"true"},"insert":"message"},{"insert":" 格式与解析示例如下：\n"},{"insert":"*","attributes":{"lmkr":"1","list":"indent1","text-indent":"true"}},{"attributes":{"inlineCode":"true"},"insert":"message"},{"insert":" 格式：\n"},{"insert":"*","attributes":{"lmkr":"1","list":"indent1","text-indent":"true"}},{"insert":" ","attributes":{"image":"true","isPlugin":"true","uuid":"js6XGBggtt","src":"https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/a8ec9934817d4348bf3b1eba21194d91","loadingStatus":"success","width":"365","height":"313","scale":"1.1661341853035143"}},{"insert":"\n"},{"insert":"*","attributes":{"lmkr":"1","list":"indent1","text-indent":"true"}},{"attributes":{"zoneType":"Z","aceTable":"rsezmohlw6chz5skyzdcwt5ser6c6mawop csznkybmn5dod9i4by3otwagn0zkw119t5"},"insert":" "},{"insert":"\n"},{"insert":"*","attributes":{"lmkr":"1","list":"indent1","text-indent":"true"}},{"attributes":{"inlineCode":"true"},"insert":"message"},{"insert":" 解析示例：\n"},{"insert":"*","attributes":{"lmkr":"1","list":"indent1","text-indent":"true"}},{"insert":" ","attributes":{"tabsZoneId":"LLI9a1vB7B","doc-tabs":"true","tabs":"true"}},{"insert":"\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#步骤-3：执行外部函数-1","heading":"h3"}},{"insert":"步骤 3：执行外部函数\n"},{"insert":"在成功解析 "},{"insert":"tool","attributes":{"inlineCode":"true"}},{"insert":" 消息后，您需要在自己的业务逻辑中实现：\n"},{"attributes":{"lmkr":"1","list":"number1","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"路由到函数"},{"insert":"：根据 "},{"attributes":{"inlineCode":"true"},"insert":"function.name"},{"insert":" 的值（例如 "},{"attributes":{"inlineCode":"true"},"insert":"\"get_current_weather\""},{"insert":"），调用您在自己代码中已实现的相应函数。\n"},{"attributes":{"lmkr":"1","list":"number1","start":"2","origin-start":"2"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"传递参数"},{"insert":"：将上一步解析出的 "},{"attributes":{"inlineCode":"true"},"insert":"function.arguments"},{"insert":" 中的参数作为入参传递给您的函数。\n"},{"attributes":{"lmkr":"1","list":"number1","start":"3","origin-start":"3"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"获取返回值"},{"insert":"：执行您的函数，并获取其返回结果，这个结果将在下一步中回传。\n"},{"insert":"*","attributes":{"lmkr":"1","tips":"{\"type\":\"warning\",\"isTitle\":true}"}},{"insert":"说明\n"},{"insert":"*","attributes":{"lmkr":"1","tips":"{\"type\":\"warning\"}"}},{"insert":"function.arguments","attributes":{"inlineCode":"true"}},{"insert":" 字段本身是一个字符串，其内容是一个 JSON 对象。在调用您的本地函数之前，您必须对这个字符串再进行一次 JSON 解析，才能获得真正的参数。\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#步骤-4：回传函数结果-1","heading":"h3"}},{"insert":"步骤 4：回传函数结果\n"},{"insert":"调用 "},{"insert":"sendUserBinaryMessage","attributes":{"hyperlink":"{\"href\":\"/docs/6348/70080#RTSRoom-senduserbinarymessage\",\"linkId\":\"VL8fafEcml\"}"}},{"insert":" 接口将函数执行结果回传给系统，并由 AI 播放。\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#方式-1：经-llm-处理后播放","heading":"h4"}},{"insert":"方式 1：经 LLM 处理后播放\n"},{"insert":"将函数返回的原始数据传回给 LLM 处理后再播放。适用于需要总结、润色等二次处理场景。\n"},{"insert":"调用 "},{"insert":"sendUserBinaryMessage","attributes":{"hyperlink":"{\"href\":\"/docs/6348/70080#RTSRoom-senduserbinarymessage\",\"linkId\":\"MEbblfM15X\"}"}},{"insert":" 接口，传入函数的执行结果交由 LLM 处理。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"inlineCode":"true"},"insert":"userId"},{"insert":"：AI 的标识 ID（对应 "},{"attributes":{"inlineCode":"true"},"insert":"AgentConfig.UserId"},{"insert":"）。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"inlineCode":"true"},"insert":"buffer"},{"insert":"：\n"},{"attributes":{"lmkr":"1","list":"bullet2","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"大小限制"},{"insert":"：该接口默认单次发送的二进制消息内容包大小为 1 KB，如需更大的包传递（最大不可超过 64 KB），需在控制台"},{"attributes":{"hyperlink":"{\"href\":\"https://console.volcengine.com/rtc/cloudRTC?tab=RTSMode\",\"linkId\":\"WmrkYhKdYI\"}"},"insert":"启用 RTS 高级功能"},{"insert":"。\n"},{"insert":"*","attributes":{"text-indent":"true","wrapperIndent":"2","lmkr":"1","tips":"{\"type\":\"warning\",\"isTitle\":true}"}},{"insert":"说明\n"},{"insert":"*","attributes":{"text-indent":"true","wrapperIndent":"2","lmkr":"1","tips":"{\"type\":\"warning\"}"}},{"insert":"若在 SDK 运行期间开启了该功能，则必须重新初始化引擎，配置才能生效。\n"},{"attributes":{"lmkr":"1","list":"bullet2","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"消息格式"},{"insert":"：\n"},{"attributes":{"lmkr":"1","list":"indent2","text-indent":"true"},"insert":"*"},{"insert":" ","attributes":{"image":"true","isPlugin":"true","uuid":"WP2AgJbCzw","src":"https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_da013d2aabd3d8c6bdcf225963c927bf.jpg","loadingStatus":"success","width":"309","height":"265","scale":"1.1660377358490566"}},{"insert":"\n"},{"attributes":{"lmkr":"1","list":"indent2","text-indent":"true"},"insert":"*"},{"attributes":{"zoneType":"Z","aceTable":"rsrwz6i3sy4s298rqpump1i7lzdss8qvfa cshgnb3frv1gwstzbdsesh7pz8mwupd0qq"},"insert":" "},{"insert":"\n"},{"attributes":{"lmkr":"1","list":"indent2","text-indent":"true"},"insert":"*"},{"insert":"你可参看以下示例代码，回传函数调用的结果信息并播放：\n"},{"attributes":{"lmkr":"1","list":"indent2","text-indent":"true"},"insert":"*"},{"insert":" ","attributes":{"tabsZoneId":"WjkivGNbOD","doc-tabs":"true","tabs":"true"}},{"insert":"\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#方式-2：直接播放（不经-llm-处理）","heading":"h4"}},{"insert":"方式 2：直接播放（不经 LLM 处理）\n"},{"insert":"将函数原始结果直接通过 TTS 播放。适用于返回结果无需处理或回复的句子较长需降低延迟等场景。\n"},{"insert":"调用 "},{"insert":"sendUserBinaryMessage","attributes":{"hyperlink":"{\"href\":\"/docs/6348/70080#RTSRoom-senduserbinarymessage\",\"linkId\":\"PxFyiJ997q\"}"}},{"insert":" 接口，设置以下参数传入函数调用的结果并播放：\n"},{"insert":"*","attributes":{"lmkr":"1","tips":"{\"type\":\"warning\",\"isTitle\":true}"}},{"insert":"说明\n"},{"insert":"*","attributes":{"lmkr":"1","tips":"{\"type\":\"warning\"}"}},{"insert":"若回复的句子较长，建议先自行将长句切分为多个短句，再分次调用 "},{"insert":"sendUserBinaryMessage","attributes":{"inlineCode":"true"}},{"insert":" 接口，降低延时。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1","tips":"{\"type\":\"warning\"}"},"insert":"*"},{"insert":"切句建议：首个分句按逗号（，）、分号（；）切分；后续分句按句号（。）、问号（？）等完整句子标点切分。避免切分数字中的小数点。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1","tips":"{\"type\":\"warning\"}"},"insert":"*"},{"insert":"切句示例："},{"attributes":{"inlineCode":"true"},"insert":"今天的天气晴朗，"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"温度10-29摄氏度，北风三级。"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"未来七天，天气会保持晴朗。"},{"insert":"\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"inlineCode":"true"},"insert":"userId"},{"insert":"：AI 的标识 ID（对应 "},{"attributes":{"inlineCode":"true"},"insert":"AgentConfig.UserId"},{"insert":"）。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"inlineCode":"true"},"insert":"buffer"},{"insert":"：\n"},{"attributes":{"lmkr":"1","list":"bullet2","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"大小限制"},{"insert":"：该接口默认单次发送的二进制消息内容包大小为 1 KB，如需更大的包传递（最大不可超过 64 KB），需在控制台"},{"attributes":{"hyperlink":"{\"href\":\"https://console.volcengine.com/rtc/cloudRTC?tab=RTSMode\",\"linkId\":\"liK7qnjMi4\"}"},"insert":"启用 RTS 高级功能"},{"insert":"。\n"},{"insert":"*","attributes":{"text-indent":"true","wrapperIndent":"2","lmkr":"1","tips":"{\"type\":\"warning\",\"isTitle\":true}"}},{"insert":"说明\n"},{"insert":"*","attributes":{"text-indent":"true","wrapperIndent":"2","lmkr":"1","tips":"{\"type\":\"warning\"}"}},{"insert":"若在 SDK 运行期间开启了该功能，则必须重新初始化引擎，配置才能生效。\n"},{"attributes":{"lmkr":"1","list":"bullet2","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"消息格式"},{"insert":"：\n"},{"attributes":{"lmkr":"1","list":"indent2","text-indent":"true"},"insert":"*"},{"insert":" ","attributes":{"image":"true","isPlugin":"true","uuid":"kIlRDXNFyu","src":"https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_6938c15a149ab250b2dd784df71d6190.jpg","loadingStatus":"success","width":"310","height":"266","scale":"1.1654135338345866"}},{"insert":"\n"},{"insert":" ","attributes":{"zoneType":"Z","aceTable":"rs5e53u7d06eenpne0uiucfy4lyauud60n cs68ap5h79t03qwp6bv39n94q41rtsuo5m"}},{"insert":"\n"},{"insert":"传入示例：\n"},{"insert":" ","attributes":{"tabsZoneId":"M9x2CAMJK4","doc-tabs":"true","tabs":"true"}},{"insert":"\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#进阶使用与实践","heading":"h2"}},{"insert":"进阶使用与实践\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#多轮函数调用","heading":"h3"}},{"insert":"多轮函数调用\n"},{"insert":"当用户的一句话包含多个有依赖关系的任务时（如“先查会议室，再导航”），大模型会与您的服务进行多轮、串行的交互来逐步完成任务。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"典型示例"},{"insert":"\n"},{"attributes":{"lmkr":"1","list":"bullet2","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"用户提问"},{"insert":"：“帮我查一下我下一场会议的会议室地点，然后导航到那里。”\n"},{"attributes":{"lmkr":"1","list":"bullet2","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"第一轮（获取前提）"},{"insert":"\n"},{"attributes":{"lmkr":"1","list":"number3","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"模型"},{"insert":"：生成第一个指令，调用 "},{"attributes":{"inlineCode":"true"},"insert":"get_next_meeting_info()"},{"insert":"。\n"},{"attributes":{"lmkr":"1","list":"number3","start":"2","origin-start":"2"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"您的服务"},{"insert":"：执行后，必须立即将结果 "},{"attributes":{"inlineCode":"true"},"insert":"{\"room\": \"A 座 301 会议室\"}"},{"insert":" 回传给模型。\n"},{"attributes":{"lmkr":"1","list":"bullet2","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"第二轮（执行依赖动作）"},{"insert":"\n"},{"attributes":{"lmkr":"1","list":"indent2","text-indent":"true"},"insert":"*"},{"insert":"3. "},{"attributes":{"bold":"true"},"insert":"模型"},{"insert":"：收到第一轮的结果“A 座 301 会议室”后，基于此信息发出第二个指令，调用 "},{"attributes":{"inlineCode":"true"},"insert":"start_navigation(destination=\"A 座 301 会议室\")"},{"insert":"。\n"},{"attributes":{"lmkr":"1","list":"indent2","text-indent":"true"},"insert":"*"},{"insert":"4. "},{"attributes":{"bold":"true"},"insert":"您的服务"},{"insert":"：执行后，再次立即将结果 "},{"attributes":{"inlineCode":"true"},"insert":"{\"status\": \"导航已开启\"}"},{"insert":" 回传给模型。\n"},{"attributes":{"lmkr":"1","list":"bullet2","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"结束（总结回复）"},{"insert":"\n"},{"attributes":{"lmkr":"1","list":"bullet3","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"模型"},{"insert":"：确认所有步骤完成，生成最终回复：“到 A 座 301 会议室的导航已经为您开启。”\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"实现方法"},{"insert":"\n"},{"attributes":{"lmkr":"1","list":"number2","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"启动会话"},{"insert":"：调用 "},{"attributes":{"inlineCode":"true"},"insert":"StartVoiceChat"},{"insert":"，并在 "},{"attributes":{"inlineCode":"true"},"insert":"Tools"},{"insert":" 参数中提供所有可能用到的函数。\n"},{"attributes":{"lmkr":"1","list":"number2","start":"2","origin-start":"2"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"接收并执行指令"},{"insert":"：您的后端服务会收到一个 "},{"attributes":{"inlineCode":"true"},"insert":"tool_calls"},{"insert":" 指令。\n"},{"attributes":{"lmkr":"1","list":"number2","start":"3","origin-start":"3"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"执行函数"},{"insert":"：在您的代码中执行对应的函数。\n"},{"attributes":{"lmkr":"1","list":"number2","start":"4","origin-start":"4"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"回填结果"},{"insert":"：将函数的执行结果通过 "},{"attributes":{"inlineCode":"true"},"insert":"UpdateVoiceChat"},{"insert":" 接口回填给大模型服务。\n"},{"attributes":{"lmkr":"1","list":"number2","start":"5","origin-start":"5"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"循环等待"},{"insert":"：大模型会根据您回填的结果，决定是生成下一个函数调用指令，还是生成最终的文本回复。您只需循环重复第 2-4 步，直到不再收到 "},{"attributes":{"inlineCode":"true"},"insert":"tool_calls"},{"insert":" 指令为止。\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#并行函数调用","heading":"h3"}},{"insert":"并行函数调用\n"},{"insert":"当用户的一句话包含多个互相独立的意图时（如“查天气和查股价”），您可以使用该功能，使大模型能够一次性返回多个函数调用指令，供您并发执行以提升效率。\n"},{"insert":"*","attributes":{"lmkr":"1","tips":"{\"type\":\"warning\",\"isTitle\":true}"}},{"insert":"说明\n"},{"insert":"*","attributes":{"lmkr":"1","tips":"{\"type\":\"warning\"}"}},{"insert":"请确保你使用的模型支持该能力。对于方舟模型，仅 doubao-seed-1.6 系列模型支持该功能。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"典型示例"},{"insert":"\n"},{"attributes":{"lmkr":"1","list":"bullet2","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"用户提问"},{"insert":"：“今天天气怎么样？顺便帮我查一下 A 的股价。”\n"},{"attributes":{"lmkr":"1","list":"bullet2","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"模型"},{"insert":"：识别出两个独立任务，一次性生成两个函数的调用指令：\n"},{"attributes":{"lmkr":"1","list":"indent2","text-indent":"true"},"insert":"*"},{"insert":" ","attributes":{"type":"codeblock","language":"Plain Text","zoneId":"P8MpgwGeC1","wrap":"true"}},{"insert":"\n"},{"attributes":{"lmkr":"1","list":"bullet2","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"您的服务"},{"insert":"：接收到指令列表后，可以并发执行 "},{"attributes":{"inlineCode":"true"},"insert":"get_current_weather"},{"insert":" 和 "},{"attributes":{"inlineCode":"true"},"insert":"get_stock_price"},{"insert":" 这两个函数。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"实现方法"},{"insert":"\n"},{"attributes":{"lmkr":"1","list":"number2","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"启用并行调用"},{"insert":"：调用 "},{"attributes":{"inlineCode":"true"},"insert":"StartVoiceChat"},{"insert":" 时，在 "},{"attributes":{"inlineCode":"true"},"insert":"LLMConfig"},{"insert":" 中设置：\n"},{"attributes":{"lmkr":"1","list":"bullet3","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"inlineCode":"true"},"insert":"EnableParallelToolCalls"},{"insert":"：设置为 "},{"attributes":{"inlineCode":"true"},"insert":"true"},{"insert":"。\n"},{"attributes":{"lmkr":"1","list":"bullet3","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"inlineCode":"true"},"insert":"Tools"},{"insert":"：提供所有可能用到的函数。\n"},{"attributes":{"lmkr":"1","list":"number2","start":"2","origin-start":"2"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"接收并执行"},{"insert":"：您的后端服务会收到一个包含多个 "},{"attributes":{"inlineCode":"true"},"insert":"tool_calls"},{"insert":" 对象的指令。遍历该指令列表，并发执行所有函数。\n"},{"attributes":{"lmkr":"1","list":"number2","start":"3","origin-start":"3"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"回传结果"},{"insert":"：\n"},{"attributes":{"lmkr":"1","list":"bullet3","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"交由 LLM 总结后统一回复"},{"insert":"：将所有函数的执行结果收集起来，通过一次 "},{"attributes":{"inlineCode":"true"},"insert":"UpdateVoiceChat"},{"insert":" 调用（"},{"attributes":{"inlineCode":"true"},"insert":"Command: \"function\""},{"insert":"）将结果数组一并回传给大模型。\n"},{"attributes":{"lmkr":"1","list":"bullet3","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"直接播报单个结果"},{"insert":"：任何一个函数执行完毕，就立即调用 "},{"attributes":{"inlineCode":"true"},"insert":"UpdateVoiceChat"},{"insert":"（"},{"attributes":{"inlineCode":"true"},"insert":"Command: \"ExternalTextToSpeech\""},{"insert":"），将该函数的结果直接通过 TTS 播放给用户。\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#保留工具调用历史","heading":"h3"}},{"insert":"保留工具调用历史\n"},{"insert":"如果您的场景要求模型在后续轮次继续引用此前的工具执行结果，例如“继续基于刚才查到的天气安排行程”或“根据上一轮函数返回的订单信息继续退款”，可在 "},{"insert":"StartVoiceChat","attributes":{"inlineCode":"true"}},{"insert":" 请求中将 "},{"insert":"LLMConfig.EnableToolCallHistory","attributes":{"inlineCode":"true"}},{"insert":" 设置为 "},{"insert":"true","attributes":{"inlineCode":"true"}},{"insert":"。\n"},{"insert":"开启后，系统会把工具调用指令和工具返回结果作为所属对话轮次的一部分写入后续上下文，减少模型遗漏已执行结果的问题。若某轮未触发 Function Calling，该轮仍只包含用户提问和最终回复，不会额外产生工具调用历史。\n"},{"insert":"*","attributes":{"lmkr":"1","tips":"{\"type\":\"warning\",\"isTitle\":true}"}},{"insert":"说明\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1","tips":"{\"type\":\"warning\"}"},"insert":"*"},{"insert":"该参数仅在已配置 "},{"attributes":{"inlineCode":"true"},"insert":"LLMConfig.Tools"},{"insert":" 并实际触发 Function Calling 时生效。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1","tips":"{\"type\":\"warning\"}"},"insert":"*"},{"attributes":{"inlineCode":"true"},"insert":"HistoryLength"},{"insert":" 仍按对话轮次计数。一次完成的用户提问及其最终回复计为一轮；若中间触发工具调用，工具调用指令和工具返回结果归入该轮，不额外增加 "},{"attributes":{"inlineCode":"true"},"insert":"HistoryLength"},{"insert":" 轮数，并随该轮一起保留和逐出。\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#提高-fc-触发准确性","heading":"h3"}},{"insert":"提高 FC 触发准确性\n"},{"insert":"为避免大模型在不相关或意图模糊的场景下（尤其是受历史对话干扰时）误触发函数调用（Function Calling），您可以通过以下方式来提升其触发准确性。\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#1.-高质量地声明工具","heading":"h4"}},{"insert":"1. 高质量地声明工具\n"},{"insert":"通过 "},{"insert":"StartVoiceChat","attributes":{"inlineCode":"true"}},{"insert":" 接口的 "},{"insert":"LLMConfig.Tools","attributes":{"inlineCode":"true"}},{"insert":" 声明工具时，提供清晰、准确的工具声明：\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"inlineCode":"true"},"insert":"name"},{"insert":" ：应使用清晰、符合语义的英文名（如 "},{"attributes":{"inlineCode":"true"},"insert":"get_current_weather"},{"insert":"），而不是 "},{"attributes":{"inlineCode":"true"},"insert":"tool_1"},{"insert":" 或 "},{"attributes":{"inlineCode":"true"},"insert":"my_func"},{"insert":"。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"inlineCode":"true"},"insert":"description"},{"insert":"：用一句话清晰地描述函数的核心用途。\n"},{"attributes":{"lmkr":"1","list":"bullet2","start":"1","origin-start":"1"},"insert":"*"},{"insert":"（不推荐） "},{"attributes":{"inlineCode":"true"},"insert":"\"description\": \"一个天气工具。\""},{"insert":"\n"},{"attributes":{"lmkr":"1","list":"bullet2","start":"1","origin-start":"1"},"insert":"*"},{"insert":"（推荐） "},{"attributes":{"inlineCode":"true"},"insert":"\"description\": \"获取一个指定城市的实时天气信息。\""},{"insert":"\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"inlineCode":"true"},"insert":"parameters"},{"insert":"：清晰说明参数的用途、格式要求，并提供示例。\n"},{"attributes":{"lmkr":"1","list":"bullet2","start":"1","origin-start":"1"},"insert":"*"},{"insert":"（不推荐） "},{"attributes":{"inlineCode":"true"},"insert":"\"description\": \"地点\""},{"insert":"\n"},{"attributes":{"lmkr":"1","list":"bullet2","start":"1","origin-start":"1"},"insert":"*"},{"insert":"（推荐） "},{"attributes":{"inlineCode":"true"},"insert":"\"description\": \"需要查询天气的城市名，例如：'上海市'。请不要包含省份信息。\""},{"insert":"\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#2.-设计系统提示词","heading":"h4"}},{"insert":"2. 设计系统提示词\n"},{"insert":"通过系统提示词（"},{"insert":"LLMConfig.SystemMessages","attributes":{"inlineCode":"true"}},{"insert":"）来为模型指定函数调用条件，从而精准控制模型的工具调用行为。\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#参考原则","heading":"h5"}},{"insert":"参考原则\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"意图匹配：仅当用户意图与工具功能明确匹配时才调用。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"主动澄清：当用户意图模糊或缺少必要参数时，应通过提问来澄清，而不是猜测。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"禁止幻觉：严禁调用未声明的工具或为参数捏造数值。\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#提示词示例","heading":"h5"}},{"insert":"提示词示例\n"},{"insert":"您可以参考以下模板，并根据您的业务场景进行调整：\n"},{"insert":" ","attributes":{"tabsZoneId":"Pnj5H1pk5X","doc-tabs":"true","tabs":"true"}},{"insert":"\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#3.-避免历史内容干扰","heading":"h4"}},{"insert":"3. 避免历史内容干扰\n"},{"insert":"如果您的业务场景无需参考历史对话，也可将 "},{"insert":"HistoryLength","attributes":{"inlineCode":"true"}},{"insert":" 设置为 "},{"insert":"0","attributes":{"inlineCode":"true"}},{"insert":"，以避免历史内容干扰。\n"},{"insert":"*","attributes":{"lmkr":"1","anchor":"#faq","heading":"h2"}},{"insert":"FAQ\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"Q1：配置了 Function Calling 后，通过 "},{"attributes":{"inlineCode":"true","bold":"true"},"insert":"updateVoiceChat/sendUserBinaryMessage"},{"attributes":{"bold":"true"},"insert":" 返回给 AI 的函数调用结果信息可以不读出来吗?"},{"insert":"\n"},{"insert":"*","attributes":{"lmkr":"1","list":"indent1","text-indent":"true"}},{"insert":"不可以。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"Q2：配置了 Function Calling 后，相关配置如何更新？"},{"insert":"\n"},{"insert":"*","attributes":{"lmkr":"1","list":"indent1","text-indent":"true"}},{"insert":"需要先调用 "},{"attributes":{"inlineCode":"true"},"insert":"StopVoiceChat"},{"insert":" 接口停止 AI 对话任务，然后再调用 "},{"attributes":{"inlineCode":"true"},"insert":"StartVoiceChat"},{"insert":" 接口重新配置 Function Calling 功能。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"**Q3：配置了 Tools，但客户端收不到 **** "},{"attributes":{"inlineCode":"true","bold":"true"},"insert":"tool"},{"attributes":{"bold":"true"},"insert":" ** 消息？"},{"insert":"\n"},{"attributes":{"lmkr":"1","list":"number2","start":"1","origin-start":"1"},"insert":"*"},{"insert":"检查 "},{"attributes":{"inlineCode":"true"},"insert":"StartVoiceChat"},{"insert":" 是否开启了 "},{"attributes":{"inlineCode":"true"},"insert":"AgentConfig.EnableConversationStateCallback: true"},{"insert":"。\n"},{"attributes":{"lmkr":"1","list":"number2","start":"2","origin-start":"2"},"insert":"*"},{"insert":"确保自定义 LLM 返回的 JSON 包含 "},{"attributes":{"inlineCode":"true"},"insert":"finish_reason: \"tool_calls\""},{"insert":"。\n"},{"attributes":{"lmkr":"1","list":"number2","start":"3","origin-start":"3"},"insert":"*"},{"attributes":{"hyperlink":"{\"href\":\"/docs/6348/70080#RTSRoom-senduserbinarymessage\",\"linkId\":\"P4fzBgHBwQ\"}"},"insert":"sendUserBinaryMessage"},{"insert":" 单次发送的二进制消息内容包大小为 1 KB，如需更大的包传递（最大不可超过 64 KB），检查是否已在控制台"},{"attributes":{"hyperlink":"{\"href\":\"https://console.volcengine.com/rtc/cloudRTC?tab=RTSMode\",\"linkId\":\"RCn6oAyEtR\"}"},"insert":"启用 RTS 高级功能"},{"insert":"。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"Q4：客户端执行函数，服务端也想收到通知可以吗？"},{"insert":"\n"},{"insert":"*","attributes":{"lmkr":"1","list":"indent1","text-indent":"true"}},{"insert":"可以。在 "},{"attributes":{"inlineCode":"true"},"insert":"StartVoiceChat"},{"insert":" 中同时配置 "},{"attributes":{"inlineCode":"true"},"insert":"LLMConfig.Tools"},{"insert":" 和 "},{"attributes":{"inlineCode":"true"},"insert":"FunctionCallingConfig.ServerMessageUrl"},{"insert":"。RTC 会同时向客户端下发二进制消息和向服务端发送 HTTP POST 回调。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"Q5：AI 为什么总是重复调用同一个函数？"},{"insert":"\n"},{"insert":"*","attributes":{"lmkr":"1","list":"indent1","text-indent":"true"}},{"insert":"通常是由于历史对话上下文干扰。请尝试：\n"},{"attributes":{"lmkr":"1","list":"number2","start":"1","origin-start":"1"},"insert":"*"},{"insert":"调小 "},{"attributes":{"inlineCode":"true"},"insert":"HistoryLength"},{"insert":"。\n"},{"attributes":{"lmkr":"1","list":"number2","start":"2","origin-start":"2"},"insert":"*"},{"insert":"在函数执行结果回传后，通过 Prompt 明确告知 AI 该任务已完成。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"Q6：在多轮对话中 FC 被持续错误触发该如何处理？"},{"insert":"\n"},{"insert":"*","attributes":{"lmkr":"1","list":"indent1","text-indent":"true"}},{"insert":"若在长周期多轮对话中，遇到 FC 被持续错误触发的情况，可采取以下应对措施：\n"},{"attributes":{"lmkr":"1","list":"number2","start":"1","origin-start":"1"},"insert":"*"},{"insert":"在 "},{"attributes":{"inlineCode":"true"},"insert":"tools"},{"insert":" 的 "},{"attributes":{"inlineCode":"true"},"insert":"description"},{"insert":" 中明确工具触发的强边界（如：“仅在用户询问天气时调用 get_weather 函数”）。\n"},{"attributes":{"lmkr":"1","list":"number2","start":"2","origin-start":"2"},"insert":"*"},{"insert":"在 "},{"attributes":{"inlineCode":"true"},"insert":"SystemMessages"},{"insert":" 中增加前置逻辑条件（如：“只有当用户明确提出 XXX 需求时，才调用工具”）。\n"},{"attributes":{"lmkr":"1","list":"number2","start":"3","origin-start":"3"},"insert":"*"},{"insert":"通过重置上下文（将 "},{"attributes":{"inlineCode":"true"},"insert":"LLMConfig.HistoryLength"},{"insert":" 设为 0）切断历史干扰。\n"},{"attributes":{"lmkr":"1","list":"number2","start":"4","origin-start":"4"},"insert":"*"},{"insert":"过滤 "},{"attributes":{"inlineCode":"true"},"insert":"UserPrompts"},{"insert":"，仅保留当前一轮的核心问询内容，防止历史信息影响判断。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"Q7：FC 中 TaskID、TaskId 和 ToolCallID 的区别是什么？"},{"insert":"\n"},{"insert":"*","attributes":{"lmkr":"1","list":"indent1","text-indent":"true"}},{"insert":"在 FC 完整流程中，存在三种不同的 ID，请勿混用：\n"},{"attributes":{"lmkr":"1","list":"bullet2","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"TaskID"},{"insert":"（UUID 格式，如 "},{"attributes":{"inlineCode":"true"},"insert":"73bc1a7e-..."},{"insert":"）：FC 回调请求体中的 TaskID 字段，仅用于标识单次 FC 任务，"},{"attributes":{"bold":"true"},"insert":"不可用于 UpdateVoiceChat"},{"insert":"。\n"},{"attributes":{"lmkr":"1","list":"bullet2","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"会话侧 TaskId"},{"insert":"（用户自定义，如 "},{"attributes":{"inlineCode":"true"},"insert":"task_001"},{"insert":" / "},{"attributes":{"inlineCode":"true"},"insert":"ChatTask01"},{"insert":"）：您在 "},{"attributes":{"inlineCode":"true"},"insert":"StartVoiceChat"},{"insert":" 中设置的任务 ID，"},{"attributes":{"inlineCode":"true"},"insert":"UpdateVoiceChat"},{"insert":" 的 TaskId 参数必须使用此值。请从返回结果或对话状态变化回调中获取并缓存。\n"},{"attributes":{"lmkr":"1","list":"bullet2","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"bold":"true"},"insert":"ToolCallID"},{"insert":"（"},{"attributes":{"inlineCode":"true"},"insert":"call_*"},{"insert":" 格式）：FC 指令消息中的工具调用唯一 ID，回传函数消息结果时需使用此 ID。\n"}],"zoneId":"0","zoneType":"Z"},"xr1enyj1ekv0ti691p8eybtlijt678okyg8xc1ua2oorsvp6rg00i0wz8ks7qaqj1ed3s9":{"ops":[{"insert":"对比项\n"}],"zoneId":"xr1enyj1ekv0ti691p8eybtlijt678okyg8xc1ua2oorsvp6rg00i0wz8ks7qaqj1ed3s9","zoneType":"Z"},"xr1enyj1ekv0ti691p8eybtlijt678okyg8xc1bhwof1j376pm6hc1b0cz9vv9szazuqvs":{"ops":[{"insert":"服务端实现\n"}],"zoneId":"xr1enyj1ekv0ti691p8eybtlijt678okyg8xc1bhwof1j376pm6hc1b0cz9vv9szazuqvs","zoneType":"Z"},"xr1enyj1ekv0ti691p8eybtlijt678okyg8xc1dk32lhn7fhww14ctnamwyke55tnrgewz":{"ops":[{"insert":"客户端实现\n"}],"zoneId":"xr1enyj1ekv0ti691p8eybtlijt678okyg8xc1dk32lhn7fhww14ctnamwyke55tnrgewz","zoneType":"Z"},"xr1374dslldq53oo87bbei0l2j1ybbt2kuyxc1ua2oorsvp6rg00i0wz8ks7qaqj1ed3s9":{"ops":[{"insert":"适用场景","attributes":{"bold":"true"}},{"insert":"\n"}],"zoneId":"xr1374dslldq53oo87bbei0l2j1ybbt2kuyxc1ua2oorsvp6rg00i0wz8ks7qaqj1ed3s9","zoneType":"Z"},"xr1374dslldq53oo87bbei0l2j1ybbt2kuyxc1bhwof1j376pm6hc1b0cz9vv9szazuqvs":{"ops":[{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"函数部署在独立的服务器上。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"需要统一管理和验证函数调用的场景。\n"}],"zoneId":"xr1374dslldq53oo87bbei0l2j1ybbt2kuyxc1bhwof1j376pm6hc1b0cz9vv9szazuqvs","zoneType":"Z"},"xr1374dslldq53oo87bbei0l2j1ybbt2kuyxc1dk32lhn7fhww14ctnamwyke55tnrgewz":{"ops":[{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"函数在客户端本地，如控制 App 功能、访问设备硬件。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"希望避免搭建额外后端服务的场景。\n"}],"zoneId":"xr1374dslldq53oo87bbei0l2j1ybbt2kuyxc1dk32lhn7fhww14ctnamwyke55tnrgewz","zoneType":"Z"},"xr1v69yfjt6gcf8q3dbjdfuejjvl0fmq4bmxc1ua2oorsvp6rg00i0wz8ks7qaqj1ed3s9":{"ops":[{"insert":"开发要求","attributes":{"bold":"true"}},{"insert":"\n"}],"zoneId":"xr1v69yfjt6gcf8q3dbjdfuejjvl0fmq4bmxc1ua2oorsvp6rg00i0wz8ks7qaqj1ed3s9","zoneType":"Z"},"xr1v69yfjt6gcf8q3dbjdfuejjvl0fmq4bmxc1bhwof1j376pm6hc1b0cz9vv9szazuqvs":{"ops":[{"insert":"提供一个公网可访问的 URL 地址，用于接收回调数据。\n"}],"zoneId":"xr1v69yfjt6gcf8q3dbjdfuejjvl0fmq4bmxc1bhwof1j376pm6hc1b0cz9vv9szazuqvs","zoneType":"Z"},"xr1v69yfjt6gcf8q3dbjdfuejjvl0fmq4bmxc1dk32lhn7fhww14ctnamwyke55tnrgewz":{"ops":[{"insert":"在客户端代码中监听 RTC SDK 的回调，并按照文档解析 / 构造特定的二进制数据包。\n"}],"zoneId":"xr1v69yfjt6gcf8q3dbjdfuejjvl0fmq4bmxc1dk32lhn7fhww14ctnamwyke55tnrgewz","zoneType":"Z"},"xr162o1j5w2k35rgjrffz2bjwsvc9q9mgenxc1ua2oorsvp6rg00i0wz8ks7qaqj1ed3s9":{"ops":[{"insert":"通信方式","attributes":{"bold":"true"}},{"insert":"\n"}],"zoneId":"xr162o1j5w2k35rgjrffz2bjwsvc9q9mgenxc1ua2oorsvp6rg00i0wz8ks7qaqj1ed3s9","zoneType":"Z"},"xr162o1j5w2k35rgjrffz2bjwsvc9q9mgenxc1bhwof1j376pm6hc1b0cz9vv9szazuqvs":{"ops":[{"insert":"系统通过公网 HTTP POST 请求下发指令到您提供的 URL。\n"}],"zoneId":"xr162o1j5w2k35rgjrffz2bjwsvc9q9mgenxc1bhwof1j376pm6hc1b0cz9vv9szazuqvs","zoneType":"Z"},"xr162o1j5w2k35rgjrffz2bjwsvc9q9mgenxc1dk32lhn7fhww14ctnamwyke55tnrgewz":{"ops":[{"insert":"系统通过 RTC 的数据通道将指令发送给您的客户端 App。\n"}],"zoneId":"xr162o1j5w2k35rgjrffz2bjwsvc9q9mgenxc1dk32lhn7fhww14ctnamwyke55tnrgewz","zoneType":"Z"},"rsry744hnudniesh55np1mz1zmz2swctfs":{"ops":[{"insert":{"id":"r1enyj1ekv0ti691p8eybtlijt678okyg8"}},{"insert":{"id":"r1374dslldq53oo87bbei0l2j1ybbt2kuy"}},{"insert":{"id":"r1v69yfjt6gcf8q3dbjdfuejjvl0fmq4bm"}},{"insert":{"id":"r162o1j5w2k35rgjrffz2bjwsvc9q9mgen"}}],"zoneId":"rsry744hnudniesh55np1mz1zmz2swctfs","zoneType":"R"},"cskcck2ke3mn8n1ss7no7dbhw0b4cuj7vb":{"ops":[{"insert":{"id":"c1ua2oorsvp6rg00i0wz8ks7qaqj1ed3s9"},"attributes":{"colWidth":"100"}},{"insert":{"id":"c1bhwof1j376pm6hc1b0cz9vv9szazuqvs"},"attributes":{"colWidth":"658"}},{"insert":{"id":"c1dk32lhn7fhww14ctnamwyke55tnrgewz"},"attributes":{"colWidth":"896"}}],"zoneId":"cskcck2ke3mn8n1ss7no7dbhw0b4cuj7vb","zoneType":"C"},"pk8Gls3OIh":{"ops":[{"insert":"{\n \"choices\": [{\n \"index\": 0,\n \"delta\": {\n \"role\": \"assistant\",\n \"tool_calls\": [{\n \"id\": \"call_unique_id_123\",\n \"type\": \"function\",\n \"function\": {\n \"name\": \"make_phone_call\",\n \"arguments\": \"{\\\"phone_number\\\": \\\"13800138000\\\"}\"\n }\n }]\n },\n \"finish_reason\": \"tool_calls\"\n }]\n}\n"}],"zoneId":"pk8Gls3OIh","zoneType":"Z"},"hfIDhIIQhE":{"ops":[{"insert":"{\n \"AppId\": \"YOUR_RTC_APPID\",\n \"RoomId\": \"YOUR_ROOM_ID\",\n \"TaskId\": \"YOUR_TASK_ID\",\n \"AgentConfig\": {\n \"TargetUserId\": [\"YOUR_USER_ID\"],\n \"UserId\": \"YOUR_BOT_ID\"\n },\n \"Config\": {\n \"S2SConfig\": {\n \"Provider\": \"volcano_duplex\",\n \"OutputMode\": 0,\n \"ProviderParams\": {\n \"app\": {\n \"appid\": \"YOUR_S2S_APPID\",\n \"token\": \"YOUR_S2S_TOKEN\"\n },\n \"session\": {\n \"audio\": {\n \"output\": {\n \"voice\": \"YOUR_DUPLEX_VOICE_ID\"\n }\n },\n \"tools\": [\n {\n \"type\": \"function\",\n \"name\": \"query_weather\",\n \"description\": \"查询指定城市的实时天气\",\n \"parameters\": {\n \"type\": \"object\",\n \"properties\": {\n \"city\": {\n \"type\": \"string\",\n \"description\": \"城市名称，例如上海\"\n }\n },\n \"required\": [\"city\"]\n }\n }\n ]\n }\n }\n },\n \"FunctionCallingConfig\": {\n \"ServerMessageUrl\": \"https://example.com/fc-callback\",\n \"ServerMessageSignature\": \"YOUR_SIGNATURE\"\n },\n \"SubtitleConfig\": {\n \"SubtitleMode\": 1\n }\n }\n}\n"}],"zoneId":"hfIDhIIQhE","zoneType":"Z"},"N5jGH5dOhC":{"ops":[{"insert":"{\n \"Message\": \"[{\\\"id\\\":\\\"call_weather_01\\\",\\\"type\\\":\\\"function\\\",\\\"function\\\":{\\\"name\\\":\\\"query_weather\\\",\\\"arguments\\\":\\\"{\\\\\\\"city\\\\\\\":\\\\\\\"上海\\\\\\\"}\\\"}}]\",\n \"Signature\": \"YOUR_SIGNATURE\",\n \"Type\": \"tool_calls\",\n \"RoomID\": \"YOUR_ROOM_ID\",\n \"TaskID\": \"FC_TRACE_TASK_ID\",\n \"TaskType\": \"voiceChat\",\n \"AppId\": \"YOUR_RTC_APPID\"\n}\n"}],"zoneId":"N5jGH5dOhC","zoneType":"Z"},"nTFSBJ2IDX":{"ops":[{"insert":"{\n \"AppId\": \"YOUR_RTC_APPID\",\n \"RoomId\": \"YOUR_ROOM_ID\",\n \"TaskId\": \"YOUR_TASK_ID\",\n \"Command\": \"function\",\n \"Message\": \"{\\\"ToolCallID\\\":\\\"call_weather_01\\\",\\\"Content\\\":\\\"上海当前晴，25 摄氏度\\\"}\"\n}\n"}],"zoneId":"nTFSBJ2IDX","zoneType":"Z"},"lY2clbW21B":{"ops":[{"insert":"// 声明您需要调用的所有函数（确保所有函数均已在业务代码中实现）\n{\n \"LLMConfig\": {\n \"Tools\": [\n {\n \"type\": \"function\",\n \"function\": {\n \"name\": \"get_current_weather\",\n \"description\": \"获取一个或多个指定城市的实时天气信息\",\n \"parameters\": {\n \"type\": \"object\",\n \"properties\": {\n \"location\": {\n \"type\": \"string\",\n \"description\": \"需要查询天气的城市名，例如：'上海市'\"\n },\n \"unit\": {\n \"type\": \"string\",\n \"enum\": [\"celsius\", \"fahrenheit\"],\n \"description\": \"温度单位，枚举值必须为数组格式\"\n }\n },\n \"required\": [\"location\"]\n }\n }\n }\n ],\n \"EnableParallelToolCalls\": true, // 可选，设为 true 时支持模型在一轮对话中同时触发多个工具调用（并行工具调用）；默认为 false，仅执行第一个被触发的工具\n \"EnableToolCallHistory\": true // 可选，设为 true 时工具调用指令和工具返回结果会随触发工具调用的轮次一起写入后续请求；默认为 false\n },\n \"FunctionCallingConfig\": {\n \"ServerMessageUrl\": \"https://your-backend.com/api/fc_callback\", \n \"ServerMessageSignature\": \"your_custom_signature\"\n }\n}\n"}],"zoneId":"lY2clbW21B","zoneType":"Z"},"qgHi0BHbBF":{"ops":[{"insert":"{\n \"Message\": \"{\\\"event_type\\\":\\\"function_calling\\\",\\\"function\\\":\\\"get_current_weather\\\",\\\"tool_call_id\\\":\\\"call_yx8****\\\",\\\"response_id\\\":\\\"021765**********e711d\\\"}\",\n \"Signature\": \"test_fc_***\", //即你在步骤1中配置的 ServerMessageSignature\n \"Type\": \"information\", //固定值，表示这是一个函数调用通知\n \"RoomID\": \"ChatRoom01\", //通话房间 ID\n \"TaskID\": \"73bc1a7e-73ef-470f-91****\",\n \"TaskType\": \"voiceChat\", //固定值，表示 AI 对话任务\n \"AppId\": \"661e****543cf\" // 应用的 AppId\n}\n"}],"zoneId":"qgHi0BHbBF","zoneType":"Z"},"xr1uqctff3r7lrunc8i6uavntwbpb1kgtmlxc1zfh2sacnmqbencpp6y4fvknrwrjo8j8z":{"ops":[{"insert":"字段名\n"}],"zoneId":"xr1uqctff3r7lrunc8i6uavntwbpb1kgtmlxc1zfh2sacnmqbencpp6y4fvknrwrjo8j8z","zoneType":"Z"},"xr1uqctff3r7lrunc8i6uavntwbpb1kgtmlxc1cgndaqu3ggu3smu10ybofwkrylw952g0":{"ops":[{"insert":"类型\n"}],"zoneId":"xr1uqctff3r7lrunc8i6uavntwbpb1kgtmlxc1cgndaqu3ggu3smu10ybofwkrylw952g0","zoneType":"Z"},"xr1uqctff3r7lrunc8i6uavntwbpb1kgtmlxc123dk7ha3c44ktrr78kekwk4ehn42ay27":{"ops":[{"insert":"描述\n"}],"zoneId":"xr1uqctff3r7lrunc8i6uavntwbpb1kgtmlxc123dk7ha3c44ktrr78kekwk4ehn42ay27","zoneType":"Z"},"xr1k61zgrwyspy0hekt74zhujipkltwy7kwxc1zfh2sacnmqbencpp6y4fvknrwrjo8j8z":{"ops":[{"insert":"event_type\n"}],"zoneId":"xr1k61zgrwyspy0hekt74zhujipkltwy7kwxc1zfh2sacnmqbencpp6y4fvknrwrjo8j8z","zoneType":"Z"},"xr1k61zgrwyspy0hekt74zhujipkltwy7kwxc1cgndaqu3ggu3smu10ybofwkrylw952g0":{"ops":[{"insert":"String\n"}],"zoneId":"xr1k61zgrwyspy0hekt74zhujipkltwy7kwxc1cgndaqu3ggu3smu10ybofwkrylw952g0","zoneType":"Z"},"xr1k61zgrwyspy0hekt74zhujipkltwy7kwxc123dk7ha3c44ktrr78kekwk4ehn42ay27":{"ops":[{"insert":"固定为 "},{"insert":"function_calling","attributes":{"inlineCode":"true"}},{"insert":"，表示触发了 Function Calling 函数调用。\n"}],"zoneId":"xr1k61zgrwyspy0hekt74zhujipkltwy7kwxc123dk7ha3c44ktrr78kekwk4ehn42ay27","zoneType":"Z"},"xr1djie1qaz9pb9urg8zwl2wwqkm1bn0wyrxc1zfh2sacnmqbencpp6y4fvknrwrjo8j8z":{"ops":[{"insert":"function\n"}],"zoneId":"xr1djie1qaz9pb9urg8zwl2wwqkm1bn0wyrxc1zfh2sacnmqbencpp6y4fvknrwrjo8j8z","zoneType":"Z"},"xr1djie1qaz9pb9urg8zwl2wwqkm1bn0wyrxc1cgndaqu3ggu3smu10ybofwkrylw952g0":{"ops":[{"insert":"String\n"}],"zoneId":"xr1djie1qaz9pb9urg8zwl2wwqkm1bn0wyrxc1cgndaqu3ggu3smu10ybofwkrylw952g0","zoneType":"Z"},"xr1djie1qaz9pb9urg8zwl2wwqkm1bn0wyrxc123dk7ha3c44ktrr78kekwk4ehn42ay27":{"ops":[{"insert":"触发的函数名称。\n"}],"zoneId":"xr1djie1qaz9pb9urg8zwl2wwqkm1bn0wyrxc123dk7ha3c44ktrr78kekwk4ehn42ay27","zoneType":"Z"},"xr1d1vbgoyah5gtltrutl69b10rgcw11q2lxc1zfh2sacnmqbencpp6y4fvknrwrjo8j8z":{"ops":[{"insert":"tool_call_id\n"}],"zoneId":"xr1d1vbgoyah5gtltrutl69b10rgcw11q2lxc1zfh2sacnmqbencpp6y4fvknrwrjo8j8z","zoneType":"Z"},"xr1d1vbgoyah5gtltrutl69b10rgcw11q2lxc1cgndaqu3ggu3smu10ybofwkrylw952g0":{"ops":[{"insert":"String\n"}],"zoneId":"xr1d1vbgoyah5gtltrutl69b10rgcw11q2lxc1cgndaqu3ggu3smu10ybofwkrylw952g0","zoneType":"Z"},"xr1d1vbgoyah5gtltrutl69b10rgcw11q2lxc123dk7ha3c44ktrr78kekwk4ehn42ay27":{"ops":[{"insert":"本次 Function Calling 任务 ID。\n"}],"zoneId":"xr1d1vbgoyah5gtltrutl69b10rgcw11q2lxc123dk7ha3c44ktrr78kekwk4ehn42ay27","zoneType":"Z"},"xr1vowrmrknk9biyuvweur6qmde28yf4pe0xc1zfh2sacnmqbencpp6y4fvknrwrjo8j8z":{"ops":[{"insert":"response_id\n"}],"zoneId":"xr1vowrmrknk9biyuvweur6qmde28yf4pe0xc1zfh2sacnmqbencpp6y4fvknrwrjo8j8z","zoneType":"Z"},"xr1vowrmrknk9biyuvweur6qmde28yf4pe0xc1cgndaqu3ggu3smu10ybofwkrylw952g0":{"ops":[{"insert":"String\n"}],"zoneId":"xr1vowrmrknk9biyuvweur6qmde28yf4pe0xc1cgndaqu3ggu3smu10ybofwkrylw952g0","zoneType":"Z"},"xr1vowrmrknk9biyuvweur6qmde28yf4pe0xc123dk7ha3c44ktrr78kekwk4ehn42ay27":{"ops":[{"insert":"触发本次 Function Calling 任务返回的响应 ID。如本次任务发生错误，可用于故障排查。\n"}],"zoneId":"xr1vowrmrknk9biyuvweur6qmde28yf4pe0xc123dk7ha3c44ktrr78kekwk4ehn42ay27","zoneType":"Z"},"rs8lr5h2nou2wyds9ut6wctqh681wzgd0z":{"ops":[{"insert":{"id":"r1uqctff3r7lrunc8i6uavntwbpb1kgtml"}},{"insert":{"id":"r1k61zgrwyspy0hekt74zhujipkltwy7kw"}},{"insert":{"id":"r1djie1qaz9pb9urg8zwl2wwqkm1bn0wyr"}},{"insert":{"id":"r1d1vbgoyah5gtltrutl69b10rgcw11q2l"}},{"insert":{"id":"r1vowrmrknk9biyuvweur6qmde28yf4pe0"}}],"zoneId":"rs8lr5h2nou2wyds9ut6wctqh681wzgd0z","zoneType":"R"},"cs0l1uj52f3eyrbdj4q0rz8ojdpkg5y8td":{"ops":[{"insert":{"id":"c1zfh2sacnmqbencpp6y4fvknrwrjo8j8z"},"attributes":{"colWidth":"168"}},{"insert":{"id":"c1cgndaqu3ggu3smu10ybofwkrylw952g0"},"attributes":{"colWidth":"100"}},{"insert":{"id":"c123dk7ha3c44ktrr78kekwk4ehn42ay27"},"attributes":{"colWidth":"924"}}],"zoneId":"cs0l1uj52f3eyrbdj4q0rz8ojdpkg5y8td","zoneType":"C"},"xXJfdq1Ikr":{"ops":[{"insert":"{\n \"AppId\": \"661e****543cf\",\n \"RoomId\": \"ChatRoom01\",\n \"TaskId\": \"task1\",\n \"Command\": \"ExternalTextToSpeech\", // 固定为 ExternalTextToSpeech\n \"Message\": \"正在为您查询，请耐心等待。\", // 内容结尾必须有标点\n \"InterruptMode\": 3 // 固定为 3，安抚语播放优先级较低，会被后续的函数结果打断。\n}\n"}],"zoneId":"xXJfdq1Ikr","zoneType":"Z"},"HBIX3uD3NM":{"ops":[{"insert":"{\n \"Message\": \"[{\\\"id\\\":\\\"call_yx8****\\\",\\\"type\\\":\\\"function\\\",\\\"function\\\":{\\\"name\\\":\\\"get_current_weather\\\",\\\"arguments\\\":\\\"{\\\\\\\"location\\\\\\\":\\\\\\\"上海\\\\\\\",\\\\\\\"unit\\\\\\\":\\\\\\\"摄氏度\\\\\\\"}\\\"}}]\",\n \"Signature\": \"cn_test_***\", //即你在步骤1中配置的 ServerMessageSignature\n \"Type\": \"tool_calls\", //固定值，表示此次消息为函数指令消息。\n \"RoomID\": \"ChatRoom01\", //通话房间 ID\n \"TaskID\": \"73bc1a7e-73ef-470f-91****\", // 仅用于标识单次 FC 任务，便于内部问题排查，不可用于 UpdateVoiceChat\n \"TaskType\": \"voiceChat\", //固定值，表示 AI 对话任务\n \"AppId\": \"661e****543cf\" // 应用的 AppId\n}\n"}],"zoneId":"HBIX3uD3NM","zoneType":"Z"},"xr1tiwpucr062lpqykqqgzgna6mg9jq9hwlxc15ve3kp18rgm7m7gpwjcyjjjcw4aluc73":{"ops":[{"insert":"字段名\n"}],"zoneId":"xr1tiwpucr062lpqykqqgzgna6mg9jq9hwlxc15ve3kp18rgm7m7gpwjcyjjjcw4aluc73","zoneType":"Z"},"xr1tiwpucr062lpqykqqgzgna6mg9jq9hwlxc13qb9qlf05p89p9kq6e3622or8vpgslc2":{"ops":[{"insert":"类型\n"}],"zoneId":"xr1tiwpucr062lpqykqqgzgna6mg9jq9hwlxc13qb9qlf05p89p9kq6e3622or8vpgslc2","zoneType":"Z"},"xr1tiwpucr062lpqykqqgzgna6mg9jq9hwlxc19i04y3nuzlmq578ece0f0bf77vdror0z":{"ops":[{"insert":"描述\n"}],"zoneId":"xr1tiwpucr062lpqykqqgzgna6mg9jq9hwlxc19i04y3nuzlmq578ece0f0bf77vdror0z","zoneType":"Z"},"xr1m77f88wz6h5tc8ybshig7an12s87npzwxc15ve3kp18rgm7m7gpwjcyjjjcw4aluc73":{"ops":[{"insert":"id\n"}],"zoneId":"xr1m77f88wz6h5tc8ybshig7an12s87npzwxc15ve3kp18rgm7m7gpwjcyjjjcw4aluc73","zoneType":"Z"},"xr1m77f88wz6h5tc8ybshig7an12s87npzwxc13qb9qlf05p89p9kq6e3622or8vpgslc2":{"ops":[{"insert":"String\n"}],"zoneId":"xr1m77f88wz6h5tc8ybshig7an12s87npzwxc13qb9qlf05p89p9kq6e3622or8vpgslc2","zoneType":"Z"},"xr1m77f88wz6h5tc8ybshig7an12s87npzwxc19i04y3nuzlmq578ece0f0bf77vdror0z":{"ops":[{"insert":"本次 Function Calling 任务 ID，与返回的函数调用通知信息中的 "},{"insert":"message.tool_call_id","attributes":{"inlineCode":"true"}},{"insert":" 的值一致。\n"}],"zoneId":"xr1m77f88wz6h5tc8ybshig7an12s87npzwxc19i04y3nuzlmq578ece0f0bf77vdror0z","zoneType":"Z"},"xr1aktot99ule1tn18b33b9n0n10onk2iw1xc15ve3kp18rgm7m7gpwjcyjjjcw4aluc73":{"ops":[{"insert":"type\n"}],"zoneId":"xr1aktot99ule1tn18b33b9n0n10onk2iw1xc15ve3kp18rgm7m7gpwjcyjjjcw4aluc73","zoneType":"Z"},"xr1aktot99ule1tn18b33b9n0n10onk2iw1xc13qb9qlf05p89p9kq6e3622or8vpgslc2":{"ops":[{"insert":"String\n"}],"zoneId":"xr1aktot99ule1tn18b33b9n0n10onk2iw1xc13qb9qlf05p89p9kq6e3622or8vpgslc2","zoneType":"Z"},"xr1aktot99ule1tn18b33b9n0n10onk2iw1xc19i04y3nuzlmq578ece0f0bf77vdror0z":{"ops":[{"insert":"Function Calling 所调用的工具类型，固定为 "},{"insert":"function","attributes":{"inlineCode":"true"}},{"insert":"，表示函数调用。\n"}],"zoneId":"xr1aktot99ule1tn18b33b9n0n10onk2iw1xc19i04y3nuzlmq578ece0f0bf77vdror0z","zoneType":"Z"},"xr1ou8acnvaeeuitlqephrqtpqhury9kmqpxc15ve3kp18rgm7m7gpwjcyjjjcw4aluc73":{"ops":[{"insert":"function\n"}],"zoneId":"xr1ou8acnvaeeuitlqephrqtpqhury9kmqpxc15ve3kp18rgm7m7gpwjcyjjjcw4aluc73","zoneType":"Z"},"xr1ou8acnvaeeuitlqephrqtpqhury9kmqpxc13qb9qlf05p89p9kq6e3622or8vpgslc2":{"ops":[{"insert":"Object\n"}],"zoneId":"xr1ou8acnvaeeuitlqephrqtpqhury9kmqpxc13qb9qlf05p89p9kq6e3622or8vpgslc2","zoneType":"Z"},"DqGVONbiB5":{"ops":[{"insert":"{\n \"name\": \"get_current_weather\", //函数名称\n \"arguments\": {\"location\":\"上海\",\"unit\":\"摄氏度\"} // 函数入参\n}\n"}],"zoneId":"DqGVONbiB5","zoneType":"Z"},"xr1ou8acnvaeeuitlqephrqtpqhury9kmqpxc19i04y3nuzlmq578ece0f0bf77vdror0z":{"ops":[{"insert":"调用函数详情。格式示例：\n"},{"insert":"*","attributes":{"lmkr":"1","blockquote":"true"}},{"attributes":{"inlineCode":"true"},"insert":"arguments"},{"insert":" 是一个 JSON 字符串，您需要进行二次解析才能获取参数对象。\n"},{"insert":" ","attributes":{"type":"codeblock","language":"JSON","zoneId":"DqGVONbiB5","wrap":"true"}},{"insert":"\n"}],"zoneId":"xr1ou8acnvaeeuitlqephrqtpqhury9kmqpxc19i04y3nuzlmq578ece0f0bf77vdror0z","zoneType":"Z"},"rsshcithor7ngje9nbvatpszmcodttsi7p":{"ops":[{"insert":{"id":"r1tiwpucr062lpqykqqgzgna6mg9jq9hwl"}},{"insert":{"id":"r1m77f88wz6h5tc8ybshig7an12s87npzw"}},{"insert":{"id":"r1aktot99ule1tn18b33b9n0n10onk2iw1"}},{"insert":{"id":"r1ou8acnvaeeuitlqephrqtpqhury9kmqp"}}],"zoneId":"rsshcithor7ngje9nbvatpszmcodttsi7p","zoneType":"R"},"cs8877lfir5bbokw1t1c5za7jnqrlov5c6":{"ops":[{"insert":{"id":"c15ve3kp18rgm7m7gpwjcyjjjcw4aluc73"},"attributes":{"colWidth":"112"}},{"insert":{"id":"c13qb9qlf05p89p9kq6e3622or8vpgslc2"},"attributes":{"colWidth":"100"}},{"insert":{"id":"c19i04y3nuzlmq578ece0f0bf77vdror0z"},"attributes":{"colWidth":"1000"}}],"zoneId":"cs8877lfir5bbokw1t1c5za7jnqrlov5c6","zoneType":"C"},"z0PL0GS11Y":{"ops":[{"insert":"{\n \"AppId\": \"YOUR_AppId\", // 与 StartVoiceChat 的一致\n \"RoomId\": \"YOUR_RoomId\", // 与 StartVoiceChat 的一致\n \"TaskId\": \"YOUR_TaskId\", // 与 StartVoiceChat 的一致\n \"Command\": \"function\", // 必须为 function\n \"Message\": \"{\\\\\\\\\"ToolCallID\\\\\\\\\":\\\\\\\\\"call_yx8****\\\\\\\\\",\\\\\\\\\"Content\\\\\\\\\":\\\\\\\\\"上海天气是晴天，25摄氏度\\\\\\\\\"}\" // 将函数结果作为 JSON 转义字符串传入\n}\n"}],"zoneId":"z0PL0GS11Y","zoneType":"Z"},"LtUDjTVsE4":{"ops":[{"insert":"将函数返回的原始数据传回给 LLM 处理后再播放。适用于需要总结、润色等二次处理场景。\n"},{"insert":"*","attributes":{"lmkr":"1","blockquote":"true"}},{"attributes":{"inlineCode":"true"},"insert":"Message"},{"insert":" 中的 "},{"attributes":{"inlineCode":"true"},"insert":"ToolCallID"},{"insert":" 的值必须与您在"},{"attributes":{"hyperlink":"{\"href\":\"#%E6%AD%A5%E9%AA%A4-3%EF%BC%9A%E6%89%A7%E8%A1%8C%E5%A4%96%E9%83%A8%E5%87%BD%E6%95%B0\",\"linkId\":\"ZIdhRJraNi\"}"},"insert":"步骤 3：执行外部函数"},{"insert":"收到的 "},{"attributes":{"inlineCode":"true"},"insert":"tool_calls"},{"insert":" 指令中的 "},{"attributes":{"inlineCode":"true"},"insert":"id"},{"insert":" 字段值完全一致。\n"},{"insert":" ","attributes":{"type":"codeblock","language":"JSON","zoneId":"z0PL0GS11Y","wrap":"true"}},{"insert":"\n"},{"insert":"LLM 可能会生成回复：“上海今天天气不错，是个大晴天，温度是 25 摄氏度。”\n"}],"zoneId":"LtUDjTVsE4","zoneType":"Z"},"DnKvvPna2f":{"ops":[{"insert":"为降低延迟，可将长回复切分为多个短句，分次调用"},{"insert":"UpdateVoiceChat","attributes":{"inlineCode":"true"}},{"insert":" 接口。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"切句建议：首句按逗号（，）、分号（；）切分；后续分句按句号（。）、问号（？）等完整句子标点切分。避免切分数字中的小数点。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"切句示例："},{"attributes":{"inlineCode":"true"},"insert":"今天的天气晴朗，"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"温度10-29摄氏度，北风三级。"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"未来七天，天气会保持晴朗。"},{"insert":"\n"}],"zoneId":"DnKvvPna2f","zoneType":"Z"},"XuwRGbGlKo":{"ops":[{"insert":"{\n \"AppId\": \"YOUR_AppId\", // 与 StartVoiceChat 的一致\n \"RoomId\": \"YOUR_RoomId\", // 与 StartVoiceChat 的一致\n \"TaskId\": \"YOUR_TaskId\", // 与 StartVoiceChat 的一致\n \"Command\": \"ExternalTextToSpeech\", // 必须为 ExternalTextToSpeech\n \"Message\": \"今天上海的天气晴朗。\", // 传入工具调用的结果，普通字符串\n \"InterruptMode\": 2 //固定值为 2\n}\n"}],"zoneId":"XuwRGbGlKo","zoneType":"Z"},"aRFJf8HsJS":{"ops":[{"insert":"将函数原始结果直接通过 TTS 播放。适用于返回结果无需处理或回复的句子较长需降低延迟等场景。\n"},{"insert":"*","attributes":{"lmkr":"1","tips":"{\"type\":\"warning\",\"isTitle\":true}"}},{"insert":"说明\n"},{"insert":"*","attributes":{"lmkr":"1","tips":"{\"type\":\"warning\"}"}},{"insert":"为降低延迟，可将长回复切分为多个短句，分次调用"},{"insert":"UpdateVoiceChat","attributes":{"inlineCode":"true"}},{"insert":" 接口。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1","tips":"{\"type\":\"warning\"}"},"insert":"*"},{"insert":"切句建议：首句按逗号（，）、分号（；）切分；后续分句按句号（。）、问号（？）等完整句子标点切分。避免切分数字中的小数点。\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1","tips":"{\"type\":\"warning\"}"},"insert":"*"},{"insert":"切句示例："},{"attributes":{"inlineCode":"true"},"insert":"今天的天气晴朗，"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"温度10-29摄氏度，北风三级。"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"未来七天，天气会保持晴朗。"},{"insert":"\n"},{"insert":" ","attributes":{"type":"codeblock","language":"JSON","zoneId":"XuwRGbGlKo","wrap":"true"}},{"insert":"\n"}],"zoneId":"aRFJf8HsJS","zoneType":"Z"},"GByVJtA8YJ":{"ops":[{"insert":"*","attributes":{"zoneId":"LtUDjTVsE4","title":"方式一：传给 LLM 处理后再播放","tabContent":"true"}},{"insert":"*","attributes":{"zoneId":"aRFJf8HsJS","title":"方式二：直接播放（不经 LLM 处理）","tabContent":"true"}},{"insert":"\n"}],"zoneId":"GByVJtA8YJ","zoneType":"Z"},"h5PQgB8Lsy":{"ops":[{"insert":"// 声明您需要调用的所有函数（确保所有函数均已在业务代码中实现）\n{\n \"LLMConfig\": {\n \"Tools\": [\n {\n \"type\": \"function\",\n \"function\": {\n \"name\": \"get_current_weather\",\n \"description\": \"获取一个或多个指定城市的实时天气信息\",\n \"parameters\": {\n \"type\": \"object\",\n \"properties\": {\n \"location\": {\n \"type\": \"string\",\n \"description\": \"需要查询天气的城市名，例如：'上海市'\"\n },\n \"unit\": {\n \"type\": \"string\",\n \"enum\": [\"celsius\", \"fahrenheit\"],\n \"description\": \"温度单位，枚举值必须为数组格式\"\n }\n },\n \"required\": [\"location\"]\n }\n }\n }\n ],\n \"EnableParallelToolCalls\": true, // 可选，设为 true 时支持模型在一轮对话中同时触发多个工具调用（并行工具调用）；默认为 false，仅执行第一个被触发的工具\n \"EnableToolCallHistory\": true // 可选，设为 true 时工具调用指令和工具返回结果会随触发工具调用的轮次一起写入后续请求；默认为 false\n }\n}\n"}],"zoneId":"h5PQgB8Lsy","zoneType":"Z"},"xr1dyyu1bovabeq07enubf2ilv6zjhdrmr1xc1je1bqr990y50qhrbykqzvemzn663qoay":{"ops":[{"insert":"字段名\n"}],"zoneId":"xr1dyyu1bovabeq07enubf2ilv6zjhdrmr1xc1je1bqr990y50qhrbykqzvemzn663qoay","zoneType":"Z"},"xr1dyyu1bovabeq07enubf2ilv6zjhdrmr1xc1uvdy82oh3bfjba8n1cru3hm73gcz6s02":{"ops":[{"insert":"类型\n"}],"zoneId":"xr1dyyu1bovabeq07enubf2ilv6zjhdrmr1xc1uvdy82oh3bfjba8n1cru3hm73gcz6s02","zoneType":"Z"},"xr1dyyu1bovabeq07enubf2ilv6zjhdrmr1xc19lykd7h5njahs5fb3fhh84wkgc8qiu3w":{"ops":[{"insert":"描述\n"}],"zoneId":"xr1dyyu1bovabeq07enubf2ilv6zjhdrmr1xc19lykd7h5njahs5fb3fhh84wkgc8qiu3w","zoneType":"Z"},"xr13vqzg1fm4ksvvglgh3703ekl8vgo7my9xc1je1bqr990y50qhrbykqzvemzn663qoay":{"ops":[{"insert":"magic number\n"}],"zoneId":"xr13vqzg1fm4ksvvglgh3703ekl8vgo7my9xc1je1bqr990y50qhrbykqzvemzn663qoay","zoneType":"Z"},"xr13vqzg1fm4ksvvglgh3703ekl8vgo7my9xc1uvdy82oh3bfjba8n1cru3hm73gcz6s02":{"ops":[{"insert":"String\n"}],"zoneId":"xr13vqzg1fm4ksvvglgh3703ekl8vgo7my9xc1uvdy82oh3bfjba8n1cru3hm73gcz6s02","zoneType":"Z"},"xr13vqzg1fm4ksvvglgh3703ekl8vgo7my9xc19lykd7h5njahs5fb3fhh84wkgc8qiu3w":{"ops":[{"insert":"消息格式，固定为 "},{"insert":"info","attributes":{"inlineCode":"true"}},{"insert":"，表示此次消息为通知函数被触发调用。\n"}],"zoneId":"xr13vqzg1fm4ksvvglgh3703ekl8vgo7my9xc19lykd7h5njahs5fb3fhh84wkgc8qiu3w","zoneType":"Z"},"xr1iw6y1ju238rkq8o9a0jqgpfjagpm60m9xc1je1bqr990y50qhrbykqzvemzn663qoay":{"ops":[{"insert":"length\n"}],"zoneId":"xr1iw6y1ju238rkq8o9a0jqgpfjagpm60m9xc1je1bqr990y50qhrbykqzvemzn663qoay","zoneType":"Z"},"xr1iw6y1ju238rkq8o9a0jqgpfjagpm60m9xc1uvdy82oh3bfjba8n1cru3hm73gcz6s02":{"ops":[{"insert":"String\n"}],"zoneId":"xr1iw6y1ju238rkq8o9a0jqgpfjagpm60m9xc1uvdy82oh3bfjba8n1cru3hm73gcz6s02","zoneType":"Z"},"xr1iw6y1ju238rkq8o9a0jqgpfjagpm60m9xc19lykd7h5njahs5fb3fhh84wkgc8qiu3w":{"ops":[{"insert":"通知消息长度，单位为 bytes。存放方式为大端序。\n"}],"zoneId":"xr1iw6y1ju238rkq8o9a0jqgpfjagpm60m9xc19lykd7h5njahs5fb3fhh84wkgc8qiu3w","zoneType":"Z"},"xr1swrfgl6p1av91zfy8ma3ak3pjbcfu3clxc1je1bqr990y50qhrbykqzvemzn663qoay":{"ops":[{"insert":"info_message\n"}],"zoneId":"xr1swrfgl6p1av91zfy8ma3ak3pjbcfu3clxc1je1bqr990y50qhrbykqzvemzn663qoay","zoneType":"Z"},"xr1swrfgl6p1av91zfy8ma3ak3pjbcfu3clxc1uvdy82oh3bfjba8n1cru3hm73gcz6s02":{"ops":[{"insert":"String\n"}],"zoneId":"xr1swrfgl6p1av91zfy8ma3ak3pjbcfu3clxc1uvdy82oh3bfjba8n1cru3hm73gcz6s02","zoneType":"Z"},"U472QtBlt2":{"ops":[{"insert":"{\n \"event_type\": \"function_calling\", // 事件类型，固定为此值\n \"function\": \"get_current_weather\", // 被触发的函数名，与您在 StartVoiceChat 中定义的名称一致\n \"tool_call_id\": \"call_yx8****\", // 本次函数调用的唯一ID，后续回传结果时需要用到\n \"response_id\": \"resp_abcde\" // 本次响应的唯一ID，可用于问题排查\n}\n"}],"zoneId":"U472QtBlt2","zoneType":"Z"},"xr1swrfgl6p1av91zfy8ma3ak3pjbcfu3clxc19lykd7h5njahs5fb3fhh84wkgc8qiu3w":{"ops":[{"insert":"函数调用通知的详细信息。内容如下：\n"},{"insert":" ","attributes":{"type":"codeblock","language":"JSON","zoneId":"U472QtBlt2","wrap":"true"}},{"insert":"\n"}],"zoneId":"xr1swrfgl6p1av91zfy8ma3ak3pjbcfu3clxc19lykd7h5njahs5fb3fhh84wkgc8qiu3w","zoneType":"Z"},"rsmgt628p0rqt5yvlahafsw0mw71r94ygr":{"ops":[{"insert":{"id":"r1dyyu1bovabeq07enubf2ilv6zjhdrmr1"}},{"insert":{"id":"r13vqzg1fm4ksvvglgh3703ekl8vgo7my9"}},{"insert":{"id":"r1iw6y1ju238rkq8o9a0jqgpfjagpm60m9"}},{"insert":{"id":"r1swrfgl6p1av91zfy8ma3ak3pjbcfu3cl"}}],"zoneId":"rsmgt628p0rqt5yvlahafsw0mw71r94ygr","zoneType":"R"},"cskazyldnlyvv2mhdq7lz7a1envyj6i61a":{"ops":[{"insert":{"id":"c1je1bqr990y50qhrbykqzvemzn663qoay"},"attributes":{"colWidth":"168"}},{"insert":{"id":"c1uvdy82oh3bfjba8n1cru3hm73gcz6s02"},"attributes":{"colWidth":"100"}},{"insert":{"id":"c19lykd7h5njahs5fb3fhh84wkgc8qiu3w"},"attributes":{"colWidth":"616"}}],"zoneId":"cskazyldnlyvv2mhdq7lz7a1envyj6i61a","zoneType":"C"},"EIUZFOoiOn":{"ops":[{"insert":"// 消息体 JSON 对应的结构体\nstruct FCInfoMessage {\n std::string event_type;\n std::string function;\n std::string tool_call_id;\n std::string response_id;\n};\n\n\n// 拆包函数，专门用于 \"info\" 消息：只做协议校验 + 提取 JSON 字符串\nbool UnpackInfoMessage(const uint8_t *message, int size, std::string& json_payload) {\n const int kHeaderSize = 8;\n if (size < kHeaderSize) {\n return false;\n }\n\n\n // 校验 magic number \"info\" (0x696E666F)\n uint32_t magic = ntohl(*reinterpret_cast(message));\n if (magic != 0x696E666F) {\n return false;\n }\n\n\n // 读取 length（大端）\n uint32_t length = ntohl(*reinterpret_cast(message + 4));\n if (size - kHeaderSize != static_cast(length)) {\n return false;\n }\n\n\n if (length > 0) {\n json_payload.assign(reinterpret_cast(message) + kHeaderSize, length);\n } else {\n json_payload.clear();\n }\n return true;\n}\n\n\n// 对外的解析接口：解析出结构体 FCInfoMessage\nbool ParseInfoMessage(const uint8_t* message, int size, FCInfoMessage& out_info) {\n std::string json_str;\n if (!UnpackInfoMessage(message, size, json_str)) {\n return false;\n }\n\n\n // 解析 JSON，容错一点，解析失败直接返回 false\n nlohmann::json json_data = nlohmann::json::parse(json_str, /*callback=*/nullptr, /*allow_exceptions=*/false);\n if (json_data.is_discarded()) {\n return false;\n }\n\n\n out_info.event_type = json_data.value(\"event_type\", \"\");\n out_info.function = json_data.value(\"function\", \"\");\n out_info.tool_call_id = json_data.value(\"tool_call_id\", \"\");\n out_info.response_id = json_data.value(\"response_id\", \"\");\n\n\n return true;\n}\n\n\n// 在 onRoomBinaryMessageReceived 回调中\nvoid onRoomBinaryMessageReceived(const char* uid, int size, const uint8_t* message) {\n FCInfoMessage info_msg;\n if (!ParseInfoMessage(message, size, info_msg)) {\n // 不是合法的 info 消息，直接忽略，可以继续检查是否为 tool 等其他消息\n return;\n }\n\n // 解析成功！现在可以安全地使用 info_msg 里的字段了。\n std::cout << \"Function Call Notification for: \" << info_msg.function << std::endl;\n std::cout << \"ToolCallID: \" << info_msg.tool_call_id << std::endl;\n\n // 可在这里添加自己的业务逻辑\n // 例如收到函数调用通知后，调用 `sendUserBinaryMessage` 函数，让 AI 播放安抚语。\n // 具体实现，参见下方文档。\n}\n"}],"zoneId":"EIUZFOoiOn","zoneType":"Z"},"iHzn2F4qHb":{"ops":[{"insert":" ","attributes":{"type":"codeblock","language":"C++","zoneId":"EIUZFOoiOn","wrap":"true"}},{"insert":"\n"}],"zoneId":"iHzn2F4qHb","zoneType":"Z"},"bYTnf2szho":{"ops":[{"insert":"// 消息体 JSON 对应的类\nclass FCInfoMessage {\n public String event_type;\n public String function;\n public String tool_call_id;\n public String response_id;\n}\n\n// 在 onRoomBinaryMessageReceived 回调中\n@Override\npublic void onRoomBinaryMessageReceived(String uid, ByteBuffer message) {\n // 使用大端序解析\n message.order(ByteOrder.BIG_ENDIAN);\n\n // 至少要有 4 字节 magic + 4 字节 length\n if (message.remaining() < 8) {\n message.rewind();\n return;\n }\n\n byte[] magicBytes = new byte[4];\n message.get(magicBytes);\n String magic = new String(magicBytes, StandardCharsets.UTF_8);\n\n // 根据 magic number 分发处理\n if (\"info\".equals(magic)) {\n int length = message.getInt();\n // 简单的合法性检查：长度不能为负，剩余字节要够\n if (length < 0 || message.remaining() < length) {\n message.rewind();\n return;\n }\n\n byte[] payload = new byte[length];\n message.get(payload);\n String infoStr = new String(payload, StandardCharsets.UTF_8);\n\n // 使用 Gson 或 Jackson 等库解析 JSON\n Gson gson = new Gson();\n FCInfoMessage infoMsg = gson.fromJson(infoStr, FCInfoMessage.class);\n\n // 现在可以根据 infoMsg.function 准备播放安抚语\n System.out.println(\"Function Call Notification for: \" + infoMsg.function);\n // 立即调用 sendUserBinaryMessage 播放安抚语...\n } else if (\"tool\".equals(magic)) {\n // ... 此处处理 \"tool\" 消息（可选）\n }\n\n // 重置 buffer 位置，以便其他逻辑可以处理\n message.rewind();\n}\n"}],"zoneId":"bYTnf2szho","zoneType":"Z"},"QhUF0smaRd":{"ops":[{"insert":" ","attributes":{"type":"codeblock","language":"Java","zoneId":"bYTnf2szho","wrap":"true"}},{"insert":"\n"}],"zoneId":"QhUF0smaRd","zoneType":"Z"},"LUahlzO8tG":{"ops":[{"insert":"// 定义类型接口\ninterface FCInfoMessage {\n event_type: string;\n function: string;\n tool_call_id: string;\n response_id: string;\n}\n\n// 在 onRoomBinaryMessageReceived 回调中\nengine.on('onRoomBinaryMessageReceived', (event: { userId: string, message: ArrayBuffer }) => {\n const { userId, message } = event;\n if (message.byteLength < 8) return;\n \n const dataView = new DataView(message);\n const magic = new TextDecoder().decode(message.slice(0, 4));\n\n if (magic === 'info') {\n const length = dataView.getUint32(4, false); // false for big-endian\n const payload = new TextDecoder().decode(message.slice(8, 8 + length));\n \n const infoMsg: FCInfoMessage = JSON.parse(payload);\n \n // 现在可以根据 infoMsg.function 准备播放安抚语\n console.log(`Function Call Notification for: \\\\${infoMsg.function}`);\n // 立即调用 engine.sendUserBinaryMessage 播放安抚语...\n \n } else if (magic === 'tool') {\n // ... 此处处理 tool 消息\n }\n});\n"}],"zoneId":"LUahlzO8tG","zoneType":"Z"},"arXgEFsm0M":{"ops":[{"insert":" ","attributes":{"type":"codeblock","language":"TypeScript","zoneId":"LUahlzO8tG","wrap":"true"}},{"insert":"\n"}],"zoneId":"arXgEFsm0M","zoneType":"Z"},"VFGHHoDqUW":{"ops":[{"insert":"*","attributes":{"zoneId":"iHzn2F4qHb","title":"C++","tabContent":"true"}},{"insert":"*","attributes":{"zoneId":"QhUF0smaRd","title":"Java","tabContent":"true"}},{"insert":"*","attributes":{"zoneId":"arXgEFsm0M","title":"TypeScript","tabContent":"true"}},{"insert":"\n"}],"zoneId":"VFGHHoDqUW","zoneType":"Z"},"xr1hiz19w114ci5cepnt7fniadaccsadbqhxc1fjb2hvikhys93u3fqf0pk2dzj1t5cvgp":{"ops":[{"insert":"参数名\n"}],"zoneId":"xr1hiz19w114ci5cepnt7fniadaccsadbqhxc1fjb2hvikhys93u3fqf0pk2dzj1t5cvgp","zoneType":"Z"},"xr1hiz19w114ci5cepnt7fniadaccsadbqhxc1cy57ay7mjvy5s8me430r8thwcyp65kb8":{"ops":[{"insert":"类型\n"}],"zoneId":"xr1hiz19w114ci5cepnt7fniadaccsadbqhxc1cy57ay7mjvy5s8me430r8thwcyp65kb8","zoneType":"Z"},"xr1hiz19w114ci5cepnt7fniadaccsadbqhxc16jvtb00z92ia67rk9bo3hrarczlwv0g5":{"ops":[{"insert":"描述\n"}],"zoneId":"xr1hiz19w114ci5cepnt7fniadaccsadbqhxc16jvtb00z92ia67rk9bo3hrarczlwv0g5","zoneType":"Z"},"xr137c51lc0n929oos8hyol1134bp6lopt8xc1fjb2hvikhys93u3fqf0pk2dzj1t5cvgp":{"ops":[{"insert":"magic number\n"}],"zoneId":"xr137c51lc0n929oos8hyol1134bp6lopt8xc1fjb2hvikhys93u3fqf0pk2dzj1t5cvgp","zoneType":"Z"},"xr137c51lc0n929oos8hyol1134bp6lopt8xc1cy57ay7mjvy5s8me430r8thwcyp65kb8":{"ops":[{"insert":"String\n"}],"zoneId":"xr137c51lc0n929oos8hyol1134bp6lopt8xc1cy57ay7mjvy5s8me430r8thwcyp65kb8","zoneType":"Z"},"xr137c51lc0n929oos8hyol1134bp6lopt8xc16jvtb00z92ia67rk9bo3hrarczlwv0g5":{"ops":[{"insert":"消息格式标识符，当前场景消息格式固定为 "},{"insert":"ctrl","attributes":{"inlineCode":"true"}},{"insert":"，用于标识该消息为控制消息。\n"}],"zoneId":"xr137c51lc0n929oos8hyol1134bp6lopt8xc16jvtb00z92ia67rk9bo3hrarczlwv0g5","zoneType":"Z"},"xr12kimqc56nqoac80905b56nlnlkzp0cimxc1fjb2hvikhys93u3fqf0pk2dzj1t5cvgp":{"ops":[{"insert":"length\n"}],"zoneId":"xr12kimqc56nqoac80905b56nlnlkzp0cimxc1fjb2hvikhys93u3fqf0pk2dzj1t5cvgp","zoneType":"Z"},"xr12kimqc56nqoac80905b56nlnlkzp0cimxc1cy57ay7mjvy5s8me430r8thwcyp65kb8":{"ops":[{"insert":"String\n"}],"zoneId":"xr12kimqc56nqoac80905b56nlnlkzp0cimxc1cy57ay7mjvy5s8me430r8thwcyp65kb8","zoneType":"Z"},"xr12kimqc56nqoac80905b56nlnlkzp0cimxc16jvtb00z92ia67rk9bo3hrarczlwv0g5":{"ops":[{"insert":"安抚语长度，单位为 bytes。存放方式为大端序。\n"}],"zoneId":"xr12kimqc56nqoac80905b56nlnlkzp0cimxc16jvtb00z92ia67rk9bo3hrarczlwv0g5","zoneType":"Z"},"xr1jedcctb7ny696bakrj3zezsrczef7bqsxc1fjb2hvikhys93u3fqf0pk2dzj1t5cvgp":{"ops":[{"insert":"control_message\n"}],"zoneId":"xr1jedcctb7ny696bakrj3zezsrczef7bqsxc1fjb2hvikhys93u3fqf0pk2dzj1t5cvgp","zoneType":"Z"},"xr1jedcctb7ny696bakrj3zezsrczef7bqsxc1cy57ay7mjvy5s8me430r8thwcyp65kb8":{"ops":[{"insert":"String\n"}],"zoneId":"xr1jedcctb7ny696bakrj3zezsrczef7bqsxc1cy57ay7mjvy5s8me430r8thwcyp65kb8","zoneType":"Z"},"aO9ronhTrg":{"ops":[{"insert":"{\n \"Command\": \"ExternalTextToSpeech\", // 指令类型，固定值，表示文本转语音\n \"Message\": \"请稍等，正在查询。\", // 需要播放的安抚语文本\n \"InterruptMode\": 3 // 必须为 3，表示如果此时 AI 正在交互，系统会直接丢弃传入的安抚语文本。如果未在交互，AI 才会将安抚语送入TTS 播放\n}\n"}],"zoneId":"aO9ronhTrg","zoneType":"Z"},"xr1jedcctb7ny696bakrj3zezsrczef7bqsxc16jvtb00z92ia67rk9bo3hrarczlwv0g5":{"ops":[{"insert":"安抚语配置信息，JSON 字符串格式，内容如下：\n"},{"insert":" ","attributes":{"type":"codeblock","language":"JSON","zoneId":"aO9ronhTrg","wrap":"true"}},{"insert":"\n"}],"zoneId":"xr1jedcctb7ny696bakrj3zezsrczef7bqsxc16jvtb00z92ia67rk9bo3hrarczlwv0g5","zoneType":"Z"},"rswaavjhvc3t6tn9d11pik9wd7jd6otvz2":{"ops":[{"insert":{"id":"r1hiz19w114ci5cepnt7fniadaccsadbqh"}},{"insert":{"id":"r137c51lc0n929oos8hyol1134bp6lopt8"}},{"insert":{"id":"r12kimqc56nqoac80905b56nlnlkzp0cim"}},{"insert":{"id":"r1jedcctb7ny696bakrj3zezsrczef7bqs"}}],"zoneId":"rswaavjhvc3t6tn9d11pik9wd7jd6otvz2","zoneType":"R"},"csu8qa0m0d6gdsafbdh2sucrk0f754qmft":{"ops":[{"insert":{"id":"c1fjb2hvikhys93u3fqf0pk2dzj1t5cvgp"},"attributes":{"colWidth":"210"}},{"insert":{"id":"c1cy57ay7mjvy5s8me430r8thwcyp65kb8"},"attributes":{"colWidth":"100"}},{"insert":{"id":"c16jvtb00z92ia67rk9bo3hrarczlwv0g5"},"attributes":{"colWidth":"763"}}],"zoneId":"csu8qa0m0d6gdsafbdh2sucrk0f754qmft","zoneType":"C"},"pGcmIzfr4d":{"ops":[{"insert":"// 发送文本转语音（TTS）指令，让 AI 播报指定的安抚语内容。\nvoid sendTTSMessage(const std::string &uid, const std::string& content) {\n nlohmann::json json_data;\n json_data[\"Command\"] = \"ExternalTextToSpeech\";\n json_data[\"Message\"] = content;\n json_data[\"InterruptMode\"] = 3; \n sendUserBinaryMessage(uid, json_data.dump());\n}\n\nvoid buildBinaryMessage(const std::string& magic_number, const std::string& message, size_t& binary_message_length, std::shared_ptr& binary_message) {\n auto magic_number_length = magic_number.size();\n auto message_length = message.size();\n\n binary_message_length = magic_number_length + 4 + message_length;\n binary_message = std::shared_ptr(new uint8_t[binary_message_length]);\n std::memcpy(binary_message.get(), magic_number.data(), magic_number_length);\n binary_message[magic_number_length] = static_cast((message_length >> 24) & 0xFF);\n binary_message[magic_number_length+1] = static_cast((message_length >> 16) & 0xFF);\n binary_message[magic_number_length+2] = static_cast((message_length >> 8) & 0xFF);\n binary_message[magic_number_length+3] = static_cast(message_length & 0xFF);\n std::memcpy(binary_message.get()+magic_number_length+4, message.data(), message_length);\n}\n\nint sendUserBinaryMessage(const std::string &uid, const std::string& message) {\n if (rtcRoom_ != nullptr)\n {\n size_t length = 0;\n std::shared_ptr binary_message = nullptr;\n buildBinaryMessage(\"ctrl\", message, length, binary_message);\n return rtcRoom_->sendUserBinaryMessage(uid.c_str(), static_cast(length), binary_message.get());\n }\n return -1;\n}\n"}],"zoneId":"pGcmIzfr4d","zoneType":"Z"},"wb1qs2IsgU":{"ops":[{"insert":" ","attributes":{"type":"codeblock","language":"C++","zoneId":"pGcmIzfr4d","wrap":"true"}},{"insert":"\n"}],"zoneId":"wb1qs2IsgU","zoneType":"Z"},"BCkdmTrrfo":{"ops":[{"insert":"// 发送文本转语音（TTS）指令，让智能体播报指定的安抚语内容。\npublic void sendTTSMessage(String userId, String content) {\n JSONObject json = new JSONObject();\n try {\n json.put(\"Command\", \"ExternalTextToSpeech\");\n json.put(\"Message\", content);\n json.put(\"InterruptMode\", 3); \n } catch (JSONException e) {\n throw new RuntimeException(e);\n }\n String jsonString = json.toString();\n byte[] buildBinary = buildBinaryMessage(\"ctrl\", jsonString);\n sendUserBinaryMessage(userId, buildBinary);\n}\n\n\nprivate byte[] buildBinaryMessage(String magic_number, String content) {\n byte[] prefixBytes = magic_number.getBytes(StandardCharsets.UTF_8);\n byte[] contentBytes = content.getBytes(StandardCharsets.UTF_8);\n int contentLength = contentBytes.length;\n\n ByteBuffer buffer = ByteBuffer.allocate(prefixBytes.length + 4 + contentLength);\n buffer.order(ByteOrder.BIG_ENDIAN);\n buffer.put(prefixBytes);\n buffer.putInt(contentLength);\n buffer.put(contentBytes);\n return buffer.array();\n}\n\npublic void sendUserBinaryMessage(String userId, byte[] buffer) {\n if (rtcRoom_ != null) {\n rtcRoom_.sendUserBinaryMessage(userId, buffer, MessageConfig.RELIABLE_ORDERED);\n }\n}\n"}],"zoneId":"BCkdmTrrfo","zoneType":"Z"},"VBGvakgZkT":{"ops":[{"insert":" ","attributes":{"type":"codeblock","language":"Java","zoneId":"BCkdmTrrfo","wrap":"true"}},{"insert":"\n"}],"zoneId":"VBGvakgZkT","zoneType":"Z"},"SmDlFjOdst":{"ops":[{"insert":"import VERTC from '@volcengine/rtc';\n\n\nconst BotName = 'RobotMan_'; // 自定义智能体名称\nconst CommandKey = 'ctrl'; \nconst engine = VERTC.createEngine('Your AppID'); // 你的 RTC 应用 APPId\n\n/**\n * @brief 指令类型\n */\nenum COMMAND {\n /**\n * @brief 发送文本转语音（TTS）指令，让智能体播报指定的安抚语内容。\n */\n EXTERNAL_TEXT_TO_SPEECH = 'ExternalTextToSpeech',\n};\n\n/**\n * @brief 模式设定\n */\nenum INTERRUPT_PRIORITY {\n /**\n * @brief 安抚语模式。\n */\n LOW = 3,\n MEDIUM = 2,\n HIGH = 1\n};\n\n/**\n * @brief 将字符串包装成 TLV\n */\nfunction stringToTLV(inputString: string, type = '') {\n const typeBuffer = new Uint8Array(4);\n\n for (let i = 0; i < type.length; i++) {\n typeBuffer[i] = type.charCodeAt(i);\n }\n\n const lengthBuffer = new Uint32Array(1);\n const valueBuffer = new TextEncoder().encode(inputString);\n\n lengthBuffer[0] = valueBuffer.length;\n\n const tlvBuffer = new Uint8Array(typeBuffer.length + 4 + valueBuffer.length);\n\n tlvBuffer.set(typeBuffer, 0);\n\n tlvBuffer[4] = (lengthBuffer[0] >> 24) & 0xff;\n tlvBuffer[5] = (lengthBuffer[0] >> 16) & 0xff;\n tlvBuffer[6] = (lengthBuffer[0] >> 8) & 0xff;\n tlvBuffer[7] = lengthBuffer[0] & 0xff;\n\n tlvBuffer.set(valueBuffer, 8);\n\n return tlvBuffer.buffer;\n};\n\n\n/**\n * @brief 发送文本转语音（TTS）指令，让智能体播报指定的安抚语内容。\n */\nengine.sendUserBinaryMessage(\n BotName,\n stringToTLV(\n JSON.stringify({\n Command: COMMAND.EXTERNAL_TEXT_TO_SPEECH,\n Message: '请稍等，正在查询。',\n InterruptMode: INTERRUPT_PRIORITY.LOW,\n }),\n CommandKey,\n )\n);\n"}],"zoneId":"SmDlFjOdst","zoneType":"Z"},"LoSAxVQ590":{"ops":[{"insert":" ","attributes":{"type":"codeblock","language":"TypeScript","zoneId":"SmDlFjOdst","wrap":"true"}},{"insert":"\n"}],"zoneId":"LoSAxVQ590","zoneType":"Z"},"B6GUwcARgU":{"ops":[{"insert":"*","attributes":{"zoneId":"wb1qs2IsgU","title":"C++","tabContent":"true"}},{"insert":"*","attributes":{"zoneId":"VBGvakgZkT","title":"Java","tabContent":"true"}},{"insert":"*","attributes":{"zoneId":"LoSAxVQ590","title":"TypeScript","tabContent":"true"}},{"insert":"\n"}],"zoneId":"B6GUwcARgU","zoneType":"Z"},"xr1m186jslp5em9n4agn38vysn0z6gqpv14xc1te66wzg2o08fa1tic6nu5ptgtmmagqh8":{"ops":[{"insert":"字段名\n"}],"zoneId":"xr1m186jslp5em9n4agn38vysn0z6gqpv14xc1te66wzg2o08fa1tic6nu5ptgtmmagqh8","zoneType":"Z"},"xr1m186jslp5em9n4agn38vysn0z6gqpv14xc1heg6e49chwn36saibdufrqot2pk8a4pd":{"ops":[{"insert":"类型\n"}],"zoneId":"xr1m186jslp5em9n4agn38vysn0z6gqpv14xc1heg6e49chwn36saibdufrqot2pk8a4pd","zoneType":"Z"},"xr1m186jslp5em9n4agn38vysn0z6gqpv14xc1n39z3pf35mje02hd6hznuppc6ovf0glj":{"ops":[{"insert":"描述\n"}],"zoneId":"xr1m186jslp5em9n4agn38vysn0z6gqpv14xc1n39z3pf35mje02hd6hznuppc6ovf0glj","zoneType":"Z"},"xr1qeqkc4b0mk2sbfspsqtr2h4uped1gp09xc1te66wzg2o08fa1tic6nu5ptgtmmagqh8":{"ops":[{"insert":"magic number\n"}],"zoneId":"xr1qeqkc4b0mk2sbfspsqtr2h4uped1gp09xc1te66wzg2o08fa1tic6nu5ptgtmmagqh8","zoneType":"Z"},"xr1qeqkc4b0mk2sbfspsqtr2h4uped1gp09xc1heg6e49chwn36saibdufrqot2pk8a4pd":{"ops":[{"insert":"String\n"}],"zoneId":"xr1qeqkc4b0mk2sbfspsqtr2h4uped1gp09xc1heg6e49chwn36saibdufrqot2pk8a4pd","zoneType":"Z"},"xr1qeqkc4b0mk2sbfspsqtr2h4uped1gp09xc1n39z3pf35mje02hd6hznuppc6ovf0glj":{"ops":[{"insert":"消息格式，固定为 "},{"insert":"tool","attributes":{"inlineCode":"true"}},{"insert":"，表示此次消息为函数调用指令。\n"}],"zoneId":"xr1qeqkc4b0mk2sbfspsqtr2h4uped1gp09xc1n39z3pf35mje02hd6hznuppc6ovf0glj","zoneType":"Z"},"xr1oohtvdb81dh5hd318dn6628b4urebpr8xc1te66wzg2o08fa1tic6nu5ptgtmmagqh8":{"ops":[{"insert":"length\n"}],"zoneId":"xr1oohtvdb81dh5hd318dn6628b4urebpr8xc1te66wzg2o08fa1tic6nu5ptgtmmagqh8","zoneType":"Z"},"xr1oohtvdb81dh5hd318dn6628b4urebpr8xc1heg6e49chwn36saibdufrqot2pk8a4pd":{"ops":[{"insert":"String\n"}],"zoneId":"xr1oohtvdb81dh5hd318dn6628b4urebpr8xc1heg6e49chwn36saibdufrqot2pk8a4pd","zoneType":"Z"},"xr1oohtvdb81dh5hd318dn6628b4urebpr8xc1n39z3pf35mje02hd6hznuppc6ovf0glj":{"ops":[{"insert":"调用指令消息长度，单位为 bytes。存放方式为大端序。\n"}],"zoneId":"xr1oohtvdb81dh5hd318dn6628b4urebpr8xc1n39z3pf35mje02hd6hznuppc6ovf0glj","zoneType":"Z"},"xr1vjaqt69pkahu6fyckmb13ln5p99ntll1xc1te66wzg2o08fa1tic6nu5ptgtmmagqh8":{"ops":[{"insert":"tool_message\n"}],"zoneId":"xr1vjaqt69pkahu6fyckmb13ln5p99ntll1xc1te66wzg2o08fa1tic6nu5ptgtmmagqh8","zoneType":"Z"},"xr1vjaqt69pkahu6fyckmb13ln5p99ntll1xc1heg6e49chwn36saibdufrqot2pk8a4pd":{"ops":[{"insert":"String\n"}],"zoneId":"xr1vjaqt69pkahu6fyckmb13ln5p99ntll1xc1heg6e49chwn36saibdufrqot2pk8a4pd","zoneType":"Z"},"HsnrmG0AN5":{"ops":[{"insert":"{\n \"tool_calls\": [\n {\n \"id\": \"call_***45\", // 调用 ID，后续响应需通过此 ID 关联回执\n \"type\": \"function\", // 固定值，表示这是一次函数调用\n \"function\": {\n \"name\": \"get_current_weather\", // 要调用的函数名称\n \"arguments\": \"{\\\"location\\\":\\\"上海\\\"}\" // 执行函数所需的参数，JSON 字符串（注意转义）\n }\n }\n ]\n}\n"}],"zoneId":"HsnrmG0AN5","zoneType":"Z"},"xr1vjaqt69pkahu6fyckmb13ln5p99ntll1xc1n39z3pf35mje02hd6hznuppc6ovf0glj":{"ops":[{"insert":"调用指令消息内容。格式如下：\n"},{"insert":" ","attributes":{"type":"codeblock","language":"JSON","zoneId":"HsnrmG0AN5","wrap":"true"}},{"insert":"\n"}],"zoneId":"xr1vjaqt69pkahu6fyckmb13ln5p99ntll1xc1n39z3pf35mje02hd6hznuppc6ovf0glj","zoneType":"Z"},"rsezmohlw6chz5skyzdcwt5ser6c6mawop":{"ops":[{"insert":{"id":"r1m186jslp5em9n4agn38vysn0z6gqpv14"}},{"insert":{"id":"r1qeqkc4b0mk2sbfspsqtr2h4uped1gp09"}},{"insert":{"id":"r1oohtvdb81dh5hd318dn6628b4urebpr8"}},{"insert":{"id":"r1vjaqt69pkahu6fyckmb13ln5p99ntll1"}}],"zoneId":"rsezmohlw6chz5skyzdcwt5ser6c6mawop","zoneType":"R"},"csznkybmn5dod9i4by3otwagn0zkw119t5":{"ops":[{"insert":{"id":"c1te66wzg2o08fa1tic6nu5ptgtmmagqh8"},"attributes":{"colWidth":"168"}},{"insert":{"id":"c1heg6e49chwn36saibdufrqot2pk8a4pd"},"attributes":{"colWidth":"100"}},{"insert":{"id":"c1n39z3pf35mje02hd6hznuppc6ovf0glj"},"attributes":{"colWidth":"553"}}],"zoneId":"csznkybmn5dod9i4by3otwagn0zkw119t5","zoneType":"C"},"DAwXZ2SMAf":{"ops":[{"insert":"// 定义与JSON结构对应的C++结构体\nstruct FunctionCall {\n std::string name;\n std::string arguments; // 注意：这是一个字符串化的JSON\n};\n\nstruct ToolCall {\n std::string id;\n std::string type;\n FunctionCall function;\n};\n\n\nbool ParseToolMessage(const uint8_t* message, int size, std::vector& out_calls) {\n // 1. 二进制解包\n const int kHeaderSize = 8;\n if (size < kHeaderSize) return false;\n\n uint32_t magic = ntohl(*reinterpret_cast(message));\n if (magic != 0x746F6F6C) return false; // \"tool\"\n\n uint32_t length = ntohl(*reinterpret_cast(message + 4));\n if (size - kHeaderSize != static_cast(length)) return false;\n\n std::string json_str;\n if (length > 0) {\n json_str.assign(reinterpret_cast(message) + kHeaderSize, length);\n }\n\n // 2. 解析JSON\n nlohmann::json json_data = nlohmann::json::parse(json_str, nullptr, false);\n if (json_data.is_discarded() || !json_data.contains(\"tool_calls\") || !json_data[\"tool_calls\"].is_array()) return false;\n\n out_calls.clear();\n\n // 3. 遍历并填充结构体\n for (const auto& item : json_data[\"tool_calls\"]) {\n ToolCall tool_call;\n tool_call.id = item.value(\"id\", \"\");\n tool_call.type = item.value(\"type\", \"\");\n\n if (item.contains(\"function\") && item[\"function\"].is_object()) {\n const auto& func_json = item[\"function\"];\n tool_call.function.name = func_json.value(\"name\", \"\");\n tool_call.function.arguments = func_json.value(\"arguments\", \"{}\");\n }\n out_calls.push_back(tool_call);\n }\n return true;\n}\n"}],"zoneId":"DAwXZ2SMAf","zoneType":"Z"},"VzHpockDeG":{"ops":[{"insert":" ","attributes":{"type":"codeblock","language":"C++","zoneId":"DAwXZ2SMAf","wrap":"true"}},{"insert":"\n"}],"zoneId":"VzHpockDeG","zoneType":"Z"},"jeChpmJkUW":{"ops":[{"insert":"class FunctionDetails {\n @SerializedName(\"name\")\n public String name;\n\n @SerializedName(\"arguments\")\n public String arguments; // 这是一个JSON字符串，可能需要二次解析\n}\n\n// 对应 tool_calls 数组中的每个元素\nclass ToolCall {\n @SerializedName(\"id\")\n public String id; // 这是我们需要的 tool_call_id\n\n @SerializedName(\"type\")\n public String type;\n\n @SerializedName(\"function\")\n public FunctionDetails function;\n}\n\n// 对应 payload 的顶层 JSON 对象\nclass ToolMessagePayload {\n @SerializedName(\"subscriber_user_id\")\n public String subscriberUserId;\n\n @SerializedName(\"tool_calls\")\n public ToolCall[] tool_calls;\n}\n\n\n// 文件 2: 在你的 RTC 客户端中实现回调\n\nclass YourRtcClient {\n // ... 其他代码 ...\n\n // 在 onRoomBinaryMessageReceived 回调中\n // @Override\n public void onRoomBinaryMessageReceived(String uid, ByteBuffer message) {\n // 确保在处理后恢复 ByteBuffer 的位置，以免影响其他处理器\n message.mark();\n\n try {\n message.order(ByteOrder.BIG_ENDIAN);\n if (message.remaining() < 8) return;\n\n byte[] magicBytes = new byte[4];\n message.get(magicBytes);\n String magic = new String(magicBytes, StandardCharsets.UTF_8);\n\n if (\"tool\".equals(magic)) {\n int length = message.getInt();\n if (message.remaining() >= length) {\n byte[] payloadBytes = new byte[length];\n message.get(payloadBytes);\n String payloadStr = new String(payloadBytes, StandardCharsets.UTF_8);\n\n // 使用 Gson 解析\n Gson gson = new Gson();\n ToolMessagePayload toolPayload = gson.fromJson(payloadStr, ToolMessagePayload.class);\n\n // 安全地获取第一个函数调用的信息\n if (toolPayload != null && toolPayload.tool_calls != null && toolPayload.tool_calls.length > 0) {\n ToolCall firstCall = toolPayload.tool_calls[0];\n \n String toolCallId = firstCall.id; // 成功获取 tool_call_id!\n String funcName = firstCall.function.name;\n String argumentsStr = firstCall.function.arguments;\n\n System.out.println(\"FC tool received:\");\n System.out.println(\" - Tool Call ID: \" + toolCallId);\n System.out.println(\" - Function Name: \" + funcName);\n System.out.println(\" - Arguments: \" + argumentsStr);\n\n // argumentsStr 是一个JSON字符串，可以继续解析\n // Map argsMap = gson.fromJson(argumentsStr, Map.class);\n }\n }\n }\n } finally {\n // 恢复 ByteBuffer 的位置\n message.reset();\n }\n }\n}\n"}],"zoneId":"jeChpmJkUW","zoneType":"Z"},"RslvZogPBL":{"ops":[{"insert":" ","attributes":{"type":"codeblock","language":"Java","zoneId":"jeChpmJkUW","wrap":"true"}},{"insert":"\n"}],"zoneId":"RslvZogPBL","zoneType":"Z"},"xXufz3JnjI":{"ops":[{"insert":"interface FunctionDetails {\n name: string;\n arguments: string; // 这是一个JSON字符串，可能需要二次解析\n}\n\n// 对应 tool_calls 数组中的每个元素\ninterface ToolCall {\n id: string; // 这是我们需要的 tool_call_id\n type: string;\n function: FunctionDetails;\n}\n\n// 对应 payload 的顶层 JSON 对象\ninterface ToolMessagePayload {\n subscriber_user_id: string;\n tool_calls: ToolCall[];\n}\n\n\n// 2. 在你的 RTC 客户端中实现回调\nengine.on('onRoomBinaryMessageReceived', (event: { userId: string, message: ArrayBuffer }) => {\n const { userId, message } = event;\n if (message.byteLength < 8) return;\n\n const dataView = new DataView(message);\n const magic = new TextDecoder().decode(message.slice(0, 4));\n\n if (magic === 'tool') {\n const length = dataView.getUint32(4, false); // false for big-endian\n if (message.byteLength < 8 + length) return;\n\n const payloadStr = new TextDecoder().decode(message.slice(8, 8 + length));\n \n // 使用正确的顶层接口来解析\n const toolPayload: ToolMessagePayload = JSON.parse(payloadStr);\n \n // 安全地获取第一个函数调用的信息\n if (toolPayload && toolPayload.tool_calls && toolPayload.tool_calls.length > 0) {\n const firstCall = toolPayload.tool_calls[0];\n \n const toolCallId = firstCall.id; // 成功获取 tool_call_id!\n const funcName = firstCall.function.name;\n const argumentsStr = firstCall.function.arguments;\n\n console.log('FC tool received:', {\n fromUserId: userId,\n tool_call_id: toolCallId,\n function_name: funcName,\n function_args_str: argumentsStr\n });\n \n // argumentsStr 是一个字符串化的JSON，可以继续解析\n try {\n const args = JSON.parse(argumentsStr);\n console.log('Parsed arguments:', args);\n } catch (e) {\n console.error('Failed to parse function arguments string:', e);\n }\n }\n }\n});\n"}],"zoneId":"xXufz3JnjI","zoneType":"Z"},"vNQWRm9V5A":{"ops":[{"insert":" ","attributes":{"type":"codeblock","language":"TypeScript","zoneId":"xXufz3JnjI","wrap":"true"}},{"insert":"\n"}],"zoneId":"vNQWRm9V5A","zoneType":"Z"},"LLI9a1vB7B":{"ops":[{"insert":"*","attributes":{"zoneId":"VzHpockDeG","title":"C++","tabContent":"true"}},{"insert":"*","attributes":{"zoneId":"RslvZogPBL","title":"Java","tabContent":"true"}},{"insert":"*","attributes":{"zoneId":"vNQWRm9V5A","title":"TypeScript","tabContent":"true"}},{"insert":"\n"}],"zoneId":"LLI9a1vB7B","zoneType":"Z"},"xr1is5iknakuom1omja865phhkdwtbu5h6ixc11k44jpjjvi58qsihe40v70pp380bpzqa":{"ops":[{"insert":"参数名\n"}],"zoneId":"xr1is5iknakuom1omja865phhkdwtbu5h6ixc11k44jpjjvi58qsihe40v70pp380bpzqa","zoneType":"Z"},"xr1is5iknakuom1omja865phhkdwtbu5h6ixc1qpehz6lc3i2yojw7vpwl1y8166nr46jr":{"ops":[{"insert":"类型\n"}],"zoneId":"xr1is5iknakuom1omja865phhkdwtbu5h6ixc1qpehz6lc3i2yojw7vpwl1y8166nr46jr","zoneType":"Z"},"xr1is5iknakuom1omja865phhkdwtbu5h6ixc1u1giequ1javym01zo45ca8trd4jz1c0f":{"ops":[{"insert":"描述\n"}],"zoneId":"xr1is5iknakuom1omja865phhkdwtbu5h6ixc1u1giequ1javym01zo45ca8trd4jz1c0f","zoneType":"Z"},"xr1guanfqtb45531vyq9e0id41oprcr7y10xc11k44jpjjvi58qsihe40v70pp380bpzqa":{"ops":[{"insert":"magic number\n"}],"zoneId":"xr1guanfqtb45531vyq9e0id41oprcr7y10xc11k44jpjjvi58qsihe40v70pp380bpzqa","zoneType":"Z"},"xr1guanfqtb45531vyq9e0id41oprcr7y10xc1qpehz6lc3i2yojw7vpwl1y8166nr46jr":{"ops":[{"insert":"String\n"}],"zoneId":"xr1guanfqtb45531vyq9e0id41oprcr7y10xc1qpehz6lc3i2yojw7vpwl1y8166nr46jr","zoneType":"Z"},"xr1guanfqtb45531vyq9e0id41oprcr7y10xc1u1giequ1javym01zo45ca8trd4jz1c0f":{"ops":[{"insert":"消息格式，固定为 "},{"insert":"func","attributes":{"inlineCode":"true"}},{"insert":"。\n"}],"zoneId":"xr1guanfqtb45531vyq9e0id41oprcr7y10xc1u1giequ1javym01zo45ca8trd4jz1c0f","zoneType":"Z"},"xr1w4kjswctqbtplmjah56jbype55lere7gxc11k44jpjjvi58qsihe40v70pp380bpzqa":{"ops":[{"insert":"length\n"}],"zoneId":"xr1w4kjswctqbtplmjah56jbype55lere7gxc11k44jpjjvi58qsihe40v70pp380bpzqa","zoneType":"Z"},"xr1w4kjswctqbtplmjah56jbype55lere7gxc1qpehz6lc3i2yojw7vpwl1y8166nr46jr":{"ops":[{"insert":"String\n"}],"zoneId":"xr1w4kjswctqbtplmjah56jbype55lere7gxc1qpehz6lc3i2yojw7vpwl1y8166nr46jr","zoneType":"Z"},"xr1w4kjswctqbtplmjah56jbype55lere7gxc1u1giequ1javym01zo45ca8trd4jz1c0f":{"ops":[{"insert":"函数调用的结果信息长度，单位为 bytes。存放方式为大端序。\n"}],"zoneId":"xr1w4kjswctqbtplmjah56jbype55lere7gxc1u1giequ1javym01zo45ca8trd4jz1c0f","zoneType":"Z"},"xr17mg9oocmfpn6ohy99o7l3990hcc2hoisxc11k44jpjjvi58qsihe40v70pp380bpzqa":{"ops":[{"insert":"Function_Response\n"}],"zoneId":"xr17mg9oocmfpn6ohy99o7l3990hcc2hoisxc11k44jpjjvi58qsihe40v70pp380bpzqa","zoneType":"Z"},"xr17mg9oocmfpn6ohy99o7l3990hcc2hoisxc1qpehz6lc3i2yojw7vpwl1y8166nr46jr":{"ops":[{"insert":"String\n"}],"zoneId":"xr17mg9oocmfpn6ohy99o7l3990hcc2hoisxc1qpehz6lc3i2yojw7vpwl1y8166nr46jr","zoneType":"Z"},"xr17mg9oocmfpn6ohy99o7l3990hcc2hoisxc1u1giequ1javym01zo45ca8trd4jz1c0f":{"ops":[{"insert":"函数调用的结果信息。\n"}],"zoneId":"xr17mg9oocmfpn6ohy99o7l3990hcc2hoisxc1u1giequ1javym01zo45ca8trd4jz1c0f","zoneType":"Z"},"rsrwz6i3sy4s298rqpump1i7lzdss8qvfa":{"ops":[{"insert":{"id":"r1is5iknakuom1omja865phhkdwtbu5h6i"}},{"insert":{"id":"r1guanfqtb45531vyq9e0id41oprcr7y10"}},{"insert":{"id":"r1w4kjswctqbtplmjah56jbype55lere7g"}},{"insert":{"id":"r17mg9oocmfpn6ohy99o7l3990hcc2hois"}}],"zoneId":"rsrwz6i3sy4s298rqpump1i7lzdss8qvfa","zoneType":"R"},"cshgnb3frv1gwstzbdsesh7pz8mwupd0qq":{"ops":[{"insert":{"id":"c11k44jpjjvi58qsihe40v70pp380bpzqa"},"attributes":{"colWidth":"238"}},{"insert":{"id":"c1qpehz6lc3i2yojw7vpwl1y8166nr46jr"},"attributes":{"colWidth":"100"}},{"insert":{"id":"c1u1giequ1javym01zo45ca8trd4jz1c0f"},"attributes":{"colWidth":"609"}}],"zoneId":"cshgnb3frv1gwstzbdsesh7pz8mwupd0qq","zoneType":"C"},"G6VRiHAZID":{"ops":[{"insert":"// 依赖 nlohmann/json 库进行 JSON 操作\n// https://github.com/nlohmann/json\n#include \"json.hpp\"\n\n// 为方便使用\nusing json = nlohmann::json;\n\n// --- 配置项 ---\n// 请将此处的 \"RobotMan_\" 替换为您为 AI 的实际 UserId\nconst std::string kAgentUserId = \"RobotMan_\";\n\n\n// 发送二进制消息的函数\n// 您需要根据实际的 SDK 接口进行适配\nvoid sendUserBinaryMessage(const std::string& userId, const std::vector& message);\n\n\n/**\n * @brief 将 JSON 字符串打包成 'func' 类型的 TLV 字节流\n */\nstd::vector stringToTLV(const std::string& content) {\n const std::string type = \"func\";\n size_t type_len = type.length();\n size_t content_len = content.length();\n size_t total_len = type_len + 4 + content_len;\n\n std::vector buffer(total_len);\n\n // 1. 写入 Type (\"func\")\n std::memcpy(buffer.data(), type.data(), type_len);\n\n // 2. 写入 Length (大端序)\n buffer[type_len + 0] = (content_len >> 24) & 0xFF;\n buffer[type_len + 1] = (content_len >> 16) & 0xFF;\n buffer[type_len + 2] = (content_len >> 8) & 0xFF;\n buffer[type_len + 3] = content_len & 0xFF;\n\n // 3. 写入 Value (JSON 字符串)\n if (!content.empty()) {\n std::memcpy(buffer.data() + type_len + 4, content.data(), content_len);\n }\n\n return buffer;\n}\n\n\n/**\n * @brief 发送函数调用的响应\n */\nvoid SendFunctionResponse(const std::string& toolCallID, const std::string& content) {\n json payload;\n payload[\"ToolCallID\"] = toolCallID;\n payload[\"Content\"] = content;\n\n std::string jsonString = payload.dump();\n \n std::vector binaryMessage = stringToTLV(jsonString);\n\n // 将二进制消息发送给指定的 AI\n sendUserBinaryMessage(kAgentUserId, binaryMessage);\n}\n"}],"zoneId":"G6VRiHAZID","zoneType":"Z"},"T4saAHiVQu":{"ops":[{"insert":" ","attributes":{"type":"codeblock","language":"C++","zoneId":"G6VRiHAZID","wrap":"true"}},{"insert":"\n"}],"zoneId":"T4saAHiVQu","zoneType":"Z"},"rEj9dLx4W8":{"ops":[{"insert":"public void SendFunctionResponse(String ToolCallID, String Content) {\n JSONObject json = new JSONObject();\n try {\n json.put(\"ToolCallID\", ToolCallID);\n json.put(\"Content\", Content);\n } catch (JSONException e) {\n throw new RuntimeException(e);\n }\n String jsonString = json.toString();\n System.out.println(jsonString);\n\n // 请将 \"AgentUserId\" 替换为您为 AI 智能体设置的实际 UserId\n app.rtcSdkWrap.sendUserBinaryMessage(\"AgentUserId\", stringToTLV(jsonString));\n}\n\npublic byte[] stringToTLV(String content) {\n String func_type = \"func\";\n byte[] prefixBytes = func_type.getBytes(StandardCharsets.UTF_8);\n byte[] contentBytes = content.getBytes(StandardCharsets.UTF_8);\n int contentLength = contentBytes.length;\n\n ByteBuffer buffer = ByteBuffer.allocate(prefixBytes.length + 4 + contentLength);\n buffer.order(ByteOrder.BIG_ENDIAN);\n buffer.put(prefixBytes);\n buffer.putInt(contentLength);\n buffer.put(contentBytes);\n return buffer.array();\n}\n"}],"zoneId":"rEj9dLx4W8","zoneType":"Z"},"Uo3R59yYBz":{"ops":[{"insert":" ","attributes":{"type":"codeblock","language":"Java","zoneId":"rEj9dLx4W8","wrap":"true"}},{"insert":"\n"}],"zoneId":"Uo3R59yYBz","zoneType":"Z"},"rYz1mupalU":{"ops":[{"insert":"import VERTC from '@volcengine/rtc';\n\n/**\n * @brief 将字符串包装成 TLV\n */\nfunction stringToTLV(inputString: string) {\n const type = 'func';\n const typeBuffer = new Uint8Array(4);\n\n for (let i = 0; i < type.length; i++) {\n typeBuffer[i] = type.charCodeAt(i);\n }\n\n const lengthBuffer = new Uint32Array(1);\n const valueBuffer = new TextEncoder().encode(inputString);\n\n lengthBuffer[0] = valueBuffer.length;\n\n const tlvBuffer = new Uint8Array(typeBuffer.length + 4 + valueBuffer.length);\n\n tlvBuffer.set(typeBuffer, 0);\n\n tlvBuffer[4] = (lengthBuffer[0] >> 24) & 0xff;\n tlvBuffer[5] = (lengthBuffer[0] >> 16) & 0xff;\n tlvBuffer[6] = (lengthBuffer[0] >> 8) & 0xff;\n tlvBuffer[7] = lengthBuffer[0] & 0xff;\n\n tlvBuffer.set(valueBuffer, 8);\n\n return tlvBuffer.buffer;\n};\n\n/**\n * @brief TLV 数据格式转换成字符串\n * @note TLV 数据格式\n * | magic number | length(big-endian) | value |\n * @param {ArrayBufferLike} tlvBuffer\n * @returns \n */\nfunction tlv2String(tlvBuffer: ArrayBufferLike) {\n const typeBuffer = new Uint8Array(tlvBuffer, 0, 4);\n const lengthBuffer = new Uint8Array(tlvBuffer, 4, 4);\n const valueBuffer = new Uint8Array(tlvBuffer, 8);\n\n let type = '';\n for (let i = 0; i < typeBuffer.length; i++) {\n type += String.fromCharCode(typeBuffer[i]);\n }\n\n const length =\n (lengthBuffer[0] << 24) | (lengthBuffer[1] << 16) | (lengthBuffer[2] << 8) | lengthBuffer[3];\n\n const value = new TextDecoder().decode(valueBuffer.subarray(0, length));\n\n return { type, value };\n};\n\n/**\n * @brief 通过 onRoomBinaryMessageReceived 接收 toolcall\n * 通过 sendUserBinaryMessage 发送 response\n */\nfunction handleRoomBinaryMessageReceived(\n event: {\n userId: string;\n message: ArrayBuffer;\n },\n) {\n const { message } = event;\n const { type, value } = tlv2String(message);\n const data = JSON.parse(value);\n const tool_calls = data?.tool_calls;\n \n if (tool_calls?.length) {\n // 为简化示例，我们只处理第一个函数调用\n const toolCall = tool_calls[0];\n const functionName = toolCall.function.name;\n // 关键：'arguments' 是一个 JSON 字符串，必须先解析成对象才能使用\n const functionArgs = JSON.parse(toolCall.function.arguments);\n\n // 请在此处替换为您自己的函数调用逻辑\n // 下方代码仅为通用示例，展示了如何根据函数名和参数动态生成结果。\n // 在真实场景中，您需要根据 functionName 调用您自己的真实函数。\n const functionResult = `函数 \\\\${functionName} 已执行，收到的参数为: \\\\${JSON.stringify(functionArgs)}`;\n \n this.engine.sendUserBinaryMessage(\n 'Your AI Bot Name', // 请将 'Your AI Bot Name' 替换为您为 AI 智能体设置的实际 UserId\n stringToTLV(\n JSON.stringify({\n ToolCallID: toolCall.id,\n Content: functionResult, // 将函数执行结果回传\n })\n )\n );\n }\n};\n\n/**\n * @brief 监听房间内二进制消息\n */\nthis.engine.on(VERTC.events.onRoomBinaryMessageReceived, handleRoomBinaryMessageReceived.bind(this));\n"}],"zoneId":"rYz1mupalU","zoneType":"Z"},"l3LiAjrXT0":{"ops":[{"insert":" ","attributes":{"type":"codeblock","language":"TypeScript","zoneId":"rYz1mupalU","wrap":"true"}},{"insert":"\n"}],"zoneId":"l3LiAjrXT0","zoneType":"Z"},"WjkivGNbOD":{"ops":[{"insert":"*","attributes":{"zoneId":"T4saAHiVQu","title":"C++","tabContent":"true"}},{"insert":"*","attributes":{"zoneId":"Uo3R59yYBz","title":"Java","tabContent":"true"}},{"insert":"*","attributes":{"zoneId":"l3LiAjrXT0","title":"TypeScript","tabContent":"true"}},{"insert":"\n"}],"zoneId":"WjkivGNbOD","zoneType":"Z"},"xr1e3rhdp65k27ztavip59tnzs73uj0udq6xc12s0eh728mwjs6o49vfda1w6s0wgmusbq":{"ops":[{"insert":"参数名\n"}],"zoneId":"xr1e3rhdp65k27ztavip59tnzs73uj0udq6xc12s0eh728mwjs6o49vfda1w6s0wgmusbq","zoneType":"Z"},"xr1e3rhdp65k27ztavip59tnzs73uj0udq6xc1qnj9ep4uqo0uw32mp2778bpeaysuyv91":{"ops":[{"insert":"类型\n"}],"zoneId":"xr1e3rhdp65k27ztavip59tnzs73uj0udq6xc1qnj9ep4uqo0uw32mp2778bpeaysuyv91","zoneType":"Z"},"xr1e3rhdp65k27ztavip59tnzs73uj0udq6xc1brzm6wtqyc3bgw9rrl5p00u6j5fczeaz":{"ops":[{"insert":"描述\n"}],"zoneId":"xr1e3rhdp65k27ztavip59tnzs73uj0udq6xc1brzm6wtqyc3bgw9rrl5p00u6j5fczeaz","zoneType":"Z"},"xr11o484tb4k4gygeq5aiaev3wilnidodcbxc12s0eh728mwjs6o49vfda1w6s0wgmusbq":{"ops":[{"insert":"magic number\n"}],"zoneId":"xr11o484tb4k4gygeq5aiaev3wilnidodcbxc12s0eh728mwjs6o49vfda1w6s0wgmusbq","zoneType":"Z"},"xr11o484tb4k4gygeq5aiaev3wilnidodcbxc1qnj9ep4uqo0uw32mp2778bpeaysuyv91":{"ops":[{"insert":"String\n"}],"zoneId":"xr11o484tb4k4gygeq5aiaev3wilnidodcbxc1qnj9ep4uqo0uw32mp2778bpeaysuyv91","zoneType":"Z"},"xr11o484tb4k4gygeq5aiaev3wilnidodcbxc1brzm6wtqyc3bgw9rrl5p00u6j5fczeaz":{"ops":[{"insert":"消息格式标识符，当前场景消息格式固定为 "},{"insert":"ctrl","attributes":{"inlineCode":"true"}},{"insert":"，用于标识该消息为控制消息。\n"}],"zoneId":"xr11o484tb4k4gygeq5aiaev3wilnidodcbxc1brzm6wtqyc3bgw9rrl5p00u6j5fczeaz","zoneType":"Z"},"xr1h5q2wgmc2ptj35ov4gr66a171bsdnj82xc12s0eh728mwjs6o49vfda1w6s0wgmusbq":{"ops":[{"insert":"length\n"}],"zoneId":"xr1h5q2wgmc2ptj35ov4gr66a171bsdnj82xc12s0eh728mwjs6o49vfda1w6s0wgmusbq","zoneType":"Z"},"xr1h5q2wgmc2ptj35ov4gr66a171bsdnj82xc1qnj9ep4uqo0uw32mp2778bpeaysuyv91":{"ops":[{"insert":"String\n"}],"zoneId":"xr1h5q2wgmc2ptj35ov4gr66a171bsdnj82xc1qnj9ep4uqo0uw32mp2778bpeaysuyv91","zoneType":"Z"},"xr1h5q2wgmc2ptj35ov4gr66a171bsdnj82xc1brzm6wtqyc3bgw9rrl5p00u6j5fczeaz":{"ops":[{"insert":"函数调用的结果信息长度，单位为 bytes。存放方式为大端序。\n"}],"zoneId":"xr1h5q2wgmc2ptj35ov4gr66a171bsdnj82xc1brzm6wtqyc3bgw9rrl5p00u6j5fczeaz","zoneType":"Z"},"xr10rf3grot34g2sysw6kjc1dpf3yuqms6wxc12s0eh728mwjs6o49vfda1w6s0wgmusbq":{"ops":[{"insert":"control_message\n"}],"zoneId":"xr10rf3grot34g2sysw6kjc1dpf3yuqms6wxc12s0eh728mwjs6o49vfda1w6s0wgmusbq","zoneType":"Z"},"xr10rf3grot34g2sysw6kjc1dpf3yuqms6wxc1qnj9ep4uqo0uw32mp2778bpeaysuyv91":{"ops":[{"insert":"String\n"}],"zoneId":"xr10rf3grot34g2sysw6kjc1dpf3yuqms6wxc1qnj9ep4uqo0uw32mp2778bpeaysuyv91","zoneType":"Z"},"f2Yq7jKdBL":{"ops":[{"insert":"{\n \"Command\": \"ExternalTextToSpeech\", // 固定值\n \"Message\": \"这里是函数调用的结果信息\", // 传入函数调用的结果\n \"InterruptMode\": 2 //必须为 2，直接播放函数结果，确保其不会被打断。\n}\n"}],"zoneId":"f2Yq7jKdBL","zoneType":"Z"},"xr10rf3grot34g2sysw6kjc1dpf3yuqms6wxc1brzm6wtqyc3bgw9rrl5p00u6j5fczeaz":{"ops":[{"insert":"函数调用的结果配置信息。具体内容格式如下：\n"},{"insert":" ","attributes":{"type":"codeblock","language":"JSON","zoneId":"f2Yq7jKdBL","wrap":"true"}},{"insert":"\n"}],"zoneId":"xr10rf3grot34g2sysw6kjc1dpf3yuqms6wxc1brzm6wtqyc3bgw9rrl5p00u6j5fczeaz","zoneType":"Z"},"rs5e53u7d06eenpne0uiucfy4lyauud60n":{"ops":[{"insert":{"id":"r1e3rhdp65k27ztavip59tnzs73uj0udq6"}},{"insert":{"id":"r11o484tb4k4gygeq5aiaev3wilnidodcb"}},{"insert":{"id":"r1h5q2wgmc2ptj35ov4gr66a171bsdnj82"}},{"insert":{"id":"r10rf3grot34g2sysw6kjc1dpf3yuqms6w"}}],"zoneId":"rs5e53u7d06eenpne0uiucfy4lyauud60n","zoneType":"R"},"cs68ap5h79t03qwp6bv39n94q41rtsuo5m":{"ops":[{"insert":{"id":"c12s0eh728mwjs6o49vfda1w6s0wgmusbq"},"attributes":{"colWidth":"210"}},{"insert":{"id":"c1qnj9ep4uqo0uw32mp2778bpeaysuyv91"},"attributes":{"colWidth":"100"}},{"insert":{"id":"c1brzm6wtqyc3bgw9rrl5p00u6j5fczeaz"},"attributes":{"colWidth":"763"}}],"zoneId":"cs68ap5h79t03qwp6bv39n94q41rtsuo5m","zoneType":"C"},"LJbrrGckzy":{"ops":[{"insert":"// 发送文本转语音（TTS）指令，让 AI 播报函数调用的结果信息\nvoid sendTTSMessage(const std::string &uid, const std::string& content) {\n nlohmann::json json_data;\n json_data[\"Command\"] = \"ExternalTextToSpeech\";\n json_data[\"Message\"] = content;\n json_data[\"InterruptMode\"] = 2; \n sendUserBinaryMessage(uid, json_data.dump());\n}\n\nvoid buildBinaryMessage(const std::string& magic_number, const std::string& message, size_t& binary_message_length, std::shared_ptr& binary_message) {\n auto magic_number_length = magic_number.size();\n auto message_length = message.size();\n\n binary_message_length = magic_number_length + 4 + message_length;\n binary_message = std::shared_ptr(new uint8_t[binary_message_length]);\n std::memcpy(binary_message.get(), magic_number.data(), magic_number_length);\n binary_message[magic_number_length] = static_cast((message_length >> 24) & 0xFF);\n binary_message[magic_number_length+1] = static_cast((message_length >> 16) & 0xFF);\n binary_message[magic_number_length+2] = static_cast((message_length >> 8) & 0xFF);\n binary_message[magic_number_length+3] = static_cast(message_length & 0xFF);\n std::memcpy(binary_message.get()+magic_number_length+4, message.data(), message_length);\n}\n\nint sendUserBinaryMessage(const std::string &uid, const std::string& message) {\n if (rtcRoom_ != nullptr)\n {\n size_t length = 0;\n std::shared_ptr binary_message = nullptr;\n buildBinaryMessage(\"ctrl\", message, length, binary_message);\n return rtcRoom_->sendUserBinaryMessage(uid.c_str(), static_cast(length), binary_message.get());\n }\n return -1;\n}\n"}],"zoneId":"LJbrrGckzy","zoneType":"Z"},"vk7sRVIwwx":{"ops":[{"insert":" ","attributes":{"type":"codeblock","language":"C++","zoneId":"LJbrrGckzy","wrap":"true"}},{"insert":"\n"}],"zoneId":"vk7sRVIwwx","zoneType":"Z"},"FyMhCY331m":{"ops":[{"insert":"// 发送文本转语音（TTS）指令，让智能体播报工具调用的结果信息\npublic void sendTTSMessage(String userId, String content) {\n JSONObject json = new JSONObject();\n try {\n json.put(\"Command\", \"ExternalTextToSpeech\");\n json.put(\"Message\", content);\n json.put(\"InterruptMode\", 2); \n } catch (JSONException e) {\n throw new RuntimeException(e);\n }\n String jsonString = json.toString();\n byte[] buildBinary = buildBinaryMessage(\"ctrl\", jsonString);\n sendUserBinaryMessage(userId, buildBinary);\n}\n\n\nprivate byte[] buildBinaryMessage(String magic_number, String content) {\n byte[] prefixBytes = magic_number.getBytes(StandardCharsets.UTF_8);\n byte[] contentBytes = content.getBytes(StandardCharsets.UTF_8);\n int contentLength = contentBytes.length;\n\n ByteBuffer buffer = ByteBuffer.allocate(prefixBytes.length + 4 + contentLength);\n buffer.order(ByteOrder.BIG_ENDIAN);\n buffer.put(prefixBytes);\n buffer.putInt(contentLength);\n buffer.put(contentBytes);\n return buffer.array();\n}\n\npublic void sendUserBinaryMessage(String userId, byte[] buffer) {\n if (rtcRoom_ != null) {\n rtcRoom_.sendUserBinaryMessage(userId, buffer, MessageConfig.RELIABLE_ORDERED);\n }\n}\n"}],"zoneId":"FyMhCY331m","zoneType":"Z"},"EptkvR8SjF":{"ops":[{"insert":" ","attributes":{"type":"codeblock","language":"Java","zoneId":"FyMhCY331m","wrap":"true"}},{"insert":"\n"}],"zoneId":"EptkvR8SjF","zoneType":"Z"},"bisastPnS2":{"ops":[{"insert":"import VERTC from '@volcengine/rtc';\n\n\nconst BotName = 'RobotMan_'; // 自定义智能体名称\nconst CommandKey = 'ctrl'; \nconst engine = VERTC.createEngine('Your AppID'); // 你的 RTC 应用 AppId\n\n/**\n * @brief 指令类型\n */\nenum COMMAND {\n /**\n * @brief 发送文本转语音（TTS）指令，让智能体播报工具调用的结果信息\n */\n EXTERNAL_TEXT_TO_SPEECH = 'ExternalTextToSpeech',\n};\n\n/**\n * @brief 模式设定\n */\nenum INTERRUPT_PRIORITY {\n /**\n * @brief 智能体播报调用指令消息内容模式。\n */\n LOW = 3,\n MEDIUM = 2,\n HIGH = 1\n};\n\n/**\n * @brief 将字符串包装成 TLV\n */\nfunction stringToTLV(inputString: string, type = '') {\n const typeBuffer = new Uint8Array(4);\n\n for (let i = 0; i < type.length; i++) {\n typeBuffer[i] = type.charCodeAt(i);\n }\n\n const lengthBuffer = new Uint32Array(1);\n const valueBuffer = new TextEncoder().encode(inputString);\n\n lengthBuffer[0] = valueBuffer.length;\n\n const tlvBuffer = new Uint8Array(typeBuffer.length + 4 + valueBuffer.length);\n\n tlvBuffer.set(typeBuffer, 0);\n\n tlvBuffer[4] = (lengthBuffer[0] >> 24) & 0xff;\n tlvBuffer[5] = (lengthBuffer[0] >> 16) & 0xff;\n tlvBuffer[6] = (lengthBuffer[0] >> 8) & 0xff;\n tlvBuffer[7] = lengthBuffer[0] & 0xff;\n\n tlvBuffer.set(valueBuffer, 8);\n\n return tlvBuffer.buffer;\n};\n\n\n/**\n * @brief 发送文本转语音（TTS）指令，让智能体播报函数调用的结果信息。\n */\nengine.sendUserBinaryMessage(\n BotName,\n stringToTLV(\n JSON.stringify({\n Command: COMMAND.EXTERNAL_TEXT_TO_SPEECH,\n Message: '上海天气是晴天，25摄氏度',\n InterruptMode: INTERRUPT_PRIORITY.MEDIUM,\n }),\n CommandKey,\n )\n);\n"}],"zoneId":"bisastPnS2","zoneType":"Z"},"ZmYlhL2uYc":{"ops":[{"insert":" ","attributes":{"type":"codeblock","language":"TypeScript","zoneId":"bisastPnS2","wrap":"true"}},{"insert":"\n"}],"zoneId":"ZmYlhL2uYc","zoneType":"Z"},"M9x2CAMJK4":{"ops":[{"insert":"*","attributes":{"zoneId":"vk7sRVIwwx","title":"C++","tabContent":"true"}},{"insert":"*","attributes":{"zoneId":"EptkvR8SjF","title":"Java","tabContent":"true"}},{"insert":"*","attributes":{"zoneId":"ZmYlhL2uYc","title":"TypeScript","tabContent":"true"}},{"insert":"\n"}],"zoneId":"M9x2CAMJK4","zoneType":"Z"},"P8MpgwGeC1":{"ops":[{"insert":"[\n {\"name\": \"get_current_weather\", \"arguments\": {}},\n {\"name\": \"get_stock_price\", \"arguments\": {\"ticker\": \"A\"}}\n]\n"}],"zoneId":"P8MpgwGeC1","zoneType":"Z"},"GwJ413RdBu":{"ops":[{"insert":"## 工具调用规则\n你拥有以下工具，仅在准确识别到用户的意图与下方某个工具功能匹配时，才调用该工具：\n1. `adjust_volume`（调整音量）：仅当用户表达了任何想改变设备音量时调用。例如，“我听不清了”、“声音太大了”、“帮我静音”、“调大音量”等。\n2. `get_current_weather`（查询天气）：仅当用户表达了想了解气象信息时调用。例如，“明天杭州会下雨吗？”、“帮我查询上海的天气”、“外面冷不冷？”等。\n如果用户意图不匹配上述任何一个工具的触发条件，严禁调用任何工具请直接对话；如果用户意图模糊，请通过提问来澄清意图。\n"}],"zoneId":"GwJ413RdBu","zoneType":"Z"},"a90rzPUidT":{"ops":[{"insert":" ","attributes":{"type":"codeblock","language":"Plain Text","zoneId":"GwJ413RdBu","wrap":"true"}},{"insert":"\n"}],"zoneId":"a90rzPUidT","zoneType":"Z"},"zFZDeQr7vZ":{"ops":[{"insert":"\"LLMConfig\": {\n // ... 其他 LLM 参数，如 Mode, Tools ...\n \"SystemMessages\": [\n // ... 此处可包含其他角色设定或行为准则 ...\n \"## 工具调用规则\\\\n你拥有以下工具，仅在准确识别到用户的意图与下方某个工具功能匹配时，才调用该工具：\\\\n1. `adjust_volume`（调整音量）：仅当用户表达了任何想改变设备音量时调用。例如，“我听不清了”、“声音太大了”、“帮我静音”、“调大音量”等。\\\\n2. `get_current_weather`（查询天气）：仅当用户表达了想了解气象信息时调用。例如，“明天杭州会下雨吗？”、“帮我查询上海的天气”、“外面冷不冷？”等。\\\\n如果用户意图不匹配上述任何一个工具的触发条件，严禁调用任何工具请直接对话；如果用户意图模糊，请通过提问来澄清意图。\"\n ]\n}\n"}],"zoneId":"zFZDeQr7vZ","zoneType":"Z"},"Ik7WHHblBM":{"ops":[{"insert":" ","attributes":{"type":"codeblock","language":"JSON","zoneId":"zFZDeQr7vZ","wrap":"true"}},{"insert":"\n"}],"zoneId":"Ik7WHHblBM","zoneType":"Z"},"Pnj5H1pk5X":{"ops":[{"insert":"*","attributes":{"zoneId":"a90rzPUidT","title":"提示词示例","tabContent":"true"}},{"insert":"*","attributes":{"zoneId":"Ik7WHHblBM","title":"对应 SystemMessages 示例","tabContent":"true"}},{"insert":"\n"}],"zoneId":"Pnj5H1pk5X","zoneType":"Z"}}}

实时音视频