开发文档
总目录
接入常见问题
开发者平台使用帮助
HTTP API接口文档
Chatbot接口指令说明文档
Android SDK用户接入指南
微信公众号客服机器人接入教程
灵聚智能助理app开源说明文档
直播数字人系统用户评论回复接口开发文档
灵聚自定义对话训练API接口说明文档
本站点使用 MrDoc 构建
-
+
开发者平台使用帮助
# 开发者平台使用帮助 ## 前言 欢迎您使用灵聚开发者平台。 如果您是智能硬件、数字人、机器人、智能家居的研发企业,或者是想为自己的APP、微信公众号增加智能机器人功能,通过灵聚开发者平台可以快速实现。 通过开发者平台您可以快速自定义机器人属性、问答内容及知识库,还可以自定义Json,满足各种应用场景的需求。 同时我们为智能家居、玩具及商用服务机器人准备了完整的软硬件一体解决方案,方案不但为多个硬件平台进行优化并完成系统整合,并且针对性的开发了许多应用场景,同时也配备了灵聚智能全双工唤醒打断功能,如果您需要可直接与我们联系。 - 点击添加[「灵聚开发者服务群」](/project-2/doc-5/) - 联系邮箱:ling@lingjutech\.com <br/> ## 1\.快速入门 ### 1\.1灵聚开发者平台是什么 欢迎您使用灵聚开发者平台。 如果您是智能硬件、数字人、机器人、智能家居的研发企业,或者是想为自己的APP、微信公众号增加智能机器人功能,通过灵聚开发者平台可以快速实现。 通过开发者平台您可以快速自定义机器人属性、问答内容及知识库,还可以自定义Json,满足各种应用场景的需求。 同时我们为智能家居、玩具及商用服务机器人准备了完整的软硬件一体解决方案,方案不但为多个硬件平台进行优化并完成系统整合,并且针对性的开发了许多应用场景,同时也配备了灵聚智能全双工唤醒打断功能,如果您需要可直接与我们联系。 - 点击添加[「灵聚开发者服务群」](/project-2/doc-5/) - 联系邮箱:ling@lingjutech\.com ### 1\.2如何使用开发者平台 1、创建应用。注册登录后创建应用,记得选择对应的应用类型。 2、编辑应用下机器人的名称等属性,并可添加简单的问答对话。 3、选择产品实用的功能,选择完成后,定制已经选择对话技能场景对应的指令反馈和对话场景输出方式。 4、下载SDK或者HTTP接口接入方式,查阅appkey,查阅authcode授权码。 5、剩下的工作就是开发集成了。 ## 2\.应用管理 ### 2\.1应用是什么意思 应用,是指一款产品在开发者平台对应的项目。 因此,依托灵聚开发者平台开发产品时,需创建应用。 ### 2\.2如何创建应用 1\.点击创建应用 2\.填入应用名称、描述 3\.选择应用的平台类型 4\.选择应用产品的市场领域分类 请认真选择产品的市场领域分类,因为系统会根据不同领域匹配默认开通的对话技能。 ### 2\.3删除应用后会怎样 删除应用会删除应用内数据,同时由该应用接入平台的所有设备都不再具备对话能力。 因此请谨慎删除应用。 ### 2\.4测试是测试什么内容 测试是对录入的属性、对话内容进行测试。 测试以录入文字对话的方式,  测试中回答的结果分为两类,一类是开发者已经自定义的问题,会被标注为来源对话库;另一类是未自定义的问题,会由灵聚智能云给出回答。 ### 2\.5重启对话是什么 当开发者编辑过自定义对话和机器人基础属性后,需要重启对话,来生效最新更新的对话内容。 重启对话需要数秒时间生效,生效中,会中断设备与终端用户的对话。 因此建议 1\.不要在用户使用高峰时间段重启对话。 2\.不要频繁重启对话。 ## 3\.接入问题 ### 3\.1如何接入应用 接入应用根据应用类型不同而有不同。 大体分为:SDK接入、HTTP接入、微信接入。其中SDK接入支持:Android、Linux、Windows平台。 请在“接入”功能页获取APPkey、授权码;根据“接入途径”页面的引导下载SDK或者获得接口路径。 接入过程请参阅灵聚提供的接入文档。 ### 3\.2SDK在哪里下载 请到具体应用中下载对应SDK。路径如下: 应用\>接入\>接入途径 ### 3\.3微信如何接入 目前支持接入公众微信号。请到接入途径中,根据引导接入。 应用\>接入\>接入途径 ### 3\.4定制SDK在哪里 在达成合作协议后,若某些功能需要定制SDK,灵聚会为开发者定制开发。定制SDK可以在接入途径功能页面由开发者自行下载。 ### 4\.5定制SDK与标准SDK有什么区别 当开发者某些定制的功能、对话技能,需要定制SDK时,灵聚才会提供定制SDK。 因此,当有提供定制SDK时,请优先使用定制SDK,以保证功能正常使用。 ## 4\.授权问题 ### 4\.1授权码是什么 授权码是灵聚为产品接入提供的激活验证机制。 开发者在对接的过程中需要获取到【appkey】及【authcode授权码】才能够进行开发。  授权码分为正式授权码和体验授权码两种类型。 体验授权码由灵聚免费提供,供开发者进行体验测试。 体验授权码有效期为30天,自接入设备当天算起。30天有效期过后,接入的设备将会失去对话能力。 正式授权码,由开发者购买正式授权配额后自行创建,正式授权码长期有效。 ### 4\.2授权配额是什么 授权配额,指可以接入的设备数量限额。 开发者在获取授权配额后,可以将配额分配给各个授权码,对各个授权码下可接入的设备数量进行灵活管理。相关阅读:如何获取授权配额? 授权配额分类 与授权码相对应的,授权配额也分为体验授权配额和正式授权配额两种。 体验授权码下,只能使用体验授权配额,正式授权码也只能使用正式授权配额。  ### 4\.3如何获取授权码 授权码由开发者在开发者平台的“接入\|授权码”页面自行创建。注意:当剩余的正式授权配额或体验配额为0时,无法创建对应的授权码。 创建步骤 1、确认当前剩余配额不为0。若需要获取更多授权配额可查阅:4\.4如何获取授权配额  2、点击“新增授权/体验授权”按钮  3、在弹出的新增授权弹窗中输入当前授权码下需要分配的配额数量,并点击提交按钮。  4、完成创建。  ### 4\.4如何获取授权配额 开发者在获取授权配额之前,需要确定需要获取哪种授权配额:体验授权码下,只能使用体验授权配额,正式授权码也只能使用正式授权配额。 #### 体验授权配额获取 1、免费的体验授权配额:开发者在创建的“Android / Linux / Windows”等硬件应用时,应用下都会有5个免费的体验授权码配额。 2、商务流程:如果你需要增加体验授权数量和延长时间,请与灵聚联系。灵聚可以为优质的合作伙伴提供灵活的体验方式。 #### 正式授权配额获取 1、开发者在“接入授权”页面点击“订购”按钮,跳转至工单页面。  点击订购 2、在工单页面输入您需要的正式授权配额数量,并点击提交按钮。授权价格会由灵聚的商务部门与您联络沟通。  提交成功 ### 4\.5体验授权能否提高授权数量和延长 如果你需要增加体验授权数量和延长时间,请与灵聚联系。灵聚可以为优质的合作伙伴提供灵活的体验方式。 ## 5\.属性管理 ### 5\.1如何编辑应用的属性 应用的属性是指接入设备的名称、性别、年龄等拟人化属性,在设备与人的对话交互中使用。 开发者可根据页面功能引导,将对应属性填入。如果未填入,则使用灵聚缺省内容。 建议设备的名称与唤醒词相同或相近,方便终端用户在与设备对话时,保持体验的统一。  ### 5\.2为什么要填入唤醒词 唤醒,是指通过特定词语,通知设备开始进入对话的环节,机器将对唤醒后录入的语句进行应答。 之所以要求开发者填入设备的唤醒词,是因为:当终端用户在已经唤醒状态,说出唤醒词,灵聚接收到正确识别的唤醒词后,会做出唤醒的反馈。 填写唤醒词后,请至高级配置\>指令反馈\>唤醒词反馈,配置唤醒后的反馈。 ## 6\.对话库 ### 6\.1对话库怎么录入对话 #### 6\.1\.1概述 灵聚开发者平台的自定义对话功能,目前提供了简单的问答录入功能。问答提交并在应用管理中“重启对话”后生效。生效后,当终端设备的用户问到对应问题,系统会优先将开发者设计的对话回答回复给用户。而当用户提问的问题,超出开发者设计的范围,则由灵聚的系统来回复答案。因此,请认真设计你的问答哦。 #### 6\.1\.2怎么录入对话 ##### 1\.基本流程 录入对话名—录入问题—录入回答—保存,如下图1  \[图1\] ##### 2\.创建多条问题 有些情况下,需要多句同样含义的问题,对应同一种回答,这时候,可以添加多个问题。点击问题上方的\+就可以添加了。如下图2  \[图2\] ##### 3\.创建多条回答 如果需要让回答不是那么单一,可以创建多条回答,系统会随机调用其中一条。一般情况下,截至到这个步骤,点击保存就可以完成创建对话了。如图3  \[图3\] ##### 4\.关于对问题语句的解析 在创建问答的过程,开发者应该已经可以见到蓝色字体“解析结果”,这是系统对问题语义解析后的结果。我们把这样的表达方式称为表达式。 如下图4  \[图4\] 例如:^【今天】^有什么^【优惠】^ 【】内是系统认为重要的关键词;^是通配符。通配符是指可以代替任意一个词汇的通配符号。 > 目前,为了保障简单对话的命中能力,此处优先使用此类方法供开发者自定义使用。同时灵聚兼用更多技术和方法,在系统内增加语句意图的理解能力,包括自动拓展语句、自动全局上下文等。在此不再更多讲述。 > > 如果你觉得有必要修改表达式,可以进入高级编辑页面进行后续操作。进入高级编辑页面有两种办法: - 办法1,在录入问题时,点击问题录入框后的“解析”按钮,系统会给出解析结果,再点击“高级编辑”按钮,即可进入高级编辑页面。 - 办法2,在保存对话后,点击对话右上角的编辑按钮,让对话进入编辑状态,点击问题录入框后的“高级编辑”按钮,即可进入高级编辑页面。按钮描述见图5。  \[图5\] ##### 5\.高级编辑 修改问题语句的解析,就是高级编辑。非专业的修改可能会导致应答异常,请谨慎对待。但是高级编辑并不涉及代码开发,所以具备普通中文语言能力的用户都可以修改。当然,如果你具有代码开发能力,更容易理解。 下面对高级编辑进行介绍: 2\.5\.1在高级编辑页面,在序号为“1”的一行中,点击编辑按钮,进入编辑状态,在编辑框中,增减通配符,编辑关键词,将重要的词用【】 括起来。见图6 ^ 代表任意一个词。【】代表与机器人对话时,问题中必须包含的词汇。 备注:当然如果此处,你把这句话所包含的意思修改的与原意不同,系统也将会以此处的表达式为准。  \[图6\] 2\.5\.2 在高级编辑页面,在序号为“2”的一行中,是对词汇的编辑。你也可以理解为此处是对词组实体集合的编辑。这里可以针对句子中关键词进行灵活的词汇拓展。  \[图7\] \#以下是更通俗的详细解释: 系统对【】内关键词匹配对应的同义词或者同类词。此处我们用“打开美国国旗图片”为例子举例:会自动为 【打开】【美国】【国旗】【图片】这四个词汇匹配对应的同义词。这样,当实际对话发生时,用户表达的语句中使用了同义词,系统也会理解这句话。 同时可以填入归属于同一个类别的词,“词组名:国家;词组内容:中国、美国、泰国”;在对话中可以用句子“打开【国家】国旗”实现更灵活的输出。 表达式\+词组集合的方式,构成了最初级的语义理解。 系统会自动使用推荐词组,原则上优先使用优先级高的词组,系统会默认同义词优先级。同时系统也会根据开发者对词组的使用情况,推荐优先级。 开发者可以为关键词选择词组、修改词组内的词语、甚至添加词组。 i\.选择词组:选中下图中的位置,就是选中【打开】关键词所对应的词组。开发者如果对系统自动匹配的词组不满意,可以选择另外的词组。见图8  \[图8\] ii\.修改词组内容:点击编辑,进入词组管理。如下图9。  \[图9\] 开发者可以编辑词组内的词语,删除、增加操作。如需要批量增加词语,请点击批量编辑。编辑词组内容见图10。 词组类型:分为同义词和其它,系统会默认优先同义词。 优先级:如果开发者对词组没有非常高的匹配要求,可以忽略优先级设定。如果需要强制要求最高优先匹配,请选择高优先级。  \[图10\] 编辑后保存的词组,系统会自动生成一个词组名称。如果开发者需要清晰的词组名称可以自行修改,如果没有该需求,则请忽略该步骤。 iii\.增加词组:如果开发者需要填入这样一个词组 “词组名称:国家 ,词组内容:英国、德国、日本……”,请点击 “\+”,如下图11  \[图11\] iv\.此处添加的词,都会被系统认为是该应用的分词依据。所以,一些不会被系统自动分词的词汇,可以在此处添加特殊词汇,成为专有词。如,“灵聚”为不常见词汇,可添加为专有词,供系统调用。 此时可添加为 词组名称:“公司 ;灵聚 灵聚智能” ##### 6\.获取问题中的某个变量 问题的解析结果中会存在通配符^或词组【】,回答里面需要用到这些变量的话可以通过该方式获取。 例如: 在回答里面录入json:\{"name":""\}。 X代表解析结果中对应的通配符^和词组【】的下标,从左往右数,下标从1开始。如图\[12\]  \[图12\] ##### 7\.保存问答 2\.7\.1 系统会进行查重等处理,请根据提示酌情处理。如果保存重复内容,系统会随机调用重复内容中的一条。 2\.7\.2 建议回答内容中,不含除标点以外的特殊符号,便于语音合成的朗读。 ### 6\.2导入和导出 平台允许自定义对话内容及词汇内容,在不同的应用间进行Copy,所以提供了使用镜像编码导出的机制,开发者可以自行导出“应用A”的对话镜像编码,在“应用B”处进行导入。 同时,为方便开发者编写问答内容,特提供使用excel文件批量导入的简单问答的功能。批量导入的内容未经过人工干预解析,可能会影响问答效果。建议导入时使用灵聚提供的模板文件。 导入后,若存在重复内容,会提示对重复内容进行人工编辑。excel单次最高导入500条。 你可能会遇到的问题:若选择Excel文件后,如果未出现“一键导入”按钮,则可能是你的文件格式不正确或者编码错误导致无法读取,请新建一个Excel文件,把你原有的文件内容拷贝到新的Excel文件导入即可。 ### 6\.3对话条数有限制吗 目前每个应用最多支持添加300条问答。 ### 6\.4关于重启对话 开发者编辑对话、导入对话、编辑属性的操作后,需要“重启对话”进行生效。生效时间根据对话库内对话数量不同而不同,一般来讲,不会超过5分钟。 - 建议不要频繁重启,会影响终端用户对话。因此灵聚对重启对话按钮进行一定点击频率限制,如果你的应用重启对话处于受限状态,可以与灵聚联系。 - 同时建议不要在对话高峰期重启对话。 ### 6\.5想要更聪明丰富的对话功能怎么办 ### 6\.5 想要更聪明丰富的对话功能怎么办? 这个功能只能应付简单的对话,毕竟穷举是个笨办法。如果你的产品、场景需要更复杂的内容和功能,如:避免每句话都要写入,让上下文更连贯、让机器人懂得更多知识、让机器人帮你打电话……请和我们联系吧,我们会为你提供更专业的技术服务。 同时,灵聚也在不断优化和提升语义相关技术,对话库功能也在不断提高。如果你有什么建议和意见,也欢迎和我们联系。 ### 6\.6 关于自定义Json输出 ****如果在对“问题”句式的意图理解后,开发者需要一些更高自由度的输出,而不是仅仅输出文本回答,那么Json自定义输出可以满足你的需求。你可以使用这个功能,轻松对接指令对设备的控制。当然灵聚在其它的对话技能中,已经提供比较完善的能力,如控制智能家居、控制机器人动作、等等,大家不妨试一试。见图1  \[图1\] ## 7\.技能管理 ### 7\.1什么是技能 这里的技能是指对话的技能,例如,天气的询问、通过对话创建、查询提醒的技能。 技能分为基础技能和高级技能。基础技能是只要开发者接入开发者平台,即可以拥有的对话能力。高级技能,灵聚会根据应用归属的不同类别,进行技能推荐并为之默认开通。如果开发者认为需要开通更多高级技能,可以向灵聚申请开通。 同时如果开发者对技能有更多需求,可以联系灵聚为你定制专有的对话能力。 ### 7\.2怎么配置应用的技能 开发者创建应用后,灵聚会为应用配置默认开通的高级技能,同时也会为应用开通所有默认的基础技能。 例如如果应用归属为机器人,那默认会为机器人开通动作能力技能,同时也已经开通默认的询问天气的基础技能。 开发者无需对基础技能进行更多配置,而且灵聚也在不断完善更多的对话技能和能力。 开发者可自行打开或关闭已经默认开通的高级技能,也可以向灵聚申请开通更多高级技能。 一般来讲,基础技能不需要特殊对接,只要接入基础的问答接口,就可以拥有全部基础技能;而高级技能则需要开发者仔细阅读开发文档,做进一步的接口接入工作。 ### 7\.3指令的反馈是什么意思 这里举例说明, 例如接入智能家居控制的对话技能时,在此项中,针对“打开空调”这条或该类指令,设计其多种情况下的反馈,包括但不限于:“找不到空调”、“空调已经打开”。此项更注重于对指令执行出现错误时的情况。 指令的反馈可以同时是文本合成和录音音频文件播放。开发者平台支持文案的录入和音频的上传。 如果目前指令反馈不能满足您的要求,可以与灵聚联系。我们会尽量满足开发者需求。 ### 7\.4什么是场景输出 此处举例说明: “讲故事”此类指令,灵聚可以输出文本故事,由语音合成最终朗读给用户。此种情况下,灵聚会直接输出结果,开发者无需做更多对接工作。 同时灵聚也可以输出语义解析结果,满足开发者自行对接第三方有声故事资源的需求。 请到应用 高级配置\>指令输出,选择对应的输出方式。 ### 7\.5什么是兜底反馈 兜底是指:当终端用户的提问,系统无法理解,或者系统已经理解但是没有准确数据回复时,系统会调用此处的内容进行应答。 系统无法理解时:通常会回复,你懂的可真多,这个我还得去翻翻书。等类似的话。 系统已经理解但是没有准确数据回复时:通常会回复,我的百宝箱里还没有这个的精确数据。 灵聚会增加精准数据和没有精准数据时可靠的理解回答。 ## 8\.工单 ### 8\.1如何创建工单 工单是开发者通过开发者平台向灵聚提交的任务和要求。 通过工单可以开通、体验某项技能,可以申购授权量。 您还可以通过添加[「灵聚开发者服务群」](/project-2/doc-5/),来与我们获取联系,我们也会在此处为您提供基础技术支持。 ### 8\.2如何提交工单 一般,在对应的功能页面会有对应的工单提交入口。
lingju.ai
2026年10月20日 17:19
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
PDF文档(打印)
分享
链接
类型
密码
更新密码