首页 > 其他分享 >业务扩展:图灵机器人调用(API)接口模式的开发流程及其注意事项

业务扩展:图灵机器人调用(API)接口模式的开发流程及其注意事项

时间:2023-04-17 14:14:45浏览次数:53  
标签:请求 api 机器人 图灵 接口 API 注意事项 com

业务场景:在网站添加一个可以回答用户问题的对话机器人;

解决方案:使用三方图灵机器人(turing)进行语料库控制,数据统计,问题反馈等;

操作流程:

1、申请图灵开发者账号权限,官网网站:http://www.tuling123.com/

2、购买相应套餐获取机器人功能,完成认证之后可获得免费版,未完成认证则需要完成套餐购买;

3、进入个人中心(机器人控制台)设置机器人基本信息,获取机器人相关参数:apiKey,api接口文档等;

 

4、前端聊天对话框搭建,可以使用三方插件,也可以自行编写,建议对机器人内容组件化(或模块化),实现多项目复用,调用图灵接口传入问题,接口返回问答渲染到对话框;

接口说明:

接口地址:http://openapi.turingapi.com/openapi/api/v2

请求方式:POST

请求参数:请求参数格式为 json

请求示例:

{
    "reqType":0,
    "perception": {
        "inputText": {
            "text": "附近的酒店", // 对话内容 必传
        },
        "inputImage": {
            "url": "imageUrl", // 图片
        },
        "selfInfo": { // 客户端属性
            "location": {
                "city": "北京",
                "province": "北京",
                "street": "信息路"
            }
        }
    },
    "userInfo": {
        "apiKey": "", // 申请的apiKey, 必传
        "userId": "", // userId, 必传
    }
}

返回示例:

{
    "intent": {
        "code": 10005,
        "intentName": "",
        "actionName": "",
        "parameters": {
            "nearby_place": "酒店"
        }
    },
    "results": [
        {
             "groupType": 1,
            "resultType": "url",
            "values": {
                "url": "http://m.elong.com/hotel/0101/nlist/#indate=2016-12-10&outdate=2016-12-11&keywords=%E4%BF%A1%E6%81%AF%E8%B7%AF"
            }
        },
        {
             "groupType": 1,
            "resultType": "text",
            "values": {
                "text": "亲,已帮你找到相关酒店信息"
            }
        }
    ]
}

异常返回示例:

{
    'intent':
        {
            'code':5000
        }
}

错误码对照表:

异常码说明
5000 无解析结果
6000 暂不支持该功能
4000 请求参数格式错误
4001 加密方式错误
4002 无功能权限
4003 该apikey没有可用请求次数
4005 无功能权限
4007 apikey不合法
4100 userid获取失败
4200 上传格式错误
4300 批量操作超过限制
4400 没有上传合法userid
4500 userid申请个数超过限制
4600 输入内容为空
4602 输入文本内容超长(上限150)
7002 上传信息失败
8008 服务器错误
0 上传成功

 

请求问题补充:接口不建议前端直接请求,建议后端中间桥接,一是接口存在跨域,如果直接使用需要解决跨域问题,vue使用了proxy代理解决了跨域问题,但是服务部署时仍需要做相应配置,二是直接请求会暴露必传参数apiKey到请求体中,存在安全隐患;

生产阶段如自己调用则需开启代理:

配置如下:

在vue.config.js中添加代码,没有此文件则在根目录创建

module.exports = {
    devServer: {
        // host: 'xxsl.job.com',
        // port: 9246,
        // https: true,
        proxy: {
            // 配置跨域 带/robot得路径匹配替换为下面得地址,并且移除路径中的/robot
            '/robot': {
                target: "http://openapi.turingapi.com/openapi",
                changeOrigin: true,
                pathRewrite: {
                    '^/robot': ''
                }
            },
            '/api': {
                target: "https://xxsl.job.com",
                changeOrigin: true,
                pathRewrite: {
                    '^/api': '/api'
                }
            }
        }
    }
}

总结:当下chatGPT大火,使用图灵机器人多少还是觉得有些AI智zhang了,但是满足业务需求,解决回答用户问题还是完全能够胜任,而且具备话术库导入,对于企业的对外服务性还是提升很大的。

标签:请求,api,机器人,图灵,接口,API,注意事项,com
From: https://www.cnblogs.com/hkb924/p/17325539.html

相关文章

  • 如何玩转国产神器:接口一体化协作平台Apifox!
    前言:Apifox是什么?简介:简单来说,Apifox=swagger+mock+postman+Jmeter,是API文档、API调试、APIMock、API自动化测试一体化协作平台。可以把接口开发过程中各角色的工作,例api设计者、后端开发、前端开发、测试人员协同到一个Apifox平台完成。工具使用界面的各个功能都直......
  • 有效避免骚扰:从用户体验角度看空号检测 API 的优势!
    引言电话营销和短信营销是企业吸引客户和促进销售的重要手段,但是无效号码的存在会导致资源浪费和用户不满。利用空号检测API可以帮助企业识别出有效和无效的电话号码,从而避免向无效号码发送营销信息,降低营销成本。本文将从用户体验、合规风险和数据分析三个角度介绍空号检测AP......
  • 从 HTTP 到 gRPC:APISIX 中 etcd 操作的迁移之路
    罗泽轩,API7.ai 技术专家/技术工程师,ApacheAPISIXPMC成员。原文链接ApacheAPISIX现有基于HTTP的etcd操作的局限性etcd在2.x版本的时候,对外暴露的是HTTP1(以下简称HTTP)的接口。etcd升级到3.x版本后,其对外API的协议从普通的HTTP切换到了gRPC。为了兼顾......
  • 免费可用的热门 API 大全整理分享
    天气/日落日出分钟级降水预报:支持国内任一经纬度的预报数据,实时调取某地未来2小时内天气预报,可做到分钟级、公里级,可准确提醒下一场雨何时出现,何时变大,何时停止等预报信息。日出日落:支持国内3400+个城市以及国际4万个城市,获取指定城市/地点每日日出时间、日落时间。月出月落和......
  • Win32API之实现远程线程注入(九)
    什么是注入注入是一种在不知情或未经许可的情况下向其他进程中注入模块并试图执行它们的技术常见的注入方式有:远程线程注入、APC注入、消息钩子注入、注册表注入、导入表注入、输入法注入等等什么是远程线程注入远程线程注入是一种技术,可以将一个动态链接库(DLL)注入到另一个进......
  • Hugging News #0414: Attention 在多模态情景中的应用、Unity API 以及 Gradio 主题构
    每一周,我们的同事都会向社区的成员们发布一些关于HuggingFace相关的更新,包括我们的产品和平台更新、社区活动、学习资源和内容更新、开源库和模型更新等,我们将其称之为「HuggingNews」,本期HuggingNews有哪些有趣的消息,快来看看吧!社区动向Attention在视觉领域的应用注......
  • ES的Java API 操作(五)
    我看到希望,哪怕只有微小的一束光,我也会拼尽全力去寻找.上一章简单介绍了ES聚合查询(四),如果没有看过,请观看上一章我们之前都是使用Postman请求来操作索引,操作文档,查询数据的,这一章节,老蝴蝶使用JavaApi进行处理.一.简单的JavaAPIES环境搭建一.一添加pom.xml依赖......
  • Floyd算法注意事项
    注意事项:k层循环不能内置Floyd适用于求解全源最短路径问题,即对于给定的图G,求解任意两点之间的最短路径长度。模板#include<bits/stdc++.h>usingnamespacestd;constintN=105;intdis[N][N];voidFloyd(){ memset(dis,0x3f3f3f,sizeof(dis));//初始化为极大值 //......
  • SAP ABAP 通过 https 消费外部 API 遇到错误消息 SSSLERR_SSL_CONNECT
    错误消息:500NativeSSLerror:SSLhandshakewithapi.uat443failed:SSSLERR_SSL_CONNECT-57SAPCRYPTO:SSL_connectfailedreceivedafatalTLS1.0internal_erroralertfromthepeer这个错误是关于ABAP作为客户端,无法通过https向提供API的外部服务器建立安全......
  • 让 Spartacus 服务器端渲染引入 long API 调用超时机制的两种配置方法
    两种方法,使用config.backend.timeout={浏览器:...,服务器:...},或者可以更具体地配置,即基于Request粒度,通过将HTTP_TIMEOUT_CONFIGHttpContextToken传递给AngularHttpClient的方法来针对每个具体请求进行配置。在SSR(Node.js)中,超时处理耗时过长的外部http调用是一项尤为......