Neocortex Logo

Faire parler des PNJ avec ChatGPT dans Unity

Faites parler des PNJ avec ChatGPT dans Unity : appelez l'API OpenAI avec UnityWebRequest, voyez ce qu'il vous reste à construire, et ajoutez un personnage vocal plus rapidement.

Sercan AltundasFounder of Neocortex

· 9 min de lecture

Faites parler des PNJ avec ChatGPT dans Unity : appelez l'API OpenAI avec UnityWebRequest, voyez ce qu'il vous reste à construire, et ajoutez un personnage vocal plus rapidement.

« PNJ ChatGPT » est l'image que la plupart des développeurs Unity se font d'abord d'un personnage IA : envoyer ce que le joueur a tapé à un modèle de langage, et afficher la réponse au-dessus de la tête du PNJ. Ce guide construit exactement cela avec l'API OpenAI, puis montre ce qu'il vous laisse à résoudre et à quoi ressemble le même PNJ avec le SDK Unity de Neocortex.

Voie 1 : appeler vous-même l'API OpenAI

Il vous faut une clé d'API OpenAI et un projet Unity. Le PNJ conserve une liste de messages, en commençant par un prompt système qui décrit le personnage, et envoie la liste entière chaque fois que le joueur parle :

using System;
using System.Collections;
using System.Collections.Generic;
using System.Text;
using UnityEngine;
using UnityEngine.Networking;

public class ChatGptNpc : MonoBehaviour
{
    [Serializable] class Message { public string role; public string content; }
    [Serializable] class ChatRequest { public string model; public Message[] messages; }
    [Serializable] class Choice { public Message message; }
    [Serializable] class ChatResult { public Choice[] choices; }

    [SerializeField] private string apiKey; // for local testing only, never ship it
    private readonly List<Message> history = new()
    {
        new Message { role = "system", content = "You are Brannoch, a gruff village blacksmith. Answer in one or two sentences." }
    };

    public IEnumerator Ask(string playerLine)
    {
        history.Add(new Message { role = "user", content = playerLine });
        string body = JsonUtility.ToJson(new ChatRequest { model = "MODEL_NAME", messages = history.ToArray() });

        using var request = new UnityWebRequest("https://api.openai.com/v1/chat/completions", "POST");
        request.uploadHandler = new UploadHandlerRaw(Encoding.UTF8.GetBytes(body));
        request.downloadHandler = new DownloadHandlerBuffer();
        request.SetRequestHeader("Content-Type", "application/json");
        request.SetRequestHeader("Authorization", "Bearer " + apiKey);
        yield return request.SendWebRequest();

        if (request.result != UnityWebRequest.Result.Success) { Debug.LogWarning(request.error); yield break; }
        Message reply = JsonUtility.FromJson<ChatResult>(request.downloadHandler.text).choices[0].message;
        history.Add(reply);
        Debug.Log(reply.content); // show it in your dialogue UI
    }
}

Remplacez MODEL_NAME par un modèle actuel tiré de la documentation d'OpenAI, appelez StartCoroutine(npc.Ask("Got any work?")), et Brannoch répond. C'est un prototype fonctionnel en une quarantaine de lignes.

Ce que le prototype vous laisse à construire

La première conversation est la partie facile. Pour la livrer, il faut résoudre :

  • La clé. Une clé OpenAI dans un build peut être extraite par n'importe qui, et elle consomme tout le compte. 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, et le streaming entre les deux, sinon chaque réponse attend que les deux soient terminées. Notre guide du pipeline vocal le détaille.
  • Émotions et actions. La réponse est du texte brut. Pour piloter l'animation ou le gameplay, il faut demander du JSON, l'analyser et gérer les cas où il revient malformé.
  • L'historique. La liste grandit à chaque réplique, et avec elle le coût et le délai. Il faut la tronquer ou la résumer.
  • Rester dans le personnage. Un prompt système seul cède vite quand les joueurs insistent. Voir comment garder les PNJ IA dans leur personnage.
  • Maîtrise des coûts. Rien n'empêche un joueur de parler toute la journée à vos frais.

Voie 2 : le même PNJ avec Neocortex

Avec Neocortex, vous concevez Brannoch une seule fois dans un éditeur sur navigateur, avec une personnalité, un monde, une base de connaissances, une voix et des actions, et le SDK Unity s'occupe du reste :

  1. Dans Unity, ajoutez le package depuis l'URL git : https://github.com/neocortex-link/neocortex-unity-sdk.git
  2. Collez votre clé API dans Tools > Neocortex > Settings.
  3. Faites un clic droit dans la Hierarchy et choisissez Neocortex > Complete Voice Chat, puis sélectionnez Brannoch dans la liste déroulante du Smart Agent.
  4. Appuyez sur Play et parlez.

Depuis le code, une question écrite avec une réponse parlée tient en un seul appel :

agent.TextToAudio("Got any work?"); // agent is a NeocortexSmartAgent

Chaque réponse arrive sous forme de lignes accompagnées d'une émotion, ainsi que d'actions avec l'identifiant de l'objet visé. L'animation et le gameplay se branchent donc sur des événements Unity au lieu de texte analysé. Notre tutoriel pas à pas sur les personnages IA dans Unity montre toute la configuration.

Côte à côte

API OpenAI directeSDK Unity Neocortex
Première réponse écriteEnviron 40 lignes de codeAucun code
Voix en entrée et en sortieÀ construire : STT, TTS, streamingUn seul composant, en flux
Émotion par ligneÀ demander dans le prompt et à analyserIntégrée, 17 émotions
ActionsDemander du JSON et le validerDéfinies dans l'éditeur, envoyées comme données
Protection de la cléVotre propre serveurLimites par joueur et par personnage sur chaque clé
Micro WebGLAbsent dans UnityModèle inclus
Conception du personnageUn prompt systèmeÉditeur visuel avec test dans le navigateur

Questions courantes sur la voie « faites-le vous-même »

  • « La réponse est coupée. » Le modèle a atteint sa limite de sortie. Demandez des réponses courtes dans le prompt système, ce qui donne aussi de meilleurs dialogues.
  • « Il a oublié ce qu'on s'est dit. » Vous devez renvoyer tout l'historique à chaque fois. Un modèle de langage ne se souvient de rien entre deux requêtes.
  • « Puis-je livrer cela en build WebGL ? » Pas avec la clé incluse : n'importe qui peut la lire dans l'onglet réseau du navigateur. Envoyez les requêtes via votre propre serveur.

Étapes suivantes

Pour aller plus loin avec Neocortex dans Unity, ajoutez le chat vocal et la synthèse vocale pour les répliques scriptées. Si vous préférez faire tourner un modèle sur votre propre machine pendant le prototypage, voyez comment faire tourner un LLM en local dans Unity. Chaque tutoriel figure dans le guide pour construire des PNJ IA.

Vérifié en novembre 2026. Neocortex n'est pas affilié à OpenAI.

Questions fréquentes

Puis-je utiliser ChatGPT pour les PNJ dans Unity ?

Oui. Vous pouvez appeler l'API OpenAI depuis Unity avec UnityWebRequest et un prompt système qui décrit le personnage. Pour la voix, les émotions, les actions et la gestion des clés sans les construire vous-même, Neocortex vous donne un personnage complet via son SDK Unity.

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

Non. Tout ce qui se trouve dans un build peut être extrait, et une clé OpenAI donne un accès complet aux dépenses de votre compte. Si vous appelez OpenAI directement, faites passer les requêtes 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 garder un PNJ ChatGPT dans son personnage ?

Rédigez un prompt système précis, décrivez le monde, limitez ce que le personnage sait et testez-le face à des joueurs qui essaient de le faire sortir de son rôle. Les personnages Neocortex se construisent dans un éditeur avec un monde, une base de connaissances et des actions, et restent dans le monde que vous décrivez.

Comment faire parler un PNJ ChatGPT ?

Il faut la reconnaissance vocale pour le joueur, la synthèse vocale pour la réponse, et le streaming entre les deux pour que l'attente reste courte. Le SDK Unity de Neocortex fait les trois avec un seul composant.

Articles similaires

À lire aussi