NAV
python shell

介绍

笨笨 聊天机器人 API 接口 现已通过 CTP平台 对外开放，供开发者免费调用。接口目前支持 HTTP 调用，包括闲聊、天气咨询等各种聊天技能，欢迎体验。

如有任何使用问题可联系 kyzhang@ir.hit.edu.cn 或在 HITSCIR-DT-Code/Benben-API 反馈。

快速接入

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())

curl -H "Accept: application/json" -H "Content-Type: application/json" -X POST \
    -d "{\"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\"}" \
    http://120.25.81.83:16999/ctp/chat/api

上述命令返回的 JSON 数据格式如下

{
  "bot_id": "9c5a7e90-14bb-49da-819f-300cc4cef827",
  "user_id": "user-001",
  "session_id": "session-007",
  "msg_type": "text",
  "reply": "你好，来个拥抱吧！"
}

笨笨机器人相关接口支持 HTTP 请求。

请求参数说明

参数 说明 示例
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 机器人返回的消息 你好，来个拥抱吧！

功能支持

已有功能

笨笨目前支持以下功能：

功能名称 功能描述 模块触发
闲聊 检索单轮模块 “你是谁”
“你爸爸是谁”
天气咨询 多轮模块
根据用户咨询的地点、时间
调用接口查询天气并返回		 “哈尔滨今天天气怎么样”
古文回复 多轮模块
触发后锁定直至输入“退出”
对用户输入语句用文言文进行回复		 "笨笨古文"
聊小说 多轮模块
触发后锁定直至输入“退出”
笨笨扮演金庸小说人物角色
对自己的属性关系进行回答		 “笨笨聊小说”
笨笨古诗 多轮模块
可进行诗词成语等5个小游戏		 “笨笨古诗”
成语接龙 多轮模块
可进行成语接龙游戏		 “成语接龙”
猜谜语 多轮模块
可进行字谜灯谜等猜谜语游戏		 “猜谜语”
“来个字谜”
脑筋急转弯 多轮模块 “脑筋急转弯”

自定义功能模块

了解更多

关于笨笨

笨笨是由 哈工大SCIR实验室 研发的一款面向普通用户的聊天机器人，具备开放域对话、知识问答、任务型对话以及对话式推荐等功能。

2016年6月6日正式对外发布，搭载于微信公众号平台之上，截至2021年10月7日，关注人数达到6569，累计百万级人机对话数据。2019年4月笨笨的开放域对话功能上线到科大讯飞AIUI平台，对外提供服务，上线至今，平均每月调用6千万次。

笨笨对话系统及其相关应用曾获“合创杯”第二届全国青年人工智能创新创业大会三等奖、中国人工智能学会最佳青年技术成果奖、吴文俊人工智能科技进步奖二等奖，相关研究成果发表在ACL等国际顶级会议。

欢迎扫描左上角二维码关注“笨笨”微信公众号。

@inproceedings{zhang2017benben,
  title={Benben: A Chinese intelligent conversational robot},
  author={Zhang, Weinan and Liu, Ting and Qin, Bing and Zhang, Yu and Che, Wanxiang and Zhao, Yanyan and Ding, Xiao},
  booktitle={Proceedings of ACL 2017, System Demonstrations},
  pages={13--18},
  year={2017}
}

关于 CTP

聊天机器人技术开放平台（Chatbot Technology Platform，CTP）测试版是基于笨笨机器人核心技术及框架开发，CTP测试版旨在开放我们已有的研究技术，希望能够最大化这些技术的利用价值，同时方便普通用户和开发者创建或者开发专属机器人。

CTP 测试版支持机器人属性自定义、专属技能模块开发、多种交互使用形式以及会话日志分析等功能。同时，CTP测试版基本内置笨笨机器人各项技能，包括闲聊以及各种游戏技能模块，可供用户开箱即用（具体列表请访问CTP官网查看）。

python shell