配置 CX 协同应用

CX 助手可以按原样使用，也可以根据业务需求进行自定义。本节使用示例应用程序来举例说明一些设置，并介绍如何配置 CX 协作。

先决条件

• CX Companion 要求在已部署的文件夹中设置 Serverless 或 Unattended Robot。
• 我们建议在外部事件模式下使用 CX 合作伙伴，但请注意，为便于使用，默认情况下会启用查询参数模式。有关更多详细信息，请参阅下面的配置数据输入模式一节。使用外部事件时：
  • 要与 Salesforce 集成，请在 Salesforce 中安装并配置 CX 配套 SF 插件。
  • 要与其他主机平台集成，请在主机应用程序中安装并配置UiPath 通信驱动程序。
• 要在有人值守模式下运行操作，CX 助手需要 UiPath Assistant 2025.0.167 版或更高版本。
• 如果要从 CX 合作伙伴启动其他应用程序，则必须使用 Integration Service 中的Apps 连接器。确保将组织的监管策略配置为允许使用此连接器：
  • 由于此连接器当前仅提供预览版，因此您必须在组织中部署的 Studio Web 监管策略中选择“启用预览包和活动”选项。这使“列出已部署的应用程序”活动可在工作流中使用。有关更多信息，请参见 Automation Ops 指南中的Studio Web 策略设置。
  • 确保在您的 Integration Service 策略中启用 Apps 连接器。有关更多信息，请参阅 Automation Ops 指南中的Integration Service 策略设置。

配置数据输入模式

该应用程序可以使用以下其中一种数据输入模式：

• “查询参数” - 如果要作为独立版部署 CX Companion，请使用此选项。为了让您能够快速测试 CX 兼容应用，我们在模板中默认启用此选项。使用查询参数的启动工作流为MainPage_Load_Initiate_Request_QueryParam.xaml 。
• 外部事件- 如果要将 CX 协作伙伴嵌入主机应用程序（例如 Salesforce）中，请使用此选项。使用外部事件的启动工作流为MainPage_Initiate_Request.xaml 。这是推荐选项，但在模板中默认不启用。要使用此选项，请执行以下操作：

  • 在 CX 协同应用程序设计器中- 在应用程序属性面板中，确保已启用外部事件，然后在允许的来源文本框中添加主机应用程序的域。有关启用外部事件的更多信息，请参阅使用外部事件设置外部上下文。

    

  • 在 CX 协同应用程序设计器中- 通过在工作流文件中打开Data Manager来禁用查询参数模式

    MainPage_Load_Initiate_Request_QueryParam.xaml并将变量ConfigEnableQueryParamMode设置为False 。默认值为True 。
  • 在主机应用程序- 对于 Salesforce 中，安装并配置CX 合作伙伴 SF 插件。对于所有其他主机应用程序，安装并配置UiPath 通信驱动程序。

配置 360 流程（可选）

解决方案中包含模拟 360 流程，应用程序调用该流程，以从主机应用程序检索客户数据。您可以根据需要自定义此流程或创建另一个流程，将其发布到 Orchestrator，并通过从启动工作流的“调用流程：启动 360 Process”活动中选择并根据需要配置所需参数来配置 CX 助理页面。

为操作配置文件夹

操作是指发布到 Orchestrator 且用户可以运行的自动化、应用程序和智能体。CX 关联配置为根据输入对象类型具有不同的操作文件夹。例如，在示例应用程序中定义了两种类型，即“案例”和“帐户” 。只要 Orchestrator 中的文件夹结构与应用程序中的配置匹配，在应用程序中加载特定类型的记录时，“操作”面板就会填充为该类型定义的文件夹中的操作。

1. 在数据输入模式下启动工作流中打开数据管理器。
2. 在ConfigAutomationsRootFolderPath变量的值字段中输入自动化根文件夹路径。例如，示例应用中的CXCompanionAutomations/AllActions 。
3. 在ConfigAutomationFoldersByType变量中配置自动化类型。在此字典变量中，每个键都是一个对象类型，它的值是 Orchestrator 子文件夹的名称，该子文件夹包含该对象类型的自动化。

   在示例应用程序中，变量配置如下：

   密钥	值
   Case 分支	案例自动化
   帐户	帐户自动化

   这对应于 Orchestrator 中的以下文件夹结构。

   

   在应用程序的“操作”面板中，显示对象类型的操作，并用一个选项卡表示在该类型的文件夹中找到的每个子文件夹。

   
4. 配置是否在可用操作中包含已部署的应用程序：
   • 如果您使用的是查询参数模式，并且还想启动已部署的应用程序，请通过添加 UiPath Apps 连接，在MainPage_Load_Initiate_Request_QueryParam.xaml和MainPage_Initiate_Request.xaml中配置“列出已部署的应用程序”活动。
   • 如果您正在使用外部事件模式，并且还想部署应用程序，请在MainPage_Initiate_Request.xaml中配置“列出已部署的应用程序”活动，方法是添加 UiPath Apps 连接，然后删除或禁用“假设条件：加载应用程序列表”活动。如果在MainPage_Load_Initiate_Request_QueryParam.xaml中启用了，则删除或禁用。
   • 如果您不打算从 CX 合作伙伴部署应用程序，请删除或禁用活动假设条件：加载应用程序列表（在两个启动工作流中均已启用） 。

5. 部署解决方案后：

   1. 转到部署应用程序的文件夹并进行编辑。
   2. 在“包要求”页面上，选择连接配置。
   3. 如果您希望所有用户使用相同的连接，请选择该连接。如果您想允许应用程序用户创建自己的连接，请选择“可由用户配置” ，以提示用户在首次加载应用程序时创建连接。

注意：您可以使用示例模拟自动化测试应用程序。

以 Attended 或 Unattended 模式运行

CX Companion 要求在已部署的文件夹中设置 Serverless 或 Unattended Robot。

要以 Unattended 或 Serverless 模式运行操作，在部署应用程序后，您可以在主机环境中使用 URL，而无需其他配置。

如果您需要在有人值守模式下运行某些操作，则必须通过将查询参数附加到应用程序 URL 来以有人值守模式运行应用程序:

• 在 Salesforce 中使用 CX 助理时，请附加attendedMode=enabledWithRobotJSHandler 。
• 在另一个第三方系统中使用 CX 协作伙伴时，请附加attendedMode=enabled 。

确保 Assistant 正在运行，并且已连接到部署应用程序的同一个租户。使用 CX 合作伙伴需要 Assistant 2025.0.167 或更高版本。

默认情况下，即使应用程序在有人值守模式下运行，所有操作也只会在无人值守模式下运行。要在有人值守模式下运行操作，请将操作标记为有人值守，或将标签Attended添加到部署到 Orchestrator 的流程中。

将应用程序配置为使用单一类型的对象

如果你不想根据不同的对象类型（例如案例和帐户），您可以将其配置为使用单个对象类型：

1. 删除了启动工作流中ConfigInputDataObjectTypeKeyName变量的默认值。
2. 从启动工作流的ConfigRequiredInputProperties变量中删除Type 。
3. 启动工作流中ConfigQueryParameterNameMap变量中的远程Type键值对。
4. 在启动工作流的ConfigAutomationsRootFolder变量中设置根文件夹名称。
5. 如果根文件夹位于顶层，则可以删除ConfigAutomationsRootFolderPath中的值。如果它处于嵌套级别，则在此变量中设置根文件夹路径。
6. 根据需要自定义 360 面板。有关详细信息，请参阅下面的 其他自定义 部分中 360 面板中显示的数据 。“切换案例”块可以删除，并保留“分配值”活动集。此外，如果适用，请将 360 面板容器的隐藏属性更新为仅基于show360Spinner ，而不基于类型。

操作输入

输入表单是根据输入参数动态创建的。该表单目前仅支持以下原始类型：文本、数字、布尔值、仅日期。如果传递任何其他类型的参数，系统将显示一个文本框。对于基于日期的输入，不要使用“日期时间”，而要使用“仅日期”来获取日期选取器控件。

操作输出

所有操作输出参数都显示在自动化追踪器中，并以参数名称作为标题。输出参数的值可以是纯文本或 HTML。收到的任何其他复杂类型数据将以字符串格式显示。

自动化追踪器支持复制到剪贴板。可以将以下三个选项之一添加到元素，并且该元素将获得复制图标：

• data-copyable="true" - 复制元素的文本内容。
• class="copyable" - 复制元素的文本内容。
• data-copy-text="custom text" - 复制指定的自定义文本。

嵌入应用程序

可以从部署过程结束时显示的对话框中复制应用程序 URL。或者，在部署应用程序后，导航至“Orchestrator” > “自动化” > “[folder_name]” ，然后单击应用旁边的“更多选项” ，然后选择“复制 URL” 。

有关更多信息，请参阅发布、部署和升级应用程序项目以及管理应用程序。

在主机应用程序的 iframe 中嵌入应用程序时，请在 URL 中包含embed_ ，以允许通过弹出窗口登录。对于外部事件模式，请包括查询参数target并将域名设置为值，例如&target=https://www.example.com 。例如： https://cloud.uipath.com/embed_/appsdev/apps_/default/run/production/22986e36-8b04-4593-b82f-aae4c14bb2dc/bd8c8ef5-a94a-43f5-9a5b-6df73d8f7aa6/IDc0b72c47295b49abaea6b701cfa5b730?el=VB&uts=true&target=https://www.example.com

其他自定义项

大多数自定义都可以通过编辑应用程序工作流文件中的变量来完成。可以更改名称以Config开头的变量，以自定义应用程序。在某些情况下，还必须更新活动。

• 唯一的键名称- 在外部事件模式下，输入请求对象可以具有多个属性，而在查询参数模式下，可能会发送多个查询参数作为输入。必须在启动工作流的ConfigInputDataObjectUniqueKeyName变量中配置保存唯一标识符的属性（例如 ）。在示例应用程序中， Id是用于唯一标识当前请求的属性名称。此唯一值还用于维护操作执行结果。
• 输入类型键名称- 要允许根据请求类型配置不同的根文件夹，应用程序需要知道保存对象类型的属性名称。必须在启动工作流的ConfigInputDataObjectTypeKeyName变量中配置保存唯一标识符的属性（例如 ）。在示例应用程序中， Type是属性名称。如果您没有不同类型的对象，请删除此变量中的值。
• 启动所需的属性- 如果启动 360 度流程需要任何必需输入，请在启动工作流的ConfigRequiredInputProperties变量中指定这些属性。如果定义的必需属性没有值，则系统会在运行时引发错误消息，并且后续活动不会运行。配置此变量时，请考虑：
  • 必须将唯一密钥名称添加到集合中。
  • 如果没有不同类型的对象，则不应在集合中包含输入类型键值名称。
  • 将任何其他所需属性添加到集合中。
• 配置查询参数：- 在查询参数模式下，将提取MainPage_Load_Initiate_Request_QueryParam.xaml中ConfigQueryParameterNameMap变量中的参数值，并将其设置为输入对象。在此字典中，键是输入对象中的属性名称，值是查询参数名称。
• “360”面板中显示的数据- 这是通过直接设置每个项目的值来配置的。在示例应用程序中，提供两组，一组用于“案例”类型，另一组用于“帐户”类型。当显示一组时，另一组会根据类型隐藏。标签是静态的，可根据需要更改。
  • 在活动“Try Catch 异常处理：” 中启动工作流的 360面板中设置相应的控件值。在此块中，“切换”用于根据类型进行配置。使用此块可根据输入对象数据设置值。
  • 要将 360 流程中的数据设置为在 360 面板中显示，请使用活动Try Catch：在启动工作流的 360 面板中设置流程中的 360 数据，并根据需要配置值。
• 隐藏 360 度面板- 要对应用程序隐藏 360 度面板，请在启动工作流中将变量ConfigHide360Panel设置为True 。即使面板处于隐藏状态，系统仍会执行 360 流程，并在运行操作时使用值来预填充表单中的输入参数。
• 将输入属性映射到操作输入参数- 来自外部事件、查询参数和 360 流程的值可用于在执行操作之前预填充显示的输入表单。默认情况下，如果操作参数名称与任何输入对象属性名称或 360 输出属性名称匹配，则系统会预填充值。您可以在ActionListPage_StartActionButton_click.xaml工作流中使用以下变量配置其他值：
  • ConfigInputArgumentsInputObjectPropertyMap - 字典，其中键是操作输入参数名称，值是输入对象属性名称。输入对象根据查询参数或来自外部事件的消息创建。
  • ConfigInputArgumentsDat360ObjectPropertyMap - 字典，其中键是操作输入参数名称，值是 360 输出参数名称。
• 启用基于上下文的操作筛选- 默认情况下，始终列出所有请求类型的所有操作。使用此选项，您可以根据当前请求上下文显示相关操作。要将其启用：
  1. 在MainPage_Action_Folder_Change.xaml工作流中，将ConfigEnableContextFiltering变量设置为True 。
  2. 将ConfigContextFilteringPropertyName值设置为 360 流程对象中的属性名称，该对象必须与操作标签匹配。
  3. 向 Orchestrator 中的已部署操作添加标签。为您希望始终可用（无论操作类型如何）的操作添加Common标签。
  4. 对于仅适用于特定请求类型的其他操作，请根据需要添加标签。当标签值与步骤 2 中配置的属性值匹配时，系统将显示操作。可以将多个标签添加到单个操作，以列出多种请求类型的操作。
  5. 如果您使用的是查询参数模式，请同时配置MainPage_Load_Initiate_Request_QueryParam.xaml工作流中步骤 1 和 2 中提到的变量。

限制和解决方法

• 用于显示操作列表的自定义列表控件无法根据可用空间展开。配置此控件的高度，以适应最常用的屏幕尺寸。

  
• 自定义列表中的每一行具有固定高度。如果操作名称或说明过长，系统可能会将其截断。使用较短的名称和说明，以便更好地对齐。
• 无法使用调试选项测试外部事件工作流。要进行测试，您必须在主机环境中部署并集成应用程序。