Jak sprawić, by NPC w Unity mówiły z ChatGPT
NPC mówiące z ChatGPT w Unity: wywołaj API OpenAI przez UnityWebRequest, zobacz, co zostaje do zbudowania, i dodaj postać z głosem szybszą drogą.
Sercan AltundasFounder of Neocortex
· 9 min czytania

„NPC z ChatGPT” to sposób, w jaki większość deweloperów Unity po raz pierwszy wyobraża sobie postać AI: wysyłasz to, co wpisał gracz, do modelu językowego i pokazujesz odpowiedź nad głową NPC. Ten przewodnik buduje dokładnie to z API OpenAI, a potem pokazuje, co zostaje do rozwiązania i jak ten sam NPC wygląda z SDK Neocortex dla Unity.
Wariant 1: wywołaj API OpenAI samodzielnie
Potrzebujesz klucza API OpenAI i projektu Unity. NPC trzyma listę wiadomości, zaczynając od prompta systemowego, który mówi, kim jest postać, i wysyła całą listę za każdym razem, gdy gracz mówi:
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
}
}Zamień MODEL_NAME na aktualny model z dokumentacji OpenAI, wywołaj StartCoroutine(npc.Ask("Got any work?")), a Brannoch odpowie. To działający prototyp na jakieś czterdzieści linii.
Co prototyp zostawia do zbudowania
Pierwsza rozmowa to łatwa część. Wypuszczenie tego do gry wymaga rozwiązania:
- Klucz. Klucz OpenAI w buildzie może wyciągnąć każdy i wydać całe konto. Między grą a API potrzebujesz własnego serwera.
- Głos. Zamiana mowy na tekst dla gracza, zamiana tekstu na mowę dla odpowiedzi i streaming między nimi, bo inaczej każda odpowiedź czeka, aż oba kroki się skończą. Nasz przewodnik po potoku głosowym rozbija to na części.
- Emocje i akcje. Odpowiedź to zwykły tekst. Żeby sterować animacją lub rozgrywką, musisz prosić o JSON, parsować go i obsługiwać przypadki, gdy wróci zepsuty.
- Historia. Lista rośnie z każdą linią, a wraz z nią rosną koszt i opóźnienie. Potrzebne jest przycinanie lub podsumowania.
- Trzymanie się roli. Sam prompt systemowy szybko pęka, gdy gracze naciskają. Zobacz jak utrzymać NPC AI w roli.
- Kontrola kosztów. Nic nie powstrzyma jednego gracza przed gadaniem cały dzień na twój rachunek.
Wariant 2: ten sam NPC z Neocortex
Z Neocortex projektujesz Brannocha raz w edytorze przeglądarkowym, z osobowością, światem, bazą wiedzy, głosem i akcjami, a SDK Unity zajmuje się resztą:
- W Unity dodaj pakiet z adresu git:
https://github.com/neocortex-link/neocortex-unity-sdk.git - Wklej swój klucz API w Tools > Neocortex > Settings.
- Kliknij prawym w Hierarchy i wybierz Neocortex > Complete Voice Chat, a potem wskaż Brannocha w liście rozwijanej Smart Agent.
- Naciśnij Play i rozmawiaj.
Z poziomu kodu pytanie tekstowe z odpowiedzią mówioną to jedno wywołanie:
agent.TextToAudio("Got any work?"); // agent is a NeocortexSmartAgentKażda odpowiedź przychodzi jako linie, z emocją przy każdej, plus akcje z ID obiektu, którego dotyczą. Animacja i rozgrywka podpinają się więc pod zdarzenia Unity, zamiast pod sparsowany tekst. Nasz krok po kroku samouczek postaci AI w Unity pokazuje całą konfigurację.
Zestawienie
| OpenAI API bezpośrednio | SDK Neocortex dla Unity | |
|---|---|---|
| Pierwsza odpowiedź tekstowa | Około 40 linii kodu | Bez kodu |
| Głos na wejściu i wyjściu | Do zbudowania: STT, TTS, streaming | Jeden komponent, w strumieniu |
| Emocja w każdej linii | Prosisz o nią i parsujesz | Wbudowane, 17 emocji |
| Akcje | Prosisz o JSON i walidujesz | Zdefiniowane w edytorze, wysyłane jako dane |
| Ochrona klucza | Twój własny serwer | Limity na gracza i na postać dla każdego klucza |
| Mikrofon w WebGL | Nie w Unity | Gotowy szablon |
| Projekt postaci | Prompt systemowy | Wizualny edytor z testami w przeglądarce |
Częste pytania przy podejściu zrób-sam
- „Odpowiedź jest ucięta.” Model osiągnął limit wyjścia. Poproś w prompcie systemowym o krótkie odpowiedzi, co i tak daje lepszy dialog.
- „Zapomniał, o czym rozmawialiśmy.” Musisz wysyłać całą historię za każdym razem. Model językowy niczego nie pamięta między żądaniami.
- „Czy mogę wydać to jako build WebGL?” Nie z kluczem w środku: każdy może go odczytać w karcie sieci przeglądarki. Wysyłaj żądania przez własny serwer.
Następne kroki
Żeby pójść dalej z Neocortex w Unity, dodaj czat głosowy i zamianę tekstu na mowę dla zaskryptowanych kwestii. Jeśli wolisz uruchamiać model na własnym komputerze podczas prototypowania, zobacz jak uruchomić LLM lokalnie w Unity. Każdy samouczek znajdziesz w przewodniku po budowaniu NPC AI.
Sprawdzone w listopadzie 2026. Neocortex nie jest powiązany z OpenAI.
Najczęściej zadawane pytania
Czy mogę użyć ChatGPT do NPC w Unity?
Tak. Z Unity możesz wywołać API OpenAI przez UnityWebRequest z promptem systemowym opisującym postać. Jeśli chcesz głosu, emocji, akcji i ochrony klucza bez budowania tego samemu, Neocortex daje gotową postać przez swój SDK Unity.
Czy bezpiecznie jest umieścić klucz API OpenAI w grze Unity?
Nie. Wszystko, co jest w buildzie, da się wyciągnąć, a klucz OpenAI daje pełny dostęp do wydatków na twoim koncie. Jeśli wywołujesz OpenAI bezpośrednio, kieruj żądania przez własny serwer. Klucze Neocortex mogą mieć limity zużycia na gracza i na postać, które egzekwują nasze serwery, a klucz możesz dezaktywować z panelu.
Jak utrzymać NPC z ChatGPT w roli?
Napisz konkretny prompt systemowy, opisz świat, ogranicz to, co postać wie, i testuj go na graczach, którzy próbują go złamać. Postacie Neocortex są budowane w edytorze z światem, bazą wiedzy i akcjami i trzymają się świata, który opisujesz.
Jak sprawić, by NPC z ChatGPT mówił?
Potrzebujesz zamiany mowy na tekst dla gracza, zamiany tekstu na mowę dla odpowiedzi i streamingu między nimi, żeby czekanie było krótkie. SDK Neocortex dla Unity robi wszystkie trzy rzeczy jednym komponentem.






