摘要： 笨笨 聊天机器人 API 接口 现已通过 CTP平台 对外开放，供开发者免费调用。接口目前支持 HTTP 调用，包括闲聊、天气咨询等各种聊天技能，欢迎体验。
如有任何使用问题或者建议可联系： [email protected] 。
更多使用说明可参考：https://hitscir-dt-code.github.io/Benben-API/
笨笨是由 哈工大SCIR实验室 研发的一款面向普通用户的聊天机器人，具备开放域对话、知识问答、任务型对话以及对话式推荐等功能。
2016年6月6日正式对外发布，搭载于微信公众号平台之上，截至2021年10月7日，关注人数达到6569，累计百万级人机对话数据。2019年4月笨笨的开放域对话功能上线到科大讯飞AIUI平台，对外提供服务，上线至今，平均每月调用6千万次。
笨笨对话系统及其相关应用曾获“合创杯”第二届全国青年人工智能创新创业大会三等奖、中国人工智能学会最佳青年技术成果奖、吴文俊人工智能科技进步奖二等奖，相关研究成果发表在ACL等国际顶级会议。
欢迎扫描二维码关注“笨笨”微信公众号。
笨笨机器人相关接口目前可通过以下代码示例请求。
import requests
data = {
"bot_id": "9c5a7e90-14bb-49da-819f-300cc4cef827",
"api_key": "e6bc4917-2ce6-440b-b8e3-0b49569ad069",
"user_id": "user-001",
"session_id": "session-007",
"message": "你好",
"msg_type": "text"
}
response = requests.post(url="http://120.25.81.83:16999/ctp/chat/api", json=data)
print(response.json())上述命令返回的 JSON 数据格式如下
{
"bot_id": "9c5a7e90-14bb-49da-819f-300cc4cef827",
"user_id": "user-001",
"session_id": "session-007",
"msg_type": "text",
"reply": "你好，来个拥抱吧！"
}请求参数说明
| 参数 | 说明 | 示例 |
|---|---|---|
| bot_id | 机器人ID 提供公用机器人 |
9c5a7e90-14bb-49da-819f-300cc4cef827 |
| api_key | API 秘钥 提供公用秘钥 |
e6bc4917-2ce6-440b-b8e3-0b49569ad069 |
| user_id | 当前聊天用户ID 根据情况初始化或者赋值 |
user-001 |
| session_id | 当前聊天会话ID 根据情况初始化或者赋值 |
session-007 |
| message | 当前请求的消息 | 你好 |
| msg_type | 当前消息类型 目前仅支持文本消息 |
text |
返回参数说明
| 参数 | 说明 | 示例 |
|---|---|---|
| bot_id | 机器人ID | |
| user_id | 当前聊天用户ID | user-001 |
| session_id | 当前聊天会话ID | session-007 |
| msg_type | 消息类型 | text |
| reply | 机器人返回的消息 | 你好，来个拥抱吧！ |
开发者可通过上述公开密钥直接调用公开闲聊机器人API，公开API现已内置所有笨笨功能。此外开发者可以登录 CTP平台 注册，支持开发、定制专属功能模块。
笨笨目前支持以下多种功能，现均已对外开放使用。
| 功能名称 | 功能描述 | 模块触发 |
|---|---|---|
| 闲聊 | 检索单轮模块 | “你是谁” “你爸爸是谁” |
| 天气咨询 | 多轮模块 根据用户咨询的地点、时间 调用接口查询天气并返回 |
“哈尔滨今天天气怎么样” |
| 古文回复 | 多轮模块 触发后锁定直至输入“退出” 对用户输入语句用文言文进行回复 |
"笨笨古文" |
| 聊小说 | 多轮模块 触发后锁定直至输入“退出” 笨笨扮演金庸小说人物角色 对自己的属性关系进行回答 |
“笨笨聊小说” |
| 笨笨古诗 | 多轮模块 可进行诗词成语等5个小游戏 |
“笨笨古诗” |
| 成语接龙 | 多轮模块 可进行成语接龙游戏 |
“成语接龙” |
| 猜谜语 | 多轮模块 可进行字谜灯谜等猜谜语游戏 |
“猜谜语” “来个字谜” |
| 脑筋急转弯 | 多轮模块 | “脑筋急转弯” |