Neocortex Logo

언리얼 엔진 Blueprint에서 ChatGPT 쓰는 법

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

Sercan AltundasFounder of Neocortex

· 9분 분량

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

"언리얼 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 노드를 제공합니다.

  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에 바인딩하고, Set Sound와 Play로 재생할 Sound Wave는 On Audio에 바인딩합니다.

음성 입력은 Neocortex Microphone Recorder 컴포넌트가 플레이어의 말을 녹음하고 전사하므로, 푸시 투 토크 버튼은 Blueprint 노드 세 개면 됩니다. 전체 과정은 언리얼 엔진 5에 AI NPC를 추가하는 법에서 확인하세요.

나란히 비교

C++에서 호출하는 OpenAI APINeocortex 언리얼 플러그인
첫 응답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로 돌려주며, 플레이어의 음성을 녹음하고 전사합니다.

비슷한 글

더 읽어 보기