Как заставить NPC говорить с ChatGPT в Unity
Заставьте NPC говорить с ChatGPT в Unity: вызовите API OpenAI через UnityWebRequest, узнайте, что остается на вашей стороне, и добавьте озвученного персонажа быстрым способом.
Sercan AltundasFounder of Neocortex
· 9 мин чтения

«NPC на ChatGPT» - так большинство разработчиков Unity впервые представляют себе AI-персонажа: отправить языковой модели то, что напечатал игрок, и показать ответ над головой NPC. Это руководство строит именно такого NPC через API OpenAI, затем показывает, что он оставляет вам решить, и как тот же NPC выглядит с Unity SDK Neocortex.
Маршрут 1: вызовите API OpenAI сами
Вам нужны ключ API OpenAI и проект Unity. 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?")), и Бранно ответит. Это рабочий прототип примерно в сорок строк.
Что прототип оставляет вам
Первый разговор - самая простая часть. Чтобы выпустить это в игру, нужно решить:
- Ключ. Ключ OpenAI в сборке может извлечь любой, и он тратит весь ваш аккаунт. Между игрой и API нужен собственный сервер.
- Голос. Распознавание речи для игрока, синтез речи для ответа и потоковая передача между ними, иначе каждый ответ ждет, пока завершатся оба. Наше руководство по голосовому конвейеру разбирает это по шагам.
- Эмоции и действия. Ответ - это простой текст. Чтобы управлять анимацией или игровой механикой, вам придется просить JSON, разбирать его и обрабатывать случаи, когда он приходит испорченным.
- История. Список растет с каждой репликой, и вместе с ним растут стоимость и задержка. Нужны обрезка или сводки.
- Удержание роли. Одного системного промпта быстро не хватает, когда игроки давят. См. как удерживать AI NPC в роли.
- Контроль расходов. Ничто не мешает одному игроку говорить весь день за ваш счет.
Маршрут 2: тот же NPC с Neocortex
С Neocortex вы создаете Бранно один раз в браузерном редакторе: с характером, миром, базой знаний, голосом и действиями. Unity SDK берет на себя остальное:
- В Unity добавьте пакет по URL git:
https://github.com/neocortex-link/neocortex-unity-sdk.git - Вставьте свой API-ключ в Tools > Neocortex > Settings.
- Щелкните правой кнопкой по Hierarchy и выберите Neocortex > Complete Voice Chat, затем выберите Бранно в выпадающем списке Smart Agent.
- Нажмите Play и говорите.
Из кода текстовый вопрос с озвученным ответом - это один вызов:
agent.TextToAudio("Got any work?"); // agent is a NeocortexSmartAgentКаждый ответ приходит строками с эмоцией для каждой и действиями с ID объекта, на который они направлены, поэтому анимация и механика подключаются к событиям Unity, а не к разбору текста. Наше пошаговое руководство по AI-персонажу в Unity показывает всю настройку.
Сравнение
| OpenAI API напрямую | Neocortex Unity SDK | |
|---|---|---|
| Первый текстовый ответ | Около 40 строк кода | Без кода |
| Голос на вход и выход | Сделать самому: STT, TTS, потоковая передача | Один компонент, потоковый |
| Эмоция в каждой реплике | Попросить и разобрать | Встроено, 17 эмоций |
| Действия | Попросить JSON и проверять | Заданы в редакторе, отправляются как данные |
| Защита ключа | Свой сервер | Лимиты на игрока и на персонажа для каждого ключа |
| Микрофон в WebGL | Нет в Unity | Включенный шаблон |
| Проектирование персонажа | Системный промпт | Визуальный редактор с тестированием в браузере |
Частые вопросы о варианте «сделать самому»
- «Ответ обрезан». Модель достигла своего лимита на вывод. Попросите в системном промпте короткие ответы, это к тому же и лучший диалог.
- «Она забыла, о чем мы говорили». Нужно отправлять всю историю каждый раз. Языковая модель ничего не помнит между запросами.
- «Можно ли выпустить это как сборку WebGL?» Не с ключом внутри: любой может увидеть его во вкладке сети браузера. Отправляйте запросы через свой сервер.
Следующие шаги
Чтобы пойти дальше с Neocortex в Unity, добавьте голосовой чат и синтез речи для сценарных реплик. Если вы хотите запускать модель на своей машине, пока делаете прототип, см. как запустить LLM локально в Unity. Все руководства собраны в гайде по созданию AI NPC.
Проверено в ноябре 2026 года. Neocortex не связан с OpenAI.
Часто задаваемые вопросы
Можно ли использовать ChatGPT для NPC в Unity?
Да. Вы можете вызывать API OpenAI из Unity через UnityWebRequest с системным промптом, который описывает персонажа. Для голоса, эмоций, действий и лимитов ключа без того, чтобы строить все самому, Neocortex дает готового персонажа через свой Unity SDK.
Безопасно ли класть ключ API OpenAI в игру на Unity?
Нет. Все, что попало в сборку, можно извлечь, а ключ OpenAI дает полный доступ к расходам вашего аккаунта. Если вы вызываете OpenAI напрямую, отправляйте запросы через свой сервер. Ключи Neocortex могут иметь лимиты использования на игрока и на персонажа, которые наши серверы применяют, а ключ можно деактивировать в панели управления.
Как удержать NPC на ChatGPT в роли?
Напишите конкретный системный промпт, опишите мир, ограничьте то, что знает персонаж, и проверьте его на игроках, которые пытаются его сломать. Персонажи Neocortex создаются в редакторе с миром, базой знаний и действиями и остаются внутри описанного вами мира.
Как заставить NPC на ChatGPT говорить?
Вам нужны распознавание речи для игрока, синтез речи для ответа и потоковая передача между ними, чтобы ожидание было коротким. Unity SDK Neocortex делает все три через один компонент.






