请选择 进入手机版 | 继续访问电脑版

[公告] 开发者文档(四)智能交互

[复制链接]
智能交互
智能问答接口,基于HTTP协议的类REST调用方式,支持XML输出格式。智能交互接口支持普通和高级两种形式:普通模式交互直接返回交互结果,高级模式返回完整的报文结果,包括分词结果和语义拆解内容等。
请求地址
请求方式:POST
请求地址:http://nlp.xiaoi.com/ask.do

请求参数
参数名
说明
示例
userId
用户id,用户和会话判断依据
例如:"user0001"
question
问题内容
例如:"您好!"
type
响应类型(0:普通、1:高级)
例如:"1"
返回报文格式
元素名
说明
示例
Response
顶级元素
表示xml为智能问答响应。
Type
响应类型。此元素客户端不用解析,仅分析调试及日志等使用。

Content
回答内容。回答内容中出现的[link]标签需要客户端以参数指明的意义渲染成对应的链接形式。
为纯文本类型。例如:"你好,我的名字叫小i"。"查看更多内需请点击[link url="http://www.xiaoi.com"]这里[/link]"
Words
分词结果,不包含弱语义词。(只有机器人理解了的问题才会输出)

Similarity
0到1范围相似度值。(只有机器人理解了的问题才会输出)
例如:"您好!"
Commands
非文本的语义表述。
例如:"1"
RelatedQuestions
相关问题列表。第一条为与用户问题语义一致的知识点。


调用示例(HTTP请求报文)


POST /ask.do HTTP/1.1
Cache-Control: no-cache
Pragma: no-cache
Host: nlp.xiaoi.com
Connection: Keep-Alive
Content-Length: xxx
Content-Type:application/x-www-form-urlencoded; charset=UTF-8
X-Auth:xxxxxx

question=你好&userId=aaa

返回示例
<?xml version="1.0" encoding="utf-8"?>                <Response>                    <Type>8</Type>                    <Content>你好,我是机器人,很高兴认识你。</Content>                    <Similarity>1.0</Similarity>                    <Commands>                        <Command name="p4">                            <Arg>http://www.xiaoi.com</Arg>                        </Command>                    </Commands>                </Response>
回复

使用道具 举报

10条回复
能不能对PHP版的SDK函数做一个简单的说明。一脸懵逼。
支持 | 反对 | 回复

使用道具 举报

windphp 发表于 2017-4-23 22:06
能不能对PHP版的SDK函数做一个简单的说明。一脸懵逼。

http://bbs.xiaoi.com/forum.php?m ... &extra=page%3D1 看看是不是这个
支持 | 反对 | 回复

使用道具 举报

joker 发表于 2017-4-25 10:09
http://bbs.xiaoi.com/forum.php?mod=viewthread&tid=469&extra=page%3D1 看看是不是这个

你好,我用这个接口,type设置为1高级,返回401认证错误,我已经申请认证了个人用户和企业用户,都是这个错误。
1支持 | 0反对 | 回复

使用道具 举报

userid哪里来的?
这个接口怎么调?
我用java调用,使用你们提供的例子返回不成功,401
支持 | 反对 | 回复

使用道具 举报

基本成功了,没有文档,猜起来好费劲啊
返回的type表示什么?
如果我问机器人最近的新闻,他就回复了一堆的link,关于这个,怎么解析出来
还有,回复中还涉及到什么类型的内容?
支持 | 反对 | 回复

使用道具 举报

你好,http://bbs.xiaoi.com/forum.php?m ... &extra=page%3D1请仔细阅读开发者文档,若你无法参透开发者文档,请联系客服QQ:3423332393,由客服为你转给商务部,谢谢!
支持 | 反对 | 回复

使用道具 举报

提示401的用户可以在请求数据加上
  1. &platform=custom
复制代码

最新的官方文档没写清楚,我看以前的代码才发现
支持 | 反对 | 回复

使用道具 举报

支持其他国家语言吗?
支持 | 反对 | 回复

使用道具 举报

Hstb 发表于 2017-7-26 10:56
提示401的用户可以在请求数据加上
最新的官方文档没写清楚,我看以前的代码才发现 ...

你调用成功了吗?请教一下。
支持 | 反对 | 回复

使用道具 举报

开发者交流
今日发帖: 0

小i微信公众号:
搜索 “xiaoirobot"
或扫描下面的二维码: