lemurengine/lemurbot

一个为 Laravel 框架编写的 AIML 聊天机器人和管理门户

安装: 349

依赖: 1

建议者: 0

安全: 0

星标: 7

关注者: 0

分支: 0

开放问题: 1

类型:项目

9.1.0 2023-06-16 16:00 UTC

This package is auto-updated.

Last update: 2024-09-18 10:28:05 UTC


README

lemurengine/lemurbot

一个为 Laravel 框架编写的 AIML 聊天机器人。将机器人添加到您的网站,并从门户管理它。

演示

http://lemurengine.com

文档

http://docs.lemurengine.com

屏幕截图

前端动画小部件

前端弹出小部件

管理仪表板

管理门户聊天

管理机器人属性

管理链接机器人知识

管理创建机器人知识

管理机器人统计

版本控制

此包是为 Laravel 9.x 构建的
兼容的 Laravel 版本反映在 LemurBot 版本中。
LemurBot 9.x 版本与 Laravel 9.x 版本兼容

先决条件

此版本是为 PHP8.0 开发的

TL/DR 新安装步骤

如果您不想阅读实际命令执行的内容,只想运行它们,请看以下内容。仅在这些命令在 Laravel 的新安装上使用。

php artisan vendor:publish --tag=lemurbot-template --force
php artisan vendor:publish --tag=lemurbot-auth --force
php artisan vendor:publish --tag=lemurbot-assets
php artisan vendor:publish --tag=lemurbot-widgets
php artisan vendor:publish --tag=lemurbot-config
php artisan vendor:publish --tag=datatables
php artisan vendor:publish --tag=datatables-buttons
php artisan vendor:publish --tag=datatables-html
php artisan vendor:publish --tag=datatables-fractal
php artisan vendor:publish --tag=lemurbot-examples
php artisan vendor:publish --tag=lemurbot-migrations
php artisan migrate
php artisan storage:link
php artisan lemur:install-all --admin=admin@lemurengine.local --bot=mybot --data=max

完整新安装步骤

LemurEngine LemurBots 是为 Laravel 框架编写的。
第一步是安装和设置您的 Laravel 版本。
有关如何安装 Laravel 的更多信息,请参阅:https://laravel.net.cn/docs/9.x/installation 使用 --with-all-dependencies 标志来更新第一次运行时可能冲突的任何包

使用 composer 安装 Lemur Engine

composer require lemurengine/lemurbot dev-develop --with-all-dependencies

发布模板(推荐)

这将创建门户的默认布局。
如果您正在将 Lemur Engine 安装到新的应用程序中,请运行此命令。
如果您已经有布局,则可能希望跳过此步骤
因为它将覆盖您现有的 layouts/app.blade.php、auth 模板和主页

php artisan vendor:publish --tag=lemurbot-template --force

发布认证模板/控制器(推荐)

这将创建门户的定制认证布局。
如果您正在将 Lemur Engine 安装到新的应用程序中,请运行此命令。
如果您已经创建了您的认证布局/控制器,则可能希望跳过此步骤
因为它将覆盖您现有的 resources/views/auth 和 app/Http/Controllers/Auth

php artisan vendor:publish --tag=lemurbot-auth --force

发布公共资产(必需)

这将复制所需的资产文件到您的公共文件夹
这是使表单和验证功能正确工作的必需品

php artisan vendor:publish --tag=lemurbot-assets

发布公共小部件(必需)

这将复制小部件到公共小部件文件夹 \

php artisan vendor:publish --tag=lemurbot-widgets

发布配置(必需)

这将复制 lemur 机器人配置文件到 config/lemurbot

  • config/lemurbot/lemur.php
  • config/lemurbot/properties.php
php artisan vendor:publish --tag=lemurbot-config

发布数据表配置和资产(必需)

此应用程序使用 Yajra datatables 插件。
https://yajrabox.com/docs/laravel-datatables
如果您需要发布配置,请使用以下命令

php artisan vendor:publish --tag=datatables
php artisan vendor:publish --tag=datatables-buttons
php artisan vendor:publish --tag=datatables-html
php artisan vendor:publish --tag=datatables-fractal

发布示例标签和插件(可选)

这将复制 HelloWorldTag 和 EchoTag 示例到 App\LemurTag 文件夹
并将示例 MaintainMode 和 ShoutBack 复制到 App\LemurPlugin 文件夹 \

php artisan vendor:publish --tag=lemurbot-examples

发布数据库迁移(可选)

这将复制 lemur 机器人迁移文件到数据库/migration/lemurbot
您真的不需要这样做。
但如果您想,您可以这样做。

php artisan vendor:publish --tag=lemurbot-migrations

运行数据库迁移(必需)

以下命令将创建或更新您现有的数据库表架构。

php artisan migrate

符号链接公共文件夹(必需)

以下命令将创建或更新您现有的数据库表架构。

php artisan storage:link

运行命令以安装用户、机器人和 AIML 数据

如果您正在迁移或已经拥有这些数据,可能不需要运行此操作(有关迁移的信息,请参阅页面顶部的相关部分)。

php artisan lemur:install-all --admin=[admin_email] --bot=[bot_name] --data=[none|min|max]

示例

php artisan lemur:install-all --admin=admin@lemurengine.local --bot=mybot --data=max

- admin_email 是您登录时使用的电子邮件地址。您的密码将是 'password',您应立即更改密码。

- bot_name 是您将要创建的机器人的名称。

- data 选择 none|min|all。这将指示安装程序安装以下内容:

  • none - 无数据
  • min - 4 个数据集(测试、你好、关键和评分)
  • max - 所有可用的数据集

您不必现在安装用户或机器人,您可以在稍后进行这些操作,但我们建议您现在完成这些操作。
如果您的用户已经存在,它将被赋予机器人管理员权限,并与您的机器人相关联。

启动应用程序

您现在可以启动应用程序,并使用上面输入的用户名和密码 'password' 登录。
别忘了更改您的密码。

php artisan serve

使用

在这里与您的机器人交谈:http://127.0.0.1:8000

在此处登录以管理您的机器人:http://127.0.0.1:8000/login

从 theramenrobotdiscocode/lemur-engine 迁移

此库的原始版本作为一个包含 Laravel 7 检入版本的完整应用程序发布。
将您的原始版本的 theramenrobotdiscocode/lemur-engine 迁移到这个版本非常简单。
没有数据库模式更改,只有一些小的数据更改和文件位置更改。
我们建议您安装一个新的 Laravel 9 版本,并将其配置为连接到您现有的数据库。
您仍需要遵循以下的新安装说明。
并且还需要执行“附加升级步骤”。

附加升级步骤:自定义标签

只有当您从旧项目迁移时才执行此操作
将您创建的任何自定义标签移动到主应用程序文件夹中名为 LemurTag 的文件夹中。

app/
├── LemurTag/
│ ├── YourTag.php
│ ├── HelloWorldTag.php
└── Models/

您需要将自定义标签的命名空间更改为 namespace App\LemurTag;
请参考 HelloWorldTag 以获取示例

附加升级步骤:运行命令以更新迁移文件夹中的几个文件名

只有当您从旧项目迁移时才执行此操作
迁移表中需要回滚到原始 Laravel 迁移文件名的 4 个文件名。
在执行下一步之前,运行此命令以更新迁移表中的 4 个文件名

php artisan lemur:upgrade 9.0.0

附加升级步骤:运行命令以更新用户为管理员用户

只有当您从旧项目迁移时才执行此操作
如果您有现有数据并想给予用户 bot_admin 权限,可以运行此命令。

php artisan lemur:install-admin --admin=[admin_email]

更多信息

查看文档以获取有关如何使用门户以及如何与机器人交谈的更多信息。

http://docs.lemurengine.com

http://lemurengine.com