@chatopera/sdk

Chatopera开发者平台：809987971， 点击链接加入群聊

Chatopera

---

Chatopera提供聊天机器人开发者平台，Chatopera SDK用于在Node.js应用中集成聊天机器人服务。

安装

---

npm install @chatopera/sdk --save

SDK 使用方法

var Chatbot = require("@chatopera/sdk");

var chatbot = new Chatbot(*ClientId*, *Secret*);

提示: 对于私有部署，按如下方法使用：

export SUPERBRAIN_PROXY_URL=http://YOUR_IP:YOUR_PORT
bot CHATBOT_ID # 此处不再需要Secret, CHATBOT_ID为创建时输入

获取ClientId和Secret

请点击这里。

• 创建聊天机器人

登录Chatopera控制台后，创建聊天机器人。

• 获得认证信息

在【设置】页面，获得ClientId和Secret。

快速开始

通过示例程序快速开始使用SDK。

API接口

请先完成注册 Chatopera并创建一个聊天机器人。

说明：

1. 除创建机器人实例外，接口调用都是基于 async/await 方式。
2. 在非正常返回情况下，接口会抛出异常 Error(msg)。
3. 下面各接口的返回值，按正常情况下介绍。

获得聊天机器人实例

var Chatbot = require("@chatopera/sdk");
var chatbot = new Chatbot(*ClientId*, *Secret*);

获得聊天机器人详情

var detail = await chatbot.detail();

返回值

{
  "name": "bar",
  "fallback": "我不明白您的意思。",
  "description": "",
  "welcome": "你好！我是机器人客服。",
  "primaryLanguage": "zh_CN"
}

进行多轮对话

var reply = await chatbot.conversation("张三", "今天北京天气怎么样");

返回值

{
  "state": "default",
  "createdAt": 1540796868205,
  "string": "白天天气晴好，早晚会感觉偏凉，午后舒适、宜人。",
  "topicName": "weather",
  "subReplies": [],
  "service": {
    "provider": "conversation"
  },
  "logic_is_fallback": false,
  "botName": "bar"
}

说明：多轮对话的返回值的含义参考文档中心。

进行FAQ对话

var reply = await chatbot.faq("张三", "停效期间的保单是否能办理减保");

返回值

[
  {
    "id": "AWa-Ogcaf3EIFA_CgZ3o",
    "score": 0.747,
    "post": " 停效期间的保单是否能办理减保？",
    "reply": " 停效期间的保单可以办理减保"
  },
  ...
]

说明：返回值为数组，id代表问答对ID，score是相似度分数，reply是回复。在含有多个元素时按score降序排列，score的分数在[0,1]之间，越接近1越相似。

查看用户列表

let users = await chatbot.users();

返回值

[
  {
    "userId": "张三",
    "lasttime": "2018-10-29T07:07:47.812Z",
    "created": "2018-10-29T05:02:13.084Z"
  },
  ...
]

说明: 按最后对话时间将序排列。

查看用户聊天历史

let chats = await chatbot.chats("张三");

返回值

[
  {
    "userId": "张三",
    "created": "2018-10-29T05:29:41.833Z",
    "textMessage": "白天天气晴好，早晚会感觉偏凉，午后舒适、宜人。",
    "direction": "outbound",
    "service": "conversation",
    "confidence": 1
  }
]

说明：按照每条消息的生成时间升序排列。

屏蔽用户

以该用户ID发送给聊天机器人信息时，将不能得到回复，此时回复内容参考文档。

await chatbot.mute("张三");

返回值为空

取消屏蔽

将一个用户取消屏蔽。

await chatbot.ummute("张三");

返回值为空

查看用户是否被屏蔽

查看一个用户是否被这个机器人屏蔽了。

let result = await chatbot.ismute("张三"); 

返回值为Boolean

[true|false]

关于各接口返回值的更多描述参考开发者平台文档。

CLI 使用方法

Chatopera Node.js SDK包括一些常用的命令，辅助开发者实现对话机器人。

connect

在命令行终端连接Bot并进行对话。

bot connect <ClientID> <userName> [secret]

其中，ClientID和secret来自于平台，在独立使用智能问答引擎时，可以省略secret。userName代表用户名，是一个不含空格或特殊符号的字符串，每个用户的唯一标识。

deploy

在命令行终端发布botarchive文件到多轮对话中。

bot deploy <ClientID> <botarchive> [secret]

其中botarchive为机器人的文件目录，支持相对路径或绝对路径。

标准目录结构:

botarchive
├── index.json
├── plugin.js
└── zh_CN.greeting.ms

其中，index.json描述机器人多轮对话属性：

{
    "name": "大白",
    "primaryLanguage": "zh_CN",
    "version": "0.5.0",
    "conversations": [
        {
            "name": "greeting",
            "enabled": true
        }
    ],
    "config": // 环境变量Key-Value
    {
    }
}

plugin.js是函数，参考说明文档。

运行示例:

bot deploy test1 app secret1

获得帮助

bot --help

Contribute

打印调试日志

export DEBUG=chatopera*

license

Apache 2.0

Copyright 2017-2018, 北京华夏春松科技有限公司. All rights reserved. This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.