Neocortex Logo

Как использовать ChatGPT в Blueprints Unreal Engine

Используйте ChatGPT в Blueprints Unreal Engine: вызывайте OpenAI API из узла на C++, открывайте его для Blueprints и сравните с озвученным NPC из плагина Neocortex.

Sercan AltundasFounder of Neocortex

· 9 мин чтения

Используйте ChatGPT в Blueprints Unreal Engine: вызывайте OpenAI API из узла на C++, открывайте его для Blueprints и сравните с озвученным NPC из плагина Neocortex.

«Как использовать ChatGPT в Blueprints Unreal?» обычно означает: дать игрокам говорить с NPC, а языковой модели - отвечать. В Unreal нет узла Blueprint для веб-запросов, поэтому первый шаг - немного C++. Это руководство собирает узел ChatGPT, который можно вызывать из Blueprint, с помощью HTTP-модуля Unreal, затем показывает, что нужно для выпуска игры, и как тот же NPC выглядит с плагином Neocortex.

Вариант 1: узел ChatGPT для Blueprints

Нужны проект на C++, ключ API OpenAI и модули HTTP и Json, добавленные в PublicDependencyModuleNames в вашем Build.cs. Этот компонент отправляет одну реплику игрока на эндпоинт 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 («Ты - Brannoch, сварливый кузнец...») и ключ, а в Blueprints вызовите Ask и привяжите On Reply к вашему виджету диалога. Замените MODEL_NAME актуальной моделью из документации OpenAI. Ответ приходит в игровом потоке, поэтому обновлять интерфейс из события безопасно.

Это отправляет по одной реплике за раз. Для разговора храните массив сообщений и отправляйте все их с каждым запросом.

Что остаётся на вашей стороне

  • Ключ. Ключ, упакованный с игрой, можно извлечь, и он расходует весь ваш аккаунт OpenAI. Между игрой и API нужен собственный сервер.
  • Голос. Речь в текст для игрока, текст в речь для ответа, декодирование аудио в Sound Wave и короткое ожидание. См. как устроен конвейер голоса ИИ-NPC.
  • Эмоции и действия. Ответ - простой текст. Чтобы управлять анимацией и игровой логикой, вы просите JSON и разбираете его, а затем обрабатываете случаи, когда он составлен неверно.
  • История и стоимость. Каждое сообщение делает следующий запрос больше, медленнее и дороже.
  • Оставаться в образе. Игроки попытаются сломать системный промпт в течение нескольких минут. См. как удерживать ИИ-NPC в образе.

Вариант 2: тот же NPC с плагином Neocortex

С Neocortex персонаж проектируется в браузерном редакторе: с личностью, миром, базой знаний, голосом и действиями. Плагин Unreal даёт узлы Blueprint для остального:

  1. Клонируйте плагин в папку Plugins вашего проекта, включите его и добавьте "Neocortex" в Build.cs.
  2. Вставьте ключ API в Project Settings > Game > Neocortex.
  3. Добавьте компонент Neocortex Smart Agent к NPC и задайте его Project Id.
  4. Вызовите Send Message For Audio с репликой игрока.
  5. Привяжите On Chat для текста, эмоции и действия, а On Audio - для Sound Wave, которую проигрываете через Set Sound и Play.

Для голосового ввода компонент Neocortex Microphone Recorder записывает и расшифровывает игрока, поэтому кнопка push to talk - это три узла Blueprint. Подробная инструкция есть в посте как добавить ИИ-NPC в Unreal Engine 5.

Бок о бок

OpenAI API из C++Плагин Neocortex для Unreal
Первый ответКомпонент на C++ и разбор JSONУзлы Blueprint
Голос на входе и выходеСделать самостоятельноКомпонент записи, Sound Wave на выходе
ЭмоцииПромпт и разборВ каждом ответе
ДействияПромпт для JSON и проверкаЗаданы в редакторе, отправляются как ключевое слово
История разговораВаш массив, растущийХранится в сессии для каждого персонажа
Защита ключаВаш собственный серверЛимиты на каждого игрока и каждого персонажа для каждого ключа
Дизайн персонажаСистемный промптВизуальный редактор с тестированием в браузере

Частые вопросы по варианту «сделай сам»

  • «Запрос никогда не возвращается». Проверьте, что модуль HTTP есть в вашем Build.cs, и что запрос не уничтожается сборщиком мусора: держите вызов внутри компонента, который живёт столько же, сколько NPC.
  • «JSON ломается на кавычках». Собирайте тело через FJsonObject, как выше, а не форматируйте строки вручную. Игроки постоянно печатают апострофы и кавычки.
  • «Можно ли вызывать это в проектах только на Blueprint?» Нет, без C++ или стороннего HTTP-плагина нельзя.

Что дальше

Для дизайна читайте как дать NPC уникальные личности и как заставить ИИ-NPC действовать по сказанному. Все руководства собраны в гайде по созданию ИИ-NPC.

Проверено в ноябре 2026 года. Neocortex не связан с OpenAI и Epic Games.

Частые вопросы

Можно ли использовать ChatGPT в Blueprints Unreal Engine?

Не встроенными узлами. В Unreal нет узла Blueprint для HTTP-запросов, поэтому вы пишете небольшую функцию на C++ с HTTP-модулем и открываете её для Blueprints, или ставите плагин. Плагин Neocortex даёт полноценного ИИ-персонажа с узлами Blueprint и голосом.

Нужен ли C++, чтобы вызывать LLM из Unreal?

Для прямого вызова API - несколько строк C++ или сторонний HTTP-плагин. С Neocortex проект должен быть проектом на C++, чтобы плагин компилировался, но всё, что вы используете, - это узлы Blueprint.

Безопасно ли вписывать ключ API OpenAI в игру на Unreal?

Нет. Всё, что упаковано с игрой, можно извлечь, а ключ OpenAI даёт полный доступ к расходам вашего аккаунта. Направляйте вызовы через собственный сервер. Ключи Neocortex могут иметь лимиты использования для каждого игрока и каждого персонажа, которые наши серверы соблюдают, а ключ можно деактивировать в панели.

Как дать ChatGPT-NPC голос в Unreal?

Нужно добавить речь в текст для игрока и текст в речь для ответа, а затем превратить аудио в Sound Wave. Плагин Neocortex возвращает ответ как Sound Wave, которую можно проиграть, и записывает и расшифровывает голос игрока.

Похожие статьи

Читайте также