...
URL参数名 | 说明 | 是否必填 | |
---|---|---|---|
输入参数 | userName | 登录账号 | 必填 |
password | 登录密码 | 必填 | |
smartbiServer | Smartbi服务器地址。该AIChat服务器第一次登录Smartbi,必填;以后选填;不填则使用之前已经登录过的Smartbi服务器。 | 选填 | |
casLoginUrl | 如果Smartbi是使用CAS登录方式,则需要填入该值;该AIChat服务器第一次登录Smartbi,必填;以后选填;不填则使用之前已经登录过的CAS认证服务器。 | 选填 | |
loginMethod | 使用的登录方法,枚举值。普通登录使用login;如果是CAS登录则使用loginWithCas,默认情况下都可以不填。
| 选填 | |
返回值 | { |
...
- 接口返回值说明
返回参数名 | 返回值说明 |
---|---|
code | 接口调用是否成功;0 - |
表示成功;负数为错误码。 | |
message | 错误描述,code=0 |
时,该内容为空。 |
token |
登录方法特有内容,这个非常重要,后续接口需要传递该值以验证登录。 | |
result | 调用接口的返回内容,登录接口的返回内容说明如下:
|
|
|
|
...
|
- 调用示例(PostMan调用截图)
4.2 查询接口(异步)
名称 | 描述 | 默认值 | |
---|---|---|---|
接口路径 | http://host:port/aiweb/api/v3/conv/query | ||
接口说明 | V3版本查询方法 -- 异步方法 -- |
SSE请求。 | |||
header | token | 登录key,使用login方法获取;login方法请参考:登录AIChat | |
接口参数 | convId | 会话Id | |
datasetId | 数据模型Id | ||
question | 用户问题 | ||
queryType | 查询类型:
| 建议使用:analysis | |
id | 本次对话id 从外部传入才能做点赞点踩 | ||
need_inquiry | 本次查询是否需要使用反问功能 | default(true) | |
返回内容 | 返回SSE对象,前端处理 SSE返回报文样例: {"role": "SimpleQuery", "response_status": "generating code", "response_message": " \"", "execution_result": "", "send_to": "Unknown", "response_type": "python"} ... SSE 接口会返回很多条这样的报文;具体原理请自行查询百度。 请手工拼接返回报文 "response_message" 和 "execution_result" 部分内容;response_type 表示当前这条报文的返回内容是啥。 |
参考代码: 锚DemoCode DemoCode
DemoCode | |
DemoCode |
服务端调用可参照以下示例代码(可展开源码阅读):
...