gptx-chatbot-ui
TypeScript icon, indicating that this package has built-in type declarations

1.2.0 • Public • Published

gptx-chatbot-ui

Use gptx-chatbot-ui to integrate an assistant into third-party pages.

Steps

1.Get sharedKey

Create a chat assistant by:

Assistant -> Publish -> Web page share -> configuration completed -> get sharedKey

2.Install

npm install gptx-chatbot-ui
# or
pnpm add gptx-chatbot-ui

3.Usage

1. Using Vue framework as an example, similar for other frameworks

<template>
  <div class="my-chat">
    <div id="chat-container" style="height: 100%;" />
  </div>
</template>
<script>
/* full */
import { SafeGenChat } from 'gptx-chatbot-ui';
import 'gptx-chatbot-ui/lib/full/style.css';

/* or lite */
// import { SafeGenChat } from 'gptx-chatbot-ui/lib/lite/gptx-chatbot-ui-lite.js';
// import 'gptx-chatbot-ui/lib/lite/style.css';

/* custom icon */
// import askIcon from "@/assets/3.jpg";
// import answerIcon from "@/assets/4.jpg";

/* or public dir */
import askIcon from "/1.jpg";
import answerIcon from "/2.jpg";

export default {
  mounted() {
     // Configuration object for the chat application
    const config = {
      el: '#chat-container', // The DOM element
      chatBaseApi: 'https://api.safegen.ai/v2', // required
      sharedKey: 'your sharedKey', // sharedKey
      locale: 'zh-CN', // 'zh-CN', 'en'(default), 'zh-TW'
      theme: "dark", // 'light'(default), 'dark'
      customIcon: {
        ask: askIcon,
        answer: answerIcon
      }
    };

    // init
    const chatInstance = new SafeGenChat(config);
    console.log(chatInstance); // application instance
  }
};

</script>

<style lang="scss" scoped>
.my-chat {
  height: 800px;
  width: 600px;
  margin: 0 auto;
}
</style>

2. Using js (ESM)

<head>
    <title>demo</title>
    <!-- css -->
    <link rel="stylesheet" href="./style.css">
</head>

<div class="my-chat">
  <div id="chat-container" style="height: 100%;" />
</div>

<script type="module">
  /* full */
  import { SafeGenChat } from './gptx-chatbot-ui.js';

  /* or lite */
  // import { SafeGenChat } from '/gptx-chatbot-ui-lite.js';
  
  // Configuration object for the chat application
  const config = {
    el: '#chat-container', // The DOM element
    chatBaseApi: 'https://api.safegen.ai/v2', // required
    sharedKey: 'your sharedKey', // sharedKey
    locale: 'zh-CN', // 'zh-CN', 'en'(default), 'zh-TW'
    theme: "dark", // 'light'(default), 'dark'
  };

  // init
  const chatInstance = new SafeGenChat(config);
  console.log(chatInstance); // application instance
</script>

<style>
  .my-chat {
    height: 800px;
    width: 800px;
    margin: 0 auto;
  }
  </style>

3. gptx-chatbot-ui VS gptx-chatbot-ui-lite

The only difference between the two is that the lite version does not use highlight.js to highlight the code syntax. If you do not have code syntax output or do not care about the beauty of the code syntax display, it is recommended to use the lite version, which will significantly reduce the size (about 63%).

Config

key type required default desc
el string true none The DOM element where the chat will be mounted
chatBaseApi string true none SafeGen AI(International):https://api.safegen.ai/v2, 千问千答(China):https://chat.dappworks.cn/v2
sharedKey string true none -
locale string false 'en' 'zh-CN', 'en', 'zh-TW'
theme string false 'light' 'light'(default), 'dark'
customIcon.ask string false 'default' Don't use relative paths
customIcon.answer string false 'default' Don't use relative paths

Package Sidebar

Install

npm i gptx-chatbot-ui

Weekly Downloads

6

Version

1.2.0

License

MIT

Unpacked Size

3.04 MB

Total Files

6

Last publish

Collaborators

  • zongpeng