Zia机器人工作流程

Zia机器人工作流程

使用 Zia，您可以优化服务台管理，还可以消除最终用户与服务台之间的隔阂。


Zia Bot 工作流程可帮助您定义针对特定用户输入或选择必须执行的各种操作。

使用 Zia Bot 工作流程，您可以轻松定义针对用户查询必须执行的各种操作的定向工作流程。

 

需要的角色： SDAdmin

 

 Zia Bot 工作流程

 

Zia Bot 工作流程可通过在图形用户界面上的拖放操作轻松定义。


转到管理 > Zia Bot > 配置 Zia 工作流程

 


 

Zia 工作流程配置页面会打开一个画布，供您创建图形化工作流程。


您可以根据需要编辑画布中的节点，也可以删除所有节点，从头开始创建工作流程。


有两个节点用于创建工作流程： 选项菜单和动作。


选项菜单是您可以提供给客户的各种选项或选择的列表。每个选项或选择都称为一个按钮。当用户选择一个按钮时，他们将进入下一步： 动作或另一个选项菜单。


选项菜单和动作都可在模板面板中使用。

 


 

要添加选项菜单，可将其拖到画布上，为其命名，然后从按钮列表中选择或添加所需的按钮。


要添加新按钮，请键入所需按钮名称并按 Enter 键。

 


 

然后，将所需的动作从模板面板拖到画布上。


现在，将选项菜单中的特定按钮连接到动作。


您可以从已定义和可用的 20 个默认动作中进行选择，也可以从头开始创建一个新的自定义动作。

 

 


 

明确定义两个节点后，将按钮与相应的动作连接起来。


选项菜单中的任何选项都会指向工作流程中的按钮：


按钮 > 动作> 用户输入 > 输出节点 > 进一步帮助


现在，每个节点都可以根据需要重新命名。但要使带动作的按钮在工作流程中有效，它必须遵循以下顺序。

 

创建新的自定义动作

 

单击自定义动作旁边的 +，然后使用以下说明填写显示的页面


使用以下指引创建自定义函数。

 

字段

描述

动作名称


为动作提供一个适当的名称，以便于识别。

作为类型查看


在视图类型下，从列表、计数、一览或信息中进行选择

如名称所示，这些都是向用户显示消息的不同方式。

 

作为模块查看


从下拉菜单中选择所需的模块。

函数名称和返回类型

 


提供函数名称，并从下拉菜单中选择返回类型。

描述


提供一个描述，说明对该自定义功能的需求。

API 名称

 


确保提供所调用函数的完整 API 名称，并确保该名称是唯一的，且未在任何其他自定义函数中使用。

参数


在继续定义自定义函数之前，请添加所需的参数。 使用 + 图标添加更多参数。

 

定义参数后，使用 Deluge 脚本编辑器定义自定义函数，如下图所示：

 


 

然后，点击保存或保存并测试完成自定义函数的创建。

最后，完成工作流程并单击保存。

只保存经过验证的工作流程。
如果工作流程未保存，请检查以下内容：
  • 无效或未连接的动作或选项菜单节点
  • 按钮连接无效或不完整
  • 无效连接器
  • 按钮输出端的连接器已连接到另一个节点
  • 连接到已连接的节点

列表视图

 

选择列表视图时，Zia Bot 中的详细信息将以列表形式显示，如下所示：


在列表视图的自定义函数中可以使用的代码如下：

 

response = invokeurl

[

url: "http://sdp-cart-w10:8080/api/v3/requests"

type: GET

parameters: {"TECHNICIAN_KEY":"EF55D735-98CC-46BD-BACE-498C4513553B"}

];

return response;

 

在编写列表视图的代码时，请注意以下几点：

  1. 确保在 deluge 脚本中使用 API

  2. 确保返回完整的 API 响应。

  3. 如果在自定义函数中使用了硬编码用户的 TECHNICIAN_KEY，则 API 响应将基于该用户的范围。由于响应将通过 Zia Bot 显给所有用户，这可能会违反用户范围的安全规则。

  4. 为避免出现这种情况，请使用 context.get(“TECHNICIAN_KEY”) 参数来获取相应用户的 TECHNICIAN KEY。

计数视图

选择 "计数视图 "时，Zia Bot 中的详细信息将显示为数字或计数，如下所示：

 


 

显示项目任务计数或数量的示例代码如下：

 Copy to clipboardCopy to clipboardCopy to clipboard

input_data = {"list_info":{"get_total_count":true}};

response = invokeurl

[

url: "http://sdp-cart-w10:8080/api/v3/projects/" + projectID + "/tasks"

type: GET

parameters: {"input_data":input_data,"TECHNICIAN_KEY":"EF55D735-98CC-46BD-BACE-498C4513553B"}

];

return response;

在应用程序接口的输入数据中，list_info 必须具有 "get_total_count "属性，以获得将在 Bot 中显示的输出计数。

一览视图

选择一览视图时，Zia Bot 中将以摘要形式显示详细信息，如下所示：

 


 

在一览视图的自定义函数中可以使用的代码如下：

response = invokeurl

[

url: "http://sdp-cart-w10:8080/api/v3/problems/" + problemID

type: GET

parameters: {"TECHNICIAN_KEY":"EF55D735-98CC-46BD-BACE-498C4513553B"}

];

return response;

信息视图

在此视图中，自定义回复将显示为消息。要提供自定义回复，可在 Zia 机器人工作流程中配置动作和按钮，并使用 Zia 的自定义功能添加必要信息。


Zia 机器人工作流程中的动作和按钮将收集准确的用户需求，而 Zia 中配置的自定义功能将提供个性化的用户回复。

用例

  • 要提供任何联系方式，例如空调维护，可以在自定义函数中保存分机号码，作为对用户查询的回复。

示例代码

插入以下自定义功能代码，并作出您所需的响应。

return {"display_message": 4537889};

Zia Bot 的回复


 一些额外的使用案例：

  • 预订会议室 - 将网站链接保存为回复

  • 请求休假 - 将网站链接保存为回复

  • 年度假期 - 以表格形式保存和显示假期

 

除了直接提问外，您还可以通过 Zia 执行某些其他操作。 下面是更新请求主题的示例代码。

 

input_data = {"request":{"subject": newsubject}};

response = invokeurl

[

url: "http://sdp-cart-w10:8080/api/v3/requests/" + requestid

type: PUT

parameters: {"input_data":input_data,"TECHNICIAN_KEY":"EF55D735-98CC-46BD-BACE-498C4513553B"}

];

displayMessage = "Problem while updating the request's subject" ;

if(response.get("response_status").get("status") == "success") {

displayMessage = "Successfully updated the request subject";

}

info response;

return {"display_message": displayMessage};

 

在 "display_message"（显示消息）键上设置您希望在机器人窗口中显示的信息。


如果未设置输出字符串，机器人窗口中将显示整个 JSON 响应。