本文根據 Google AI for Developers 官方文檔(AI Studio quickstart、Text generation、Prompt design strategies、Thinking、Safety settings、Google Search、Code execution、URL context)和 Google 官方網誌整理,資料核對於 2026-10-10。截圖來自官方網誌和官方文檔,圖下註明出處,部分為早期介面。
適用於誰
- 在 Google AI Studio 裏想讓模型固定身份、語氣或輸出格式的人;
- 搜「google ai studio 系統指令」「system instructions」「temperature」「thinking level」想知道每個設定是幹什麼的人;
- 準備把 AI Studio 裏調好的設定搬到 Gemini API 代碼裏的開發者。
AI Studio 的整體入門見本站《Google AI Studio 怎麼用:介面入口、選模型、發第一條提示與獲取代碼(入門)》。
結論先說
- 系統指令在右上角「運行設定(Run settings)」面板裏,找到「系統指令(System Instructions)」輸入框填寫;對話開始後也能改。
- 寫法上,把身份、硬性約束和輸出格式放進系統指令,用 XML 風格標籤或 Markdown 標題分塊,這是官方對 Gemini 3 系列的建議。
- 新模型不要再調溫度:官方說明從 Gemini 3.6 Flash、3.5 Flash-Lite 起,
temperature、top_p、top_k已棄用並被忽略;想要更穩定的輸出,官方建議改用系統指令寫明規則。 - 真正該調的是思考等級(thinking level):等級越高推理越充分,但更慢、消耗的 token 更多。
- 聯網搜尋、代碼執行、URL 上下文是三個內置工具,在運行設定裏按需打開,各有限制。
一、系統指令在哪裏填
- 打開 Google AI Studio,預設進入 Playground。
- 點右上角「運行設定(Run settings)」展開面板,找到「系統指令(System Instructions)」輸入框。
- 寫入要求,然後在下方輸入框提問、點「運行(Run)」。
官方快速入門用了一個例子:先只寫一句「你是住在木衛二上的外星人」,模型的回答又長又發散;再補上「你叫 Tim,回答控制在三段以內,語氣要活潑」,輸出就穩定多了。官方同時說明,對話開始之後系統指令仍然可以修改。

圖片來源:Google 官方網誌《Leveling up your developer experience in Google AI Studio》
官方網誌介紹過「儲存系統指令」功能:可以把系統指令存成模板,在不同對話裏複用,不必為了保留指令而清空對話。
二、系統指令怎麼寫
官方《Prompt design strategies》對 Gemini 3 系列的建議,歸納起來是:
- 直接、精確:把目標說清楚,不需要客套和反覆強調;
- 結構一致:用 XML 風格標籤(如
<role>、<constraints>)或 Markdown 標題分隔各部分,選一種用到底; - 關鍵要求放進系統指令:身份(persona)、行為約束、輸出格式放在系統指令裏,或放在用戶提示的最開頭;
- 想要詳細回答要明說:Gemini 3 預設回答直接、簡潔,需要更口語或更詳細時必須在指令裏寫出來;
- 長資料放前面,問題放最後:先給全部上下文,再用「根據以上資訊……」這類過渡句提出問題。
一個可以直接改的模板(按官方示例的結構改寫成中文):
text
<role>
你是一名面向初學者的 Python 老師,回答準確、耐心。
</role>
<constraints>
1. 只用中文回答。
2. 每個知識點配一個可以直接運行的最小示例。
3. 不確定的內容直接說不確定,不要編造。
</constraints>
<output_format>
先用一句話給結論,再分點解釋,最後給示例代碼。
</output_format>
三、思考等級(thinking level)
Gemini 3 系列預設開啟「思考」,模型會先在內部推理再作答。官方 Thinking 頁列出的預設值和可選等級(節選):
| 模型 | 預設 | 可選等級 |
|---|---|---|
| gemini-3.8-flash | medium | low、medium、high |
| gemini-3.6-flash | medium | minimal、low、medium、high |
| gemini-3.5-flash-lite | minimal | minimal、low、medium、high |
| gemini-3.1-pro-preview | high | low、medium、high |
怎麼選,官方的說法是:
- low:對延遲敏感的任務,比如實時聊天、寫草稿、快速數據分析;
- medium:大多數任務質素最好,適合複雜代碼和智能體場景;
- high:深度推理、數學、多步驟難題。
注意兩點:Gemini 3.8 Flash 不支持 minimal,傳了會報錯;輸出費用是「輸出 token + 思考 token」之和,等級越高越貴。官方還提醒,不要靠把最大輸出 token 設得很小來省錢——這個上限包含思考 token,設小了會讓回答被截斷甚至為空,應當改為降低思考等級。
四、溫度、Top P、Top K:新模型已棄用
這是最容易被舊教學帶偏的地方。官方《What's new in Gemini 3.6 Flash and 3.5 Flash-Lite》寫明:從這兩個模型開始(以及之後發佈的所有 Gemini 模型),temperature、top_p、top_k 已棄用,API 會忽略它們,未來的模型代際裏再傳會直接返回 400 錯誤,官方要求從請求裏刪掉。Gemini 3.8 Flash 的遷移清單裏也有同樣的一條。
想讓輸出更穩定、更可復現,官方給的替代做法是:在系統指令裏把規則寫明確。需要固定格式時用結構化輸出,見本站《Gemini 結構化輸出(Structured Output)怎麼用:JSON Schema、Pydantic 與 Zod 示例》。
官方《Prompt design strategies》和排錯頁裏還保留着一條稍早的提醒,方向是一致的:對 Gemini 3.x 模型「強烈建議保持預設值」,把溫度調到 1.0 以下可能導致循環輸出或推理質素下降。總之,不要再把調溫度當成控制輸出的手段。
五、安全設定(Safety settings)
運行設定面板的「高級設定(Advanced settings)」裏有一項「安全設定(Safety settings)」,用來按類別設定內容過濾的嚴格程度,面向的是需要自行把關內容的應用開發者(例如給面向未成年人的產品加嚴)。官方文檔的幾個要點:
- 危害兒童安全等核心傷害類內容始終被攔截,任何設定都改變不了;
- 模型自身已帶有安全機制,這些可調過濾器是在此之外的一層;
- 使用時必須遵守服務條款和生成式 AI 禁止使用政策,責任在使用者;
- 用代碼調用時,官方說明新的 Interactions API 不支持自定義安全設定,這項功能只在舊的 generateContent API 裏有。
六、三個常用工具
1. 聯網搜尋(Grounding with Google Search)

圖片來源:Google 官方文檔《Grounding with Google Search》
打開後,模型自行判斷要不要搜尋、搜什麼,回答裏帶引用來源。官方建議在需要較新或較冷門的事實時打開。計費方面,官方說明 Gemini 3 及更新的模型按模型實際執行的每次搜尋查詢計費,一個問題可能觸發多次搜尋;定價頁上 Gemini 3.8 Flash 等模型的表格裏,搜尋接地在 API 免費層一欄標的是「不可用(Not available)」。具體價格以官方定價頁為準。
2. 代碼執行(Code execution)
讓模型編寫並運行 Python 代碼,適合計算、計數、處理數據。官方列出的限制:運行環境最長 30 秒;只能用環境裏預裝的庫,不能自己安裝;只能返回代碼和結果,不能返回媒體文件等其他產物;文本和 CSV 文件效果最好。啟用它本身不額外收費,按所用模型的輸入輸出 token 計費。
3. URL 上下文(URL context)
把網頁地址交給模型,讓它讀取頁面內容來回答。官方限制:每次請求最多 20 個 URL,單個 URL 取回內容最大 34MB;地址必須能公開訪問,需要登入或付費才能看的頁面、本機地址和內網地址都不支持。
七、搬到代碼裏要注意什麼
AI Studio 裏的系統指令對應 API 的 system_instruction,思考等級對應 generation_config 裏的 thinking_level:
python
from google import genai
client = genai.Client() # 自動讀取環境變量 GEMINI_API_KEY
interaction = client.interactions.create(
model="gemini-3.8-flash",
system_instruction="你是一名面向初學者的 Python 老師,只用中文回答。",
input="列表推導式怎麼用?",
generation_config={"thinking_level": "low"},
tools=[{"type": "google_search"}], # 需要聯網搜尋時才加
)
print(interaction.output_text)
官方特別說明:用 previous_interaction_id 接續多輪對話時,伺服器只保留對話歷史;system_instruction、generation_config 和 tools 只對當次請求生效,每一輪都要重新傳。完整的調用流程見本站《Gemini API Python 調用教學:安裝 google-genai SDK、流式輸出、多輪對話與傳圖片》。
常見問題
Q:系統指令和直接寫在提問裏有什麼區別?
系統指令對整個對話生效,適合放不變的規則;提問裏放每次不同的任務和資料。官方建議關鍵約束放系統指令或提示最開頭。
Q:為什麼調了溫度沒變化?
如果用的是 Gemini 3.6 Flash、3.5 Flash-Lite 或更新的模型,官方說明溫度等採樣參數已被忽略。
Q:模型思考太久怎麼辦?
把思考等級調低。官方排錯頁說明,延遲變高、token 用量變大,通常就是因為 Gemini 3 系列預設開啟了思考。
Q:回覆顯示 Content blocked?
把滑鼠懸停在提示上可以看到被攔截的類別。先檢查提示和上載的內容是否確實觸及了對應類別;屬於誤判的正常內容,換一種更明確、中性的表述通常就能通過。違反使用政策的請求不會、也不應該靠調設定來放行。
參考資料
- Google AI Studio quickstart(官方):https://ai.google.dev/gemini-api/docs/ai-studio-quickstart
- Leveling up your developer experience in Google AI Studio(Google 官方網誌):https://blog.google/innovation-and-ai/technology/developers-tools/ai-studio-updates-more-control/
- Text generation(官方):https://ai.google.dev/gemini-api/docs/text-generation
- Prompt design strategies(官方):https://ai.google.dev/gemini-api/docs/prompting-strategies
- Gemini thinking(官方):https://ai.google.dev/gemini-api/docs/thinking
- What's new in Gemini 3.6 Flash and 3.5 Flash-Lite(官方):https://ai.google.dev/gemini-api/docs/whats-new-gemini-3.6
- What's new in Gemini 3.8 Flash(官方):https://ai.google.dev/gemini-api/docs/latest-model
- Safety settings(官方):https://ai.google.dev/gemini-api/docs/safety-settings
- Grounding with Google Search(官方):https://ai.google.dev/gemini-api/docs/google-search
- Code execution(官方):https://ai.google.dev/gemini-api/docs/code-execution
- URL context(官方):https://ai.google.dev/gemini-api/docs/url-context
- Interactions API(官方):https://ai.google.dev/gemini-api/docs/interactions-overview
- Gemini Developer API pricing(官方):https://ai.google.dev/gemini-api/docs/pricing
0 條評論
還沒有評論,來搶沙發~