Neocortex Logo

Cómo hacer que los NPC hablen con ChatGPT en Unity

Haz que los NPC hablen con ChatGPT en Unity: llama a la API de OpenAI con UnityWebRequest, mira lo que te deja por construir y añade un personaje con voz por el camino más rápido.

Sercan AltundasFounder of Neocortex

· 9 min de lectura

Haz que los NPC hablen con ChatGPT en Unity: llama a la API de OpenAI con UnityWebRequest, mira lo que te deja por construir y añade un personaje con voz por el camino más rápido.

"NPC de ChatGPT" es como la mayoría de los desarrolladores de Unity se imaginan por primera vez un personaje de IA: enviar a un modelo de lenguaje lo que escribió el jugador y mostrar la respuesta sobre la cabeza del NPC. Esta guía construye exactamente eso con la API de OpenAI, y luego muestra qué te deja por resolver y cómo se ve el mismo NPC con el SDK de Unity de Neocortex.

Ruta 1: llama tú mismo a la API de OpenAI

Necesitas una clave de API de OpenAI y un proyecto de Unity. El NPC guarda una lista de mensajes, que empieza con un prompt de sistema que dice quién es el personaje, y envía la lista completa cada vez que habla el jugador:

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

Sustituye MODEL_NAME por un modelo actual de la documentación de OpenAI, llama a StartCoroutine(npc.Ask("Got any work?")), y Brannoch responde. Es un prototipo funcional en unas cuarenta líneas.

Lo que el prototipo te deja por construir

La primera conversación es la parte fácil. Llevarlo a un juego real implica resolver:

  • La clave. Una clave de OpenAI en una build puede extraerla cualquiera y gastar toda tu cuenta. Necesitas un servidor propio entre el juego y la API.
  • La voz. Conversión de voz a texto para el jugador, conversión de texto a voz para la respuesta, y streaming entre ambas, o cada respuesta espera a que terminen las dos. Nuestra guía del pipeline de voz lo desglosa.
  • Emoción y acciones. La respuesta es texto plano. Para controlar la animación o la jugabilidad tienes que pedir JSON, analizarlo y gestionar las veces que llega mal formado.
  • El historial. La lista crece con cada línea, y con ella crecen el coste y el retraso. Necesitas recortarla o resumirla.
  • Mantenerse en personaje. Un prompt de sistema por sí solo se rompe rápido cuando los jugadores presionan. Consulta cómo mantener a los NPC de IA en personaje.
  • Control de costes. Nada impide que un jugador hable todo el día a costa de tu factura.

Ruta 2: el mismo NPC con Neocortex

Con Neocortex diseñas a Brannoch una sola vez en un editor del navegador, con personalidad, mundo, base de conocimiento, voz y acciones, y el SDK de Unity se encarga del resto:

  1. En Unity, añade el paquete desde la URL de git: https://github.com/neocortex-link/neocortex-unity-sdk.git
  2. Pega tu clave de API en Tools > Neocortex > Settings.
  3. Haz clic derecho en la Jerarquía y elige Neocortex > Complete Voice Chat, y luego selecciona a Brannoch en el desplegable del Smart Agent.
  4. Pulsa Play y habla.

Desde el código, una pregunta escrita con respuesta hablada es una sola llamada:

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

Cada respuesta llega como líneas con una emoción en cada una, más las acciones con el id del objeto al que apuntan, así que la animación y la jugabilidad se conectan a eventos de Unity en lugar de texto analizado. Nuestro tutorial paso a paso de personajes de IA en Unity muestra la configuración completa.

Lado a lado

API de OpenAI directamenteSDK de Unity de Neocortex
Primera respuesta de textoUnas 40 líneas de códigoSin código
Voz de entrada y salidaHay que construirla: STT, TTS, streamingUn componente, en streaming
Emoción por líneaPedirla en el prompt y analizarlaIntegrada, 17 emociones
AccionesPedir JSON y validarloDefinidas en el editor, enviadas como datos
Protección de la claveTu propio servidorLímites por jugador y por personaje en cada clave
Micrófono en WebGLNo está en UnityPlantilla incluida
Diseño del personajeUn prompt de sistemaEditor visual con pruebas en el navegador

Preguntas habituales en la ruta hecha a mano

  • "La respuesta se corta." El modelo alcanzó su límite de salida. Pide respuestas breves en el prompt de sistema, que además son mejores diálogos.
  • "Se olvidó de lo que hablamos." Tienes que enviar el historial completo en cada petición. Un modelo de lenguaje no recuerda nada entre peticiones.
  • "¿Puedo publicarlo como build de WebGL?" No con la clave dentro: cualquiera puede leerla en la pestaña de red del navegador. Envía las peticiones a través de tu propio servidor.

Siguientes pasos

Para avanzar con Neocortex en Unity, añade chat de voz y texto a voz para frases con guion. Si prefieres ejecutar un modelo en tu propia máquina mientras haces el prototipo, consulta cómo ejecutar un LLM en local en Unity. Todos los tutoriales están en la guía para crear NPC de IA.

Revisado en noviembre de 2026. Neocortex no está afiliado a OpenAI.

Preguntas frecuentes

¿Puedo usar ChatGPT para NPC en Unity?

Sí. Puedes llamar a la API de OpenAI desde Unity con UnityWebRequest y un prompt de sistema que describa al personaje. Para tener voz, emociones, acciones y límites de clave sin construirlos tú, Neocortex te da un personaje completo a través de su SDK de Unity.

¿Es seguro poner una clave de API de OpenAI en un juego de Unity?

No. Cualquier cosa de una build puede extraerse, y una clave de OpenAI da acceso total al gasto de tu cuenta. Si llamas a OpenAI directamente, envía las peticiones a través de tu propio servidor. Las claves de Neocortex pueden tener límites de uso por jugador y por personaje que nuestros servidores aplican, y puedes desactivar una clave desde el panel.

¿Cómo mantengo en personaje a un NPC de ChatGPT?

Escribe un prompt de sistema concreto, describe el mundo, limita lo que sabe el personaje y ponlo a prueba con jugadores que intenten romperlo. Los personajes de Neocortex se construyen en un editor con mundo, base de conocimiento y acciones, y se mantienen dentro del mundo que describes.

¿Cómo hago que un NPC de ChatGPT hable?

Necesitas conversión de voz a texto para el jugador, conversión de texto a voz para la respuesta y streaming entre ambas para que la espera sea corta. El SDK de Unity de Neocortex hace las tres cosas desde un solo componente.

Artículos similares

Sigue leyendo