# 智能体与模型 — AI Game Dev 应用与 CLI · AI Game Developer Wiki

在 AI Game Dev 应用和 CLI 中选择 AI 模型、推理强度和智能体，控制工具审批，并在自己的 GPU 上使用本地 AI 模型。

本页由英文机器翻译而成。[阅读英文原文](https://ai-game.dev/docs/wiki/app/agents-and-models)。

AI Game Dev 应用让你选择由哪个 AI 模型来回答、它思考得多深入、由哪个智能体角色处理任务，以及它可以使用哪些工具。本页介绍模型选择器、提供商与可用性、智能体与技能、审批、计划模式、语音输入，以及在你自己的电脑上运行的本地模型。

## 模型与提供商

应用提供来自多家提供商的托管聊天模型：Anthropic 的 Claude 系列、OpenAI 的 GPT 系列、DeepSeek 和 Google 的 Gemini。确切的列表并非内置在应用中：它由 ai-game.dev 根据你的账号下发，因此始终与你的套餐和地区相匹配。新账号会从服务器分配的默认模型开始。

决定你能否使用某个模型的因素：

- **套餐。** 部分模型需要特定套餐，例如 Studio 或更高版本。参见[定价页面](https://ai-game.dev/pricing)。
- **地区。** 可用性取决于你的账单地址所在的国家/地区。参见[模型可用性页面](https://ai-game.dev/model-availability)。
- **年龄。** 少数模型要求你已在账号中确认年满 18 周岁。

你无法使用的模型仍会列出，并在名称下方说明原因。

## 在桌面应用中挑选模型

1. 打开一个聊天。输入框控件行中的模型徽标显示当前模型。
2. 点击该徽标打开模型列表。
3. 选择一个模型。不可用的模型会显示原因，例如升级提示或“在你的地区不可用”。列表底部会显示你的可用性所依据的地区。

支持该设置的模型还有**推理强度**设置。对于困难的设计和调试任务，更高的强度更好；对于日常编辑，较低的强度更快。

每个窗格各自保留自己的模型、推理强度和智能体。一种实用的配置是：在一个窗格中使用大型模型来规划和构建功能，在第二个窗格中使用更快的模型来回答快速问题。参见[工作区](https://ai-game.dev/zh-hans/docs/wiki/app/workspace#panes)。

## 在 CLI 中挑选模型

输入 `/model` 打开模型选择器。使用方向键和 Enter 选择；Tab 切换推理强度。你也可以在启动时选择模型：

```bash
gamedev --model <model-id>
```

如果你指定的模型对你的账号不可用，CLI 会提示这一点，并要求你用 `--model` 或 `/model` 选择另一个。

**提示**

更便宜、更快的模型在完成同样的工作时占用的月度额度比例更小。把最大的模型留给确实需要它们的任务。

## 智能体与技能

除了模型之外，会话还有一个**智能体**：一个带有自己指令的角色，例如某类工作的专家。列表包含 Claude agent SDK 的内置智能体，以及你的项目 Claude 配置中定义的智能体或由 Claude 插件添加的智能体。

在 CLI 中：

```text
/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`）以及包来添加。参见[包](https://ai-game.dev/zh-hans/docs/wiki/app/packages)。

## 会话工具

每个会话都会选择自己携带哪些工具。输入框上方的 **Tools row** 列出你已安装的包所提供的工具（Blender、Music、Knowledge Base、Image Gen、Video、Tripo、Cloud generation），并可为本次会话单独开启或关闭每个工具。在 CLI 中，打开 `/config` 并使用 **Tools** 部分。

每个工具都会占用智能体上下文的一部分，因此只携带任务所需工具的会话运行更快，也更不容易选错工具。更改会从下一条消息起生效，无需重启聊天。

## 审批与权限

当你的审批策略要求时，智能体在运行工具前会询问。共有三种模式：

| 模式 | 智能体何时询问 |
| --- | --- |
| 每次都询问 | 在 AI 运行的每个工具之前，即使在项目内也是如此。最安全，但打断最多 |
| 仅在项目外时询问（默认） | 当它访问项目文件夹之外，或试图更改项目自身的权限设置时。在项目内，它读取、写入和运行命令时不会询问 |
| 从不询问 | 永不询问。AI 可以在你机器上的任何位置读取、写入和运行命令 |

**警告**

在默认模式下，shell 命令会在项目内不加提示地运行，因此 AI 可以在你的机器上执行代码。“从不询问”会把这一范围扩展到整台电脑；只有在你信任该任务时才使用它。

你也可以信任项目之外的额外文件夹；针对此类路径的审批提示会提供始终允许该文件夹的选项。在 **Settings**、**Permissions** 中，或在 CLI 中更改模式：

```text
/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
```

更改从下一轮起生效。

## 计划模式与提问

计划模式是输入框中的一个会话级开关。开启后，智能体会读取文件和搜索项目，但在它给出计划且你批准之前，任何更改都会被拒绝。智能体还可以提出澄清性问题，你也可以在它工作时排队发送后续消息。这篇关于[计划模式](https://ai-game.dev/zh-hans/blog/plan-mode-ai-agent-game-development)的文章完整演示了一个功能。

## 语音输入

按住说话在两个前端中都可用：在聊天输入框中按住 Space（或使用桌面应用中的麦克风按钮），说话，然后松开。语音在你的电脑上通过本地 Whisper 模型转写；无需安装任何东西。在 **Settings**、**Voice** 中设置语言，或在 CLI 中使用 `/voice-language`。

## 在自己的 GPU 上运行本地模型

聊天模型是托管的，但媒体模型可以在你的电脑上运行，免费且不占用你的额度：

- **本地图像生成**：FLUX、基于 SDXL 的模型、Qwen-Image、Qwen-Image-Edit、Z-Image Turbo 等，由 stable-diffusion.cpp 运行。在会话的 Tools row 中开启 **Image Gen**。
- **本地视频生成**：LTX-2.5 和 Wan 2.2 TI2V 5B。开启 **Video**。

模型是以包的形式提供的，只有在你批准后才会下载。应用会检查你的 GPU、显存和驱动，并推荐你的电脑可以运行的模型。在 Packages 窗口的 **Models** 标签页中管理它们，或在 CLI 中使用 `/images` 和 `/models`。包含硬件要求的完整列表见[包目录](https://ai-game.dev/zh-hans/docs/wiki/app/packages-catalog#local-image-models)。

云端媒体模型（视频、语音、音效和音乐）则在 AI Game Dev 服务器上运行，并占用你的额度；参见[云端生成](https://ai-game.dev/zh-hans/docs/wiki/app/packages-catalog#cloud-generation)。

## 了解更多

- [最佳实践](https://ai-game.dev/docs/best-practices)：针对各引擎编写请求。
- [用于游戏的本地 AI 图像生成](https://ai-game.dev/zh-hans/blog/local-ai-image-generation-for-games)与[本地 AI 视频生成](https://ai-game.dev/zh-hans/blog/local-ai-video-generation-on-your-gpu)。
- [包](https://ai-game.dev/zh-hans/docs/wiki/app/packages)：为智能体添加工具。

---

Source (HTML): https://ai-game.dev/zh-hans/docs/wiki/app/agents-and-models

Machine-translated (zh-Hans) from the English page: https://ai-game.dev/docs/wiki/app/agents-and-models