유니티에서 ChatGPT로 NPC가 말하게 하는 방법
유니티에서 UnityWebRequest로 OpenAI API를 호출해 NPC가 말하게 하는 방법입니다. 직접 만들어야 할 부분을 살펴보고, 음성이 있는 캐릭터를 더 빠르게 만드는 방법도 소개합니다.
Sercan AltundasFounder of Neocortex
· 9분 분량

"ChatGPT NPC"는 대부분의 유니티 개발자가 AI 캐릭터를 처음 떠올리는 방식입니다. 플레이어가 입력한 글을 언어 모델에 보내고, 답을 NPC 머리 위에 보여 주는 것입니다. 이 가이드는 바로 그것을 OpenAI API로 만들고, 그다음 그것이 여러분에게 무엇을 남겨 두는지 보여 준 뒤, 같은 NPC를 Neocortex 유니티 SDK로 만들면 어떻게 되는지 보여 줍니다.
경로 1: OpenAI API를 직접 호출하기
OpenAI API 키와 유니티 프로젝트가 필요합니다. NPC는 메시지 목록을 유지합니다. 목록은 캐릭터가 누구인지 설명하는 시스템 프롬프트로 시작하며, 플레이어가 말할 때마다 목록 전체를 보냅니다.
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
}
}MODEL_NAME을 OpenAI 문서의 최신 모델로 바꾸고, StartCoroutine(npc.Ask("Got any work?"))를 호출하면 Brannoch가 답합니다. 약 마흔 줄이면 작동하는 프로토타입이 완성됩니다.
프로토타입 이후 직접 만들어야 할 것
첫 대화는 가장 쉬운 부분입니다. 출시하려면 다음을 풀어야 합니다.
- 키. 빌드 안의 OpenAI 키는 누구나 꺼낼 수 있고, 계정의 모든 지출을 쓸 수 있습니다. 게임과 API 사이에 여러분만의 서버가 필요합니다.
- 음성. 플레이어를 위한 음성 인식, 답변을 위한 음성 합성, 그리고 둘 사이의 스트리밍이 필요합니다. 그렇지 않으면 모든 답이 두 과정이 끝날 때까지 기다립니다. 음성 파이프라인 가이드가 이를 자세히 나눠 설명합니다.
- 감정과 행동. 답변은 평범한 텍스트입니다. 애니메이션이나 게임플레이를 구동하려면 JSON을 요청하고, 파싱하고, 형식이 깨졌을 때를 처리해야 합니다.
- 대화 기록. 목록은 대사가 하나씩 늘어날 때마다 커지고, 비용과 지연도 함께 늘어납니다. 잘라 내거나 요약해야 합니다.
- 캐릭터 유지. 시스템 프롬프트만으로는 플레이어가 밀어붙일 때 금방 무너집니다. AI NPC를 캐릭터답게 유지하는 방법을 보세요.
- 비용 관리. 한 플레이어가 하루 종일 말하는 것을 막을 장치가 아무것도 없으면 청구서가 그대로 나옵니다.
경로 2: Neocortex로 같은 NPC 만들기
Neocortex를 쓰면 브라우저 에디터에서 Brannoch를 한 번 설계합니다. 성격, 세계관, 지식 베이스, 음성, 행동을 정하면 유니티 SDK가 나머지를 처리합니다.
- 유니티에서 git URL로 패키지를 추가하세요:
https://github.com/neocortex-link/neocortex-unity-sdk.git - Tools > Neocortex > Settings에 API 키를 붙여넣으세요.
- 계층 창을 우클릭하고 Neocortex > Complete Voice Chat을 고른 뒤, Smart Agent의 드롭다운에서 Brannoch를 선택하세요.
- Play를 누르고 말하세요.
코드에서는 텍스트 질문에 음성 답을 받는 것이 한 번의 호출입니다.
agent.TextToAudio("Got any work?"); // agent is a NeocortexSmartAgent각 답변은 감정이 붙은 대사 줄로 도착하며, 행동이 있다면 대상 오브젝트의 ID도 함께 옵니다. 따라서 애니메이션과 게임플레이는 파싱된 텍스트가 아니라 유니티 이벤트에 연결됩니다. 전체 설정은 단계별 유니티 AI 캐릭터 튜토리얼에서 볼 수 있습니다.
나란히 비교
| OpenAI API 직접 호출 | Neocortex Unity SDK | |
|---|---|---|
| 첫 텍스트 답변 | 약 40줄의 코드 | 코드 없음 |
| 음성 입력과 출력 | 직접 구현: STT, TTS, 스트리밍 | 컴포넌트 하나, 스트리밍 |
| 대사마다 감정 | 요청하고 파싱 | 기본 제공, 17가지 감정 |
| 행동 | JSON을 요청하고 검증 | 에디터에서 정의, 데이터로 전송 |
| 키 보호 | 직접 만든 서버 | 키마다 플레이어별, 캐릭터별 한도 적용 |
| WebGL 마이크 | Unity에 없음 | 템플릿 포함 |
| 캐릭터 설계 | 시스템 프롬프트 | 브라우저 테스트가 되는 비주얼 에디터 |
직접 만드는 방식에서 자주 나오는 질문
- "답변이 잘려요." 모델이 출력 한도에 닿은 것입니다. 시스템 프롬프트에 짧은 답을 요청하세요. 대사도 그편이 더 좋습니다.
- "우리가 했던 말을 잊어버렸어요." 매번 전체 기록을 보내야 합니다. 언어 모델은 요청 사이에 아무것도 기억하지 않습니다.
- "WebGL 빌드로 출시할 수 있나요?" 키가 안에 있으면 안 됩니다. 브라우저의 네트워크 탭에서 누구나 읽을 수 있기 때문입니다. 요청은 여러분의 서버를 거쳐 보내세요.
다음 단계
Neocortex로 유니티에서 더 나아가려면 음성 대화와 스크립트 대사를 위한 음성 합성을 추가해 보세요. 프로토타이핑하는 동안 자기 컴퓨터에서 모델을 돌리고 싶다면 유니티에서 LLM을 로컬로 실행하는 방법을 보세요. 모든 튜토리얼은 AI NPC 만들기 가이드에 있습니다.
2026년 11월 기준 확인. Neocortex는 OpenAI와 제휴 관계가 없습니다.
자주 묻는 질문
유니티에서 NPC에 ChatGPT를 쓸 수 있나요?
네. UnityWebRequest와 캐릭터를 설명하는 시스템 프롬프트로 유니티에서 OpenAI API를 호출할 수 있습니다. 음성, 감정, 행동, 키 한도를 직접 만들지 않고 얻으려면 Neocortex 유니티 SDK로 완전한 캐릭터를 쓸 수 있습니다.
유니티 게임에 OpenAI API 키를 넣어도 안전한가요?
아니요. 빌드 안의 모든 것은 추출될 수 있고, OpenAI 키는 계정의 지출 전체에 접근할 수 있게 합니다. OpenAI를 직접 호출한다면 요청을 여러분의 서버를 거쳐 보내세요. Neocortex 키에는 플레이어별, 캐릭터별 사용 한도를 설정할 수 있으며, 저희 서버가 이를 적용합니다. 대시보드에서 키를 비활성화할 수도 있습니다.
ChatGPT NPC가 캐릭터에서 벗어나지 않게 하려면 어떻게 하나요?
구체적인 시스템 프롬프트를 쓰고, 세계를 설명하고, 캐릭터가 아는 범위를 제한하고, 플레이어가 깨뜨리려 할 때를 가정해 테스트하세요. Neocortex 캐릭터는 세계, 지식 베이스, 행동을 갖춘 에디터에서 만들어지며, 여러분이 묘사한 세계 안에 머뭅니다.
ChatGPT NPC가 말하게 하려면 어떻게 하나요?
플레이어를 위한 음성 인식, 답변을 위한 음성 합성, 그리고 대기 시간을 짧게 유지하는 둘 사이의 스트리밍이 필요합니다. Neocortex 유니티 SDK는 컴포넌트 하나로 이 세 가지를 모두 처리합니다.






