Neocortex Logo

Utiliser ChatGPT dans les Blueprints d'Unreal Engine

Utilisez ChatGPT dans les Blueprints d'Unreal Engine : appelez l'API OpenAI depuis un nœud C++, exposez-le aux Blueprints, et comparez avec un PNJ doublé grâce au plugin Neocortex.

Sercan AltundasFounder of Neocortex

· 9 min de lecture

Utilisez ChatGPT dans les Blueprints d'Unreal Engine : appelez l'API OpenAI depuis un nœud C++, exposez-le aux Blueprints, et comparez avec un PNJ doublé grâce au plugin Neocortex.

« Comment utiliser ChatGPT dans les Blueprints d'Unreal ? » signifie en général : laisser les joueurs parler à un PNJ et faire répondre un modèle de langage. Unreal n'a pas de nœud Blueprint pour les requêtes web, donc la première étape demande un peu de C++. Ce guide construit un nœud ChatGPT appelable depuis un Blueprint avec le module HTTP d'Unreal, puis montre ce qu'il faut pour le livrer et à quoi ressemble le même PNJ avec le plugin Neocortex.

Première voie : un nœud ChatGPT pour les Blueprints

Il vous faut un projet C++, une clé API OpenAI, et les modules HTTP et Json ajoutés à PublicDependencyModuleNames dans votre Build.cs. Ce composant envoie une réplique du joueur au point d'accès de complétion de chat et déclenche un événement Blueprint avec la réponse :

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

Ajoutez le composant à votre PNJ, réglez SystemPrompt (« Tu es Brannoch, un forgeron bourru... ») et la clé, puis dans les Blueprints appelez Ask et liez On Reply à votre widget de dialogue. Remplacez MODEL_NAME par un modèle actuel tiré de la documentation d'OpenAI. La réponse arrive sur le thread de jeu, donc il est sûr de mettre l'interface à jour depuis l'événement.

Cela n'envoie qu'une réplique à la fois. Pour une conversation, gardez un tableau de messages et envoyez-les tous à chaque requête.

Ce que cette voie vous laisse à construire

  • La clé. Une clé livrée avec le jeu peut être extraite et consomme tout le compte OpenAI. Il vous faut votre propre serveur entre le jeu et l'API.
  • La voix. La reconnaissance vocale pour le joueur, la synthèse vocale pour la réponse, le décodage de l'audio en Sound Wave, et la limitation de l'attente. Voir le fonctionnement du pipeline vocal des PNJ IA.
  • L'émotion et les actions. La réponse est du texte brut. Pour piloter l'animation et le gameplay, vous demandez du JSON et l'analysez, puis gérez les cas où il est mal formé.
  • L'historique et le coût. Chaque message rend la requête suivante plus grosse, plus lente et plus chère.
  • Rester dans le personnage. Les joueurs essaieront de casser un prompt système en quelques minutes. Voir comment garder les PNJ IA dans leur personnage.

Deuxième voie : le même PNJ avec le plugin Neocortex

Avec Neocortex, le personnage est conçu dans un éditeur dans le navigateur, avec une personnalité, un monde, une base de connaissances, une voix et des actions, et le plugin Unreal vous donne des nœuds Blueprint pour le reste :

  1. Clonez le plugin dans le dossier Plugins de votre projet, activez-le, et ajoutez "Neocortex" à votre Build.cs.
  2. Collez votre clé API dans Project Settings > Game > Neocortex.
  3. Ajoutez un composant Neocortex Smart Agent au PNJ et réglez son Project Id.
  4. Appelez Send Message For Audio avec la réplique du joueur.
  5. Liez On Chat pour le texte, l'émotion et l'action, et On Audio pour une Sound Wave que vous jouez avec Set Sound et Play.

Pour la saisie vocale, le composant Neocortex Microphone Recorder enregistre et transcrit le joueur, donc un bouton push-to-talk tient en trois nœuds Blueprint. La démarche complète est dans comment ajouter des PNJ IA à Unreal Engine 5.

Côte à côte

API OpenAI depuis C++Plugin Unreal Neocortex
Première réponseUn composant C++ et une analyse JSONNœuds Blueprint
Voix en entrée et en sortieÀ construire soi-mêmeComposant d'enregistrement, Sound Wave en sortie
ÉmotionPrompt et analyseÀ chaque réponse
ActionsDemander du JSON et validerDéfinies dans l'éditeur, envoyées sous forme de mot-clé
Historique de conversationVotre tableau, qui grossitConservé dans une session par personnage
Protection de la cléVotre propre serveurLimites par joueur et par personnage sur chaque clé
Conception du personnageUn prompt systèmeÉditeur visuel avec test dans le navigateur

Questions fréquentes sur la voie « faites-le vous-même »

  • « La requête ne revient jamais. » Vérifiez que le module HTTP figure dans votre Build.cs et que la requête n'est pas supprimée par le ramasse-miettes : gardez l'appel dans un composant qui vit aussi longtemps que le PNJ.
  • « Le JSON casse sur les guillemets. » Construisez le corps avec FJsonObject, comme ci-dessus, au lieu de formater des chaînes à la main. Les joueurs tapent sans cesse des apostrophes et des guillemets.
  • « Puis-je l'appeler depuis un projet uniquement en Blueprints ? » Pas sans C++ ni un plugin HTTP tiers.

Étapes suivantes

Pour l'aspect conception, lisez comment donner aux PNJ des personnalités uniques et comment faire agir les PNJ IA sur ce qu'ils disent. Tous les tutoriels figurent dans le guide pour créer des PNJ IA.

Vérifié en novembre 2026. Neocortex n'est affilié ni à OpenAI ni à Epic Games.

Questions fréquentes

Puis-je utiliser ChatGPT dans les Blueprints d'Unreal Engine ?

Pas avec les nœuds intégrés. Unreal n'a pas de nœud Blueprint pour les requêtes HTTP, donc vous écrivez une petite fonction C++ avec le module HTTP et l'exposez aux Blueprints, ou vous installez un plugin. Le plugin Neocortex vous donne un personnage IA complet avec des nœuds Blueprint et la voix.

Ai-je besoin de C++ pour appeler un LLM depuis Unreal ?

Pour un appel direct à l'API, quelques lignes de C++ ou un plugin HTTP tiers suffisent. Avec Neocortex, le projet doit être un projet C++ pour que le plugin compile, mais tout ce que vous utilisez est un nœud Blueprint.

Est-il sûr de mettre une clé API OpenAI dans un jeu Unreal ?

Non. Tout ce qui est empaqueté avec le jeu peut être extrait, et une clé OpenAI donne un accès complet aux dépenses de votre compte. Passez les appels par votre propre serveur. Les clés Neocortex peuvent porter des limites d'usage par joueur et par personnage que nos serveurs appliquent, et vous pouvez désactiver une clé depuis le tableau de bord.

Comment donner une voix à un PNJ ChatGPT dans Unreal ?

Il faudrait ajouter une reconnaissance vocale pour le joueur et une synthèse vocale pour la réponse, puis transformer l'audio en Sound Wave. Le plugin Neocortex renvoie la réponse sous forme de Sound Wave que vous pouvez jouer, et enregistre et transcrit la voix du joueur.

Articles similaires

À lire aussi