Gemini 3.8 Flash：Google 官方结构化提示与 Agent 工作流

一句话结论

Google 的提示设计指南为 Gemini 3 Flash 给出了一套可复用的结构化提示和 Agent 工作流：把角色、约束、上下文、任务和输出格式分开，先规划再执行并验证结果；对 Gemini 3.8 Flash 可作为官方起始模板，但页面没有给出 3.8 专属的成功率或参数保证。

适用场景

• 适合的任务：需要稳定输出格式的抽取、总结、代码分析、资料问答，以及需要规划、工具执行和结果校验的 Agent。

• 不适合的任务：把模板当成自动授权机制、事实准确率保证，或直接替代工具权限、人工确认和业务验收。

• 适用的模型版本：本文目标模型为 Google API 的 gemini-3.8-flash。原页面的专门小节名为 Gemini 3 Flash strategies，页面导航同时显示 “Gemini 3.8 Flash is now available”，因此选择它作为 3.8 Flash 的官方提示起点；这不是 3.8 模型快照的独立测评。

• 适用的客户端、Agent 或 API：Google AI for Developers 的 Gemini API 提示设计语境。第三方客户端、IDE Agent 或编排框架需要自行映射 system instruction、工具权限和停止条件。

• 参数说明：本页不规定模型 ID、采样参数或工具 schema；不要从本模板推断这些配置。

可直接使用的内容

1. Gemini 3 Flash 的官方策略片段

以下三段是页面在 Gemini 3 Flash strategies 小节给出的可直接拼接到 system instruction 的原文模板。日期年份应由应用在运行时替换：

# Current-day accuracy
For time-sensitive user queries that require up-to-date information, you
MUST follow the provided current time (date and year) when formulating
search queries in tool calls. Remember it is 2026 this year.

# Knowledge-cutoff accuracy
Your knowledge cutoff date is January 2025.

# Strict grounding (use only for closed-book tasks)
You are a strictly grounded assistant limited to the information provided in
the User Context. In your answers, rely only on the facts that are directly
mentioned in that context. You must not access or utilize your own knowledge
or common sense to answer. Do not assume or infer from the provided facts;
simply report them exactly as they appear. Your answer must be factual and
fully truthful to the provided text, leaving absolutely no room for
speculation or interpretation. Treat the provided context as the absolute
limit of truth; any facts or details that are not directly mentioned in the
context must be considered completely untruthful and completely unsupported.
If the exact answer is not explicitly written in the context, you must state
that the information is not available.

2. 结构化提示模板（官方示例的 3.8 Flash 适配版）

官方页面用 XML 或 Markdown 标签区分指令、上下文和任务，并给出“角色 → 指令 → 约束 → 输出格式 → 用户上下文/任务”的组合模板。下面只把官方示例中的模型标签改为目标版本，其余字段保留为可替换占位符：

System Instruction:

<role>
You are Gemini 3.8 Flash, a specialized assistant for [domain].
You are precise, analytical, and persistent.
</role>

<instructions>
1. Plan: analyze the task and create a step-by-step plan.
2. Execute: carry out the plan.
3. Validate: review your output against the user's task.
4. Format: present the final answer in the requested structure.
</instructions>

<constraints>
- Verbosity: [low / medium / high]
- Tone: [formal / casual / technical]
- Permissions: [what the agent may read, write, call, or ask permission for]
- Evidence: [required sources or context; say “not available” when absent]
</constraints>

<output_format>
1. Executive Summary: [short overview]
2. Detailed Response: [main content]
3. Validation: [checks performed and unresolved issues]
</output_format>

User Prompt:

<context>
[Insert relevant documents, code, tool results, or background information]
</context>

<task>
[Insert the specific user request here]
</task>

<final_instruction>
Use the context and constraints above. Think through the task before
answering, but return only the requested result and validation fields.
</final_instruction>

3. Agent 工作流

把页面的 Agentic workflows 三个维度落实为一轮最小闭环：

1. Reason and plan
   - Decompose dependencies, prerequisites, constraints, and operation order.
   - Diagnose failures beyond the first obvious cause.
   - Decide how exhaustive the information search must be.

2. Execute reliably
   - Adapt the plan when observations contradict assumptions.
   - Retry transient errors within an explicit limit; change strategy for other errors.
   - Distinguish low-risk reads from high-risk writes and request permission when needed.

3. Interact and return
   - Ask for clarification when ambiguity changes the action or its risk.
   - Set verbosity explicitly and meet the required precision/completeness.
   - Validate against the task, then return the requested format plus unresolved issues.

Google 还指出，Gemini 2.5 与 Gemini 3 系列会自动产生内部思考文本；复杂任务可以用简短的 “Think very hard before answering” 提示加强思考，但会增加思考 token，通常不需要要求模型把思考过程原样输出。

测试/工作流步骤

1. 把领域、权限、证据要求和输出字段填入模板；不要把用户原文直接混入 system instruction 的规则区。

2. 对长文档、代码库或长视频，把上下文放在前面，把具体问题放在上下文之后，并以“根据上述信息”开头。

3. 日期敏感任务加入运行时当前日期；知识时效不足时使用经过配置的 grounding 工具，而不是把当前日期硬编码成长期事实。

4. 仅在闭卷抽取/合规摘要中启用严格 grounding；开放问答不应误用“只能使用 User Context”的限制。

5. 运行一组代表性任务，至少检查：规则遵循、工具/权限边界、格式合规、证据覆盖、失败恢复和 token/延迟成本。

6. 比较“基础提示”和“结构化模板”两组结果，并保留完整输入、工具调用、验证输出和人工接管点；不要以模型自述的“已完成”作为验收。

原始证据与数据

适用边界

• 原页面的正文以 Gemini 3 / Gemini 3 Flash 为指导对象，没有公开 gemini-3.8-flash 的专属 prompt 对照实验、数据集、成功率、模型快照或置信区间；本文的 3.8 适配是基于官方页面上下文的使用映射，不是独立测评结论。

• “Gemini 3 会自动思考”不表示固定的推理 token 数、延迟或质量；是否改善任务必须用自己的 harness 回归验证。

• 严格 grounding 模板会禁止常识补全和推断；上下文不完整时应明确返回信息不可用，不要把它用于需要开放世界知识的任务。

• “Remember it is 2026 this year.” 是页面示例的采集时年份；生产实现应注入真实日期，避免年份过期。

• 规划、重试和风险规则不能替代应用层的工具白名单、权限控制、审计日志、写入确认和人工接管。

• 页面示例使用英语；中文输出、标签命名、工具 schema 和客户端字段需要在目标 API/Agent 中单独测试。

来源摘录或观察（仅做合规短引）

Google 的核心提醒是：“Gemini 3 is a reasoning model. This changes how you should prompt.” 其实际建议不是无止境增加提示词长度，而是用清晰任务、结构化上下文、明确约束和可验证的 Agent 闭环来迭代。