Neocortex Logo

ChatGPT'yi Unreal Engine Blueprint'lerinde nasıl kullanırsınız

Unreal Engine Blueprint'lerinde ChatGPT'yi kullanın: bir C++ düğümünden OpenAI API'sini çağırın, Blueprint'lere açın ve Neocortex eklentisindeki sesli bir NPC ile karşılaştırın.

Sercan AltundasFounder of Neocortex

· 9 dk okuma

Unreal Engine Blueprint'lerinde ChatGPT'yi kullanın: bir C++ düğümünden OpenAI API'sini çağırın, Blueprint'lere açın ve Neocortex eklentisindeki sesli bir NPC ile karşılaştırın.

"Unreal Blueprint'lerinde ChatGPT'yi nasıl kullanırım?" sorusu genellikle şu anlama gelir: oyuncuların bir NPC ile konuşmasını ve bir dil modelinin cevap vermesini sağlamak. Unreal'da web istekleri için bir Blueprint düğümü yoktur, bu yüzden ilk adım biraz C++ gerektirir. Bu rehber, Unreal'ın HTTP modülünü kullanarak Blueprint'ten çağrılabilir bir ChatGPT düğümü kurar, ardından yayınlamanın neler gerektirdiğini ve aynı NPC'nin Neocortex eklentisiyle nasıl göründüğünü gösterir.

1. yol: Blueprint'ler için bir ChatGPT düğümü

Bir C++ projesine, bir OpenAI API anahtarına ve Build.cs dosyanızdaki PublicDependencyModuleNames listesine eklenmiş HTTP ve Json modüllerine ihtiyacınız var. Bu bileşen, bir oyuncu satırını sohbet tamamlama uç noktasına gönderir ve cevapla bir Blueprint olayı tetikler:

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

Bileşeni NPC'nize ekleyin, SystemPrompt değerini ("Sen Brannoch, sert huylu bir demirci..." gibi) ve anahtarı ayarlayın, sonra Blueprint'lerde Ask çağrısını yapın ve On Reply olayını diyalog widget'ınıza bağlayın. MODEL_NAME yerine OpenAI'nin belgelerindeki güncel bir modeli yazın. Cevap oyun iş parçacığında gelir, bu yüzden olaydan UI'yi güncellemek güvenlidir.

Bu, her seferinde tek bir satır gönderir. Bir konuşma için mesajlardan oluşan bir dizi tutun ve her istekte hepsini gönderin.

Bunun size bıraktıkları

  • Anahtar. Oyunla birlikte paketlenen bir anahtar çıkarılabilir ve tüm OpenAI hesabınızı harcar. Oyun ile API arasında kendi sunucunuza ihtiyacınız var.
  • Ses. Oyuncu için konuşmadan metne, cevap için metinden sese, sesin bir Sound Wave'e çözülmesi ve beklemenin kısa tutulması. Bkz. yapay zeka NPC ses hattı nasıl çalışır.
  • Duygu ve eylemler. Cevap düz metindir. Animasyon ve oyun mekaniklerini sürmek için JSON istemeniz, ayrıştırmanız ve bozuk geldiği zamanları ele almanız gerekir.
  • Geçmiş ve maliyet. Her mesaj bir sonraki isteği daha büyük, daha yavaş ve daha pahalı yapar.
  • Karakterde kalmak. Oyuncular birkaç dakika içinde bir sistem istemini bozmaya çalışacaktır. Bkz. yapay zeka NPC'lerini karakterde nasıl tutarsınız.

2. yol: Neocortex eklentisiyle aynı NPC

Neocortex ile karakter bir tarayıcı editöründe tasarlanır: kişilik, bir dünya, bir bilgi tabanı, bir ses ve eylemler. Unreal eklentisi geri kalan kısım için Blueprint düğümleri sunar:

  1. Eklentiyi projenizin Plugins klasörüne klonlayın, etkinleştirin ve Build.cs dosyanıza "Neocortex" ekleyin.
  2. API anahtarınızı Project Settings > Game > Neocortex içine yapıştırın.
  3. NPC'ye bir Neocortex Smart Agent bileşeni ekleyin ve Project Id değerini ayarlayın.
  4. Oyuncunun satırıyla Send Message For Audio çağrısını yapın.
  5. Metin, duygu ve eylem için On Chat olayını, Set Sound ve Play ile oynattığınız bir Sound Wave için On Audio olayını bağlayın.

Sesli girdi için Neocortex Microphone Recorder bileşeni oyuncuyu kaydeder ve metne çevirir, bu yüzden bas-konuş düğmesi üç Blueprint düğümüdür. Tam anlatım: Unreal Engine 5'e yapay zeka NPC'leri nasıl eklenir.

Yan yana

C++ üzerinden OpenAI APINeocortex Unreal eklentisi
İlk cevapBir C++ bileşeni ve JSON ayrıştırmaBlueprint düğümleri
Ses girişi ve çıkışıKendiniz kurarsınızKaydedici bileşeni, Sound Wave çıkışı
Duyguİstem ve ayrıştırmaHer cevapta
EylemlerJSON isteyin ve doğrulayınEditörde tanımlanır, bir anahtar sözcük olarak gönderilir
Konuşma geçmişiSizin, büyüyen diziKarakter başına bir oturumda tutulur
Anahtar korumasıKendi sunucunuzHer anahtarda oyuncu ve karakter başına sınırlar
Karakter tasarımıBir sistem istemiTarayıcıda test edilebilen görsel editör

Kendin yap yolu hakkında sık sorulanlar

  • "İstek hiç dönmüyor." HTTP modülünün Build.cs dosyanızda olduğunu ve isteğin çöp toplanmadığını kontrol edin: çağrıyı NPC kadar yaşayan bir bileşenin içinde tutun.
  • "JSON tırnaklarda bozuluyor." Gövdeyi yukarıdaki gibi FJsonObject ile kurun, metinleri elle biçimlendirmeyin. Oyuncular her zaman kesme işareti ve tırnak yazar.
  • "Bunu yalnızca Blueprint içeren projelerden çağırabilir miyim?" C++ ya da üçüncü taraf bir HTTP eklentisi olmadan olmaz.

Sonraki adımlar

Tasarım tarafı için NPC'lere nasıl benzersiz kişilik verilir ve yapay zeka NPC'leri söylediklerine göre nasıl eylem yapar yazılarını okuyun. Her eğitim yapay zeka NPC'leri yapma rehberinde yer alır.

Kasım 2026'da kontrol edildi. Neocortex, OpenAI ya da Epic Games ile bağlantılı değildir.

Sık sorulan sorular

ChatGPT'yi Unreal Engine Blueprint'lerinde kullanabilir miyim?

Yerleşik düğümlerle olmaz. Unreal'da HTTP istekleri için bir Blueprint düğümü yoktur, bu yüzden HTTP modülüyle küçük bir C++ işlevi yazıp onu Blueprint'lere açarsınız ya da bir eklenti kurarsınız. Neocortex eklentisi, Blueprint düğümleri ve sesle tam bir yapay zeka karakteri sunar.

Unreal'dan bir LLM çağırmak için C++ gerekir mi?

Doğrudan bir API çağrısı için birkaç satır C++ ya da üçüncü taraf bir HTTP eklentisi gerekir. Neocortex ile eklentinin derlenebilmesi için proje bir C++ projesi olmalıdır, ama kullandığınız her şey bir Blueprint düğümüdür.

Bir OpenAI API anahtarını Unreal oyununa koymak güvenli mi?

Değil. Oyunla paketlenen her şey çıkarılabilir ve bir OpenAI anahtarı hesabınızın tüm harcamasına tam erişim verir. Çağrıları kendi sunucunuz üzerinden yönlendirin. Neocortex anahtarları, sunucularımızın uyguladığı oyuncu ve karakter başına kullanım sınırları taşıyabilir ve anahtarı panelden devre dışı bırakabilirsiniz.

Unreal'da bir ChatGPT NPC'sine ses nasıl verilir?

Oyuncu için konuşmadan metne, cevap için metinden sese ekler, sonra sesi bir Sound Wave'e çevirirsiniz. Neocortex eklentisi cevabı oynatabileceğiniz bir Sound Wave olarak döndürür ve oyuncunun sesini kaydedip metne çevirir.

Benzer yazılar

Okumaya devam et