Giter Site home page Giter Site logo

jiabing3 / chatbot-samples Goto Github PK

View Code? Open in Web Editor NEW

This project forked from chatopera/chatbot-samples

0.0 0.0 0.0 3.59 MB

🤖 聊天机器人,对话模板

Home Page: https://bot.chatopera.com/

License: Other

Shell 38.78% JavaScript 41.78% MAXScript 19.44%

chatbot-samples's Introduction

Chatopera 对话模板

本源码库提供多个 对话模板 项目。

基于这些源码程序,您可以:

  • 快速掌握 Chatopera 对话机器人开发,实现智能问答,智能客服等应用; 以对话模板为脚手架,学习最佳实践,开发多轮对话;

  • 快速掌握 Chatopera 机器人的系统集成。

开始阅读前,请完成:

提示:Chatopera 云服务是 Chatopera 机器人平台的公有云;如果您使用私有部署的 Chatopera 机器人平台,请用部署后的服务地址。

快速开始

使用 Chatopera 对话模板定制聊天机器人的流程如下:

  • 注册 Chatopera 云服务:https://bot.chatopera.com

  • 下载安装多轮对话设计器

  • 在 Chatopera 云服务上创建机器人

  • 在多轮对话设计器上添加机器人

  • 针对任意模板

    • 下载机器人知识库导入文件 faq.json
    • 下载机器人多轮对话 c66 文件
    • 导入知识库 faq.json
    • 导入多轮对话 c66
  • 在 Chatopera 云服务上测试和体验

  • 使用 多轮对话设计器 更新、调试多轮对话

关于 faq.json 和 多轮对话 c66 文件参考下文更多介绍。

模板目录

程序 语言 位置 功能
GuessNumber en_US projects/GuessNumber 小游戏, Guess the secret number in the bot's hat.
天气查询 zh_CN projects/天气查询 实现一个能回答天气情况的聊天机器人
活动通知 zh_CN projects/活动通知 实现一个能通知用户展会活动的聊天机器人
招聘面试 zh_CN projects/招聘面试 进行工作面试:提问技能知识、评估性格和心理素质,发送邮件报告面试过程。
小笑话 zh_CN projects/小笑话 发送“笑话”,机器人返回一个笑话,逗您一乐。
闲聊 zh_CN projects/闲聊 闲聊,寒暄,6,000+ 条对话语料,修改 faq.json 追加。

查看所有模板

对话模板目录结构

.
├── README.md                      # 模板描述文件
├── botarchive                     # 多轮对话 nodejs 项目
│   ├── index.json                 # 项目描述
│   ├── plugin.js                  # 函数
│   ├── zh_CN.chatopera.ms         # 话题脚本 1
│   ├── zh_CN.profile.ms           # 话题脚本 2
│   └── zh_CN.weather.ms           # 话题脚本 N
├── package.json                   # 基于Node.js开发时的环境依赖描述
├── faq.pairs.json                 # 知识库导入文件,包含问答对、扩展问等
├── flow.mdj                       # UML对话流程文件,描述对话流程
├── flow.xlsx                      # Excel话术文件,描述对话流程
├── releases                       # 版本目录
│   └── *.c66                      # 对话应用发布包,c66 文件
├── sample.env                     # 基于Node.js开发时的机器人远程调试配置信息
└── scripts                        #    基于Node.js开发时的工具脚本
    ├── archive.sh                 #    打包,将 botarchive 制作为 c66 发布包
    ├── bot                        #    bot命令行工具 wrapper
    ├── chat.sh                    #    和机器人连接,测试对话
    ├── deploy.sh                  #    将 botarchive 内容更新到远程机器人
    ├── install.sh                 #    安装依赖,需要先执行,其它脚本才能使用
    └── trace.sh                   #    实时打印机器人的日志

提示:botarchive 文件夹 <- 解压 - zip - 压缩 -> c66 文件。

有两个主要用途:体验 Chatopera 机器人定制化开发机器人

体验机器人服务
体验对话模板机器人的效果 参考文档
定制化开发机器人
基于 多轮对话设计器 开发 (推荐) 参考文档
基于 Node.js 开发 参考文档

在定制化开发环节,支持两种开发方法:1)使用 多轮对话设计器;2)基于 Node.js 环境开发。

两种方法支持的功能是一致的,基于多轮对话设计器更被官方推荐。虽然 基于 Node.js 环境开发 对程序员更友好,但是将来会以 多轮对话设计器 更新为主。

系统集成

API - 检索多轮对话。

快速开始

以 Node.js SDK 为例。

npm install @chatopera/sdk

开始聊天。

const Chatbot = require("@chatopera/sdk").Chatbot;
const bot = new Chatbot(clientid, clientsecret, provider);

# 请求多轮对话接口

let response = await bot.command("POST", "/conversation/query", {
    fromUserId: username,
    textMessage: answers.send,
    faqBestReplyThreshold: faqBest,
    faqSuggReplyThreshold: faqSugg,
})

# faqBest, faqSugg 分别为 FAQ 知识库最佳建议恢复阈值和建议回复阈值,取值为 (0,1),并且 faqBest > faqSugg

系统集成详情打开详细文档链接,了解其它语言 SDK 和更多 API 接口介绍。

建模工具

在实现聊天机器人前,尤其是多轮对话,完成一个任务,要先考虑好它的对话流程。然后再根据 Chatopera 机器人平台 提供的知识库、多轮对话和意图识别模块进行实现。

在对话模板中,我们提供两种类型的,完成建模任务的方案。

Excel

查看使用 Excel 形式描述的话术建模文件,在对话模板项目中打开 flow.xlsx

比如,活动通知话术模版 Excel 文件

UML 流程图

对话模板中,有的带有[对话流程的建模项目],即以".mdj"结尾的文件,通常被命名为 flow.mdj,使用 StarUML 可以打开项目。

比如,一个对话流程图示例:活动通知

对话流程借鉴 UML Activity Diagram 建模,入门参考文档,内附元素定义、StarUML 软件下载等。

添加新机器人并初始化

./admin/init.sh BOT_NAME # 在 projects 目录下添加一个 zh_CN 机器人

Chatopera 机器人平台使用指南

本系列视频帮助您在 Chatopera 机器人平台上开发聊天机器人,通过自然语言交互的形式,定制开发聊天机器人,提升业务流程自动化。Chatopera 机器人平台包括知识库、多轮对话、意图识别和语音识别等组件,标准化聊天机器人开发,支持企业 OA 智能问答、HR 智能问答、智能客服和网络营销等场景。

上线聊天机器人!

技术支持

反馈

其它

LICENSE

Apache 2.0

chatoper banner

chatbot-samples's People

Contributors

hailiang-wang avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.