本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 楼宇自动化
<a name="building-automations"></a>

Amazon Quick Automate 提供了多种创建自动化的方法，以满足不同的需求和技能水平。本节介绍可用的创建方法和工具。

## 先决条件
<a name="building-prerequisites"></a>

在创建自动化之前，您需要在特定的自动化组中创建一个项目。自动化组将控制您在构建自动化时可用的集成和凭据。确保为计划在自动化中与之交互的任何外部系统设置所需的集成和凭据。

创建项目后，单击 “**开始构建**” 按钮即可开始构建。

**注意**  
您必须拥有所有者权限才能管理自动化组的集成和证书。

## 创建方法
<a name="creation-methods"></a>

从三种方法中进行选择来构建自动化。如果您不熟悉 Amazon Quick Automate，我们建议：
+ 首先探索示例自动化
+ 尝试使用自然语言创建简单的自动化
+ 熟悉基础知识后，可以尝试手动编辑

### 使用示例自动化
<a name="using-sample-automations"></a>

探索演示常见自动化模式的预建示例，快速入门。这些示例提供了不同自动化功能的实际示例，可作为学习资源，帮助您熟悉 Amazon Quick Automate 的功能。要使用示例自动化，请执行以下操作：
+ 按行业搜索不同的样本。
+ 单击示例查看自动化的概述。
  + 如果需要任何集成，它们将被列为先决条件。
+ 单击 “**从示例开始**”，在画布中打开自动化。
+ 现在，您将能够查看、编辑和测试自动化。

### 用自然语言创作
<a name="creating-with-natural-language"></a>

自动化助手提供了一种通过 AI-powered 以下方式创建自动化的方法：
+ 聊天界面-用自然语言以对话方式描述您的流程
+ 文件上传-导入描述您的流程步骤和要求的所有文档

当您通过任一方法提供输入时，自动化助手将通过两步引导式体验生成您的自动化：
+ **High-level 计划**
  + 首先，助手会分析您的需求并生成高级自动化计划。该计划由**流程步骤组成，这些步骤**对作为自动化一部分的相关操作进行逻辑分组。每个流程步骤最初都包含自然语言指令。
  + 查看并编辑每个处理步骤的说明，然后单击 “**生成**” 为该步骤创建低级操作。
+ **Low-level actions**
  + 接下来，Assistant 将根据步骤说明构建低级操作和流程逻辑。
  + 查看和编辑生成的操作。单击 “**运行**” 或 “**调试**” 开始测试。

提供自然语言输入的最佳实践：
+ 像培训新员工一样指定分步流程
+ 包括执行每个步骤所需的确切细节：
  + 发送消息时的电子邮件地址
  + 文档的文件名和位置 uploading/downloading 
  + 导航到网站时的网址

### 从头开始创建（空白自动化）
<a name="creating-from-scratch"></a>

使用可视化设计器界面手动生成自动化：
+ 导航到您的项目摘要
+ 单击 “**开始构建**”
+ 选择 “**跳过**” 以访问画布

设计器界面提供了几个关键组件：
+ **画布**-可视化自动化。您可以在画布上放大和缩小、展开和折叠流程步骤以及对操作进行重新排序。
+ **操作面板**-动作面板包含您的自动化组中可用的所有自动化操作的完整列表。您可以搜索和筛选以查找按类别（代理、流程流、Web 浏览器等）组织的操作。 Drag-and-drop 在画布上执行操作以构建您的自动化。您也可以单击鼠标悬停在操作之间时找到的加号，直接在画布上添加新动作。
+ **属性面板**-添加动作或单击流程中的现有动作后，属性面板允许您配置控制该动作的行为方式的输入和输出参数。
+ **设置面板**-允许您创建和编辑运行时配置，并浏览可用于自动化的凭据。
+ **变量面板**-显示自动化中使用的所有变量。通过直接在自动化中添加新引用，可以无缝创建变量。

## 运行时配置和变量
<a name="runtime-configurations-variables"></a>

运行时配置允许您创建易于编辑的设置，供自动化系统使用。运行时配置的示例包括：
+ 网站网址
+ 文件名和位置
+ 电子邮件配置，例如主题和发件人列表

当自动化运行时，变量用于在自动化中的操作之间存储和传递信息。只需在输出属性中提供新的引用名称，即可为自动化添加新变量。常见的变量类型包括：
+ 字符串-纯文本（例如，名称、描述）
+ 数字-数值（例如，数量、分数）
+ 布尔值- True/False 值
+ 数组-项目集合或列表
+ 对象- Key-value 成对
+ 文件-文档和媒体（例如 PDF、图像）
+ 数据表-包含行和列 Spreadsheet-like 的数据

## 编辑自动化
<a name="editing-automations"></a>

创建自动化后，您可以使用 “自动化助手” 或直接在画布上进行编辑，对其进行修改。

### 使用自动化助手
<a name="using-automation-assistant"></a>

自动化助手可帮助您通过自然语言进行更改。你可以：
+ 询问整个自动化、具体步骤或具体操作的更新
  + 首先选择具体步骤，将聊天重点放在具体步骤上
+ 根据实际自动化，提出问题并获得产品内帮助和建议
+ 寻求帮助，根据您的需求编写表达式和代码

要使用助手进行编辑，请执行以下操作：
+ 在工具栏中单击 “**使用助手构建**”
+ 描述您要进行的更改
+ 查看并确认建议的修改
  + 聊天中包含更改摘要。单击 “**拒绝更改**” 以恢复到先前版本。
+ 测试更新的自动化

### 在画布上编辑
<a name="editing-on-canvas"></a>

直接在视觉设计器中进行更改：
+ 选择要修改的步骤或操作
+ 使用属性面板调整设置
+ 使用拖放功能重新排列步骤

**注意**  
每个动作都有一个选项菜单，其中包含常用操作，例如复制操作或删除动作。

**编辑的最佳实践：**
+ 进行增量更改
+ 每次重大修改后都要进行测试

**注意**  
更改会自动保存到上线版本。如果要部署这些更改，请提交并部署更新后的版本。

**提示**  
如果您在构建时遇到问题：  
使用自动化助手获取帮助
查看操作文档以了解具体要求

## 自动化输入和输出
<a name="automation-inputs-outputs"></a>

定义输入和输出架构，在 Amazon Quick Automate 中创建可重复使用的参数化自动化。通过使用 “开始” 和 “结束” 节点定义输入和输出架构，您可以将静态自动化转换为可重复使用的工作流程，每次运行时都接受不同的数据。您可以定义在运行时提供的键入输入参数和在自动化完成时捕获的结构化输出值，而不是硬编码值。输入和输出适用于所有调用方法：手动运行、API 调用和计划触发器。

使用输入和输出的主要好处：
+ **可重用性-使用**不同的数据运行相同的自动化，而无需修改自动化本身。
+ **类型安全** — Amazon Quick Automate 会在执行开始之前根据架构验证输入数据，从而防止运行无效数据。
+ **API 集成** — Auto-generated 架构支持编程发现和与外部系统的集成。
+ **可观察性** — 结构化输出被捕获为执行工件以供审计和审查。

### 支持的数据类型
<a name="automate-supported-data-types"></a>

输入和输出字段支持以下数据类型：
+ **文本**-纯文本值（例如，text1、text2）
+ **数字-包括小数的数值（例如 3.14、100）**
+ **布尔值**-真值或假值
+ **文件**-最大大小为 5 MB 的文件对象

### 开始和结束节点
<a name="start-and-end-nodes"></a>

每个自动化都包括一个 “开始” 节点和一个 “结束” 节点，默认情况下它们为空。您可以编辑这些节点来创建架构，使用自动化中的输入，并更新输出数据以从自动化中返回。“开始” 节点在运行时接收输入数据，而 “结束” 节点（包括 “结束进程” 节点）在执行期间收集输出数据，并在自动化完成时将其作为结构化构件返回。

#### 晚于
<a name="start-node"></a>

“开始” 节点是触发自动化时接受输入参数的入口点。默认情况下，它为空。

属性：
+ **输入格式**-定义自动化接受的输入参数的架构。使用定义输入和输出架构中所述的输入架构编辑器进行编辑。
+ **输入变量**-存储自动化输入值的变量，该值在输入格式中定义并由用户提供。

#### 早于
<a name="end-node"></a>

“结束” 节点是在自动化成功完成时收集并返回输出值的终止点。您可以使用 “结束” 节点的属性设置自动化中变量的输出值。根据自动化的结构，您的自动化可以有多个结束节点（结束进程）。

属性：
+ **输出格式**-定义自动化返回的输出参数的架构。选择 **“编辑”**，然后使用定义输入和输出架构中所述的输出架构编辑器添加或修改架构。
+ **输出数据**-将自动化中变量的值映射到您定义的输出字段。对于您在结束节点（输出架构）中创建的每个输出变量，请指定包含要返回的数据的自动化变量。使用**编辑输出数据**编辑器在**输出值**字段中配置这些映射。

### 定义输入和输出架构
<a name="defining-input-output-schemas"></a>

架构定义了您的自动化接受为输入并作为输出生成的数据结构。创作工作室提供了一个可视化表单生成器，用于直接在自动化画布上定义输入和输出架构。

要定义输入架构，请执行以下操作：
+ 在 Amazon Quick Automate 中打开自动化。
+ 在画布上选择 “**开始**” 节点以打开架构编辑器。您也可以从属性窗格中打开架构编辑器。为此，请选择 “**开始**” 节点，然后在属性窗格中选择 **“以**输入格式**编辑**”。
+ 选择 **\+添加字段**以添加输入字段。
+ 对于每个输入字段，配置以下属性：
  + **名称**-字段的唯一标识符。
  + **类型**-字段接受的数据类型。有关更多信息，请参阅支持的数据类型。
  + **必填**字段-运行自动化时是否必须提供该字段。
  + **默认值**（可选）-只有清除 “**必填**” 字段后，此选项才处于活动状态。当您运行测试或触发自动化时，默认值会预先填充在输入表单中。
  + **描述**-对字段所代表内容的描述。
+ 选择 “**保存**” 以将架构与您的自动化一起存储。

要定义输出架构，请执行以下操作：
+ 在画布上选择 “**结束**” 节点以打开输出架构编辑器。您也可以从属性窗格中打开架构编辑器。为此，请选择 “**结束**” 节点，然后在属性窗格中选择 **“以**输出格式**编辑**”。
+ 选择 **\+添加字段**以添加输出字段。
+ 对于每个输出字段，配置以下属性：
  + **名称**-字段的唯一标识符。
  + **类型**-输出的数据类型。
  + **描述**-对输出所代表内容的描述。
+ 选择**保存**。

**注意**  
您可以从 “开始” 节点定义输入和任何 “结束” 节点的输出。如果您的自动化有多个结束节点，则添加或修改一个终端节点的架构会修改所有终端节点架构。

### 使用起始节点的输入值
<a name="using-input-values"></a>

当您的自动化在 “开始” 节点上定义了输入架构时，您可以使用`inputs`字典在整个工作流程中访问这些输入值。运行时会自动验证并使用自动化运行时提供的值填充此字典。

```
# Access required input fields
value = inputs["field_name"]

# Example usage
customer_id = inputs["customer_id"]  # Retrieves a required string input
```

### 在 “结束” 节点中设置输出值
<a name="setting-output-values"></a>

“结束” 节点定义自动化中的哪些值作为输出返回。您可以使用 O **utput Data** 属性进行配置，该属性为在编辑器中设置输出值提供了两种交互模式。通过选择 “**输出值**” 字段旁边的代码图标 (`</>`) 在模式之间切换。

两种设置输出的模式：
+ **变量选择模式（下拉列表）**-默认界面显示自动化中所有可用变量的下拉列表。选择要分配给每个输出字段的变量。
+ **表达式模式（代码）**-选择任何输出值字段旁边的代码图标 (`</>`) 以切换到表达式模式。此模式允许您输入自定义表达式、执行计算、访问嵌套数据或设置文字值。

### 使用 “使用助手构建” 定义架构
<a name="defining-schemas-with-assistant"></a>

使用 Assistant 构建可以直接创建或修改输入和输出架构。用自然语言描述您的输入和输出要求，助手会为您生成架构定义。助手所做的任何更改都会自动与 Studio 可视化表单生成器同步。

### 注意事项
<a name="inputs-outputs-considerations"></a>

使用自动化输入和输出时，请记住以下几点：
+ 输入和输出架构是可选的。没有架构的现有自动化继续保持不变。
+ 文件输入的最大大小为 5 MB。对于较大的文件，请改为将文件位置（例如 Amazon S3 路径）作为文本输入传递。
+ 为了便于观察和审计，每次执行时都会存储输入和输出值。
+ 更新架构时，必须重新部署自动化才能使更改在已部署的运行中生效。测试运行始终使用最新的草稿架构。

您可以通过以下方式使用输入和输出值：
+ 在画布上测试和运行自动化。有关更多信息，请参阅[测试自动化。](https://docs.aws.amazon.com/quicksuite/latest/userguide/testing-automations.html#running-and-debugging)
+ 手动触发已部署的自动化。有关更多信息，请参阅[部署自动化。](https://docs.aws.amazon.com/quicksuite/latest/userguide/deploying-automations.html#deploy-run-inputs-outputs)
+ 已部署自动化的计划触发器。有关更多信息，请参阅[部署自动化。](https://docs.aws.amazon.com/quicksuite/latest/userguide/deploying-automations.html#deploy-run-inputs-outputs)

## 管理自动化版本
<a name="managing-automation-versions"></a>

Amazon Quick Automate 提供版本控制功能，可帮助您跟踪和维护自动化系统的更新历史记录，并轻松恢复以前的版本。

### 重要概念
<a name="version-key-concepts"></a>
+ **实时版本**-可在画布中编辑的自动化的当前工作副本。编辑时，更改会自动保存到上线版本。
+ **已提交版本**-可以部署的自动化的 Read-only 快照。提交新版本的自动化以跟踪重要更新，并在需要时能够恢复。
+ **已部署的版本**-可以部署和激活已提交的版本以按计划运行。

**注意**  
每个版本都保留自己的运行时配置值。对 Live 版本运行时设置的更改不会影响之前提交或部署的版本。

### 提交版本
<a name="committing-versions"></a>

要提交版本，请执行以下操作：
+ 在画布工具栏中单击 “**提交**”
+ 添加描述性备注，解释您的更改
+ 选择如何增加版本号：
  + 次要版本（例如，1.05 → 1.06），用于较小的更新（默认）
  + 主要版本（例如，1.0 → 2.0），用于进行重大更改
+ 单击 “**提交**”

**重要**  
如果自动化存在任何验证错误，则无法提交版本。在尝试提交之前，请先解决所有错误。

当你提交一个版本时：
+ 提交的版本变为只读快照
+ 当前运行时配置与提交的版本一起保存
+ 将根据该快照创建新的 Live 版本以继续编辑

**重要**  
只能部署已提交的版本。必须先提交 Live 版本，然后才能进行部署。

### 查看版本
<a name="viewing-versions"></a>

在两个地方查看版本：
+ **画布中的版本下拉列表**-默认为上线版本。从下拉列表中选择任何以前的版本，以只读模式在画布上查看。
+ **“版本” 选项卡**-可在项目详细信息中找到。显示完整的版本历史记录，包括版本号、版本提交时间、提交版本的用户以及任何版本说明。单击操作菜单以查看版本详细信息或部署版本。

### 还原早期版本
<a name="restoring-previous-versions"></a>

要恢复先前版本并继续将其编辑为 Live 版本，请执行以下操作：
+ 从画布上方的版本下拉列表中选择版本
+ 选择 “**恢复实时版本**”
+ 所选版本将取代您当前的 Live 版本
+ 继续编辑 Live 版本以进行任何必要的调整
+ 提交为新版本以拍摄快照或部署更新

**注意**  
恢复版本会创建新的工作副本，但不会删除任何版本历史记录。

### 最佳实践
<a name="version-best-practices"></a>
+ 添加清晰的版本注释以跟踪更改的目的
+ 在重大更新后提交版本
+ 在提交之前测试更改
+ 提交前请查看运行时配置