理开发干货Gemini 3.1 引的“思维链标签”在 API 中的调方式|Duuu笔记
在生产环境中优化前端，本文分析
需同时配置三项：一、设置 response_mime_type 为 "text/x-markdown"；二、在 system_instruction 中精确声明“请逐步推理，并在每段推理前后分别使用 [THINK] 和 [/THINK] 标签包裹”；三、在 user 提示最前端插入“启用思维链：[THINK]开始推理[/THINK]”。
如果您正在使用 Gemini 3.1 的 API 并希望启用模型在生成响应前显式输出推理过程，则需正确配置请求中的特定字段以激活“思维链标签”功能。以下是实现该功能的具体调用方式：
一、设置 response_mime_type 为 text/x-markdown
Gemini 3.1 将“思维链标签”能力与响应格式强绑定，仅当指定 MIME 类型为 text/x-markdown 时，模型才会在输出中插入结构化的思维链标记（如 [THINK]、[/THINK]）。
1、在 API 请求的 payload 中添加 response_mime_type 字段。
2、将该字段值设为
"text/x-markdown"
。
3、确保不同时设置 response_schema 或其他冲突的格式化参数。
二、在 system_instruction 中声明启用思维链
模型需明确接收指令以激活内部思维链生成逻辑，仅靠 MIME 类型不足以触发完整标签行为，必须通过系统级提示词引导。
1、在请求体中包含 system_instruction 字段。
2、将其内容设为
"请逐步推理，并在每段推理前后分别使用 [THINK] 和 [/THINK] 标签包裹"
。
3、避免使用模糊表述如“请思考”或“请解释”，必须精确复现标签名称及括号格式。
OpenClaw
开源的自托管AI智能体助手，曾用名Clawdbot、Moltbot
下载
三、在 user 提示中嵌入显式触发短语
部分请求场景下，模型对 system_instruction 的响应存在延迟或忽略，需在用户输入中重复强化指令信号以确保标签稳定输出。
1、在 contents[0].parts[0].text 中，于问题前插入固定短语。
2、该短语必须为
"启用思维链：[THINK]开始推理[/THINK]"
。
3、保持该短语位于文本最前端，且不被换行或空格截断。
四、验证响应中是否存在有效标签对
成功调用后，API 返回的 candidate.content.parts[0].text 应包含至少一组完整闭合的思维链标签，用于界定推理段落边界。
1、检查返回文本是否出现
"[THINK]"
开头标记。
2、确认其后紧跟非空文本内容。
3、验证对应位置存在严格匹配的
"[/THINK]"
结束标记，且二者嵌套层级无交叉。
