Bot Libre

一个用于人工智能、自然语言处理、聊天机器人、虚拟助手、社交媒体自动化和在线客服自动化的开源平台。

• https://www.botlibre.org
• https://www.botlibre.com
• https://www.botlibre.biz

组件

• botlibre-web : 一个用于开发和托管适用于网页、移动设备和社交媒体的机器人的Web平台
• ai-engine : 人工智能/自然语言处理引擎，Java库
• ai-engine-test : JUnit测试用例，Java，测试GUI
• sdk : Android、iOS、Web SDK，(Java、Objective-C、JavaScript)

BotLibre 快速上手指南

BotLibre 是一个开源的人工智能平台，支持自然语言处理（NLP）、聊天机器人、虚拟代理、社交媒体自动化及在线聊天自动化。本指南将帮助中国开发者快速搭建并运行 BotLibre 核心组件。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Linux (推荐 Ubuntu/CentOS), macOS, 或 Windows
• JDK：Java Development Kit 8 或更高版本 (推荐 JDK 11+)
  • 验证命令：java -version
• 构建工具：Maven 3.6+ 或 Gradle
  • 验证命令：mvn -v
• 应用服务器：Apache Tomcat 9+ (用于部署 botlibre-web)
• 数据库：PostgreSQL 或 MySQL (用于持久化存储)
• 国内加速建议：
  • 配置 Maven 使用阿里云镜像源以加快依赖下载速度。请在 ~/.m2/settings.xml 中添加：

  <mirrors>
    <mirror>
      <id>aliyunmaven</id>
      <mirrorOf>*</mirrorOf>
      <name>Aliyun Maven</name>
      <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
  </mirrors>
  

安装步骤

以下是获取源码并编译核心 AI 引擎 (ai-engine) 的步骤。若需部署完整 Web 平台，请参考 botlibre-web 模块。

1. 克隆仓库 从 GitHub 获取源代码：

   git clone https://github.com/BotLibre/botlibre.git
   cd botlibre
   

2. 编译 AI 引擎 (ai-engine) 进入引擎目录并使用 Maven 进行构建：

   cd ai-engine
   mvn clean install
   

3. 部署 Web 平台 (可选) 若需运行完整的 Web 界面，需构建 botlibre-web 并部署至 Tomcat：

   cd ../botlibre-web
   mvn clean package
   # 将生成的 war 包复制到 Tomcat webapps 目录
   cp target/botlibre.war $TOMCAT_HOME/webapps/
   

4. 启动服务 启动 Tomcat 服务器：

   $TOMCAT_HOME/bin/startup.sh
   

   访问 http://localhost:8080/botlibre 即可看到平台首页。

基本使用

方式一：通过 Web 界面创建机器人

这是最简单的使用方式，无需编写代码：

1. 访问部署好的 BotLibre 网站或 www.botlibre.org。
2. 注册账号并登录。
3. 点击 "Create" -> "Bot"。
4. 输入机器人名称，选择模板（如 "Basic"），点击 "Create Bot"。
5. 在训练页面直接输入问答对进行训练，或在聊天窗口测试交互。

方式二：通过 Java SDK 调用

如果您已将 ai-engine 集成到项目中，可通过以下代码快速初始化并加载机器人：

import org.botlibre.Bot;
import org.botlibre.api.BasicState;
import org.botlibre.kb.KnowledgeBase;

public class QuickStart {
    public static void main(String[] args) {
        // 初始化机器人实例
        Bot bot = new Bot();
        
        // 加载知识库 (此处仅为示例，实际需加载具体脚本或数据库)
        KnowledgeBase kb = new KnowledgeBase();
        bot.setKnowledgeBase(kb);
        
        // 创建会话状态
        BasicState state = new BasicState();
        
        // 发送消息并获取响应
        String input = "Hello";
        String response = bot.chat(input, state);
        
        System.out.println("Bot: " + response);
    }
}

对于移动端或前端集成，可参考官方提供的 Android (Java), iOS (Objective-C) 或 Web (JavaScript) SDK 文档进行接入。