Neocortex Logo

如何在 Unreal Engine 蓝图中使用 ChatGPT

在 Unreal Engine 蓝图中使用 ChatGPT:从 C++ 节点调用 OpenAI API,将其暴露给蓝图,并与 Neocortex 插件中的有声 NPC 进行对比。

Sercan AltundasFounder of Neocortex

· 阅读约 9 分钟

在 Unreal Engine 蓝图中使用 ChatGPT:从 C++ 节点调用 OpenAI API,将其暴露给蓝图,并与 Neocortex 插件中的有声 NPC 进行对比。

“如何在 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 插件则为其余部分提供蓝图节点:

  1. 将插件克隆到项目的 Plugins 文件夹中,启用它,并在 Build.cs 中添加 "Neocortex"。
  2. 在 Project Settings > Game > Neocortex 中粘贴你的 API 密钥。
  3. 为 NPC 添加一个 Neocortex Smart Agent 组件,并设置其 Project Id。
  4. 调用 Send Message For Audio,传入玩家的话。
  5. 绑定 On Chat 以获取文字、情绪和动作,绑定 On Audio 以获取 Sound Wave,然后通过 Set Sound 和 Play 播放。

对于语音输入,Neocortex Microphone Recorder 组件可以录制并转录玩家的语音,因此按住说话按钮只需三个蓝图节点。完整教程请参阅 如何在 Unreal Engine 5 中添加 AI NPC。

并排对比

在 C++ 中调用 OpenAI APINeocortex 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 形式返回,并负责录制和转录玩家的语音。

相关文章

继续阅读