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

# 自动化操作参考
<a name="automations-actions-reference"></a>

以下是 App Studio 中使用的自动化操作的参考文档。

自动化操作，通常称为**操作**，是构成自动化的单个逻辑步骤。每个操作都会执行特定的任务，无论是发送电子邮件、创建数据记录、调用 Lambda 函数还是调用。 APIs操作通过操作库添加到自动化中，并且可以分组为条件语句或循环。

有关创建和配置自动化及其操作的信息，请参阅中的主题。[自动化和操作：定义应用程序的业务逻辑](automations.md)

## 调用 API
<a name="automations-actions-reference-invoke-API"></a>

调用 HTTP REST API 请求。构建者可以使用此操作将请求从 App Studio 发送到其他系统或服务 APIs。例如，您可以使用它连接到第三方系统或本土应用程序以访问关键业务数据，或者调用 App Studio 专用 App Studio 操作无法调用的 API 端点。

有关 REST 的更多信息 APIs，请参阅[什么是 RESTful API？](https://aws.amazon.com/what-is/restful-api/) 。

### Properties
<a name="automations-actions-reference-invoke-API-properties"></a>

#### Connector
<a name="automations-actions-reference-invoke-API-properties-connector"></a>

用于此操作发出的 API 请求的**连接器**。连接器下拉列表仅包含以下类型的连接器：`API Connector`和`OpenAPI Connector`。根据连接器的配置方式，它可能包含重要信息，例如凭据和默认标头或查询参数。

有关 API 连接器的更多信息，包括使用`API Connector`和之间的比较`OpenAPI Connector`，请参阅[Connect 连接到第三方服务](add-connector-third-party.md)。

#### API 请求配置属性
<a name="automations-actions-reference-invoke-API-properties-request-config"></a>

从属性面板中选择**配置 API 请求**以打开请求配置对话框。如果选择了 **API 连接器**，则对话框将包含连接器信息。

**方法：**API 调用的方法。可能值如下所示：
+ `DELETE`：删除指定资源。
+ `GET`：检索信息或数据。
+ `HEAD`：仅检索不带正文的响应标头。
+ `POST`：提交待处理的数据。
+ `PUSH`：提交待处理的数据。
+ `PATCH`：部分更新指定资源。

**路径：**资源的相对路径。

**标头：**与 API 请求一起发送的键值对形式的任何标头。如果选择了连接器，则其配置的标头将自动添加且无法删除。无法编辑配置的标题，但您可以通过添加另一个同名的标题来覆盖它们。

**查询参数：**任何要与 API 请求一起发送的键值对形式的查询参数。如果选择了连接器，则会自动添加其配置的查询参数，且无法对其进行编辑或删除。

**正文：**与 API 请求一起发送的信息，采用 JSON 格式。没有受理`GET`请求的机构。

#### 模拟输出
<a name="automations-actions-reference-invoke-API-properties-mocked-output"></a>

在预览环境中，操作不会与外部服务或资源交互。**Mocked 输出**字段用于提供一个 JSON 表达式，该表达式可模拟连接器在预览环境中的行为，以用于测试目的。此代码段存储在操作`results`的地图中，就像连接器响应在实时环境中发布的应用程序一样。

使用此字段，您可以测试各种场景及其对自动化中其他操作的影响，例如模拟不同的结果值、错误场景、边缘案例或不愉快的路径，而无需通过连接器与外部服务进行通信。

## 调用 AWS
<a name="automations-actions-reference-invoke-aws"></a>

从服务调用操作。 AWS 这是调用 AWS 服务或操作的一般操作，如果没有针对所需 AWS 服务或操作的专用操作，则应使用此操作。

### Properties
<a name="automations-actions-reference-invoke-aws-properties"></a>

#### 服务
<a name="automations-actions-reference-invoke-aws-properties-service"></a>

包含要运行的操作的 AWS 服务。

#### 操作
<a name="automations-actions-reference-invoke-aws-properties-operation"></a>

要运行的操作。

#### Connector
<a name="automations-actions-reference-invoke-aws-properties-connector"></a>

用于此操作运行的操作的连接器。配置的连接器应使用运行操作的正确凭据以及其他配置信息（例如包含操作中引用的任何资源的 AWS 区域）进行设置。

#### 配置
<a name="automations-actions-reference-invoke-aws-properties-configuration"></a>

运行指定操作时的 JSON 输入。有关配置 AWS 操作输入的更多信息，请参阅[适用于 JavaScript 的 AWS SDK](https://docs.aws.amazon.com/sdk-for-javascript)。

## 调用 Lambda
<a name="automations-actions-reference-invoke-lambda"></a>

调用现有的 Lambda 函数。

### Properties
<a name="automations-actions-reference-invoke-lambda-properties"></a>

#### Connector
<a name="automations-actions-reference-invoke-lambda-properties-connector"></a>

用于此操作运行的 Lambda 函数的连接器。配置的连接器应使用访问 Lambda 函数的正确凭证以及其他配置信息（例如包含 Lambda 函数的 AWS 区域）进行设置。有关为 Lambda 配置连接器的更多信息，请参阅。[步骤 3：创建 Lambda 连接器](connectors-lambda.md#connectors-lambda-create-connector)

#### 函数名称
<a name="automations-actions-reference-invoke-lambda-properties-function-name"></a>

要运行的 Lambda 函数的名称。请注意，这是函数名称，而不是函数 ARN（Amazon 资源名称）。

#### 函数事件
<a name="automations-actions-reference-invoke-lambda-properties-function-event"></a>

要作为事件负载传递给 Lambda 函数的键值对。

#### 模拟输出
<a name="automations-actions-reference-invoke-lambda-properties-mocked-output"></a>

在预览环境中，操作不会与外部服务或资源交互。**Mocked 输出**字段用于提供一个 JSON 表达式，该表达式可模拟连接器在预览环境中的行为，以用于测试目的。此代码段存储在操作`results`的地图中，就像连接器响应在实时环境中发布的应用程序一样。

使用此字段，您可以测试各种场景及其对自动化中其他操作的影响，例如模拟不同的结果值、错误场景、边缘案例或不愉快的路径，而无需通过连接器与外部服务进行通信。

## 循环
<a name="automations-actions-reference-loop"></a>

重复运行嵌套操作以遍历项目列表，一次只能遍历一个项目。例如，将该[创建记录](#automations-actions-reference-create-record)操作添加到循环操作中以创建多条记录。

循环操作可以嵌套在其他循环或条件动作中。循环操作是按顺序运行的，而不是并行运行的。循环中每个操作的结果只能访问同一循环迭代中的后续操作。不能在循环之外或循环的不同迭代中访问它们。

### Properties
<a name="automations-actions-reference-loop-properties"></a>

#### 来源
<a name="automations-actions-reference-loop-properties-source"></a>

要迭代的项目列表，一次只能遍历一项。源可以是先前操作的结果，也可以是您可以使用 JavaScript 表达式提供的字符串、数字或对象的静态列表。

##### 示例
<a name="automations-actions-reference-loop-properties-source-examples"></a>

以下列表包含源输入的示例。
+ 先前操作的结果：`{{results.actionName.data}}`
+ 数字清单：`{{[1, 2, 3, 4, 5, 6, 7, 8, 9, 10]}}`
+ 字符串列表：`{{["apple", "banana", "orange", "grape", "kiwi"]}}`
+ 计算值：`{{params.actionName.split("\n")}}`

#### 当前项目名称
<a name="automations-actions-reference-loop-properties-function-name"></a>

可用于引用当前正在迭代的项目的变量名称。当前项目名称是可配置的，因此您可以嵌套两个或多个循环并访问每个循环中的变量。例如，如果您要使用两个环路循环遍历国家和城市，则可以配置并引用`currentCountry`和`currentCity`。

## 条件
<a name="automations-actions-reference-condition"></a>

根据自动化运行时评估的一个或多个指定逻辑条件的结果运行操作。条件动作由以下组件组成：
+ 一个*条件*字段，用于提供计算结果为`true`或`false`的 JavaScript 表达式。
+ 一个*真正的分支*，其中包含条件计算结果为时运行的操作。`true`
+ 一个 *false 分支*，其中包含条件计算结果为时运行的操作。`false`

通过将动作拖动到条件动作中，为真分支和假分支添加动作。

### Properties
<a name="automations-actions-reference-condition-properties"></a>

#### 条件
<a name="automations-actions-reference-condition-properties-condition"></a>

操作运行时要评估的 JavaScript 表达式。

## 创建记录
<a name="automations-actions-reference-create-record"></a>

在现有 App Studio 实体中创建一条记录。

### Properties
<a name="automations-actions-reference-create-record-properties"></a>

#### 实体
<a name="automations-actions-reference-create-record-properties-entity"></a>

要在其中创建记录的实体。选择实体后，必须向该实体的字段中添加值才能创建记录。字段的类型以及字段是必填字段还是可选字段都是在实体中定义的。

## 更新记录
<a name="automations-actions-reference-update-record"></a>

更新 App Studio 实体中的现有记录。

### Properties
<a name="automations-actions-reference-update-record-properties"></a>

#### 实体
<a name="automations-actions-reference-update-record-properties-entity"></a>

包含要更新的记录的实体。

#### Conditions
<a name="automations-actions-reference-update-record-properties-conditions"></a>

定义操作更新哪些记录的标准。您可以对条件进行分组以创建一条逻辑语句。您可以将组或条件与`AND`或`OR`语句合并。

#### 字段
<a name="automations-actions-reference-update-record-properties-fields"></a>

条件指定的记录中要更新的字段。

#### 值
<a name="automations-actions-reference-update-record-properties-values"></a>

指定字段中要更新的值。

## 删除记录
<a name="automations-actions-reference-delete-record"></a>

从 App Studio 实体中删除一条记录。

### Properties
<a name="automations-actions-reference-delete-record-properties"></a>

#### 实体
<a name="automations-actions-reference-delete-record-properties-entity"></a>

包含要删除的记录的实体。

#### Conditions
<a name="automations-actions-reference-delete-record-properties-conditions"></a>

定义操作删除哪些记录的标准。您可以对条件进行分组以创建一条逻辑语句。您可以将组或条件与`AND`或`OR`语句合并。

## 调用数据操作
<a name="automations-actions-reference-invoke-data-action"></a>

使用可选参数运行数据操作。

### Properties
<a name="automations-actions-reference-invoke-data-action-properties"></a>

#### 数据操作
<a name="automations-actions-reference-invoke-data-action-properties-data-action"></a>

该操作要运行的数据操作。

#### 参数
<a name="automations-actions-reference-invoke-data-action-properties-parameters"></a>

数据操作要使用的数据操作参数。数据操作参数用于发送用作数据操作输入的值。配置自动化操作时可以添加数据操作参数，但必须在 “**数据**” 选项卡中进行编辑。

#### 高级设置
<a name="automations-actions-reference-invoke-data-action-properties-advanced-settings"></a>

该`Invoke data action`操作包含以下高级设置：
+ **页面大小：**每次查询中要提取的最大记录数。默认值为 500，最大值为 3000。
+ **分页令牌：**用于从查询中获取其他记录的标记。例如，如果设置`Page size`为 500，但有超过 500 条记录，则将分页令牌传递给后续查询将获取接下来的 500 条记录。如果不再存在记录或页面，则标记将处于未定义状态。

## 亚马逊 S3：放置对象
<a name="automations-actions-reference-s3-put-object"></a>

使用`Amazon S3 PutObject`操作将由密钥（文件路径）标识的对象添加到指定的 Amazon S3 存储桶。

### Properties
<a name="automations-actions-reference-s3-put-object-properties"></a>

#### Connector
<a name="automations-actions-reference-s3-put-object-properties-connector"></a>

用于此操作运行的操作的连接器。应使用运行操作的相应凭据以及其他配置信息（例如包含操作中引用的任何资源的 AWS 区域）来设置已配置的连接器。

#### 配置
<a name="automations-actions-reference-s3-put-object-properties-configuration"></a>

要在`PutObject`命令中使用的必需选项。这些方法如下所示：

**注意**  
有关`Amazon S3 PutObject`操作的更多信息，请参阅[PutObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html)《*亚马逊简单存储服务 API 参考*》。
+ **存储桶：**用于放置对象的 Amazon S3 存储桶的名称。
+ **密钥：**要放入 Amazon S3 存储桶的对象的唯一名称。
+ **正文：**要放入 Amazon S3 存储桶的数据元的内容。

#### 模拟输出
<a name="automations-actions-reference-s3-put-object-properties-mocked-output"></a>

在预览环境中，操作不会与外部服务或资源交互。**Mocked 输出**字段用于提供一个 JSON 表达式，该表达式可模拟连接器在预览环境中的行为，以用于测试目的。此代码段存储在操作`results`的地图中，就像连接器响应在实时环境中发布的应用程序一样。

使用此字段，您可以测试各种场景及其对自动化中其他操作的影响，例如模拟不同的结果值、错误场景、边缘案例或不愉快的路径，而无需通过连接器与外部服务进行通信。

## 亚马逊 S3：删除对象
<a name="automations-actions-reference-s3-delete-object"></a>

使用`Amazon S3 DeleteObject`操作从指定的 Amazon S3 存储桶中删除由密钥（文件路径）标识的对象。

### Properties
<a name="automations-actions-reference-s3-delete-object-properties"></a>

#### Connector
<a name="automations-actions-reference-s3-delete-object-properties-connector"></a>

用于此操作运行的操作的连接器。配置的连接器应使用运行操作的正确凭据以及其他配置信息（例如包含操作中引用的任何资源的 AWS 区域）进行设置。

#### 配置
<a name="automations-actions-reference-s3-delete-object-properties-configuration"></a>

要在`DeleteObject`命令中使用的必需选项。这些方法如下所示：

**注意**  
有关`Amazon S3 DeleteObject`操作的更多信息，请参阅[DeleteObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html)《*亚马逊简单存储服务 API 参考*》。
+ **存储桶：**要从中删除对象的 Amazon S3 存储桶的名称。
+ **密钥：**要从 Amazon S3 存储桶中删除的对象的唯一名称。

#### 模拟输出
<a name="automations-actions-reference-s3-delete-object-properties-mocked-output"></a>

在预览环境中，操作不会与外部服务或资源交互。**Mocked 输出**字段用于提供一个 JSON 表达式，该表达式可模拟连接器在预览环境中的行为，以用于测试目的。此代码段存储在操作`results`的地图中，就像连接器响应在实时环境中发布的应用程序一样。

使用此字段，您可以测试各种场景及其对自动化中其他操作的影响，例如模拟不同的结果值、错误场景、边缘案例或不愉快的路径，而无需通过连接器与外部服务进行通信。

## 亚马逊 S3：获取对象
<a name="automations-actions-reference-s3-get-object"></a>

使用`Amazon S3 GetObject`操作从指定的 Amazon S3 存储桶中检索由密钥（文件路径）标识的对象。

### Properties
<a name="automations-actions-reference-s3-get-object-properties"></a>

#### Connector
<a name="automations-actions-reference-s3-get-object-properties-connector"></a>

用于此操作运行的操作的连接器。配置的连接器应使用运行操作的正确凭据以及其他配置信息（例如包含操作中引用的任何资源的 AWS 区域）进行设置。

#### 配置
<a name="automations-actions-reference-s3-get-object-properties-configuration"></a>

要在`GetObject`命令中使用的必需选项。这些方法如下所示：

**注意**  
有关`Amazon S3 GetObject`操作的更多信息，请参阅[GetObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html)《*亚马逊简单存储服务 API 参考*》。
+ **存储桶：**要从中检索对象的 Amazon S3 存储桶的名称。
+ **密钥：**要从 Amazon S3 存储桶中检索的对象的唯一名称。

#### 模拟输出
<a name="automations-actions-reference-s3-get-object-properties-mocked-output"></a>

在预览环境中，操作不会与外部服务或资源交互。**Mocked 输出**字段用于提供一个 JSON 表达式，该表达式可模拟连接器在预览环境中的行为，以用于测试目的。此代码段存储在操作`results`的地图中，就像连接器响应在实时环境中发布的应用程序一样。

使用此字段，您可以测试各种场景及其对自动化中其他操作的影响，例如模拟不同的结果值、错误场景、边缘案例或不愉快的路径，而无需通过连接器与外部服务进行通信。

## 亚马逊 S3：列出对象
<a name="automations-actions-reference-s3-list-objects"></a>

使用`Amazon S3 ListObjects`操作列出指定 Amazon S3 存储桶中的对象。

### Properties
<a name="automations-actions-reference-s3-list-objects-properties"></a>

#### Connector
<a name="automations-actions-reference-s3-list-objects-properties-connector"></a>

用于此操作运行的操作的连接器。配置的连接器应使用运行操作的正确凭据以及其他配置信息（例如包含操作中引用的任何资源的 AWS 区域）进行设置。

#### 配置
<a name="automations-actions-reference-s3-list-objects-properties-configuration"></a>

要在`ListObjects`命令中使用的必需选项。这些方法如下所示：

**注意**  
有关`Amazon S3 ListObjects`操作的更多信息，请参阅[ListObjects](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html)《*亚马逊简单存储服务 API 参考*》。
+ **存储桶：**用于列出对象的 Amazon S3 存储桶的名称。

#### 模拟输出
<a name="automations-actions-reference-s3-list-objects-properties-mocked-output"></a>

在预览环境中，操作不会与外部服务或资源交互。**Mocked 输出**字段用于提供一个 JSON 表达式，该表达式可模拟连接器在预览环境中的行为，以用于测试目的。此代码段存储在操作`results`的地图中，就像连接器响应在实时环境中发布的应用程序一样。

使用此字段，您可以测试各种场景及其对自动化中其他操作的影响，例如模拟不同的结果值、错误场景、边缘案例或不愉快的路径，而无需通过连接器与外部服务进行通信。

## Amazon Textract：分析文档
<a name="automations-actions-reference-textract-analyze-document"></a>

使用`Amazon Textract AnalyzeDocument`操作来分析输入文档中检测到的项目之间的关系。

### Properties
<a name="automations-actions-reference-textract-analyze-document-properties"></a>

#### Connector
<a name="automations-actions-reference-textract-analyze-document-properties-connector"></a>

用于此操作运行的操作的连接器。配置的连接器应使用运行操作的正确凭据以及其他配置信息（例如包含操作中引用的任何资源的 AWS 区域）进行设置。

#### 配置
<a name="automations-actions-reference-textract-analyze-document-properties-configuration"></a>

要在`AnalyzeDocument`命令中使用的请求内容。这些方法如下所示：

**注意**  
有关`Amazon Textract AnalyzeDocument`操作的更多信息，请参阅 [AnalyzeDocument](https://docs.aws.amazon.com/textract/latest/dg/API_AnalyzeDocument.html)*Amazon Textract 开发者指南*。
+ **文档/S3Object/Bucket：亚马逊 S3 存储桶**的名称。如果使用 **S3 上传**组件将文件传递给操作，则此参数可以留空。
+ **文档/S3Object/名称：**输入文档的文件名。如果使用 **S3 上传**组件将文件传递给操作，则此参数可以留空。
+ **文档/S3Object/版本：**如果 Amazon S3 存储桶启用了版本控制，则可以指定对象的版本。如果使用 **S3 上传**组件将文件传递给操作，则此参数可以留空。
+ **FeatureTypes：**要执行的分析类型列表。有效值为：`TABLES`、`FORMS`、`QUERIES`、`SIGNATURES` 和 `LAYOUT`。

#### 模拟输出
<a name="automations-actions-reference-textract-analyze-document-properties-mocked-output"></a>

在预览环境中，操作不会与外部服务或资源交互。**Mocked 输出**字段用于提供一个 JSON 表达式，该表达式可模拟连接器在预览环境中的行为，以用于测试目的。此代码段存储在操作`results`的地图中，就像连接器响应在实时环境中发布的应用程序一样。

使用此字段，您可以测试各种场景及其对自动化中其他操作的影响，例如模拟不同的结果值、错误场景、边缘案例或不愉快的路径，而无需通过连接器与外部服务进行通信。

## Amazon Textract：分析支出
<a name="automations-actions-reference-textract-analyze-expense"></a>

使用`Amazon Textract AnalyzeExpense`操作来分析输入文档，了解文本之间与财务相关的关系。

### Properties
<a name="automations-actions-reference-textract-analyze-expense-properties"></a>

#### Connector
<a name="automations-actions-reference-textract-analyze-expense-properties-connector"></a>

用于此操作运行的操作的连接器。配置的连接器应使用运行操作的正确凭据以及其他配置信息（例如包含操作中引用的任何资源的 AWS 区域）进行设置。

#### 配置
<a name="automations-actions-reference-textract-analyze-expense-properties-configuration"></a>

要在`AnalyzeExpense`命令中使用的请求内容。这些方法如下所示：

**注意**  
有关`Amazon Textract AnalyzeExpense`操作的更多信息，请参阅 [AnalyzeExpense](https://docs.aws.amazon.com/textract/latest/dg/API_AnalyzeExpense.html)*Amazon Textract 开发者指南*。
+ **文档/S3Object/Bucket：亚马逊 S3 存储桶**的名称。如果使用 **S3 上传**组件将文件传递给操作，则此参数可以留空。
+ **文档/S3Object/名称：**输入文档的文件名。如果使用 **S3 上传**组件将文件传递给操作，则此参数可以留空。
+ **文档/S3Object/版本：**如果 Amazon S3 存储桶启用了版本控制，则可以指定对象的版本。如果使用 **S3 上传**组件将文件传递给操作，则此参数可以留空。

#### 模拟输出
<a name="automations-actions-reference-textract-analyze-expense-properties-mocked-output"></a>

在预览环境中，操作不会与外部服务或资源交互。**Mocked 输出**字段用于提供一个 JSON 表达式，该表达式可模拟连接器在预览环境中的行为，以用于测试目的。此代码段存储在操作`results`的地图中，就像连接器响应在实时环境中发布的应用程序一样。

使用此字段，您可以测试各种场景及其对自动化中其他操作的影响，例如模拟不同的结果值、错误场景、边缘案例或不愉快的路径，而无需通过连接器与外部服务进行通信。

## Amazon Textract：分析身份证
<a name="automations-actions-reference-textract-analyze-id"></a>

使用该`Amazon Textract AnalyzeID`操作来分析身份证件以获取相关信息。

### Properties
<a name="automations-actions-reference-textract-analyze-id-properties"></a>

#### Connector
<a name="automations-actions-reference-textract-analyze-id-properties-connector"></a>

用于此操作运行的操作的连接器。配置的连接器应使用运行操作的正确凭据以及其他配置信息（例如包含操作中引用的任何资源的 AWS 区域）进行设置。

#### 配置
<a name="automations-actions-reference-textract-analyze-id-properties-configuration"></a>

要在`AnalyzeID`命令中使用的请求内容。这些方法如下所示：

**注意**  
有关该`Amazon Textract AnalyzeID`操作的更多信息，请参阅*亚马逊 Textrac* t 开发者[指南中的 analyzeID](https://docs.aws.amazon.com/textract/latest/dg/API_AnalyzeID.html)。
+ **文档/S3Object/Bucket：亚马逊 S3 存储桶**的名称。如果使用 **S3 上传**组件将文件传递给操作，则此参数可以留空。
+ **文档/S3Object/名称：**输入文档的文件名。如果使用 **S3 上传**组件将文件传递给操作，则此参数可以留空。
+ **文档/S3Object/版本：**如果 Amazon S3 存储桶启用了版本控制，则可以指定对象的版本。如果使用 **S3 上传**组件将文件传递给操作，则此参数可以留空。

#### 模拟输出
<a name="automations-actions-reference-textract-analyze-id-properties-mocked-output"></a>

在预览环境中，操作不会与外部服务或资源交互。**Mocked 输出**字段用于提供一个 JSON 表达式，该表达式可模拟连接器在预览环境中的行为，以用于测试目的。此代码段存储在操作`results`的地图中，就像连接器响应在实时环境中发布的应用程序一样。

使用此字段，您可以测试各种场景及其对自动化中其他操作的影响，例如模拟不同的结果值、错误场景、边缘案例或不愉快的路径，而无需通过连接器与外部服务进行通信。

## Amazon Textract：检测文档文本
<a name="automations-actions-reference-textract-detect-document-text"></a>

使用该`Amazon Textract DetectDocumentText`操作来检测输入文档中的文本行和构成一行文本的单词。

### Properties
<a name="automations-actions-reference-textract-detect-document-text-properties"></a>

#### Connector
<a name="automations-actions-reference-textract-detect-document-text-properties-connector"></a>

用于此操作运行的操作的连接器。配置的连接器应使用运行操作的正确凭据以及其他配置信息（例如包含操作中引用的任何资源的 AWS 区域）进行设置。

#### 配置
<a name="automations-actions-reference-textract-detect-document-text-properties-configuration"></a>

要在`DetectDocumentText`命令中使用的请求内容。这些方法如下所示：

**注意**  
有关`Amazon Textract DetectDocumentText`操作的更多信息，请参阅 [DetectDocumentText](https://docs.aws.amazon.com/textract/latest/dg/API_DetectDocumentText.html)*Amazon Textract 开发者指南*。
+ **文档/S3Object/Bucket：亚马逊 S3 存储桶**的名称。如果使用 **S3 上传**组件将文件传递给操作，则此参数可以留空。
+ **文档/S3Object/名称：**输入文档的文件名。如果使用 **S3 上传**组件将文件传递给操作，则此参数可以留空。
+ **文档/S3Object/版本：**如果 Amazon S3 存储桶启用了版本控制，则可以指定对象的版本。如果使用 **S3 上传**组件将文件传递给操作，则此参数可以留空。

#### 模拟输出
<a name="automations-actions-reference-textract-detect-document-text-properties-mocked-output"></a>

在预览环境中，操作不会与外部服务或资源交互。**Mocked 输出**字段用于提供一个 JSON 表达式，该表达式可模拟连接器在预览环境中的行为，以用于测试目的。此代码段存储在操作`results`的地图中，就像连接器响应在实时环境中发布的应用程序一样。

使用此字段，您可以测试各种场景及其对自动化中其他操作的影响，例如模拟不同的结果值、错误场景、边缘案例或不愉快的路径，而无需通过连接器与外部服务进行通信。

## 亚马逊 Bedrock：GenAI Prompt
<a name="automations-actions-reference-bedrock-prompt"></a>

使用 [Amazon Bedrock InvokeModel](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html) 操作使用操作属性中提供的提示和推理参数运行推理。该操作可以生成文本、图像和嵌入内容。

### Properties
<a name="automations-actions-reference-bedrock-prompt-properties"></a>

#### Connector
<a name="automations-actions-reference-bedrock-prompt-properties-connector"></a>

用于此操作运行的操作的连接器。要成功使用此操作，必须将连接器配置为 **Amazon Bedrock Runtime** 作为服务。配置的连接器应使用运行操作的正确凭据以及其他配置信息（例如包含操作中引用的任何资源的 AWS 区域）进行设置。

#### 模型
<a name="automations-actions-reference-bedrock-prompt-properties-model"></a>

Amazon Bedrock 用于处理请求的基础模型。有关亚马逊 Bedrock 中模型的更多信息，请参阅[亚马逊 Bedrock 用户指南中的*亚马逊 Bedrock* 基础模型信息](https://docs.aws.amazon.com/bedrock/latest/userguide/foundation-models-reference.html)。

#### 输入类型
<a name="automations-actions-reference-bedrock-prompt-properties-input-type"></a>

输入的输入类型将发送到 Amazon Bedrock 模型。可能的值为 “**文本**”、“**文档**” 和 “**图像**”。如果输入类型不可选，则配置的模型可能不支持该类型。

#### 用户提示
<a name="automations-actions-reference-bedrock-prompt-properties-user-prompt"></a>

要发送给 Amazon Bedrock 模型的提示，以进行处理以生成响应。您可以输入静态文本，也可以传入来自应用程序其他部分的输入，例如使用参数的组件、自动化中的先前操作或其他自动化。以下示例说明如何传入来自组件或先前操作的值：
+ 要使用参数从组件传递值，请执行以下操作：`{{params.paramName}}`
+ 要传递先前操作中的值，请执行以下操作：`{{results.actionName}}`

#### 系统提示符（克劳德模型）
<a name="automations-actions-reference-bedrock-prompt-properties-system-prompt"></a>

Amazon Bedrock 模型在处理请求时要使用的系统提示。系统提示符用于为 Claude 模型提供上下文、说明或指南。

#### 请求设置
<a name="automations-actions-reference-bedrock-prompt-properties-request-settings"></a>

配置各种请求设置和模型推理参数。您可以配置以下设置：
+ **温度**：Amazon Bedrock 模型在处理请求时使用的温度。温度决定了 Bedrock 模型输出的随机性或创造力。温度越高，反应的创造性就越强，分析性就越低。可能的值是`[0-10]`。
+ **最大代币**数量：限制 Amazon Bedrock 模型的输出长度。
+ **TopP****：在 nucleus 采样中，模型按概率递减顺序计算每个后续代币在所有期权上的累积分布，并在其达到 TopP 指定的特定概率后将其切断。**你应该改变**温度**或 **TopP**，但不能两者兼而有之
+ **停止序**列：导致模型停止处理请求和生成输出的序列。

有关更多信息，请参阅 *Amazon Bedrock 用户*指南中的[基础模型的推理请求参数和响应字段](https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html)。

#### 停止序列
<a name="automations-actions-reference-bedrock-prompt-properties-guardrail"></a>

**输入 Amazon Bedrock Guardrail **ID** 和版本。**护栏用于根据您的用例和负责任的人工智能政策实施保障措施。*有关更多信息，请参阅《亚马逊 Bedrock [用户指南》中的使用 Amazon Bedrock Guardrails 阻止模型中的有害内容](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails.html)。*

#### 模拟输出
<a name="automations-actions-reference-bedrock-prompt-properties-mocked-output"></a>

在预览环境中，操作不会与外部服务或资源交互。**Mocked 输出**字段用于提供一个 JSON 表达式，该表达式可模拟连接器在预览环境中的行为，以用于测试目的。此代码段存储在操作`results`的地图中，就像连接器响应在实时环境中发布的应用程序一样。

使用此字段，您可以测试各种场景及其对自动化中其他操作的影响，例如模拟不同的结果值、错误场景、边缘案例或不愉快的路径，而无需通过连接器与外部服务进行通信。

## Amazon Bedrock：调用模型
<a name="automations-actions-reference-bedrock-invoke-model"></a>

使用 [Amazon Bedrock InvokeModel](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html) 操作使用请求正文中提供的提示和推理参数运行推理。您可以使用模型推理来生成文本、图像和嵌入内容。

### Properties
<a name="automations-actions-reference-bedrock-invoke-model-properties"></a>

#### Connector
<a name="automations-actions-reference-bedrock-invoke-model-properties-connector"></a>

用于此操作运行的操作的连接器。要成功使用此操作，必须将连接器配置为 **Amazon Bedrock Runtime** 作为服务。配置的连接器应使用运行操作的正确凭据以及其他配置信息（例如包含操作中引用的任何资源的 AWS 区域）进行设置。

#### 配置
<a name="automations-actions-reference-bedrock-invoke-model-properties-configuration"></a>

要在`InvokeModel`命令中使用的请求内容。

**注意**  
有关`Amazon Bedrock InvokeModel`操作的更多信息，包括示例命令，请参阅 *Amazon Bedrock API 参考[InvokeModel](https://docs.aws.amazon.com/textract/latest/dg/API_DetectDocumentText.html)*中的。

#### 模拟输出
<a name="automations-actions-reference-bedrock-invoke-model-properties-mocked-output"></a>

在预览环境中，操作不会与外部服务或资源交互。**Mocked 输出**字段用于提供一个 JSON 表达式，该表达式可模拟连接器在预览环境中的行为，以用于测试目的。此代码段存储在操作`results`的地图中，就像连接器响应在实时环境中发布的应用程序一样。

使用此字段，您可以测试各种场景及其对自动化中其他操作的影响，例如模拟不同的结果值、错误场景、边缘案例或不愉快的路径，而无需通过连接器与外部服务进行通信。

## JavaScript
<a name="automations-actions-reference-javascript"></a>

运行自定义 JavaScript 函数以返回指定值。

**重要**  
App Studio 不支持使用第三方库或自定义 JavaScript 库。

### Properties
<a name="automations-actions-reference-javascript-properties"></a>

#### 源代码
<a name="automations-actions-reference-javascript-properties-source-code"></a>

操作要运行的 JavaScript 代码片段。

**提示**  
您可以通过执行以下步骤使用 AI 来帮助您生成 JavaScript ：  
选择展开图标以打开展开的 JavaScript 编辑器。
（可选）：启用**修改代码**开关以修改任何现有代码 JavaScript。否则，人工智能将取代任何现有 JavaScript的。
在 “**生成**” 中 JavaScript，描述你要用什么来做 JavaScript，例如：**Add two numbers**。
选择发送图标以生成您的 JavaScript.

## 调用自动化
<a name="automations-actions-reference-invoke-automation"></a>

运行指定的自动化。

### Properties
<a name="automations-actions-reference-invoke-automation-properties"></a>

#### 调用自动化
<a name="automations-actions-reference-invoke-automation-properties-invoke-automation"></a>

要由操作运行的自动化。

## 发送电子邮件
<a name="automations-actions-reference-send-email"></a>

使用`Amazon SES SendEmail`操作发送电子邮件。

### Properties
<a name="automations-actions-reference-send-email-properties"></a>

#### Connector
<a name="automations-actions-reference-send-email-properties-connector"></a>

用于此操作运行的操作的连接器。配置的连接器应使用运行操作的正确凭据以及其他配置信息（例如包含操作中引用的任何资源的 AWS 区域）进行设置。

#### 配置
<a name="automations-actions-reference-send-email-properties-configuration"></a>

要在`SendEmail`命令中使用的请求内容。这些方法如下所示：

**注意**  
有关该`Amazon SES SendEmail`操作的更多信息，请参阅[SendEmail](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html)《*亚马逊简单电子邮件服务 API 参考*》。

#### 模拟输出
<a name="automations-actions-reference-send-email-properties-mocked-output"></a>

在预览环境中，操作不会与外部服务或资源交互。**Mocked 输出**字段用于提供一个 JSON 表达式，该表达式可模拟连接器在预览环境中的行为，以用于测试目的。此代码段存储在操作`results`的地图中，就像连接器响应在实时环境中发布的应用程序一样。

使用此字段，您可以测试各种场景及其对自动化中其他操作的影响，例如模拟不同的结果值、错误场景、边缘案例或不愉快的路径，而无需通过连接器与外部服务进行通信。