Neocortex Logo

Как заставить NPC говорить с ChatGPT в Unity

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

Sercan AltundasFounder of Neocortex

· 9 мин чтения

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

«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 берет на себя остальное:

  1. В Unity добавьте пакет по URL git: https://github.com/neocortex-link/neocortex-unity-sdk.git
  2. Вставьте свой API-ключ в Tools > Neocortex > Settings.
  3. Щелкните правой кнопкой по Hierarchy и выберите Neocortex > Complete Voice Chat, затем выберите Бранно в выпадающем списке Smart Agent.
  4. Нажмите 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 делает все три через один компонент.

Похожие статьи

Читайте также