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

「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ノードを提供します。
- プラグインをプロジェクトの
Pluginsフォルダにクローンし、有効にして、Build.csに"Neocortex"を追加します。 - Project Settings > Game > NeocortexにAPIキーを貼り付けます。
- NPCにNeocortex Smart Agentコンポーネントを追加し、そのProject Idを設定します。
- プレイヤーの1行を使って、Send Message For Audioを呼び出します。
- テキスト、感情、アクションにはOn Chatをバインドします。Set SoundとPlayで再生するSound Waveには、On Audioをバインドします。
音声入力では、Neocortex Microphone Recorderコンポーネントがプレイヤーの声を録音して文字にするため、プッシュ・トゥ・トークのボタンはBlueprintノード3つで作れます。全体の手順は、Unreal Engine 5にAI NPCを追加する方法にあります。
並べて比較
| C++からのOpenAI API | Neocortex 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として返し、プレイヤーの声を録音して文字にします。






