Neocortex Logo

UnityでNPCにChatGPTで話させる方法

Unity で ChatGPT を使って NPC を話させます。UnityWebRequest で OpenAI API を呼び出し、そのあとに自分で作る必要があるものを確認し、音声付きのキャラクターを早く作る方法を解説します。

Sercan AltundasFounder of Neocortex

· 9分で読めます

Unity で ChatGPT を使って NPC を話させます。UnityWebRequest で OpenAI API を呼び出し、そのあとに自分で作る必要があるものを確認し、音声付きのキャラクターを早く作る方法を解説します。

「ChatGPT NPC」は、多くの Unity 開発者が AI キャラクターを最初に思い浮かべる形です。プレイヤーが入力した内容を言語モデルに送り、その答えを NPC の頭上に表示します。このガイドでは、まさにそれを OpenAI API で作ります。そのあと、自分で解決する必要があることを示し、同じ NPC を Neocortex Unity SDK で作るとどうなるかを紹介します。

方法 1: OpenAI API を自分で呼び出す

OpenAI の API キーと Unity プロジェクトが必要です。NPC はメッセージのリストを保持します。最初はシステムプロンプトで、そのキャラクターが誰かを示します。プレイヤーが話すたびに、リスト全体を送ります。

using System;
using System.Collections;
using System.Collections.Generic;
using System.Text;
using UnityEngine;
using UnityEngine.Networking;

public class ChatGptNpc : MonoBehaviour
{
    [Serializable] class Message { public string role; public string content; }
    [Serializable] class ChatRequest { public string model; public Message[] messages; }
    [Serializable] class Choice { public Message message; }
    [Serializable] class ChatResult { public Choice[] choices; }

    [SerializeField] private string apiKey; // for local testing only, never ship it
    private readonly List<Message> history = new()
    {
        new Message { role = "system", content = "You are Brannoch, a gruff village blacksmith. Answer in one or two sentences." }
    };

    public IEnumerator Ask(string playerLine)
    {
        history.Add(new Message { role = "user", content = playerLine });
        string body = JsonUtility.ToJson(new ChatRequest { model = "MODEL_NAME", messages = history.ToArray() });

        using var request = new UnityWebRequest("https://api.openai.com/v1/chat/completions", "POST");
        request.uploadHandler = new UploadHandlerRaw(Encoding.UTF8.GetBytes(body));
        request.downloadHandler = new DownloadHandlerBuffer();
        request.SetRequestHeader("Content-Type", "application/json");
        request.SetRequestHeader("Authorization", "Bearer " + apiKey);
        yield return request.SendWebRequest();

        if (request.result != UnityWebRequest.Result.Success) { Debug.LogWarning(request.error); yield break; }
        Message reply = JsonUtility.FromJson<ChatResult>(request.downloadHandler.text).choices[0].message;
        history.Add(reply);
        Debug.Log(reply.content); // show it in your dialogue UI
    }
}

MODEL_NAME を、OpenAI のドキュメントにある現行のモデルに置き換えてください。そして StartCoroutine(npc.Ask("Got any work?")) を呼び出すと、Brannoch が答えます。これで、約 40 行の動くプロトタイプができあがります。

プロトタイプの先に自分で作る必要があるもの

最初の会話は簡単な部分です。製品として出荷するには、次の問題を解決する必要があります。

  • キーの管理。 ビルドに入れた OpenAI のキーは、誰でも取り出せ、アカウントの利用料をすべて使い切られます。ゲームと API の間に、自分のサーバーが必要です。
  • 音声。 プレイヤーの音声を文字にする音声認識、返答を話す音声合成、そしてその間のストリーミングが必要です。そうしないと、どの返答も両方が終わるまで待たされます。私たちの音声パイプラインのガイドで、その仕組みを説明しています。
  • 感情とアクション。 返答はプレーンテキストです。アニメーションやゲームプレイを動かすには、JSON を出すようプロンプトで指示し、それを解析し、形式が崩れて返ってきた場合も扱う必要があります。
  • 履歴。 リストは発言のたびに長くなり、費用と遅延も増えます。切り詰めるか、要約する必要があります。
  • キャラクターを保つこと。 プレイヤーが押してくると、システムプロンプトだけではすぐに崩れます。AI NPC をキャラクターに沿わせる方法をご覧ください。
  • 費用の管理。 1 人のプレイヤーが一日中話し続けても、それを止める仕組みがありません。

方法 2: Neocortex で同じ NPC を作る

Neocortex では、Brannoch を一度だけブラウザのエディタで設計します。性格、世界、知識ベース、音声、アクションを設定すると、残りは Unity SDK が処理します。

  1. Unity で、git URL からパッケージを追加します: https://github.com/neocortex-link/neocortex-unity-sdk.git
  2. Tools > Neocortex > Settings に API キーを貼り付けます。
  3. Hierarchy を右クリックし、Neocortex > Complete Voice Chat を選びます。その後、Smart Agent のドロップダウンで Brannoch を選びます。
  4. Play を押して、話しかけます。

コードからは、テキストの質問に音声で答えさせるのは 1 回の呼び出しです。

agent.TextToAudio("Got any work?"); // agent is a NeocortexSmartAgent

各返答は、感情付きのセリフとして届きます。また、対象となるオブジェクトの ID を持つアクションも届きます。そのため、アニメーションとゲームプレイは、解析したテキストではなく Unity のイベントに接続できます。段階ごとのUnity の AI キャラクターのチュートリアルで、セットアップ全体を紹介しています。

並べて比べる

OpenAI API を直接使うNeocortex Unity SDK
最初のテキストの返答約 40 行のコードコードなし
音声の入出力自分で作る: STT、TTS、ストリーミング1 つのコンポーネント、ストリーミング対応
セリフごとの感情プロンプトで指示して解析組み込み、17 種類の感情
アクションJSON をプロンプトで指示して検証エディタで定義し、データとして送信
キーの保護自分のサーバーキーごとに、プレイヤーとキャラクターの上限
WebGL のマイクUnity にはないテンプレートが含まれる
キャラクターの設計システムプロンプトビジュアルエディタ。テストはエディタで

自分で作る方法でよくある質問

  • 「返答が途中で切れる」。 モデルが出力の上限に達しました。システムプロンプトで短い答えを求めてください。それは、より良い会話にもつながります。
  • 「さっき話したことを忘れた」。 毎回、履歴全体を送る必要があります。言語モデルは、リクエストの間に何も覚えていません。
  • 「WebGL ビルドとして出荷できますか?」。 キーをビルドの中に入れたままではできません。ブラウザのネットワークタブで、誰でも読めてしまうためです。リクエストは自分のサーバーを経由させてください。

次のステップ

Unity で Neocortex をさらに使うなら、ボイスチャットと、スクリプトされたセリフのテキスト読み上げを追加してください。プロトタイプ作成の間に、自分のマシンでモデルを動かしたい場合は、Unity で LLM をローカルで動かす方法をご覧ください。すべてのチュートリアルは、AI NPC の作り方ガイドにまとめています。

2026年11月時点で確認。Neocortex は OpenAI と提携していません。

よくある質問

Unity の NPC に ChatGPT を使えますか?

はい。UnityWebRequest と、キャラクターを説明するシステムプロンプトを使って、Unity から OpenAI API を呼び出せます。音声、感情、アクション、キーの上限を自分で作らずに済ませたい場合は、Neocortex の Unity SDK で、完全なキャラクターを使えます。

Unity のゲームに OpenAI API キーを入れても安全ですか?

安全ではありません。ビルドに入れたものはすべて取り出せ、OpenAI のキーはアカウントの支出を完全に操作できてしまいます。OpenAI を直接呼び出す場合は、リクエストを自分のサーバーを経由させてください。Neocortex のキーには、プレイヤーとキャラクターごとの利用上限を設定でき、当社のサーバーが適用します。また、ダッシュボードからキーを無効にできます。

ChatGPT の NPC をキャラクターに沿わせるにはどうすればよいですか?

具体的なシステムプロンプトを書き、世界を説明し、キャラクターが知っていることを制限して、それを壊そうとするプレイヤーに対してテストしてください。Neocortex のキャラクターは、世界、知識ベース、アクションを備えたエディタで作られ、説明した世界の中にとどまります。

ChatGPT の NPC に話させるにはどうすればよいですか?

プレイヤーの音声を文字にする音声認識、返答を話す音声合成、そしてその間のストリーミングが必要です。待ち時間を短く保つためです。Neocortex Unity SDK は、この 3 つを 1 つのコンポーネントで処理します。

関連記事

こちらもおすすめ