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

"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:
- In Unity, aggiungi il pacchetto dall'URL git:
https://github.com/neocortex-link/neocortex-unity-sdk.git - Incolla la tua chiave API in Tools > Neocortex > Settings.
- Fai clic destro sulla Hierarchy e scegli Neocortex > Complete Voice Chat, poi seleziona Brannoch nel menu a tendina dello Smart Agent.
- 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 NeocortexSmartAgentOgni 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 direttamente | SDK Unity di Neocortex | |
|---|---|---|
| Prima risposta testuale | Circa 40 righe di codice | Nessun codice |
| Voce in entrata e in uscita | Da costruire: STT, TTS, streaming | Un solo componente, in streaming |
| Emozione per ogni riga | Chiederla nel prompt e analizzarla | Integrata, 17 emozioni |
| Azioni | Chiedere JSON nel prompt e validarlo | Definite nell'editor, inviate come dati |
| Protezione della chiave | Un tuo server | Limiti per giocatore e per personaggio su ogni chiave |
| Microfono WebGL | Non in Unity | Template incluso |
| Progettazione del personaggio | Un prompt di sistema | Editor 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.






