跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.langbot.app/llms.txt

Use this file to discover all available pages before exploring further.

通过一行脚本标签将 LangBot 聊天组件嵌入到任何网站。

创建机器人

打开 LangBot WebUI,进入机器人 > 创建机器人,填写机器人名称,平台/适配器选择 页面机器人 创建页面机器人

配置项

配置项说明
组件标题显示在聊天组件顶部的标题,默认为 LangBot
气泡图标浮动聊天气泡上显示的图标
组件语言聊天组件的显示语言,支持简体中文、English 等
Turnstile 站点密钥Cloudflare Turnstile 站点密钥,用于防止机器人滥用。留空则不启用
Turnstile 服务端密钥Cloudflare Turnstile 服务端密钥,与站点密钥一起在 Cloudflare 控制台中获取。设置了站点密钥时必填

获取嵌入代码

创建并保存后,在机器人配置页面的嵌入代码区域会自动生成一段 <script> 标签。 嵌入代码 复制此代码并粘贴到你的网站 HTML 中(通常放在 </body> 前),保存后页面右下角将出现聊天气泡,访客即可与机器人对话。
<script data-title="LangBot" src="http://localhost:5300/api/v1/embed/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"></script>
嵌入代码中的 URL 默认为 localhost,如果你的 LangBot 部署在服务器上,请将 localhost:5300 替换为你的实际访问地址。

防滥用(可选)

如果担心接口被滥用,可以在 Cloudflare 控制台中开启 Turnstile:
  1. 前往 Cloudflare Turnstile > 添加站点
  2. 获取站点密钥服务端密钥
  3. 分别填入 LangBot 页面机器人的对应配置项
  4. 保存即可生效

开始使用

嵌入代码添加到网站后,访客点击页面右下角的聊天气泡即可与机器人进行对话。