Hexabot

构建流畅的 AI 聊天机器人 / 智能体

Hexabot 为您提供创建和管理自有 AI 驱动聊天机器人/智能体所需的一切功能，支持高度自定义、多渠道、多语言以及文本转行动（Text-to-Action）能力。

扩展库 · 文档

视频教程 · 加入我们的 Discord

简介

Hexabot 是一款开源的 AI 聊天机器人/智能体解决方案，让您可以轻松创建和管理多渠道、多语言的聊天机器人或智能体。Hexabot 专为灵活性和可定制性而设计，提供强大的文本转行动功能。该项目最初是闭源的（第 1 版），现在我们已将第 2 版开源，旨在回馈社区，并使开发者能够通过扩展（extensions）来自定义和扩展平台。

功能特性

• LLM 与 NLU 支持： 集成您喜爱的 LLM 模型，无论是 Ollama、ChatGPT、Mistral 还是 Gemini 等。通过管理机器学习模型的训练数据集，检测用户意图和语言，从而提供智能响应。
• 多渠道支持： 在 Web、移动端和社交媒体平台等多个渠道上创建一致的聊天机器人体验。
• 可视化编辑器： 通过直观的拖放界面设计和管理聊天机器人流程。支持文本消息、快速回复、轮播图等。
• 插件系统： 通过开发并从 扩展库 安装扩展来增强 Hexabot 的功能。启用文本转行动响应、第三方系统集成等功能。
• 多语言支持： 定义多种语言，允许聊天机器人以用户偏好的语言进行交互。
• 知识库： 无缝集成和管理产品目录、店铺列表等动态内容，实现更具互动性的对话。
• 用户角色与权限： 提供精细的访问控制，用于管理系统不同部分的用户角色和权限。
• 上下文数据： 定义变量以收集和利用有关最终用户的相关信息，从而提供个性化的响应。
• 订阅者与标签： 通过分配标签来组织用户，并根据定义的细分市场定制其聊天体验。
• 收件箱与接管： 提供实时聊天窗口，可监控对话并在必要时转交给人工坐席。
• 分析仪表盘： 通过直观的指标和可视化图表监控聊天机器人的交互和表现。

目录结构

• frontend： 使用 React/Next.js 构建的管理面板，用于管理聊天机器人配置和流程。
• api： 后端 API，使用 NestJS 构建，并连接到 MongoDB 进行数据存储和管理。
• widget： 基于 React 的实时聊天组件，可嵌入任何网站以提供实时交互。
• docker： 一套用于部署整个解决方案的 Docker Compose 文件，方便在任何环境中运行 Hexabot。

快速入门

前置要求

• Node.js >= 20.18.1
• npm (Node Package Manager)
• 已安装 Docker

安装

全局安装 Hexabot CLI 以便使用其命令：

npm install -g hexabot-cli

使用方法

1. 创建新项目：

   hexabot create my-chatbot
   

   这将在 my-chatbot 文件夹中创建入门所需的所有必要文件。

2. 进入项目目录：

   cd my-chatbot
   

3. 安装依赖：

   npm install
   

4. 初始化环境：

   hexabot init
   

   此命令会将 .env.example 文件复制为 .env，您可以根据需要编辑该文件以自定义配置。

5. 以开发模式运行：

   hexabot dev --services ollama
   

   这将在开发模式下启动所需的服务。

UI 管理面板可通过 http://localhost:8080 访问，默认凭据为：

• 用户名： admin@admin.admin
• 密码： adminadmin

文档

有关如何入门的详细信息，以及深入的用户和开发者指南，请参阅 docs 文件夹中的完整文档或访问 文档网站。

您还可以在以下位置找到项目不同组件的特定文档：

• CLI 文档
• API 文档
• UI 文档
• 实时聊天组件文档

贡献

我们欢迎社区贡献！无论您是想报告 Bug、建议新功能还是提交 Pull Request，您的反馈对我们都非常宝贵。

请先参考我们的贡献政策：如何向 Hexabot 贡献代码