Como fazer NPCs falarem com o ChatGPT na Unity
Faça NPCs falarem com o ChatGPT na Unity: chame a API da OpenAI com UnityWebRequest, veja o que ela deixa para você construir e adicione um personagem com voz do jeito mais rápido.
Sercan AltundasFounder of Neocortex
· 9 min de leitura

"NPC com ChatGPT" é como a maioria dos desenvolvedores de Unity imagina pela primeira vez um personagem de IA: enviar o que o jogador digitou para um modelo de linguagem e mostrar a resposta acima da cabeça do NPC. Este guia cria exatamente isso com a API da OpenAI, depois mostra o que ela deixa para você resolver e como o mesmo NPC fica com o SDK da Neocortex para Unity.
Rota 1: chame a API da OpenAI você mesmo
Você precisa de uma chave de API da OpenAI e de um projeto na Unity. O NPC mantém uma lista de mensagens, começando com um prompt de sistema que diz quem é o personagem, e envia a lista inteira toda vez que o jogador fala:
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
}
}Troque MODEL_NAME por um modelo atual da documentação da OpenAI, chame StartCoroutine(npc.Ask("Got any work?")), e Brannoch responde. Isso é um protótipo funcionando em cerca de quarenta linhas.
O que o protótipo deixa para você construir
A primeira conversa é a parte fácil. Colocar isso no ar exige resolver:
- A chave. Uma chave da OpenAI em um build pode ser extraída por qualquer pessoa e consome toda a sua conta. Você precisa de um servidor próprio entre o jogo e a API.
- Voz. Speech to text para o jogador, text to speech para a resposta e streaming entre os dois, ou então cada resposta espera que ambos terminem. Nosso guia do pipeline de voz detalha isso.
- Emoção e ações. A resposta é texto simples. Para comandar animação ou jogabilidade, você pede JSON no prompt, faz o parse e trata as vezes em que ele volta malformado.
- Histórico. A lista cresce a cada fala, e com ela crescem o custo e o atraso. Você precisa de cortes ou resumos.
- Ficar no personagem. Um prompt de sistema sozinho quebra rápido quando os jogadores insistem. Veja como manter NPCs de IA no personagem.
- Controle de custo. Nada impede que um jogador converse o dia inteiro às custas da sua conta.
Rota 2: o mesmo NPC com a Neocortex
Com a Neocortex, você cria o Brannoch uma vez em um editor no navegador, com personalidade, mundo, base de conhecimento, voz e ações, e o SDK para Unity cuida do resto:
- Na Unity, adicione o pacote pela URL do git:
https://github.com/neocortex-link/neocortex-unity-sdk.git - Cole a sua chave de API em Tools > Neocortex > Settings.
- Clique com o botão direito na Hierarchy e escolha Neocortex > Complete Voice Chat, depois selecione o Brannoch no menu suspenso do Smart Agent.
- Aperte Play e converse.
No código, uma pergunta em texto com resposta falada é uma única chamada:
agent.TextToAudio("Got any work?"); // agent is a NeocortexSmartAgentCada resposta chega em linhas, com uma emoção em cada uma, além de eventuais ações com o ID do objeto que elas alvejam, então animação e jogabilidade se conectam a eventos da Unity em vez de texto analisado. Nosso tutorial passo a passo de personagem de IA na Unity mostra a configuração completa.
Lado a lado
| API da OpenAI diretamente | SDK da Neocortex para Unity | |
|---|---|---|
| Primeira resposta em texto | Cerca de 40 linhas de código | Sem código |
| Voz de entrada e saída | Você constrói: STT, TTS, streaming | Um componente, em streaming |
| Emoção por linha | Pedir no prompt e fazer o parse | Integrada, 17 emoções |
| Ações | Pedir JSON no prompt e validar | Definidas no editor, enviadas como dados |
| Proteção da chave | Seu próprio servidor | Limites por jogador e por personagem em cada chave |
| Microfone no WebGL | Não existe na Unity | Template incluído |
| Criação do personagem | Um prompt de sistema | Editor visual com testes no navegador |
Dúvidas comuns na rota faça-você-mesmo
- "A resposta foi cortada." O modelo atingiu o limite de saída. Peça respostas curtas no prompt de sistema, o que também é um diálogo melhor.
- "Ele esqueceu o que falamos." Você precisa enviar o histórico inteiro a cada vez. Um modelo de linguagem não lembra de nada entre as requisições.
- "Posso lançar como build WebGL?" Não com a chave dentro: qualquer pessoa pode lê-la na aba de rede do navegador. Envie as requisições pelo seu próprio servidor.
Próximos passos
Para avançar com a Neocortex na Unity, adicione chat por voz e text to speech para falas roteirizadas. Se preferir rodar um modelo na sua própria máquina enquanto prototipa, veja como rodar um LLM localmente na Unity. Todos os tutoriais estão no guia para criar NPCs de IA.
Verificado em novembro de 2026. A Neocortex não é afiliada à OpenAI.
Perguntas frequentes
Posso usar o ChatGPT para NPCs na Unity?
Sim. Você pode chamar a API da OpenAI a partir da Unity com UnityWebRequest e um prompt de sistema que descreve o personagem. Para voz, emoções, ações e limites de chave sem construir tudo por conta própria, a Neocortex oferece um personagem completo pelo seu SDK para Unity.
É seguro colocar uma chave de API da OpenAI em um jogo na Unity?
Não. Qualquer coisa que esteja em um build pode ser extraída, e uma chave da OpenAI dá acesso total aos gastos da sua conta. Se você chamar a OpenAI diretamente, envie as requisições por um servidor próprio. As chaves da Neocortex podem ter limites de uso por jogador e por personagem, aplicados pelos nossos servidores, e você pode desativar uma chave pelo painel.
Como mantenho um NPC do ChatGPT no personagem?
Escreva um prompt de sistema específico, descreva o mundo, limite o que o personagem sabe e teste contra jogadores que tentem quebrá-lo. Os personagens da Neocortex são criados em um editor com mundo, base de conhecimento e ações, e permanecem dentro do mundo que você descreve.
Como faço um NPC do ChatGPT falar?
Você precisa de speech to text para o jogador, text to speech para a resposta e streaming entre os dois, para que a espera seja curta. O SDK para Unity da Neocortex faz as três coisas a partir de um único componente.






