@chatopera/sdk

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

Chatopera

---

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

安装

---

npm install @chatopera/sdk --save

使用文档

快速开始，类接口定义和实例化文档等，参考 文档中心：

https://docs.chatopera.com/products/chatbot-platform/integration.html

命令行工具

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

获得帮助

打印可用命令。

bot --help

连接聊天机器人

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

Usage: connect [options]

Options:
  -c, --clientid <value>      ClientId of the bot, *required.
  -u, --username <value>      Username to chat with bot, *required.
  -s, --clientsecret [value]  Client Secret of the bot, optional, default null
  -p, --provider [value]      Chatopera Superbrain Instance URL, optional, default https://bot.chatopera.com
  -h, --help                  output usage information

其中，clientid和clientsecret从每个机器人的设置页面获取，username代表用户名，是一个不含空格或特殊符号的字符串，每个用户的唯一标识，provider是Chatopera 机器人平台地址，默认为 Chatopera 云服务。

示例：

bot connect -c xxx -s xxx -u zhangsan

在对话中，可以使用快捷方式，快速输入。

快捷方式	Mac OSX / Windows
回溯历史	↑ 上箭头；↓ 下箭头
打印历史	Shift + → 右箭头
使用索引输入历史，索引根据打印历史获得	输入索引，然后 Ctrl + Shift + Shift + → 右箭头

上传多轮对话脚本

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

Usage: deploy [options]

Options:
  -c, --clientid <value>      ClientId of the bot, *required.
  -b, --botarchive <value>    Conversation Bundle, *required.
  -s, --clientsecret [value]  Client Secret of the bot, optional, default null.
  -p, --provider [value]      Chatopera Superbrain Instance URL, optional, default https://bot.chatopera.com
  -h, --help                  output usage information

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

标准目录结构:

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是函数，参考说明文档。

打印聊天机器人日志

方便调试多轮对话脚本，实时跟踪服务器端日志，排查问题。

Usage: bot trace [options]

Options:
  -c, --clientid <value>      ClientId of the bot, *required.
  -s, --clientsecret [value]  Client Secret of the bot, optional, default null
  -p, --provider [value]      Chatopera Bot Service URL, optional, default https://bot.chatopera.com
  -l, --log-level [value]     Log level to follow, optional, [DEBUG|INFO|WARN|ERROR], default DEBUG
  -h, --help                  display help for command

Contribute

打印调试日志

export DEBUG=chatopera*
cp sample.env .env # edit .env
npm run test

license

Apache 2.0

Copyright 2018-2020, 北京华夏春松科技有限公司. 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.