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

[帮助文档] Bot开放平台新手教程(九)开发者中心-客服api

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

请求地址
请求方式:POST
请求地址:http://robot.open.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: http://robot.open.xiaoi.com
Connection: Keep-Alive
Content-Length: xxx
Content-Type:application/x-www-form-urlencoded; charset=UTF-8
X-Auth:xxxxxx

question=你好&userId=aaa

返回示例
<?xmlversion="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>

回复

使用道具 举报

Bot开放平台
今日发帖: 1 

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