언리얼 엔진 Blueprint에서 ChatGPT 쓰는 법
언리얼 엔진 Blueprint에서 ChatGPT 쓰기: C++ 노드에서 OpenAI API를 호출하고 Blueprint에 노출하며, Neocortex 플러그인의 음성 NPC와 비교합니다.
Sercan AltundasFounder of Neocortex
· 9분 분량

"언리얼 Blueprint에서 ChatGPT를 어떻게 쓰나요?"라는 질문은 보통 이런 뜻입니다. 플레이어가 NPC와 대화하고, 언어 모델이 답하게 하고 싶다는 것입니다. 언리얼 엔진에는 웹 요청을 위한 Blueprint 노드가 없으므로, 첫 단계는 약간의 C++입니다. 이 가이드는 언리얼 엔진의 HTTP 모듈로 Blueprint에서 호출할 수 있는 ChatGPT 노드를 만들고, 출시에 무엇이 필요한지 보여 준 뒤, 같은 NPC가 Neocortex 플러그인에서 어떻게 보이는지 설명합니다.
방법 1: Blueprint용 ChatGPT 노드
C++ 프로젝트, OpenAI API 키, 그리고 Build.cs의 PublicDependencyModuleNames에 추가한 HTTP와 Json 모듈이 필요합니다. 이 컴포넌트는 플레이어의 한 줄을 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...")와 키를 설정한 뒤, Blueprint에서 Ask를 호출하고 On Reply를 대화 위젯에 바인딩하세요. MODEL_NAME은 OpenAI 문서의 현재 모델로 바꾸세요. 응답은 게임 스레드에서 도착하므로, 이벤트에서 UI를 업데이트해도 안전합니다.
이 방식은 한 번에 한 줄만 보냅니다. 대화를 이어 가려면 메시지 배열을 유지하고, 요청마다 모든 메시지를 함께 보내야 합니다.
여러분이 직접 만들어야 하는 것
- 키. 게임과 함께 패키징한 키는 추출될 수 있으며, 여러분의 OpenAI 계정 전체를 쓸 수 있습니다. 게임과 API 사이에 자체 서버가 필요합니다.
- 음성. 플레이어 음성을 텍스트로 바꾸는 음성-텍스트 변환, 답변을 음성으로 바꾸는 텍스트 음성 변환, 오디오를 Sound Wave로 디코딩하는 작업, 그리고 기다리는 시간을 짧게 유지하는 작업입니다. AI NPC 음성 파이프라인의 작동 방식을 참고하세요.
- 감정과 동작. 답변은 일반 텍스트입니다. 애니메이션과 게임 로직을 구동하려면 JSON을 요청하고 파싱해야 하며, 형식이 잘못된 경우도 처리해야 합니다.
- 기록과 비용. 메시지가 하나 늘 때마다 다음 요청은 더 커지고, 느려지고, 비싸집니다.
- 캐릭터 유지. 플레이어는 몇 분 안에 시스템 프롬프트를 깨려고 할 것입니다. AI NPC가 캐릭터를 유지하는 방법을 참고하세요.
방법 2: Neocortex 플러그인으로 같은 NPC 만들기
Neocortex에서는 캐릭터를 브라우저 편집기에서 설계합니다. 성격, 세계관, 지식 베이스, 음성, 동작을 설정하고, 언리얼 플러그인이 나머지를 위한 Blueprint 노드를 제공합니다.
- 플러그인을 프로젝트의
Plugins폴더에 복제하고, 활성화한 뒤,Build.cs에"Neocortex"를 추가합니다. - Project Settings > Game > Neocortex에 API 키를 붙여 넣습니다.
- NPC에 Neocortex Smart Agent 컴포넌트를 추가하고 Project Id를 설정합니다.
- 플레이어의 말과 함께 Send Message For Audio를 호출합니다.
- 텍스트, 감정, 동작은 On Chat에 바인딩하고, Set Sound와 Play로 재생할 Sound Wave는 On Audio에 바인딩합니다.
음성 입력은 Neocortex Microphone Recorder 컴포넌트가 플레이어의 말을 녹음하고 전사하므로, 푸시 투 토크 버튼은 Blueprint 노드 세 개면 됩니다. 전체 과정은 언리얼 엔진 5에 AI NPC를 추가하는 법에서 확인하세요.
나란히 비교
| C++에서 호출하는 OpenAI API | Neocortex 언리얼 플러그인 | |
|---|---|---|
| 첫 응답 | 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와 제휴 관계가 아닙니다.
자주 묻는 질문
언리얼 엔진 Blueprint에서 ChatGPT를 쓸 수 있나요?
기본 제공 노드로는 안 됩니다. 언리얼 엔진에는 HTTP 요청을 위한 Blueprint 노드가 없으므로, HTTP 모듈로 작은 C++ 함수를 만들어 Blueprint에 노출하거나 플러그인을 설치해야 합니다. Neocortex 플러그인은 Blueprint 노드와 음성을 갖춘 완전한 AI 캐릭터를 제공합니다.
언리얼에서 LLM을 호출하려면 C++가 필요한가요?
직접 API를 호출한다면 몇 줄의 C++나 타사 HTTP 플러그인이 필요합니다. Neocortex에서는 플러그인이 컴파일되도록 프로젝트가 C++ 프로젝트여야 하지만, 사용하는 것은 모두 Blueprint 노드입니다.
언리얼 게임에 OpenAI API 키를 넣어도 안전한가요?
아닙니다. 게임과 함께 패키징된 것은 모두 추출될 수 있으며, OpenAI 키는 계정의 지출 전체에 대한 권한을 줍니다. 호출은 자체 서버를 거치세요. Neocortex 키에는 저희 서버가 강제하는 플레이어별, 캐릭터별 사용 한도를 둘 수 있고, 대시보드에서 키를 비활성화할 수도 있습니다.
언리얼에서 ChatGPT NPC에게 목소리를 주려면 어떻게 하나요?
플레이어를 위한 음성-텍스트 변환과 답변을 위한 텍스트 음성 변환을 추가한 다음, 오디오를 Sound Wave로 바꿔야 합니다. Neocortex 플러그인은 답변을 재생할 수 있는 Sound Wave로 돌려주며, 플레이어의 음성을 녹음하고 전사합니다.






