Keural Kit

Keural Kit memasang skrin Keural ke dalam halaman dengan satu skrip. Skrin dilukis dalam Shadow DOM, jadi tidak bercampur dengan CSS halaman. Kit dikemas kini bersama setiap pelancaran web Keural. Jika skrin lama masih kelihatan selepas penerbitan, kosongkan cache pelayar dan CDN, kemudian semak masa binaan dengan window.KeuralKit.__build.

MemuatkanSalin pautan tajuk

Kit dimuatkan daripada alamat web persekitaran Keural yang digunakan. Untuk keural.ai, alamatnya https://keural.ai; untuk persekitaran on-premise atau khusus, gunakan alamat web Keural bagi persekitaran tersebut. Sebelum skrip dimasukkan, tetapkan window.__KEURAL_ENV__ dengan alamat pelayan yang akan dipanggil oleh Kit. Ketiga-tiga alamat mesti tergolong dalam persekitaran yang sama dan diperoleh daripada pegawai hubungan Keural semasa pelaksanaan.

<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 digunakan pada domain kedua, isi ketiga-tiga nilai NEXT_PUBLIC_ADDITIONAL_FRONTEND_URL, NEXT_PUBLIC_ADDITIONAL_API_BASE_URL, dan NEXT_PUBLIC_ADDITIONAL_FAST_API_BASE_URL sekali gus. Jika salah satu tiada, ralat akan berlaku. Nilai ialah alamat https:// tanpa laluan.

Selepas skrip dimuatkan, window.KeuralKit tersedia. Dalam SPA seperti React, gunakan pemuat supaya skrip hanya dimasukkan 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);
  });
}

Pasang sembangSalin pautan tajuk

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

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

// Apabila meninggalkan skrin
window.KeuralKit.unmount(el);

• Untuk membuka perbualan sedia ada, isi ID perbualan dalam sessionId.
• initialData hanya dimasukkan semasa membuka perbualan baharu. Jika dimasukkan semasa membuka semula perbualan sedia ada, mesej yang sama akan dihantar semula.
• Jika userInfo.userId tiada, pengguna dianggap belum log masuk. Pasang (mount) selepas maklumat log masuk sedia.

KaedahSalin pautan tajuk

Kaedah mount* dan update* menerima colorMode dan userInfo bersama-sama, dan unmount(el) hanya menerima elemen. update* melukis semula pilihan pada elemen yang sama. Untuk membuka atau menutup tetingkap, tukar nilai open dan panggil update*. Jika mount* dipanggil semula pada elemen yang sama, skrin sedia ada digunakan semula.

Pilihan mountChatSalin pautan tajuk

initialDataSalin pautan tajuk

Bahasa skrinSalin pautan tajuk

Skrin Kit dipaparkan dalam bahasa Korea.

Tetapan dan log masukSalin pautan tajuk

• Tetapan pengguna ditukar dalam web atau aplikasi Keural. Skrin Kit mengikut tetapan tersebut.
• Log masuk diuruskan oleh perkhidmatan anda, dan Kit hanya menerima maklumat pengguna yang telah log masuk.