Keural Kit

Keural Kit menempatkan layar Keural di halaman Anda hanya dengan satu skrip. Layar digambar di dalam Shadow DOM sehingga tidak bercampur dengan CSS halaman Anda. Kit diperbarui saat web Keural dideploy. Jika layar lama masih tampil setelah deployment, hapus cache browser dan CDN, lalu periksa waktu build dengan window.KeuralKit.__build.

MemuatSalin tautan judul

Kit dimuat dari alamat web lingkungan Keural yang Anda gunakan. Jika memakai keural.ai, alamatnya https://keural.ai; untuk lingkungan on-premise atau khusus, gunakan alamat web Keural milik lingkungan tersebut. Sebelum skrip dimuat, atur alamat server yang akan dipanggil Kit di window.__KEURAL_ENV__. Ketiga alamat harus berasal dari lingkungan yang sama, dan diperoleh dari penanggung jawab saat penerapan.

<script>
  window.__KEURAL_ENV__ = {
    NEXT_PUBLIC_API_BASE_URL: '<KEURAL_API_URL>',
    NEXT_PUBLIC_FAST_API_BASE_URL: '<KEURAL_AGENT_URL>',
    NEXT_PUBLIC_MODE: 'prd',
  };
</script>
<script src="<KEURAL_WEB_URL>/plugin/kit/keural.js" async></script>

Jika Kit yang sama juga digunakan di domain kedua, atur ketiga nilai NEXT_PUBLIC_ADDITIONAL_FRONTEND_URL, NEXT_PUBLIC_ADDITIONAL_API_BASE_URL, dan NEXT_PUBLIC_ADDITIONAL_FAST_API_BASE_URL sekaligus. Jika ada yang kurang, akan terjadi error. Nilainya berupa alamat https:// tanpa path.

Setelah skrip dimuat, window.KeuralKit dibuat. Pada SPA seperti React, gunakan loader agar skrip hanya dimuat sekali.

export function loadKeuralKit(src = '<KEURAL_WEB_URL>/plugin/kit/keural.js') {
  if (window.KeuralKit) return Promise.resolve(window.KeuralKit);
  return new Promise((resolve, reject) => {
    const s = document.createElement('script');
    s.src = src;
    s.async = true;
    s.onload = () => resolve(window.KeuralKit);
    s.onerror = () => {
      s.remove();
      reject(new Error('Keural Kit failed to load'));
    };
    document.head.appendChild(s);
  });
}

Memasang chatSalin tautan judul

const el = document.getElementById('keural-chat')!;

window.KeuralKit.mountChat(el, {
  userInfo: { userId: user.id, name: user.name },
  colorMode: 'light',
  initialData: { message: 'Ringkas pendapatan kuartal ini', room_name: 'Laporan kuartal' },
  onSessionCreated: (roomId) => router.push(`/c/${roomId}`),
  onError: () => router.push('/'),
});

// Saat meninggalkan layar
window.KeuralKit.unmount(el);

• Untuk membuka percakapan yang sudah ada, isi ID percakapan di sessionId.
• initialData hanya diisi saat membuka percakapan baru. Jika diisi saat membuka percakapan yang sudah ada, pesan yang sama akan terkirim ulang.
• Jika userInfo.userId tidak ada, pengguna diperlakukan sebagai belum login. Pasang (mount) setelah informasi login siap.

MetodeSalin tautan judul

Metode mount* dan update* menerima colorMode dan userInfo bersamaan, sedangkan unmount(el) hanya menerima elemen. update* menggambar ulang opsi pada elemen yang sama. Saat membuka dan menutup jendela, ubah nilai open lalu panggil update*. Jika mount* dipanggil lagi pada elemen yang sama, layar yang sudah ada akan dipakai ulang.

Opsi mountChatSalin tautan judul

initialDataSalin tautan judul

Bahasa layarSalin tautan judul

Layar Kit ditampilkan dalam bahasa Korea.

Pengaturan dan loginSalin tautan judul

• Pengaturan pengguna diubah di web atau aplikasi Keural, dan layar Kit mengikuti pengaturan tersebut.
• Login ditangani oleh layanan Anda, dan Kit hanya menerima informasi pengguna yang sudah login.