Neocortex Logo

Come usare ChatGPT nei Blueprint di Unreal Engine

Usa ChatGPT nei Blueprint di Unreal Engine: chiama l'API OpenAI da un nodo C++, esponilo ai Blueprint e confrontalo con un NPC con voce del plugin Neocortex.

Sercan AltundasFounder of Neocortex

· 9 min di lettura

Usa ChatGPT nei Blueprint di Unreal Engine: chiama l'API OpenAI da un nodo C++, esponilo ai Blueprint e confrontalo con un NPC con voce del plugin Neocortex.

"Come uso ChatGPT nei Blueprint di Unreal?" di solito significa: far parlare i giocatori con un NPC e far rispondere un modello linguistico. Unreal non ha un nodo Blueprint per le richieste web, quindi il primo passo è un po' di C++. Questa guida costruisce un nodo ChatGPT richiamabile dai Blueprint con il modulo HTTP di Unreal, poi mostra cosa serve per distribuirlo e come appare lo stesso NPC con il plugin Neocortex.

Percorso 1: un nodo ChatGPT per i Blueprint

Ti servono un progetto C++, una chiave API OpenAI e i moduli HTTP e Json aggiunti a PublicDependencyModuleNames nel tuo Build.cs. Questo componente invia una battuta del giocatore all'endpoint chat completions e lancia un evento Blueprint con la risposta:

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

Aggiungi il componente al tuo NPC, imposta SystemPrompt ("Sei Brannoch, un fabbro burbero...") e la chiave, e nei Blueprint chiama Ask e collega On Reply al tuo widget di dialogo. Sostituisci MODEL_NAME con un modello attuale dalla documentazione di OpenAI. La risposta arriva sul thread di gioco, quindi è sicuro aggiornare l'interfaccia dall'evento.

Questo invia una riga alla volta. Per una conversazione, tieni un array di messaggi e inviane tutti a ogni richiesta.

Cosa resta da costruire a te

  • La chiave. Una chiave inclusa nel gioco può essere estratta e spende l'intero account OpenAI. Ti serve un tuo server tra il gioco e l'API.
  • La voce. Speech to text per il giocatore, text to speech per la risposta, decodifica dell'audio in una Sound Wave, e un'attesa breve. Vedi come funziona la pipeline vocale degli NPC AI.
  • Emozione e azioni. La risposta è testo semplice. Per guidare animazioni e gameplay devi chiedere un JSON nel prompt e analizzarlo, poi gestire le volte in cui è malformato.
  • Cronologia e costi. Ogni messaggio rende la richiesta successiva più grande, più lenta e più costosa.
  • Restare nel personaggio. I giocatori proveranno a rompere il system prompt in pochi minuti. Vedi come far restare in character gli NPC AI.

Percorso 2: lo stesso NPC con il plugin Neocortex

Con Neocortex, il personaggio si progetta in un editor nel browser, con una personalità, un mondo, una base di conoscenza, una voce e azioni, e il plugin Unreal ti dà i nodi Blueprint per il resto:

  1. Clona il plugin nella cartella Plugins del progetto, abilitalo e aggiungi "Neocortex" al tuo Build.cs.
  2. Incolla la tua chiave API in Project Settings > Game > Neocortex.
  3. Aggiungi un componente Neocortex Smart Agent all'NPC e imposta il suo Project Id.
  4. Chiama Send Message For Audio con la battuta del giocatore.
  5. Collega On Chat per il testo, l'emozione e l'azione, e On Audio per una Sound Wave che riproduci con Set Sound e Play.

Per l'input vocale, il componente Neocortex Microphone Recorder registra e trascrive il giocatore, quindi un pulsante push to talk sono tre nodi Blueprint. La procedura completa è in come aggiungere NPC AI a Unreal Engine 5.

Confronto diretto

API OpenAI da C++Plugin Unreal di Neocortex
Prima rispostaUn componente C++ e l'analisi JSONNodi Blueprint
Voce in entrata e in uscitaDa costruire a teComponente registratore, Sound Wave in uscita
EmozionePrompt e analisiSu ogni risposta
AzioniChiedere un JSON nel prompt e validarloDefinite nell'editor, inviate come parola chiave
Cronologia della conversazioneIl tuo array, che cresceConservata in una sessione per personaggio
Protezione della chiaveIl tuo serverLimiti per giocatore e per personaggio su ogni chiave
Design del personaggioUn system promptEditor visuale con test nel browser

Domande comuni sul percorso fai-da-te

  • "La richiesta non torna mai." Controlla che il modulo HTTP sia nel tuo Build.cs e che la richiesta non venga raccolta dal garbage collector: tieni la chiamata dentro un componente che vive quanto l'NPC.
  • "Il JSON si rompe con le virgolette." Costruisci il corpo con FJsonObject, come sopra, invece di formattare le stringhe a mano. I giocatori digitano apostrofi e virgolette di continuo.
  • "Posso chiamarlo da progetti solo Blueprint?" Non senza C++ o un plugin HTTP di terze parti.

Prossimi passi

Per il lato del design, leggi come dare agli NPC personalità uniche e come far agire gli NPC AI su ciò che dicono. Ogni tutorial è nella guida alla creazione di NPC AI.

Verificato a novembre 2026. Neocortex non è affiliato a OpenAI né a Epic Games.

Domande frequenti

Posso usare ChatGPT nei Blueprint di Unreal Engine?

Non con i nodi integrati. Unreal non ha un nodo Blueprint per le richieste HTTP, quindi scrivi una piccola funzione C++ con il modulo HTTP e la esponi ai Blueprint, oppure installi un plugin. Il plugin Neocortex ti dà un personaggio AI completo con nodi Blueprint e voce.

Mi serve il C++ per chiamare un LLM da Unreal?

Per una chiamata API diretta, poche righe di C++ o un plugin HTTP di terze parti. Con Neocortex il progetto deve essere un progetto C++ perché il plugin compili, ma tutto ciò che usi è un nodo Blueprint.

È sicuro mettere una chiave API OpenAI in un gioco Unreal?

No. Tutto ciò che viene impacchettato con il gioco può essere estratto, e una chiave OpenAI dà pieno accesso alla spesa del tuo account. Fai passare le chiamate dal tuo server. Le chiavi Neocortex possono avere limiti di utilizzo per giocatore e per personaggio che i nostri server applicano, e puoi disattivare una chiave dalla dashboard.

Come do una voce a un NPC ChatGPT in Unreal?

Aggiungeresti speech to text per il giocatore e text to speech per la risposta, poi trasformeresti l'audio in una Sound Wave. Il plugin Neocortex restituisce la risposta come Sound Wave riproducibile, e registra e trascrive la voce del giocatore.

Articoli simili

Continua a leggere