Neocortex Logo

Cara Menambahkan Karakter AI yang Bisa Bicara ke Situs Anda

Tambahkan karakter AI yang bisa bicara ke situs web mana pun: pasang Neocortex Web SDK, simpan kunci API di server Anda, letakkan elemen chat suara dan tangani aksi.

Sercan AltundasFounder of Neocortex

· 7 menit baca

Tambahkan karakter AI yang bisa bicara ke situs web mana pun: pasang Neocortex Web SDK, simpan kunci API di server Anda, letakkan elemen chat suara dan tangani aksi.

Karakter di situs web adalah pemandu, pembawa acara atau asisten toko yang bisa diajak bicara pengunjung dengan kata-kata mereka sendiri, dengan kepribadian dan suara alih-alih gelembung chat yang generik. Panduan ini menunjukkan cara menambahkannya ke situs mana pun dengan Neocortex Web SDK: beberapa baris di server, satu elemen di halaman, dan aksi opsional yang membuat karakter bisa melakukan sesuatu.

Yang akan Anda bangun

Sebuah karakter di halaman Anda yang:

  • menjawab pertanyaan yang diketik atau diucapkan dengan suaranya sendiri
  • mengetahui konten Anda, dari basis pengetahuan yang Anda unggah
  • bisa menjalankan aksi di halaman, seperti membuka produk atau memulai tur
  • tidak pernah memperlihatkan kunci API Anda ke browser

Yang Anda butuhkan

  • Akun Neocortex, kunci API dan sebuah karakter dari dasbor
  • Server yang menjalankan Node 20 atau lebih baru, atau Cloudflare Workers, Bun atau Deno
  • Halaman yang disajikan lewat HTTPS, karena browser hanya mengizinkan mikrofon di halaman yang aman

Langkah 1: rancang karakter

Di editor Neocortex, berikan karakter kepribadian, suara dan basis pengetahuan dengan halaman produk, FAQ atau catatan tur Anda. Uji di browser sampai terdengar tepat: pengujian di editor sudah termasuk di setiap paket. Salin id karakter dari dasbor.

Langkah 2: pasang SDK

Jalankan npm install @neocortex-link/web di proyek situs Anda.

Langkah 3: tambahkan proxy ke server Anda

Kunci API Neocortex bersifat rahasia. Siapa pun yang membaca kunci dari JavaScript halaman Anda bisa menaikkan pemakaian di akun Anda, jadi SDK menyediakan handler server kecil yang menyimpan kunci tersebut. Handler itu juga memeriksa siapa yang berbicara dan hanya mengizinkan karakter yang Anda daftarkan.

Di aplikasi Next.js, buat app/api/neocortex/[...path]/route.ts:

import { createNeocortexHandler } from "@neocortex-link/web/server";
import { auth } from "@/auth";

const handler = createNeocortexHandler({
  apiKey: process.env.NEOCORTEX_API_KEY!,
  characters: ["your-character-id"],
  authorize: async () => {
    const session = await auth();
    return session?.user ? { id: session.user.id } : null;
  },
});

export { handler as GET, handler as POST, handler as OPTIONS };

authorize mengembalikan pengunjung sebagai { id }, atau null untuk menolak. ID itu menjadi playerId karakter, sehingga setiap pengunjung mendapat percakapannya sendiri. Untuk Express, bungkus handler yang sama dengan toNodeHandler dan pasang di /api/neocortex. Situs tanpa login bisa memberi setiap pengunjung ID tetap di cookie yang ditandatangani.

Langkah 4: letakkan karakter di halaman

Muat UI sekali dengan import "@neocortex-link/web/ui/auto" (atau dari tag skrip CDN jika situs Anda tidak memakai bundler), lalu letakkan elemen di mana pun karakter seharusnya tampil:

<neocortex-chat endpoint="/api/neocortex" character-id="your-character-id" voice></neocortex-chat>

Chat datang dengan kotak teks dan input mikrofon. Atribut voice menambahkan balasan yang diucapkan: setiap baris di-streaming sebagai suara, dan baris berikutnya diambil selagi baris saat ini diputar. Tambahkan push-to-talk jika pengunjung harus menahan tombol saat berbicara, atau mic="false" untuk hanya teks.

Elemennya adalah Web Components standar, sehingga berfungsi di React, Vue, Svelte, Angular atau HTML biasa, dan Anda bisa mengubah gayanya dengan CSS custom properties dalam mode terang atau gelap. Ada juga elemen untuk group chat dengan beberapa karakter (paket Pro dan Team) dan pembawa kuis (paket Team).

Langkah 5: biarkan karakter bertindak

Definisikan aksi di editor, seperti OPEN_PRODUCT atau START_TOUR, lalu tangani di halaman:

const chat = document.querySelector("neocortex-chat");
chat.agent.registerAction("OPEN_PRODUCT", (action) => openProduct(action.targetId));

openProduct adalah fungsi Anda sendiri. Karakter memutuskan kapan sebuah aksi cocok dengan percakapan, dan kode Anda memutuskan apa yang dilakukannya.

Ide untuk karakter situs web

  • Pemandu produk di konfigurator 3D yang menjelaskan pilihan dan mengganti warna saat diminta.
  • Pembawa acara yang menjawab pertanyaan jadwal dan mengarahkan pengunjung ke panggung yang tepat.
  • Karakter museum atau merek yang menceritakan kisah dari arsip Anda dengan suaranya sendiri.
  • Halaman depan game tempat pengunjung bisa bicara dengan karakter game sebelum membeli.

Panduan kasus penggunaan kami membahas lebih dalam panduan belanja AI untuk toko 3D web dan host AI untuk acara virtual.

Masalah umum

  • Mikrofon tidak mulai. Browser membutuhkan HTTPS dan klik atau ketukan sebelum merekam. Uji di domain asli Anda, bukan pratinjau HTTP biasa.
  • 401 atau 403 dari endpoint. authorize mengembalikan null, atau id karakter tidak ada di daftar characters.
  • Kunci berakhir di browser. Jangan pernah meneruskannya ke kode klien. Hanya handler server yang boleh membaca NEOCORTEX_API_KEY.

Langkah selanjutnya

Untuk engine game alih-alih situs web, mulailah dengan cara menambahkan karakter AI ke game Unity Anda. Untuk memahami sisi suaranya, baca cara kerja pipeline suara NPC AI. Setiap tutorial dalam seri ini ada di panduan membangun NPC AI, dan pengaturan lengkapnya ada di dokumentasi Web SDK.

Pertanyaan yang sering diajukan

Bagaimana cara menambahkan karakter AI dengan suara ke situs saya?

Pasang Neocortex Web SDK, tambahkan proxy kecilnya ke server Anda agar kunci API tetap privat, lalu letakkan elemen neocortex-chat di halaman dengan atribut voice. Pengunjung bisa mengetik atau berbicara, dan karakter menjawab dengan suara.

Bisakah saya memasang chatbot AI di situs tanpa memperlihatkan kunci API?

Bisa. Neocortex Web SDK menyertakan handler server yang menyimpan kunci, memeriksa siapa yang berbicara, dan hanya mengizinkan karakter yang Anda daftarkan. Browser hanya berbicara dengan endpoint Anda sendiri.

Apakah ini berfungsi dengan React, Vue atau WordPress?

UI chat dibuat dari Web Components standar, sehingga berfungsi di React, Vue, Svelte, Angular dan HTML biasa. Situs mana pun yang bisa menjalankan endpoint server kecil, seperti Next.js, Express atau Cloudflare Workers, bisa menjadi host untuk proxy-nya.

Apakah Neocortex Web SDK gratis?

SDK ini open source dengan lisensi Apache-2.0. Percakapan dihitung ke paket Neocortex Anda.

Bisakah karakter melakukan sesuatu di halaman?

Bisa. Definisikan aksi untuk karakter di editor Neocortex, lalu daftarkan handler untuk setiap aksi di halaman, misalnya untuk membuka produk, memulai tur, atau menggulir ke bagian tertentu.

Artikel serupa

Baca juga