# エージェントとモデル — 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. モデルを選択します。利用できないモデルには、アップグレードのヒントや「お住まいの地域では利用できません」など、その理由が表示されます。一覧の下部には、利用可否の判定に使われている地域が表示されます。

対応しているモデルには **推論の強度** 設定もあります。強度を上げると難しい設計やデバッグ作業に適し、下げると定型的な編集を素早く行えます。

各ペインはそれぞれのモデル、推論の強度、エージェントを保持します。実用的な構成は、1 つのペインに大きなモデルを置いて機能の計画と実装を任せ、2 つ目のペインには素早い質問用の高速なモデルを置くことです。[Workspace](https://ai-game.dev/ja/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`）やパッケージで追加できます。[Packages](https://ai-game.dev/ja/docs/wiki/app/packages)を参照してください。

## セッションのツール

各セッションは、どのツールを携えるかを選べます。コンポーザーの上にある **Tools row** には、インストール済みパッケージ（Blender、Music、Knowledge Base、Image Gen、Video、Tripo、Cloud generation）のツールが並び、それぞれをこのセッションに限ってオン/オフできます。CLI では `/config` を開き、**Tools** セクションを使います。

どのツールもエージェントのコンテキストの一部を占めるため、そのタスクに必要なツールだけを持つセッションのほうが高速で、誤ったツールを選ぶ可能性も低くなります。変更はチャットを再起動せずに次のメッセージから適用されます。

## 承認と権限

承認ポリシーに応じて、エージェントはツールを実行する前に確認を求めます。モードは 3 つあります:

| モード | エージェントが確認するタイミング |
| --- | --- |
| 毎回確認する | AI が実行するすべてのツールの前。プロジェクト内であっても確認します。最も安全ですが、中断が最も多くなります |
| プロジェクト外のみ確認する（デフォルト） | プロジェクトフォルダの外にアクセスする場合、またはプロジェクト自体の権限設定を変更しようとする場合。プロジェクト内では確認なしで読み取り、書き込み、コマンド実行を行います |
| 確認しない | 確認は一切しません。AI はマシン上のどこでも読み取り、書き込み、コマンド実行ができます |

**注意**

デフォルトモードではプロジェクト内でシェルコマンドが確認なしで実行されるため、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/ja/blog/plan-mode-ai-agent-game-development)の記事では、機能を 1 つ作り上げる流れを順を追って説明しています。

## 音声入力

プッシュトゥトークは両方のフロントエンドで使えます。チャット入力欄で 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/ja/docs/wiki/app/packages-catalog#local-image-models)にあります。

クラウドのメディアモデル（動画、音声、効果音、音楽）は AI Game Dev のサーバー上で実行され、利用枠を消費します。[Cloud generation](https://ai-game.dev/ja/docs/wiki/app/packages-catalog#cloud-generation)を参照してください。

## さらに詳しく

- エンジン別のリクエストの書き方については[ベストプラクティス](https://ai-game.dev/docs/best-practices)を参照してください。
- [ゲーム向けのローカル AI 画像生成](https://ai-game.dev/ja/blog/local-ai-image-generation-for-games)と[ローカル AI 動画生成](https://ai-game.dev/ja/blog/local-ai-video-generation-on-your-gpu)。
- エージェントにツールを追加するには[パッケージ](https://ai-game.dev/ja/docs/wiki/app/packages)を参照してください。

---

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

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