Neocortex Logo

Jak używać ChatGPT w Blueprints w Unreal Engine

Używaj ChatGPT w Blueprints Unreal Engine: wywołaj API OpenAI z węzła C++, udostępnij go w Blueprints i porównaj z mówiącym NPC z wtyczki Neocortex.

Sercan AltundasFounder of Neocortex

· 9 min czytania

Używaj ChatGPT w Blueprints Unreal Engine: wywołaj API OpenAI z węzła C++, udostępnij go w Blueprints i porównaj z mówiącym NPC z wtyczki Neocortex.

"Jak użyć ChatGPT w Blueprints Unreal?" zwykle oznacza: pozwolić graczom rozmawiać z NPC, a model językowy ma odpowiadać. Unreal nie ma węzła Blueprint do żądań sieciowych, więc pierwszym krokiem jest odrobina C++. Ten przewodnik buduje węzeł ChatGPT wywoływalny z Blueprints, używając modułu HTTP Unreala, potem pokazuje, co trzeba zrobić, by go wydać, i jak ten sam NPC wygląda z wtyczką Neocortex.

Droga 1: węzeł ChatGPT dla Blueprints

Potrzebujesz projektu C++, klucza API OpenAI oraz modułów HTTP i Json dodanych do PublicDependencyModuleNames w pliku Build.cs. Ten komponent wysyła jedną linię gracza do endpointu chat completions i wywołuje zdarzenie Blueprint z odpowiedzią:

// 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();
}

Dodaj komponent do swojego NPC, ustaw SystemPrompt ("You are Brannoch, a gruff blacksmith...") i klucz, a w Blueprints wywołaj Ask i podłącz On Reply do swojego widgetu dialogowego. Zamień MODEL_NAME na aktualny model z dokumentacji OpenAI. Odpowiedź przychodzi w wątku gry, więc aktualizowanie interfejsu z tego zdarzenia jest bezpieczne.

To wysyła jedną linię naraz. Przy rozmowie trzymaj tablicę wiadomości i wysyłaj wszystkie w każdym żądaniu.

Co zostaje do zbudowania

  • Klucz. Klucz spakowany z grą można wyciągnąć i wydać nim cały Twój rachunek OpenAI. Potrzebujesz własnego serwera między grą a API.
  • Głos. Zamiana mowy na tekst dla gracza, zamiana tekstu na mowę dla odpowiedzi, dekodowanie audio do Sound Wave i utrzymanie krótkiego czekania. Zobacz jak działa potok głosu NPC AI.
  • Emocje i akcje. Odpowiedź to zwykły tekst. Aby sterować animacją i rozgrywką, musisz prosić o JSON, parsować go i obsługiwać przypadki, gdy jest źle sformatowany.
  • Historia i koszt. Każda wiadomość sprawia, że następne żądanie jest większe, wolniejsze i droższe.
  • Trzymanie się postaci. Gracze spróbują złamać prompt systemowy w ciągu kilku minut. Zobacz jak utrzymać NPC AI w roli.

Droga 2: ten sam NPC z wtyczką Neocortex

W Neocortex postać projektuje się w edytorze w przeglądarce, z osobowością, światem, bazą wiedzy, głosem i akcjami, a wtyczka Unreal daje węzły Blueprint do reszty:

  1. Sklonuj wtyczkę do folderu Plugins projektu, włącz ją i dodaj "Neocortex" do Build.cs.
  2. Wklej swój klucz API w Project Settings > Game > Neocortex.
  3. Dodaj komponent Neocortex Smart Agent do NPC i ustaw jego Project Id.
  4. Wywołaj Send Message For Audio z linią gracza.
  5. Podłącz On Chat dla tekstu, emocji i akcji oraz On Audio dla Sound Wave, który odtworzysz przez Set Sound i Play.

Do wejścia głosowego komponent Neocortex Microphone Recorder nagrywa i transkrybuje gracza, więc przycisk push to talk to trzy węzły Blueprint. Pełne omówienie znajdziesz w jak dodać NPC AI do Unreal Engine 5.

Obok siebie

API OpenAI z C++Wtyczka Neocortex dla Unreal
Pierwsza odpowiedźKomponent C++ i parsowanie JSONWęzły Blueprint
Głos na wejściu i wyjściuZbuduj samKomponent nagrywania, Sound Wave na wyjściu
EmocjePrompt i parsowaniePrzy każdej odpowiedzi
AkcjePrompt o JSON i walidacjaZdefiniowane w edytorze, wysyłane jako słowo kluczowe
Historia rozmowyTwoja tablica, rosnącaPrzechowywana w sesji dla każdej postaci
Ochrona kluczaWłasny serwerLimity na gracza i na postać dla każdego klucza
Projektowanie postaciPrompt systemowyWizualny edytor z testowaniem w przeglądarce

Częste pytania o drogę zrób-to-sam

  • "Żądanie nigdy nie wraca." Sprawdź, czy moduł HTTP jest w Build.cs i czy żądanie nie jest usuwane przez garbage collection: trzymaj wywołanie w komponencie, który żyje tak długo jak NPC.
  • "JSON psuje się przy cudzysłowach." Buduj treść przez FJsonObject, jak wyżej, zamiast składać stringi ręcznie. Gracze cały czas wpisują apostrofy i cudzysłowy.
  • "Czy mogę to wywołać w projekcie tylko z Blueprintów?" Nie bez C++ albo wtyczki HTTP od firmy trzeciej.

Dalsze kroki

Od strony projektowej przeczytaj jak nadać NPC unikalne osobowości i jak sprawić, by NPC AI działały na to, co mówią. Wszystkie samouczki znajdziesz w przewodniku po budowaniu NPC AI.

Sprawdzono w listopadzie 2026. Neocortex nie jest powiązany z OpenAI ani Epic Games.

Najczęściej zadawane pytania

Czy mogę używać ChatGPT w Blueprints Unreal Engine?

Nie wbudowanymi węzłami. Unreal nie ma węzła Blueprint do żądań HTTP, więc piszesz małą funkcję C++ z modułem HTTP i udostępniasz ją Blueprints albo instalujesz wtyczkę. Wtyczka Neocortex daje pełną postać AI z węzłami Blueprint i głosem.

Czy do wywołania LLM z Unreal potrzebuję C++?

Do bezpośredniego wywołania API kilka linijek C++ albo wtyczka HTTP od firmy trzeciej. Przy Neocortex projekt musi być projektem C++, żeby wtyczka się skompilowała, ale wszystko, czego używasz, to węzły Blueprint.

Czy bezpiecznie jest umieścić klucz API OpenAI w grze Unreal?

Nie. Wszystko spakowane z grą można wyciągnąć, a klucz OpenAI daje pełny dostęp do wydatków Twojego konta. Kieruj wywołania przez własny serwer. Klucze Neocortex mogą mieć limity użycia na gracza i na postać, które egzekwują nasze serwery, a klucz można wyłączyć z panelu.

Jak nadać głos NPC ChatGPT w Unreal?

Dodałbyś zamianę mowy na tekst dla gracza i zamianę tekstu na mowę dla odpowiedzi, a potem zamieniłbyś audio w Sound Wave. Wtyczka Neocortex zwraca odpowiedź jako Sound Wave, który można odtworzyć, a także nagrywa i transkrybuje głos gracza.

Podobne artykuły

Czytaj dalej