Neocortex Logo

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 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ą.

„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ą:

  1. W Unity dodaj pakiet z adresu git: https://github.com/neocortex-link/neocortex-unity-sdk.git
  2. Wklej swój klucz API w Tools > Neocortex > Settings.
  3. Kliknij prawym w Hierarchy i wybierz Neocortex > Complete Voice Chat, a potem wskaż Brannocha w liście rozwijanej Smart Agent.
  4. 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 NeocortexSmartAgent

Każ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średnioSDK Neocortex dla Unity
Pierwsza odpowiedź tekstowaOkoło 40 linii koduBez kodu
Głos na wejściu i wyjściuDo zbudowania: STT, TTS, streamingJeden komponent, w strumieniu
Emocja w każdej liniiProsisz o nią i parsujeszWbudowane, 17 emocji
AkcjeProsisz o JSON i walidujeszZdefiniowane w edytorze, wysyłane jako dane
Ochrona kluczaTwój własny serwerLimity na gracza i na postać dla każdego klucza
Mikrofon w WebGLNie w UnityGotowy szablon
Projekt postaciPrompt systemowyWizualny 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.

Podobne artykuły

Czytaj dalej