如何在 Unreal Engine 蓝图中使用 ChatGPT
在 Unreal Engine 蓝图中使用 ChatGPT:从 C++ 节点调用 OpenAI API,将其暴露给蓝图,并与 Neocortex 插件中的有声 NPC 进行对比。
Sercan AltundasFounder of Neocortex
· 阅读约 9 分钟

“如何在 Unreal 蓝图中使用 ChatGPT?”通常的意思是:让玩家与 NPC 对话,并由语言模型作出回答。Unreal 没有用于网络请求的蓝图节点,因此第一步需要一点 C++。本指南使用 Unreal 的 HTTP 模块构建一个可由蓝图调用的 ChatGPT 节点,然后说明要发布这样做需要什么,并展示同一个 NPC 使用 Neocortex 插件时的样子。
途径一:用于蓝图的 ChatGPT 节点
你需要一个 C++ 项目、一个 OpenAI API 密钥,并在 Build.cs 的 PublicDependencyModuleNames 中添加 HTTP 和 Json 模块。这个组件会把一句玩家的话发送到聊天补全端点,并通过蓝图事件返回答案:
// 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(“你是 Brannoch,一个脾气粗暴的铁匠……”)和密钥,然后在蓝图中调用 Ask,并将 On Reply 绑定到你的对话控件。把 MODEL_NAME 替换为 OpenAI 文档中当前的模型。响应会在游戏线程上到达,因此在该事件中更新 UI 是安全的。
这种方式每次只发送一句话。如果要进行多轮对话,请保留一个消息数组,并在每次请求时把所有消息一并发送。
它留给你自己构建的内容
- 密钥。 随游戏打包的密钥可以被提取出来,并耗尽你整个 OpenAI 账户的额度。你需要在游戏与 API 之间设置自己的服务器。
- 语音。 为玩家做语音转文字,为回复做文字转语音,将音频解码为 Sound Wave,并尽量缩短等待时间。参见 AI NPC 语音流程如何运作。
- 情绪与动作。 回复只是纯文本。要驱动动画和游戏玩法,你需要提示模型输出 JSON 并进行解析,还要处理格式错误的情况。
- 历史与成本。 每条消息都会让下一次请求变得更大、更慢,也更昂贵。
- 保持角色设定。 玩家会在几分钟内尝试打破系统提示词。参见 如何让 AI NPC 保持角色。
途径二:使用 Neocortex 插件实现同一个 NPC
使用 Neocortex 时,角色在浏览器编辑器中设计,包括性格、世界观、知识库、声音和动作。Unreal 插件则为其余部分提供蓝图节点:
- 将插件克隆到项目的
Plugins文件夹中,启用它,并在Build.cs中添加"Neocortex"。 - 在 Project Settings > Game > Neocortex 中粘贴你的 API 密钥。
- 为 NPC 添加一个 Neocortex Smart Agent 组件,并设置其 Project Id。
- 调用 Send Message For Audio,传入玩家的话。
- 绑定 On Chat 以获取文字、情绪和动作,绑定 On Audio 以获取 Sound Wave,然后通过 Set Sound 和 Play 播放。
对于语音输入,Neocortex Microphone Recorder 组件可以录制并转录玩家的语音,因此按住说话按钮只需三个蓝图节点。完整教程请参阅 如何在 Unreal Engine 5 中添加 AI NPC。
并排对比
| 在 C++ 中调用 OpenAI API | Neocortex Unreal 插件 | |
|---|---|---|
| 第一次回复 | 一个 C++ 组件和 JSON 解析 | 蓝图节点 |
| 语音输入与输出 | 自行构建 | Recorder 组件,输出 Sound Wave |
| 情绪 | 提示并解析 | 每条回复都有 |
| 动作 | 提示输出 JSON 并校验 | 在编辑器中定义,以关键词形式发送 |
| 对话历史 | 你自己的数组,不断增长 | 为每个角色在会话中保存 |
| 密钥保护 | 你自己的服务器 | 每个密钥上都有按玩家和按角色的限制 |
| 角色设计 | 系统提示词 | 可视化编辑器,支持在浏览器中测试 |
自行实现途径中的常见问题
- “请求一直没有返回。” 检查
Build.cs中是否包含HTTP模块,并确认请求没有被垃圾回收:请将调用放在一个生命周期与 NPC 相同的组件中。 - “JSON 遇到引号就出错了。” 像上面那样用
FJsonObject构建请求体,而不是手动拼接字符串。玩家总会输入撇号和引号。 - “能否在纯蓝图项目中调用它?” 如果没有 C++ 或第三方 HTTP 插件,是不行的。
后续步骤
关于设计方面,请阅读 如何赋予 NPC 独特的性格 和 如何让 AI NPC 落实自己所说的话。所有教程都收录在 构建 AI NPC 指南 中。
2026 年 11 月核对。Neocortex 与 OpenAI 或 Epic Games 没有关联。
常见问题
能在 Unreal Engine 蓝图中使用 ChatGPT 吗?
不能直接使用内置节点。Unreal 没有用于 HTTP 请求的蓝图节点,因此你需要用 HTTP 模块编写一个小型 C++ 函数,并将其暴露给蓝图,或者安装一个插件。Neocortex 插件则提供一个包含蓝图节点和语音的完整 AI 角色。
在 Unreal 中调用 LLM 需要 C++ 吗?
直接调用 API 的话,需要几行 C++ 或一个第三方 HTTP 插件。使用 Neocortex 时,项目必须是 C++ 项目,以便插件能够编译,但你使用的所有功能都是蓝图节点。
把 OpenAI API 密钥放进 Unreal 游戏里安全吗?
不安全。任何随游戏打包的内容都可以被提取,而 OpenAI 密钥拥有对你账户支出的完全访问权限。请通过你自己的服务器转发调用。Neocortex 的密钥可以设置按玩家和按角色的用量限制,由我们的服务器执行,并且你可以在仪表盘中停用某个密钥。
如何在 Unreal 中为 ChatGPT NPC 添加声音?
你需要为玩家添加语音转文字,为回复添加文字转语音,然后把音频转换为 Sound Wave。Neocortex 插件会把回复以可播放的 Sound Wave 形式返回,并负责录制和转录玩家的语音。






