Neocortex Logo

Cara Membuat NPC Berbicara dengan ChatGPT di Unity

Buat NPC berbicara dengan ChatGPT di Unity: panggil API OpenAI dengan UnityWebRequest, lihat apa yang masih harus Anda bangun, dan tambahkan karakter bersuara dengan cara yang lebih cepat.

Sercan AltundasFounder of Neocortex

· 9 menit baca

Buat NPC berbicara dengan ChatGPT di Unity: panggil API OpenAI dengan UnityWebRequest, lihat apa yang masih harus Anda bangun, dan tambahkan karakter bersuara dengan cara yang lebih cepat.

"NPC ChatGPT" adalah cara kebanyakan developer Unity pertama kali membayangkan karakter AI: kirim apa yang diketik pemain ke model bahasa, lalu tampilkan jawabannya di atas kepala NPC. Panduan ini membangun persis itu dengan API OpenAI, lalu menunjukkan apa yang masih harus Anda selesaikan dan bagaimana NPC yang sama terlihat dengan Neocortex Unity SDK.

Rute 1: panggil API OpenAI sendiri

Anda memerlukan API key OpenAI dan proyek Unity. NPC menyimpan daftar pesan, dimulai dengan system prompt yang menjelaskan siapa karakter itu, dan mengirim seluruh daftar setiap kali pemain berbicara:

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
    }
}

Ganti MODEL_NAME dengan model terbaru dari dokumentasi OpenAI, panggil StartCoroutine(npc.Ask("Got any work?")), dan Brannoch menjawab. Itu prototipe yang berfungsi dalam sekitar empat puluh baris.

Yang masih harus Anda bangun dari prototipe

Percakapan pertama adalah bagian yang mudah. Untuk merilisnya, Anda harus menyelesaikan:

  • Key. API key OpenAI di dalam build bisa diambil siapa saja dan menghabiskan seluruh akun Anda. Anda memerlukan server sendiri di antara game dan API.
  • Suara. Speech-to-text untuk pemain, text-to-speech untuk balasan, dan streaming di antara keduanya, atau setiap jawaban harus menunggu keduanya selesai. Panduan voice pipeline kami memecahnya langkah demi langkah.
  • Emosi dan aksi. Balasan berupa teks biasa. Untuk menggerakkan animasi atau gameplay, Anda harus meminta JSON, mengurai, dan menangani saat hasilnya rusak.
  • Riwayat. Daftarnya bertambah dengan setiap baris, dan biaya serta jedanya ikut bertambah. Anda memerlukan pemangkasan atau ringkasan.
  • Tetap dalam karakter. System prompt saja cepat rusak ketika pemain menekan. Lihat cara menjaga NPC AI tetap dalam karakter.
  • Kontrol biaya. Tidak ada yang menghentikan satu pemain mengobrol seharian dengan tagihan Anda.

Rute 2: NPC yang sama dengan Neocortex

Dengan Neocortex, Anda merancang Brannoch sekali di editor browser, dengan kepribadian, dunia, basis pengetahuan, suara dan aksi, lalu Unity SDK menangani sisanya:

  1. Di Unity, tambahkan paket dari git URL: https://github.com/neocortex-link/neocortex-unity-sdk.git
  2. Tempelkan API key Anda di Tools > Neocortex > Settings.
  3. Klik kanan Hierarchy dan pilih Neocortex > Complete Voice Chat, lalu pilih Brannoch di dropdown Smart Agent.
  4. Tekan Play dan bicaralah.

Dari kode, pertanyaan teks dengan jawaban yang diucapkan cukup satu panggilan:

agent.TextToAudio("Got any work?"); // agent is a NeocortexSmartAgent

Setiap balasan tiba sebagai baris dengan emosi masing-masing, ditambah aksi apa pun dengan id objek yang dituju, sehingga animasi dan gameplay terhubung ke event Unity alih-alih teks yang diurai. Tutorial karakter AI Unity langkah demi langkah kami menunjukkan seluruh pengaturannya.

Berdampingan

API OpenAI langsungNeocortex Unity SDK
Balasan teks pertamaSekitar 40 baris kodeTanpa kode
Suara masuk dan keluarBangun sendiri: STT, TTS, streamingSatu komponen, di-stream
Emosi per barisMinta dan urai sendiriSudah built in, 17 emosi
AksiMinta JSON dan validasiDidefinisikan di editor, dikirim sebagai data
Perlindungan keyServer Anda sendiriBatas per pemain dan per karakter untuk setiap key
Mikrofon WebGLTidak ada di UnityTemplate tersedia
Desain karakterSebuah system promptEditor visual dengan pengujian di browser

Pertanyaan umum untuk rute buatan sendiri

  • "Balasannya terpotong." Model mencapai batas output. Minta jawaban singkat di system prompt, yang juga merupakan dialog yang lebih baik.
  • "Dia lupa apa yang kita bicarakan." Anda harus mengirim seluruh riwayat setiap kali. Model bahasa tidak mengingat apa pun di antara permintaan.
  • "Bisakah saya merilisnya sebagai build WebGL?" Tidak dengan key di dalamnya: siapa pun bisa membacanya di tab network browser. Kirim permintaan melalui server Anda sendiri.

Langkah selanjutnya

Untuk melangkah lebih jauh dengan Neocortex di Unity, tambahkan voice chat dan text-to-speech untuk baris terskrip. Jika Anda lebih suka menjalankan model di mesin sendiri selama membuat prototipe, lihat cara menjalankan LLM secara lokal di Unity. Semua tutorial ada di panduan membangun NPC AI.

Diperiksa November 2026. Neocortex tidak berafiliasi dengan OpenAI.

Pertanyaan yang sering diajukan

Bisakah saya memakai ChatGPT untuk NPC di Unity?

Bisa. Anda bisa memanggil API OpenAI dari Unity dengan UnityWebRequest dan system prompt yang menjelaskan karakter. Untuk suara, emosi, aksi dan batas key tanpa membangunnya sendiri, Neocortex memberi Anda karakter lengkap melalui Unity SDK-nya.

Apakah aman memasukkan API key OpenAI ke game Unity?

Tidak. Apa pun di dalam build bisa diekstrak, dan key OpenAI memberi akses penuh ke pengeluaran akun Anda. Jika Anda memanggil OpenAI langsung, arahkan permintaan melalui server Anda sendiri. Key Neocortex bisa membawa batas penggunaan per pemain dan per karakter yang ditegakkan server kami, dan Anda bisa menonaktifkan key dari dashboard.

Bagaimana cara menjaga NPC ChatGPT tetap dalam karakter?

Tulis system prompt yang spesifik, jelaskan dunianya, batasi apa yang diketahui karakter, dan uji dengan pemain yang berusaha merusaknya. Karakter Neocortex dibangun di editor dengan dunia, basis pengetahuan dan aksi, dan tetap berada di dalam dunia yang Anda jelaskan.

Bagaimana cara membuat NPC ChatGPT berbicara?

Anda memerlukan speech-to-text untuk pemain, text-to-speech untuk balasan, dan streaming di antara keduanya agar waktu tunggunya tetap singkat. Neocortex Unity SDK melakukan ketiganya dari satu komponen.

Artikel serupa

Baca juga