茉莉云机器人API

小左
2021-10-20 / 4 评论 / 78 阅读 / 正在检测是否收录...
温馨提示:
本文最后更新于2021年10月29日,已超过343天没有更新,若内容或图片失效,请留言反馈。

【简单介绍】
茉莉云主要给用户提供机器人API服务为主,支持上下文场景对话,灵活配置知识库以及插件功能,为你打造专属机器人API服务。
后续我们将支持在线接入公众号,提供网页智能客服,提供机器人学习功能等,敬请期待!

茉莉云机器人API官网:https://mly.app/
⭐购买续费时使用本站专属口令码,可享受8折优惠哦。(口令信息回复后可见)

【新版说明】
茉莉始终坚持着免费、开放的态度,历经7年风霜,未经动摇,新版本还是会保障普通用户能够免费使用到茉莉机器人的服务,仅对使用需求较大的用户收取适量的会员费用,希望网友们能理解,毕竟我们也需要生活。

【功能简介】

【聊天插件】
[介绍]:AI聊天,与知识库灵活搭配,让你的机器人更具多元化。
【天气预报】
[介绍]:全国天气预报查询,并且会提示未来的天气变化。
[触发]:天气/武汉天气
[回复]:武汉天气【周五~08月13日】:小雨,24℃,东北风(0-3级 微风<5.4m/s);温馨提示......
[提示]:天气预报支持多轮上下文场景对话

【手机号归属地】
[介绍]:可查询全国手机号归属地信息。
[触发]:手机号/归属地/sjh/mobile/phone查询
[回复]:手机号前缀:1867230,归属地:湖北武汉,运营商:联通
[提示]:手机号归属地查询支持多轮上下文场景对话
【随机最美古诗词】
[介绍]:精选古诗词一句。
[触发]:最美古诗词/最美诗词
[回复]:两情若是久长时,又岂在朝朝暮暮。 《鹊桥仙》 - 秦观
【翻译功能】
[介绍]:通用翻译功能,几乎支持所有语种。
[触发]:进入翻译模式/翻译hello/Translate i miss you
[回复]:回复翻译内容
[提示]:翻译插件支持多轮上下文场景对话
【其他功能】
如果你有好的想法或建议,欢迎向我们反馈,期待中(QQ群:273970059);
其他功能陆续完善中,敬请期待,已规划功能如下:
【数学计算】 【笑话大全】 【故事大全】 【成语接龙】 【ip查询】 【身份证基本信息解析】

【茉莉API】
接口地址(Post请求)
https://i.mly.app/reply

请求头(Headers)

参数名必填说明
Api-Key开放接口的ApiKey,在机器人详情中获取,机器人创建时就跟随着创建,平台唯一。
Api-Secret开放接口的ApiSecret,在机器人详情中获取,机器人创建时会随机生成秘钥,后续可以自行修改。
Content-Typeapplication/json;charset=UTF-8

请求参数(Json对象)

参数名必填说明
content消息主体,跟机器人交互的文本
type对话场景,1:私聊,2:群聊(对话场景不一样,from和to参数的含义也不一样)
from消息发送者标识符(ID):群消息时,此值表示群成员;好友消息时,此值表示好友。
fromName消息发送者名字或昵称:群消息时,此值表示群成员;好友消息时,此值表示好友。
to是/否消息接收者标识符(ID):群消息时此值表示群标识;好友消息时此值不用传,并且无效。
toName消息接收者名字或昵称:群消息时此值表示群名;好友消息时此值不用传,并且无效。

接口响应结果(Json)

字段名字段类型说明
code字符串响应码,此值非00000都为异常状态码
message字符串接口响应的消息提示,异常状态码可以参考此值的消息提示
data数组当接口响应码为00000时,就会响应接口的正确数据

接口响应示例(Json)

{"code":"00000","message":"请求成功","data":[{"content":"不懂,style正在学习中,说不定下次就会回答了","typed":1,"remark":null}]}

data数组里面的typed表示当前回复的类型,1:文本,2:图片,3:文档,4:音频,9:其它文件

接口响应状态码
当接口返回当code值是"00000"的时候,表示请求成功,其他的值都表示失败的请求,不会计入调用次数,当值为C1001时表示当日调用次数已用完。

【调用示例】
[JAVA(SpringBoot)]

// 构建请求头
HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.APPLICATION_JSON);
headers.add("Api-Key", "机器人的Api-Key");
headers.add("Api-Secret", "机器人的Api-Secret");
JSONObject body = new JSONObject();
// 发送的内容
body.set("content", "你好");
// 消息类型,1:私聊,2:群聊
body.set("type", type);
body.set("from", "消息发送者标识");
body.set("fromName", "消息发送者昵称");
HttpEntity<String> formEntity = new HttpEntity<String>(body.toString(), headers);
JSONObject jsonObject = restTemplate.postForEntity("https://i.mly.app/reply", formEntity, JSONObject.class).getBody();

[PHP]

<?php
$url = 'https://i.mly.app/reply';
$apiKey = '机器人的 Api-Key';
$apiSecret = '机器人的 Api-Secret';
$message = '你好,你叫什么名字呀?'; // 消息内容
$header = array(
    "Api-Key: {$apiKey}",
    "Api-Secret: {$apiSecret}",
);
$body = json_encode([
    'content' => $message,
    'type' => 1,
    'from' => '123456',
    'fromName' => '张三',
    'to' => '1234567',
    'toName' => '王五',
]);
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_HEADER, 0);
curl_setopt($curl, CURLOPT_TIMEOUT, 1);
curl_setopt($curl, CURLOPT_TIMEOUT_MS, 3000);
curl_setopt($curl, CURLOPT_HTTPHEADER, array_merge($header, array(
        'Content-Type: application/json',
        'Content-Length: ' . strlen($body)),
));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, $body);
$data = curl_exec($curl);
curl_close($curl);

if (curl_error($curl)) {
    echo "Error: " . curl_error($curl);
} else {
    echo json_encode($data, JSON_UNESCAPED_UNICODE);
}
?>

[Python]

import http.client
import json
conn = http.client.HTTPSConnection("i.mly.app")
payload = json.dumps({
  "content": "555555555",
  "type": 1,
  "from": "123456",
  "fromName": "张三"
})
headers = {
  'Api-Key': 'xxxxxxxxxxx',
  'Api-Secret': 'xxxxxxxxxx',
  'Content-Type': 'application/json'
}
conn.request("POST", "/reply", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

【常见问题】

Q:这个网站是干什么的?

A:这个网站主要是提供机器人Api服务的,此网站不提供具体的机器人软件,您使用的软件可能是其他开发者制作。

Q:有没有推荐的机器人软件?

A:如需使用比如qq聊天机器人,微信聊天机器人等,请前往论坛探索,或者看本站顶部导航「谁在使用」。

Q:知识库的权重设置有什么用?

A:用户的每个知识库都可以自己设置它的权重,一共有5个档,分别为极低、较低、正常、较高、极高,从左到右,权重依次升高,系统默认的知识库都是正常档。

知识库权重越高,此知识库对应的词库优先级也就越高。比如知识库A和知识库B,都设有一个提问:「你好啊」,假如知识库A比知识库B的权重高,那么机器人在引用了这两个知识库的情况下,有优先使用知识库A对应的回答。

注意:知识库权重高,就不一定此知识库的词库在任何情况下都会优先,还是得看具体都语义,只有语义相近都情况下,才会优先。

Q:词库回答里面的代码有哪些,以及作用?

A:目前有[botname]、[name]、[age]、[sex]、[constellation],分别表示机器人名字,对方的称呼,年龄,性别,星座。

词库里面加这些代码,会在机器人回复时自动替换成相应的信息。比如词库回答里面有一个[botname]:如果名为"茉莉"的机器人使用次词库,那么回复时,[botname]会被替换为"茉莉";如果名为"二狗子"的机器人使用此词库,那么回复时,[botname]会被替换为"二狗子"。

Q:一个词库的提问和回答为什么都可以填多个?

A:提问有多个,表示相似提问,只要任意一个符合用户的消息语义,都可以触发对应的回复。回答有多个,表示一个提问,机器人可以回答多条消息,所以Api接口数据返回的是一个数组。

Q:支持通过上传文件批量导入词库吗?

A:支持,在知识库详情里面,有导入功能。导入时请注意知识库容量哦。

Q:一个知识库可以被多个机器人应用吗?

A:可以的,不管是系统的知识库,还是自己创建的知识库,都可以被不同的机器人重复应用。

Q:机器人信息里面的"万金油回复"是什么意思?

A:字面意思是通用的回复,主要用在机器人不知道怎么回复时,就会从万金油回复列表中随机选择一个回复(原:随机回复),如果机器人没有设置,系统也会有默认的万金油回复。

Q:为啥我添加了词库,机器人没有效果?

A:请检查机器人是否应用了该知识库。

Q:为啥我的机器人没有xxx功能?

A:请检查机器人是否应用了该插件

Q:Api调用量不够使用怎么办?

A:茉莉云秉承着开放、免费的态度,一般情况下基本足够支撑普通用户使用,对于重度使用Api的用户,我们提供了会员服务,升级会员能享受更多的调用量,也是对我们服务压力的均摊,感谢!

如果您的项目用于教育、公益,请联系我们免费为您升级会员服务。

Q:微信公众号怎么接入?

A:暂时只支持通过开发者信息接入,先在控制台添加微信公众号,然后把生成的「开发配置」填入微信公众平台并启用,这样微信公众号就会自动回复消息了。

如果想自定义新用户关注公众号时自动发送消息,请在词库里面添加一个提问「关注微信公众号」,会自动回复对应的回答。

0

评论 (4)

取消
  1. 头像
    WispX
    MacOS · Google Chrome
    @

    留下足迹 :^(左哼哼)

    回复
    1. 头像
      qeq 作者
      Windows 10 · QQ Browser
      @ WispX

      woc,熊佬 表情

      回复
  2. 头像
    冬天的秘密
    Windows 10 · Google Chrome
    @

    可以的 ( ,,´・ω・)ノ"(´っω・`。)

    回复
    1. 头像
      qeq 作者
      Windows 10 · QQ Browser
      @ 冬天的秘密

      woc,费佬 表情

      回复