Neocortex Logo

Come far parlare gli NPC con ChatGPT in Unity

Fai parlare gli NPC con ChatGPT in Unity: chiama l'API OpenAI con UnityWebRequest, scopri cosa ti lascia da costruire e aggiungi un personaggio doppiato nel modo più rapido.

Sercan AltundasFounder of Neocortex

· 9 min di lettura

Fai parlare gli NPC con ChatGPT in Unity: chiama l'API OpenAI con UnityWebRequest, scopri cosa ti lascia da costruire e aggiungi un personaggio doppiato nel modo più rapido.

"NPC ChatGPT" è il modo in cui la maggior parte degli sviluppatori Unity immagina per la prima volta un personaggio IA: invii al modello linguistico ciò che il giocatore ha scritto e mostri la risposta sopra la testa dell'NPC. Questa guida costruisce esattamente questo con l'API OpenAI, poi mostra cosa ti lascia da risolvere e come lo stesso NPC appare con l'SDK Unity di Neocortex.

Percorso 1: chiama tu stesso l'API OpenAI

Ti servono una chiave API OpenAI e un progetto Unity. L'NPC tiene una lista di messaggi, che parte da un prompt di sistema che dice chi è il personaggio, e invia l'intera lista ogni volta che il giocatore parla:

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
    }
}

Sostituisci MODEL_NAME con un modello attuale dalla documentazione di OpenAI, chiama StartCoroutine(npc.Ask("Got any work?")), e Brannoch risponde. Si tratta di un prototipo funzionante in circa quaranta righe.

Cosa ti lascia da costruire il prototipo

La prima conversazione è la parte facile. Portarla in produzione richiede di risolvere:

  • La chiave. Una chiave OpenAI in una build può essere estratta da chiunque e consuma l'intero account. Ti serve un server tuo tra il gioco e l'API.
  • La voce. Speech-to-text per il giocatore, text-to-speech per la risposta, e lo streaming tra i due, altrimenti ogni risposta aspetta che entrambi finiscano. La nostra guida alla pipeline vocale la scompone.
  • Emozione e azioni. La risposta è testo semplice. Per guidare animazioni o meccaniche di gioco devi chiedere JSON nel prompt, analizzarlo e gestire le volte in cui arriva malformato.
  • La cronologia. La lista cresce a ogni battuta, e con essa crescono il costo e il ritardo. Ti servono tagli o riassunti.
  • Restare nel personaggio. Un prompt di sistema da solo cede in fretta quando i giocatori insistono. Vedi come tenere gli NPC IA nel personaggio.
  • Controllo dei costi. Nulla impedisce a un giocatore di parlare tutto il giorno a spese tue.

Percorso 2: lo stesso NPC con Neocortex

Con Neocortex progetti Brannoch una sola volta in un editor nel browser, con una personalità, un mondo, una knowledge base, una voce e azioni, e l'SDK Unity si occupa del resto:

  1. In Unity, aggiungi il pacchetto dall'URL git: https://github.com/neocortex-link/neocortex-unity-sdk.git
  2. Incolla la tua chiave API in Tools > Neocortex > Settings.
  3. Fai clic destro sulla Hierarchy e scegli Neocortex > Complete Voice Chat, poi seleziona Brannoch nel menu a tendina dello Smart Agent.
  4. Premi Play e parla.

Dal codice, una domanda di testo con una risposta parlata è una sola chiamata:

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

Ogni risposta arriva come righe con un'emozione per ciascuna, più le eventuali azioni con l'id dell'oggetto a cui si riferiscono, quindi animazione e meccaniche si agganciano agli eventi di Unity invece che a testo analizzato. La nostra guida passo passo a un personaggio IA in Unity mostra l'intera configurazione.

Fianco a fianco

API OpenAI direttamenteSDK Unity di Neocortex
Prima risposta testualeCirca 40 righe di codiceNessun codice
Voce in entrata e in uscitaDa costruire: STT, TTS, streamingUn solo componente, in streaming
Emozione per ogni rigaChiederla nel prompt e analizzarlaIntegrata, 17 emozioni
AzioniChiedere JSON nel prompt e validarloDefinite nell'editor, inviate come dati
Protezione della chiaveUn tuo serverLimiti per giocatore e per personaggio su ogni chiave
Microfono WebGLNon in UnityTemplate incluso
Progettazione del personaggioUn prompt di sistemaEditor visuale con test nel browser

Domande comuni sul percorso fai-da-te

  • "La risposta viene troncata." Il modello ha raggiunto il suo limite di output. Chiedi risposte brevi nel prompt di sistema, che è anche un dialogo migliore.
  • "Ha dimenticato cosa abbiamo detto." Devi inviare tutta la cronologia ogni volta. Un modello linguistico non ricorda nulla tra una richiesta e l'altra.
  • "Posso distribuirlo come build WebGL?" Non con la chiave dentro: chiunque può leggerla nella scheda di rete del browser. Invia le richieste tramite un tuo server.

Prossimi passi

Per andare oltre con Neocortex in Unity, aggiungi la chat vocale e la sintesi vocale per battute scriptate. Se preferisci far girare un modello sulla tua macchina mentre prototipi, vedi come far girare un LLM in locale in Unity. Ogni tutorial si trova nella guida alla costruzione di NPC IA.

Verificato a novembre 2026. Neocortex non è affiliata con OpenAI.

Domande frequenti

Posso usare ChatGPT per gli NPC in Unity?

Sì. Puoi chiamare l'API OpenAI da Unity con UnityWebRequest e un prompt di sistema che descrive il personaggio. Per voce, emozioni, azioni e limiti sulle chiavi senza doverli costruire tu, Neocortex ti dà un personaggio completo tramite il suo SDK Unity.

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

No. Qualsiasi cosa nella build può essere estratta, e una chiave OpenAI dà pieno accesso alla spesa dell'account. Se chiami OpenAI direttamente, fai passare le richieste 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 tengo un NPC ChatGPT nel personaggio?

Scrivi un prompt di sistema specifico, descrivi il mondo, limita ciò che il personaggio sa e mettilo alla prova con giocatori che cercano di farlo uscire di ruolo. I personaggi Neocortex sono costruiti in un editor con un mondo, una knowledge base e azioni, e restano dentro il mondo che descrivi.

Come faccio parlare un NPC ChatGPT?

Ti servono speech-to-text per il giocatore, text-to-speech per la risposta e lo streaming tra i due, così l'attesa resta breve. L'SDK Unity di Neocortex fa tutti e tre con un solo componente.

Articoli simili

Continua a leggere