Neocortex Logo

Unreal Engine のBlueprintsでChatGPTを使う方法

Unreal Engine のBlueprintsでChatGPTを使います。C++のノードからOpenAI APIを呼び出してBlueprintsに公開する方法と、Neocortexプラグインで音声付きのNPCを作る方法を比べます。

Sercan AltundasFounder of Neocortex

· 9分で読めます

Unreal Engine のBlueprintsでChatGPTを使います。C++のノードからOpenAI APIを呼び出してBlueprintsに公開する方法と、Neocortexプラグインで音声付きのNPCを作る方法を比べます。

「UnrealのBlueprintsでChatGPTを使うには?」という問いは、通常、プレイヤーがNPCに話しかけ、言語モデルが答えるようにしたい、という意味です。Unrealには、Webリクエストのための Blueprintノードがありません。そのため、最初の一歩は少しのC++です。この記事では、UnrealのHTTPモジュールを使い、Blueprintから呼び出せる ChatGPTノードを作ります。そのうえで、出荷に必要なことと、同じNPCがNeocortexプラグインではどう見えるかを示します。

方法1:Blueprints向けのChatGPTノード

C++のプロジェクト、OpenAIのAPIキー、そしてBuild.csのPublicDependencyModuleNamesにHTTPとJsonのモジュールを追加する必要があります。このコンポーネントは、プレイヤーの1行をchat completionsのエンドポイントに送り、答えを持ってBlueprintのイベントを発生させます。

// NpcChatComponent.cpp: declare Ask as a BlueprintCallable UFUNCTION and OnReply as a
// BlueprintAssignable delegate with one FString parameter in NpcChatComponent.h
#include "NpcChatComponent.h"
#include "HttpModule.h"
#include "Interfaces/IHttpResponse.h"
#include "Dom/JsonObject.h"
#include "Serialization/JsonReader.h"
#include "Serialization/JsonSerializer.h"

static TSharedPtr<FJsonValue> ChatMessage(const FString& Role, const FString& Content)
{
    TSharedRef<FJsonObject> Message = MakeShared<FJsonObject>();
    Message->SetStringField(TEXT("role"), Role);
    Message->SetStringField(TEXT("content"), Content);
    return MakeShared<FJsonValueObject>(Message);
}

void UNpcChatComponent::Ask(const FString& PlayerLine)
{
    TSharedRef<FJsonObject> Root = MakeShared<FJsonObject>();
    Root->SetStringField(TEXT("model"), TEXT("MODEL_NAME"));
    Root->SetArrayField(TEXT("messages"), { ChatMessage(TEXT("system"), SystemPrompt), ChatMessage(TEXT("user"), PlayerLine) });
    FString Body;
    FJsonSerializer::Serialize(Root, TJsonWriterFactory<>::Create(&Body));

    TSharedRef<IHttpRequest, ESPMode::ThreadSafe> Request = FHttpModule::Get().CreateRequest();
    Request->SetURL(TEXT("https://api.openai.com/v1/chat/completions"));
    Request->SetVerb(TEXT("POST"));
    Request->SetHeader(TEXT("Content-Type"), TEXT("application/json"));
    Request->SetHeader(TEXT("Authorization"), TEXT("Bearer ") + ApiKey); // testing only, never ship it
    Request->SetContentAsString(Body);
    Request->OnProcessRequestComplete().BindWeakLambda(this, [this](FHttpRequestPtr, FHttpResponsePtr Response, bool bOk)
    {
        TSharedPtr<FJsonObject> Json;
        if (!bOk || !Response.IsValid() || !FJsonSerializer::Deserialize(TJsonReaderFactory<>::Create(Response->GetContentAsString()), Json)) return;
        const TArray<TSharedPtr<FJsonValue>>* Choices;
        if (Json->TryGetArrayField(TEXT("choices"), Choices) && Choices->Num() > 0)
        {
            OnReply.Broadcast((*Choices)[0]->AsObject()->GetObjectField(TEXT("message"))->GetStringField(TEXT("content")));
        }
    });
    Request->ProcessRequest();
}

コンポーネントをNPCに追加し、SystemPrompt(「You are Brannoch, a gruff blacksmith...」)とキーを設定します。BlueprintsでAskを呼び出し、On Replyを会話のウィジェットにバインドします。MODEL_NAMEは、OpenAIのドキュメントにある現在のモデルに置き換えてください。返答はゲームのスレッドで届くため、そのイベントからUIを更新しても安全です。

これは1行ずつ送ります。会話にする場合は、メッセージの配列を保持し、リクエストのたびにすべてを送ってください。

自分で作ることになる部分

  • キー。 ゲームに含めたキーは取り出されてしまい、アカウントの利用料を使い切られるおそれがあります。ゲームとAPIの間に、自分のサーバーが必要です。
  • 声。 プレイヤーの音声を文字にする音声認識、返答を読み上げるテキスト読み上げ、音声をSound Waveにデコードすること、そして待ち時間を短く保つことです。AI NPCの音声パイプラインの仕組みをご覧ください。
  • 感情とアクション。 返答はただのテキストです。アニメーションやゲームの動作を動かすには、JSONを出すようプロンプトで指示して解析し、形式が崩れたときの処理も作る必要があります。
  • 履歴と費用。 メッセージが増えるたびに、次のリクエストは大きく、遅く、高くなります。
  • キャラクターを保つこと。 プレイヤーは数分でシステムプロンプトを壊そうとします。AI NPCをキャラクターに保つ方法をご覧ください。

方法2:Neocortexプラグインで同じNPCを作る

Neocortexでは、キャラクターをブラウザのエディターで設計します。人格、世界観、知識ベース、声、アクションを持たせます。Unrealプラグインが、それ以外の部分のBlueprintノードを提供します。

  1. プラグインをプロジェクトのPluginsフォルダにクローンし、有効にして、Build.csに"Neocortex"を追加します。
  2. Project Settings > Game > NeocortexにAPIキーを貼り付けます。
  3. NPCにNeocortex Smart Agentコンポーネントを追加し、そのProject Idを設定します。
  4. プレイヤーの1行を使って、Send Message For Audioを呼び出します。
  5. テキスト、感情、アクションにはOn Chatをバインドします。Set SoundとPlayで再生するSound Waveには、On Audioをバインドします。

音声入力では、Neocortex Microphone Recorderコンポーネントがプレイヤーの声を録音して文字にするため、プッシュ・トゥ・トークのボタンはBlueprintノード3つで作れます。全体の手順は、Unreal Engine 5にAI NPCを追加する方法にあります。

並べて比較

C++からのOpenAI APINeocortex Unrealプラグイン
最初の返答C++のコンポーネントとJSONの解析Blueprintノード
音声の入出力自分で作るRecorderコンポーネント、出力はSound Wave
感情プロンプトと解析すべての返答に付く
アクションJSON用のプロンプトと検証エディターで定義し、キーワードとして送られる
会話の履歴自分の配列。増え続けるキャラクターごとにセッションで保持
キーの保護自分のサーバーキーごとに、プレイヤーごととキャラクターごとの制限
キャラクターの設計システムプロンプトビジュアルエディター。テストが可能

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

  • 「リクエストが戻ってこない」。 Build.csにHTTPモジュールがあるか確認し、リクエストがガベージコレクションされていないか確認してください。呼び出しは、NPCと同じくらい長く生きるコンポーネントの中に置いてください。
  • 「引用符でJSONが壊れる」。 文字列を手で組み立てるのではなく、上のようにFJsonObjectで本文を作ってください。プレイヤーは、アポストロフィや引用符をいつも入力します。
  • 「Blueprintだけのプロジェクトから呼び出せますか?」 C++か、サードパーティのHTTPプラグインなしでは、できません。

次のステップ

設計の面は、NPCに個性を与える方法とAI NPCに言ったことを実行させる方法をご覧ください。すべてのチュートリアルは、AI NPCを作るガイドにまとめています。

2026年11月に確認。Neocortexは、OpenAIとEpic Gamesとは提携していません。

よくある質問

Unreal EngineのBlueprintsでChatGPTを使えますか?

内蔵のノードでは使えません。UnrealにはHTTPリクエストのBlueprintノードがないため、HTTPモジュールで小さなC++の関数を書き、それをBlueprintsに公開するか、プラグインを入れる必要があります。Neocortexプラグインは、Blueprintノードと音声を備えた、完全なAIキャラクターを提供します。

UnrealからLLMを呼び出すには、C++が必要ですか?

直接APIを呼び出すなら、数行のC++かサードパーティのHTTPプラグインが必要です。Neocortexでは、プラグインをコンパイルするためにプロジェクトがC++プロジェクトである必要がありますが、使うものはすべてBlueprintノードです。

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

安全ではありません。ゲームに含めたものは何でも取り出せ、OpenAIのキーはアカウントの支出を完全に操作できてしまいます。呼び出しは自分のサーバーを経由させてください。Neocortexのキーには、プレイヤーごととキャラクターごとの利用制限を付けられ、その制限は当社のサーバーが適用します。ダッシュボードからキーを無効にすることもできます。

UnrealでChatGPTのNPCに声を付けるには?

プレイヤーの音声には音声認識を、返答には読み上げを追加し、その音声をSound Waveに変換します。Neocortexプラグインは、返答を再生できるSound Waveとして返し、プレイヤーの声を録音して文字にします。

関連記事

こちらもおすすめ