Neocortex Logo

Como usar o ChatGPT em Blueprints da Unreal Engine

Use o ChatGPT em Blueprints da Unreal Engine: chame a API da OpenAI a partir de um nó em C++, exponha-o aos Blueprints e compare com um NPC com voz do plugin da Neocortex.

Sercan AltundasFounder of Neocortex

· 9 min de leitura

Use o ChatGPT em Blueprints da Unreal Engine: chame a API da OpenAI a partir de um nó em C++, exponha-o aos Blueprints e compare com um NPC com voz do plugin da Neocortex.

"Como uso o ChatGPT nos Blueprints da Unreal?" geralmente significa: deixar o jogador conversar com um NPC e fazer um modelo de linguagem responder. A Unreal não tem nenhum nó de Blueprint para requisições web, então o primeiro passo é um pouco de C++. Este guia cria um nó de ChatGPT chamável por Blueprint com o módulo HTTP da Unreal, depois mostra o que é preciso para publicar e como o mesmo NPC fica com o plugin da Neocortex.

Caminho 1: um nó de ChatGPT para Blueprints

Você precisa de um projeto em C++, de uma chave de API da OpenAI e dos módulos HTTP e Json adicionados a PublicDependencyModuleNames no seu Build.cs. Este componente envia uma fala do jogador para o endpoint de chat completions e dispara um evento de Blueprint com a resposta:

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

Adicione o componente ao seu NPC, defina SystemPrompt ("You are Brannoch, a gruff blacksmith...") e a chave, e nos Blueprints chame Ask e vincule On Reply ao seu widget de diálogo. Substitua MODEL_NAME por um modelo atual da documentação da OpenAI. A resposta chega na thread do jogo, então é seguro atualizar a interface a partir do evento.

Isso envia uma linha por vez. Para uma conversa, mantenha um array de mensagens e envie todas elas em cada requisição.

O que ele deixa para você construir

  • A chave. Uma chave empacotada com o jogo pode ser extraída e consome toda a sua conta da OpenAI. Você precisa de um servidor próprio entre o jogo e a API.
  • Voz. Speech-to-text para o jogador, text-to-speech para a resposta, decodificação do áudio em um Sound Wave, e manter a espera curta. Veja como funciona o pipeline de voz de NPCs com IA.
  • Emoção e ações. A resposta é texto simples. Para controlar animação e jogabilidade, você pede JSON no prompt, faz o parse e trata as vezes em que ele vem malformado.
  • Histórico e custo. Cada mensagem deixa a próxima requisição maior, mais lenta e mais cara.
  • Manter o personagem no papel. Os jogadores tentarão quebrar um prompt de sistema em poucos minutos. Veja como manter NPCs com IA no personagem.

Caminho 2: o mesmo NPC com o plugin da Neocortex

Com a Neocortex, o personagem é desenhado em um editor no navegador, com personalidade, um mundo, uma base de conhecimento, uma voz e ações, e o plugin da Unreal oferece nós de Blueprint para o restante:

  1. Clone o plugin na pasta Plugins do seu projeto, ative-o e adicione "Neocortex" ao seu Build.cs.
  2. Cole sua chave de API em Project Settings > Game > Neocortex.
  3. Adicione um componente Neocortex Smart Agent ao NPC e defina o Project Id.
  4. Chame Send Message For Audio com a fala do jogador.
  5. Vincule On Chat para o texto, a emoção e a ação, e On Audio para um Sound Wave que você toca com Set Sound e Play.

Para entrada de voz, o componente Neocortex Microphone Recorder grava e transcreve o jogador, então um botão de push-to-talk são três nós de Blueprint. O passo a passo completo está em como adicionar NPCs com IA à Unreal Engine 5.

Lado a lado

API da OpenAI em C++Plugin da Neocortex para Unreal
Primeira respostaUm componente em C++ e parse de JSONNós de Blueprint
Voz de entrada e saídaConstrua você mesmoComponente de gravação, Sound Wave na saída
EmoçãoPrompt e parseEm cada resposta
AçõesPedir JSON no prompt e validarDefinidas no editor, enviadas como palavra-chave
Histórico da conversaSeu array, crescendoMantido em uma sessão por personagem
Proteção da chaveSeu próprio servidorLimites por jogador e por personagem em cada chave
Design do personagemUm prompt de sistemaEditor visual com testes no navegador

Dúvidas comuns na rota faça-você-mesmo

  • "A requisição nunca retorna." Confira se o módulo HTTP está no seu Build.cs e se a requisição não está sendo coletada pelo garbage collector: mantenha a chamada dentro de um componente que viva enquanto o NPC viver.
  • "O JSON quebra com aspas." Monte o corpo com FJsonObject, como acima, em vez de formatar strings à mão. Os jogadores digitam apóstrofos e aspas o tempo todo.
  • "Posso chamar isso em projetos só com Blueprints?" Não, sem C++ ou um plugin HTTP de terceiros.

Próximos passos

Para o lado do design, leia como dar personalidades únicas aos NPCs e como fazer NPCs com IA agirem sobre o que dizem. Todos os tutoriais estão no guia para criar NPCs com IA.

Verificado em novembro de 2026. A Neocortex não é afiliada à OpenAI nem à Epic Games.

Perguntas frequentes

Posso usar o ChatGPT nos Blueprints da Unreal Engine?

Não com os nós integrados. A Unreal não tem nó de Blueprint para requisições HTTP, então você escreve uma pequena função em C++ com o módulo HTTP e a expõe aos Blueprints, ou instala um plugin. O plugin da Neocortex oferece um personagem de IA completo com nós de Blueprint e voz.

Preciso de C++ para chamar um LLM na Unreal?

Para uma chamada direta à API, algumas linhas de C++ ou um plugin HTTP de terceiros. Com a Neocortex, o projeto precisa ser um projeto em C++ para que o plugin compile, mas tudo o que você usa são nós de Blueprint.

É seguro colocar uma chave de API da OpenAI em um jogo na Unreal?

Não. Qualquer coisa empacotada com o jogo pode ser extraída, e uma chave da OpenAI dá acesso total aos gastos da sua conta. Direcione as chamadas por um servidor próprio. As chaves da Neocortex podem ter limites de uso por jogador e por personagem, que os nossos servidores aplicam, e você pode desativar uma chave pelo painel.

Como dou voz a um NPC com ChatGPT na Unreal?

Você adicionaria speech-to-text para o jogador e text-to-speech para a resposta, depois transformaria o áudio em um Sound Wave. O plugin da Neocortex devolve a resposta como um Sound Wave que você pode tocar, e grava e transcreve a voz do jogador.

Artigos semelhantes

Continue lendo