代理與模型
在 AI Game Dev 應用程式與 CLI 中選擇 AI 模型、推理強度與代理,控制工具核准,並在自己的 GPU 上執行本機 AI 模型。
AI Game Dev 應用程式讓你選擇由哪個 AI 模型回答、它思考得多用力、由哪個代理角色負責這項任務,以及它能使用哪些工具。本頁說明模型選擇器、供應商與可用性、代理與技能、核准、計畫模式、語音輸入,以及在你自己的電腦上執行的本機模型。
模型與供應商
應用程式提供來自多家供應商的託管聊天模型:Anthropic 的 Claude 系列、OpenAI 的 GPT 系列、DeepSeek 與 Google 的 Gemini。確切清單並非內建於應用程式中:它會依你的帳號從 ai-game.dev 取得,因此永遠符合你的方案與地區。新帳號會從伺服器指派的預設模型開始。
決定你是否能使用某個模型的因素:
- 方案。 部分模型需要特定方案,例如 Studio 或更高階的方案。請參閱定價頁面。
- 地區。 可用性取決於你帳單地址所在的國家。請參閱模型可用性頁面。
- 年齡。 少數模型要求你已在帳號中確認自己年滿 18 歲。
無法使用的模型仍會列出,並在其名稱下方顯示原因。
在桌面應用程式中選擇模型
- 開啟一個聊天。輸入區控制列中的模型標籤會顯示目前的模型。
- 點擊該標籤即可開啟模型清單。
- 選擇模型。無法使用的模型會說明原因,例如升級提示或「無法在你的地區使用」。清單底部會顯示你的可用性所依據的地區。
支援的模型還有推理強度設定。強度越高,越適合困難的設計與除錯任務;強度越低,例行編輯就越快。
每個窗格各自保留自己的模型、推理強度與代理。一個實用的配置是:在一個窗格使用大型模型來規劃並建置功能,在第二個窗格使用較快的模型來回答快速問題。請參閱工作區。
在 CLI 中選擇模型
輸入 /model 即可開啟模型選擇器。使用方向鍵與 Enter 選擇;Tab 可切換推理強度。你也可以在啟動時選擇模型:
gamedev --model <model-id>如果你指定的模型無法供你的帳號使用,CLI 會告知你,並請你改用 --model 或 /model 另選一個。
代理與技能
除了模型之外,一個工作階段還有代理:一個帶有自身指示的角色,例如專精某類工作的專家。清單包含 Claude agent SDK 內建的代理,以及你專案 Claude 設定中定義的代理或由 Claude 外掛新增的代理。
在 CLI 中:
/agent list the agents and show the active one
/agent use <agent-id> switch this session to an agent
/agent refresh ask for the agent list again
/skills list the skills available in this project在桌面應用程式中,每個窗格各自保留自己的代理,就像各自的模型一樣。
技能、指令與代理可透過 Claude 外掛(Settings、Claude Plugins,或在 CLI 中使用 /plugin)以及套件加入。請參閱套件。
工作階段工具
每個工作階段會選擇要攜帶哪些工具。輸入區上方的 Tools 列會列出你已安裝套件中的工具(Blender、Music、Knowledge Base、Image Gen、Video、Tripo、Cloud generation),並僅針對此工作階段逐一開啟或關閉。在 CLI 中,開啟 /config 並使用 Tools 區段。
每個工具都會佔用代理上下文的一部分,因此只攜帶任務所需工具的工作階段會更快,也較不容易選錯工具。變更會從下一則訊息起生效,不需重新啟動聊天。
核准與權限
當你的核准政策要求時,代理會在執行工具前先詢問。共有三種模式:
| 模式 | 代理何時詢問 |
|---|---|
| 每次詢問 | 在 AI 執行每一個工具之前都詢問,即使在專案內也一樣。最安全,但中斷次數最多 |
| 僅在專案外詢問(預設) | 當它觸及專案資料夾以外的範圍,或試圖變更專案本身的權限設定時。在專案內則不需詢問即可讀取、寫入與執行命令 |
| 永不詢問 | 永不詢問。AI 可以在你機器上的任何位置讀取、寫入與執行命令 |
你也可以信任專案以外的額外資料夾;針對這類路徑的核准提示會提供永遠允許該資料夾的選項。在 Settings、Permissions 中,或在 CLI 中變更模式:
/permissions show the mode and trusted folders
/permissions always ask every time
/permissions outside-project ask only outside the project
/permissions never never ask
/permissions trust <folder> trust a folder and everything in it
/permissions untrust <folder> stop trusting a folder
/permissions timeout on auto-deny a request left unanswered for 5 minutes變更會從下一回合起生效。
計畫模式與提問
計畫模式是輸入區中的一個工作階段專屬開關。開啟後,代理可以讀取檔案並搜尋專案,但所有變更都會被拒絕,直到它提出計畫並經你核准。代理也可以提出釐清問題,而你可以趁它工作時排入後續訊息。計畫模式一文完整走過一個功能的流程。
語音輸入
按鍵說話在兩種前端皆可使用:在聊天輸入區按住 Space(或在桌面應用程式中使用麥克風按鈕)、說話,然後放開。語音會在你的電腦上以本機 Whisper 模型轉錄;無需安裝任何東西。在 Settings、Voice 中設定語言,或在 CLI 中使用 /voice-language。
在自己的 GPU 上執行本機模型
聊天模型是託管的,但媒體模型可以在你的電腦上執行,免費且不佔用你的額度:
- 本機影像生成:FLUX、以 SDXL 為基礎的模型、Qwen-Image、Qwen-Image-Edit、Z-Image Turbo 等,由 stable-diffusion.cpp 執行。請在工作階段的 Tools 列中開啟 Image Gen。
- 本機影片生成:LTX-2.5 與 Wan 2.2 TI2V 5B。請開啟 Video。
模型是以套件形式提供,只會在你核准後才下載。應用程式會檢查你的 GPU、視訊記憶體與驅動程式,並推薦你的電腦能執行的模型。可在 Packages 視窗的 Models 分頁中管理,或在 CLI 中使用 /images 與 /models。完整清單與硬體需求請見套件目錄。
雲端媒體模型(影片、語音、音效與音樂)則在 AI Game Dev 伺服器上執行,並會使用你的額度;請參閱雲端生成。
延伸閱讀
- 最佳實務:依各引擎撰寫需求。
- 遊戲的本機 AI 影像生成與本機 AI 影片生成。
- 套件:為代理加入工具。