全局服务

新建全局服务

新建HTTP类型全局服务

1. 登录智能对话机器人管理控制台，进入具体机器人空间，选择知识库>全局配置>全局服务进入全局服务管理界面。

2. 单击新建服务，在新建服务窗口选择服务类型为HTTP服务，完成其他有关信息填写后即可完成服务的新建。

   说明

   选择服务类型为“HTTP服务”实质是调用外部HTTP接口。

   

有关服务的其他内容配置介绍如下：

• 服务名称：根据服务提供的功能, 可自定义服务名称。

• 服务类型：当前支持的服务类型有“HTTP服务”、“阿里云函数计算”和“阿里云短信服务”三类，此处要选择服务类型为“HTTP服务”。

• 服务调用方式：同步和异步标识调用服务的方式，同步方式仅当获取到服务调用执行结果后才会返回，异步方式触发服务调用后会直接返回。

  • 同步：服务调用方式若选择同步，服务将在调用完成或超时的情况，生成response信息并返回结果。

  • 异步：若选择异步，需要调用方自主访问接口，来获取服务结果或超时信息。

    • 是否轮询：若选择“是”，im、外呼等渠道端会对接口发起轮询，如果异步服务有结果，则返回接口参数。

  说明

  对于同步调用的执行，默认需要等待服务返回后才触发后续流程，如果服务的返回结果会影响问答引擎后续动作，建议使用同步服务。

  对于异步调用，会有两种场景：

  例如机器人返回答案同时需要给客户发一条备忘短信，这种场景调用短信接口和后续问答无关，可以使用异步服务，“是否轮询”选择“否”，整体交互体验会更优雅；

  在某些场景中，服务的返回结果会影响问答引擎后续动作，同时业务接口实时较高（如订车票类服务接口），在对话过程中调用这种服务并获取结果会导致对话实时增加，对话交互体验下降，可以使用异步服务，“是否轮询”选择“是”。im、外呼等渠道端会对接口发起轮询，如果异步服务有结果，则返回接口参数。

• 服务超时时间：设定调用服务超时时间，超时后，系统会返回timeout信息。

• 服务接收参数：设置服务需要接收的参数。

• 服务接口：该服务需要引用的第三方接口。

• 接口入参： 根据第三方接口要求提供入参，可通过${}引用上面的服务接收参数，例：${city}。

• 设置服务返回参数，可在服务节点，将该参数赋值到全局变量。

• 接口需要utf-8编码、string格式的结果，result=${serviceOutput}表示将结果全部信息赋予result参数，供引用该服务的模块使用；如果结果string是json结构，支持${serviceOutput.name}表示获取接口结果中name字段

使用案例演示

参数说明：

• 服务接收参数：设置服务需要接收的参数，如查天气需要指定城市 。

• 服务接口：该服务需要引用的第三方接口

  • 请求类型：GET

  • 请求URL： http://127.xx.xx.xx/smsapi

• 请求参数： 根据第三方接口要求提供入参，可通过${}引用上面的服务接收参数，例： ${city}。

• 接口出参：服务接口返回的结果 ${serviceOutput}， 赋值到的服务返回参数。

• 服务返回参数：设置服务返回参数，可在服务节点， 将该参数赋值给全局变量。

新建函数计算类型全局服务

1. 单击新建服务，在新建服务窗口选择服务类型为函数计算，完成其他有关信息填写后即可完成服务的新建。

   

有关服务的其他内容配置介绍如下：

• 服务名称：根据服务提供的功能，可自定义服务名称。

• 服务类型：当前支持的服务类型有“HTTP服务”、“阿里云函数计算”和“阿里云短信服务”三类，此处要选择服务类型为“函数计算”。

• 选择服务/函数：选择的服务需在函数计算2.0进行创建

• 服务接收参数：服务接收的参数

• 服务返回参数：服务返回的参数

新建短信服务类型全局服务

1. 单击新建服务，在新建服务窗口选择服务类型为短信服务，完成其他有关信息填写后即可完成服务的新建。

   

有关服务的其他内容配置介绍如下：

• 服务名称：根据服务提供的功能, 可自定义服务名称。

• 服务类型：当前支持的服务类型有“HTTP服务”、“阿里云函数计算”和“阿里云短信服务”三类，此处要选择服务类型为“短信服务”。

• 选择签名/模板：选择的服务需在短信服务进行创建。

• 服务返回参数：可通过此参数查询短信成功或失败的状态。