本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
自动化操作参考
以下是 App Studio 中使用的自动化操作的参考文档。
自动化操作，通常称为动作，是构成自动化的单个逻辑步骤。无论是发送电子邮件、创建数据记录、调用 Lambda 函数还是调用 API，每个操作都会执行特定的任务。操作从操作库添加到自动化中，可以分组为条件语句或循环。
有关创建和配置自动化及其操作的信息，请参阅中的自动化和操作：定义应用程序的业务逻辑主题。
调用 API
调用 HTTP REST API 请求。构建者可以使用此操作通过 API 将来自 App Studio 的请求发送到其他系统或服务。例如，您可以使用它连接到第三方系统或本土应用程序以访问业务关键数据，或者调用专用 App Studio 操作无法调用的 API 端点。
有关 REST API 的更多信息，请参阅什么是 RESTful API？
Properties
Connector
用于此操作发出的 API 请求的连接器。连接器下拉列表仅包含以下类型的连接器：API Connector和OpenAPI Connector。根据连接器的配置方式，它可以包含重要信息，例如凭据和默认标头或查询参数。
有关 API 连接器的更多信息，包括使用API Connector和之间的比较OpenAPI Connector，请参阅连接到第三方服务。
API 请求配置属性
从属性面板中选择 “配置 API 请求” 以打开请求配置对话框。如果选择了 API 连接器，则对话框将包含连接器信息。
方法：API 调用的方法。可能值如下所示：
DELETE: 删除指定资源。GET: 检索信息或数据。HEAD: 仅检索响应的标头，不包括正文。POST: 提交要处理的数据。PUSH: 提交要处理的数据。PATCH：部分更新指定资源。
路径：资源的相对路径。
标头：与 API 请求一起发送的键值对形式的任何标头。如果选择了连接器，则将自动添加其配置的标头，并且无法删除。无法编辑已配置的标题，但您可以通过添加另一个同名的标头来覆盖它们。
查询参数：与 API 请求一起发送的任何以键值对形式发送的查询参数。如果选择了连接器，则将自动添加其配置的查询参数，并且无法编辑或删除。
正文：与 API 请求一起以 JSON 格式发送的信息。没有可GET处理请求的正文。
模拟输出
操作不与预览环境中的外部服务或资源交互。Mocked 输出字段用于提供 JSON 表达式，用于模拟连接器在预览环境中的行为，以进行测试。该代码片段存储在操作results的地图中，就像连接器对实时环境中已发布应用程序的响应一样。
使用此字段，您可以在不通过连接器与外部服务通信的情况下测试各种场景及其对自动化中其他操作的影响，例如模拟不同的结果值、错误场景、边缘情况或不愉快的路径。
调用 AWS
从服务调用操作。 AWS 这是调用 AWS 服务或操作的常规操作，如果没有针对所需 AWS 服务或操作的专用操作，则应使用此操作。
Properties
服务
包含要运行的操作的 AWS 服务。
操作
要运行的操作。
Connector
用于此操作运行的操作的连接器。应使用运行操作的正确凭据设置配置的连接器以及其他配置信息，例如包含操作中引用的任何资源的 AWS 区域。
配置
运行指定操作时要使用的 JSON 输入。有关配置 AWS 操作输入的更多信息，请参阅适用于 JavaScript 的 AWS SDK。
调用 Lambda
调用现有的 Lambda 函数。
Properties
Connector
用于此操作运行的 Lambda 函数的连接器。配置的连接器应使用适当的证书进行设置，以访问 Lambda 函数和其他配置信息，例如包含 Lambda 函数的 AWS 区域。有关为 Lambda 配置连接器的更多信息，请参阅第 3 步：创建 Lambda 连接器。
函数名称
要运行的 Lambda 函数的名称。请注意，这是函数名称，而不是函数 ARN（亚马逊资源名称）。
函数事件
Key-value 配对将作为事件负载传递给您的 Lambda 函数。
模拟输出
操作不与预览环境中的外部服务或资源交互。Mocked 输出字段用于提供 JSON 表达式，用于模拟连接器在预览环境中的行为，以进行测试。该代码片段存储在操作results的地图中，就像连接器对实时环境中已发布应用程序的响应一样。
使用此字段，您可以在不通过连接器与外部服务通信的情况下测试各种场景及其对自动化中其他操作的影响，例如模拟不同的结果值、错误场景、边缘情况或不愉快的路径。
循环
反复运行嵌套操作以遍历项目列表，一次只能迭代一个项目。例如，将该创建记录动作添加到循环操作中以创建多条记录。
循环操作可以嵌套在其他循环或条件操作中。循环操作按顺序运行，而不是并行运行。循环中每个操作的结果只能由同一循环迭代中的后续操作访问。它们不能在循环之外或循环的不同迭代中访问。
Properties
来源
要迭代的项目列表，一次只能一个项目。源可以是先前操作的结果，也可以是您可以使用 JavaScript 表达式提供的字符串、数字或对象的静态列表。
示例
以下列表包含源输入的示例。
先前操作的结果：
{{results.actionName.data}}数字清单：
{{[1, 2, 3, 4, 5, 6, 7, 8, 9, 10]}}字符串列表：
{{["apple", "banana", "orange", "grape", "kiwi"]}}计算值：
{{params.actionName.split("\n")}}
当前物品名称
可用于引用当前正在迭代的项目的变量的名称。当前项目名称是可配置的，因此您可以嵌套两个或更多循环并访问每个循环中的变量。例如，如果您使用两个环路遍历国家和城市，则可以配置和引用currentCountry和currentCity。
条件
根据自动化运行时评估的一个或多个指定逻辑条件的结果运行操作。条件操作由以下组件组成：
条件字段，用于提供计算结果为
true或false的 JavaScript 表达式。一个真正的分支，其中包含条件计算结果为时运行的操作。
true一个 false 分支，其中包含条件计算结果为时运行的
false操作。
通过将动作拖动到条件操作中，向真和假分支添加动作。
Properties
条件
操作运行时要计算的 JavaScript 表达式。
创建记录
在现有 App Studio 实体中创建一条记录。
Properties
实体
要在其中创建记录的实体。选择实体后，必须将值添加到该实体的字段中才能创建记录。实体中定义了字段的类型以及字段是必填的还是可选的。
更新记录
更新 App Studio 实体中的现有记录。
Properties
实体
包含要更新的记录的实体。
Conditions
定义操作更新哪些记录的标准。您可以对条件进行分组以创建一条逻辑语句。您可以将组或条件与 AND or OR 语句组合在一起。
字段
条件指定的记录中要更新的字段。
值
要在指定字段中更新的值。
删除记录
从 App Studio 实体中删除一条记录。
Properties
实体
包含要删除的记录的实体。
Conditions
定义操作删除哪些记录的标准。您可以对条件进行分组以创建一条逻辑语句。您可以将组或条件与 AND or OR 语句组合在一起。
调用数据操作
使用可选参数运行数据操作。
Properties
数据操作
操作要运行的数据操作。
参数
数据操作使用的数据操作参数。数据操作参数用于发送用作数据操作输入的值。配置自动化操作时可以添加数据操作参数，但必须在 “数据” 选项卡中进行编辑。
高级设置
该Invoke data action操作包含以下高级设置：
页面大小：每次查询中要提取的最大记录数。默认值为 500，最大值为 3000。
分页令牌：用于从查询中获取其他记录的令牌。例如，如果将设置
Page size为 500，但有超过 500 条记录，则将分页令牌传递给后续查询将提取接下来的 500 条记录。如果没有更多记录或页面，则该令牌将处于未定义状态。
亚马逊 S3：放置对象
使用该Amazon S3 PutObject操作将由密钥（文件路径）标识的对象添加到指定的 Amazon S3 存储桶。
Properties
Connector
用于此操作运行的操作的连接器。应使用运行操作的相应凭据以及其他配置信息（例如包含操作中引用的任何资源的 AWS 区域）来设置已配置的连接器。
配置
PutObject命令中使用的必需选项。这些方法如下所示：
注意
有关该Amazon S3 PutObject操作的更多信息，请参阅PutObject《亚马逊简单存储服务 API 参考》。
存储桶：用于放置对象的 Amazon S3 存储桶的名称。
密钥：要放入 Amazon S3 存储桶的对象的唯一名称。
正文：要放入 Amazon S3 存储桶的对象的内容。
模拟输出
操作不与预览环境中的外部服务或资源交互。Mocked 输出字段用于提供 JSON 表达式，用于模拟连接器在预览环境中的行为，以进行测试。该代码片段存储在操作results的地图中，就像连接器对实时环境中已发布应用程序的响应一样。
使用此字段，您可以在不通过连接器与外部服务通信的情况下测试各种场景及其对自动化中其他操作的影响，例如模拟不同的结果值、错误场景、边缘情况或不愉快的路径。
亚马逊 S3：删除对象
使用该Amazon S3 DeleteObject操作从指定的 Amazon S3 存储桶中删除由密钥（文件路径）标识的对象。
Properties
Connector
用于此操作运行的操作的连接器。应使用运行操作的正确凭据设置配置的连接器以及其他配置信息，例如包含操作中引用的任何资源的 AWS 区域。
配置
DeleteObject命令中使用的必需选项。这些方法如下所示：
注意
有关该Amazon S3 DeleteObject操作的更多信息，请参阅DeleteObject《亚马逊简单存储服务 API 参考》。
存储桶：要从中删除对象的 Amazon S3 存储桶的名称。
密钥：要从 Amazon S3 存储桶中删除的对象的唯一名称。
模拟输出
操作不与预览环境中的外部服务或资源交互。Mocked 输出字段用于提供 JSON 表达式，用于模拟连接器在预览环境中的行为，以进行测试。该代码片段存储在操作results的地图中，就像连接器对实时环境中已发布应用程序的响应一样。
使用此字段，您可以在不通过连接器与外部服务通信的情况下测试各种场景及其对自动化中其他操作的影响，例如模拟不同的结果值、错误场景、边缘情况或不愉快的路径。
亚马逊 S3：获取对象
使用该Amazon S3 GetObject操作从指定的 Amazon S3 存储桶中检索由密钥（文件路径）标识的对象。
Properties
Connector
用于此操作运行的操作的连接器。应使用运行操作的正确凭据设置配置的连接器以及其他配置信息，例如包含操作中引用的任何资源的 AWS 区域。
配置
GetObject命令中使用的必需选项。这些方法如下所示：
注意
有关该Amazon S3 GetObject操作的更多信息，请参阅GetObject《亚马逊简单存储服务 API 参考》。
存储桶：用于检索对象的 Amazon S3 存储桶的名称。
密钥：要从 Amazon S3 存储桶中检索的对象的唯一名称。
模拟输出
操作不与预览环境中的外部服务或资源交互。Mocked 输出字段用于提供 JSON 表达式，用于模拟连接器在预览环境中的行为，以进行测试。该代码片段存储在操作results的地图中，就像连接器对实时环境中已发布应用程序的响应一样。
使用此字段，您可以在不通过连接器与外部服务通信的情况下测试各种场景及其对自动化中其他操作的影响，例如模拟不同的结果值、错误场景、边缘情况或不愉快的路径。
亚马逊 S3：列出对象
使用该Amazon S3 ListObjects操作列出指定 Amazon S3 存储桶中的对象。
Properties
Connector
用于此操作运行的操作的连接器。应使用运行操作的正确凭据设置配置的连接器以及其他配置信息，例如包含操作中引用的任何资源的 AWS 区域。
配置
ListObjects命令中使用的必需选项。这些方法如下所示：
注意
有关该Amazon S3 ListObjects操作的更多信息，请参阅ListObjects《亚马逊简单存储服务 API 参考》。
存储桶：用于列出对象的 Amazon S3 存储桶的名称。
模拟输出
操作不与预览环境中的外部服务或资源交互。Mocked 输出字段用于提供 JSON 表达式，用于模拟连接器在预览环境中的行为，以进行测试。该代码片段存储在操作results的地图中，就像连接器对实时环境中已发布应用程序的响应一样。
使用此字段，您可以在不通过连接器与外部服务通信的情况下测试各种场景及其对自动化中其他操作的影响，例如模拟不同的结果值、错误场景、边缘情况或不愉快的路径。
亚马逊 Textract：分析文档
使用该Amazon Textract AnalyzeDocument操作分析输入文档中检测到的项目之间的关系。
Properties
Connector
用于此操作运行的操作的连接器。应使用运行操作的正确凭据设置配置的连接器以及其他配置信息，例如包含操作中引用的任何资源的 AWS 区域。
配置
要在AnalyzeDocument命令中使用的请求的内容。这些方法如下所示：
注意
有关该Amazon Textract AnalyzeDocument操作的更多信息，请参阅亚马逊 Textract 开发者指南AnalyzeDocument中的内容。
文档/S3Object/存储桶：亚马逊 S3 存储桶的名称。如果使用 S3 上传组件将文件传递给操作，则可以将此参数留空。
文档/S3Object/名称：输入文档的文件名。如果使用 S3 上传组件将文件传递给操作，则可以将此参数留空。
文档/S3Object/版本：如果 Amazon S3 存储桶启用了版本控制，则可以指定对象的版本。如果使用 S3 上传组件将文件传递给操作，则可以将此参数留空。
FeatureTypes：要执行的分析类型列表。有效值为：
TABLES、FORMS、QUERIES、SIGNATURES和LAYOUT。
模拟输出
操作不与预览环境中的外部服务或资源交互。Mocked 输出字段用于提供 JSON 表达式，用于模拟连接器在预览环境中的行为，以进行测试。该代码片段存储在操作results的地图中，就像连接器对实时环境中已发布应用程序的响应一样。
使用此字段，您可以在不通过连接器与外部服务通信的情况下测试各种场景及其对自动化中其他操作的影响，例如模拟不同的结果值、错误场景、边缘情况或不愉快的路径。
亚马逊 Textract：分析支出
使用该Amazon Textract AnalyzeExpense操作来分析输入文档中是否存在与财务相关的文本关系。
Properties
Connector
用于此操作运行的操作的连接器。应使用运行操作的正确凭据设置配置的连接器以及其他配置信息，例如包含操作中引用的任何资源的 AWS 区域。
配置
要在AnalyzeExpense命令中使用的请求的内容。这些方法如下所示：
注意
有关该Amazon Textract AnalyzeExpense操作的更多信息，请参阅亚马逊 Textract 开发者指南AnalyzeExpense中的内容。
文档/S3Object/存储桶：亚马逊 S3 存储桶的名称。如果使用 S3 上传组件将文件传递给操作，则可以将此参数留空。
文档/S3Object/名称：输入文档的文件名。如果使用 S3 上传组件将文件传递给操作，则可以将此参数留空。
文档/S3Object/版本：如果 Amazon S3 存储桶启用了版本控制，则可以指定对象的版本。如果使用 S3 上传组件将文件传递给操作，则可以将此参数留空。
模拟输出
操作不与预览环境中的外部服务或资源交互。Mocked 输出字段用于提供 JSON 表达式，用于模拟连接器在预览环境中的行为，以进行测试。该代码片段存储在操作results的地图中，就像连接器对实时环境中已发布应用程序的响应一样。
使用此字段，您可以在不通过连接器与外部服务通信的情况下测试各种场景及其对自动化中其他操作的影响，例如模拟不同的结果值、错误场景、边缘情况或不愉快的路径。
亚马逊 Textract：分析 ID
使用该Amazon Textract AnalyzeID操作分析身份证件中的相关信息。
Properties
Connector
用于此操作运行的操作的连接器。应使用运行操作的正确凭据设置配置的连接器以及其他配置信息，例如包含操作中引用的任何资源的 AWS 区域。
配置
要在AnalyzeID命令中使用的请求的内容。这些方法如下所示：
注意
有关该Amazon Textract AnalyzeID操作的更多信息，请参阅亚马逊 Textract 开发者指南中的 AnalyzeID。
文档/S3Object/存储桶：亚马逊 S3 存储桶的名称。如果使用 S3 上传组件将文件传递给操作，则可以将此参数留空。
文档/S3Object/名称：输入文档的文件名。如果使用 S3 上传组件将文件传递给操作，则可以将此参数留空。
文档/S3Object/版本：如果 Amazon S3 存储桶启用了版本控制，则可以指定对象的版本。如果使用 S3 上传组件将文件传递给操作，则可以将此参数留空。
模拟输出
操作不与预览环境中的外部服务或资源交互。Mocked 输出字段用于提供 JSON 表达式，用于模拟连接器在预览环境中的行为，以进行测试。该代码片段存储在操作results的地图中，就像连接器对实时环境中已发布应用程序的响应一样。
使用此字段，您可以在不通过连接器与外部服务通信的情况下测试各种场景及其对自动化中其他操作的影响，例如模拟不同的结果值、错误场景、边缘情况或不愉快的路径。
亚马逊 Textract：检测文档文本
使用该Amazon Textract DetectDocumentText操作来检测输入文档中的文本行和构成一行文本的单词。
Properties
Connector
用于此操作运行的操作的连接器。应使用运行操作的正确凭据设置配置的连接器以及其他配置信息，例如包含操作中引用的任何资源的 AWS 区域。
配置
要在DetectDocumentText命令中使用的请求的内容。这些方法如下所示：
注意
有关该Amazon Textract DetectDocumentText操作的更多信息，请参阅亚马逊 Textract 开发者指南DetectDocumentText中的内容。
文档/S3Object/存储桶：亚马逊 S3 存储桶的名称。如果使用 S3 上传组件将文件传递给操作，则可以将此参数留空。
文档/S3Object/名称：输入文档的文件名。如果使用 S3 上传组件将文件传递给操作，则可以将此参数留空。
文档/S3Object/版本：如果 Amazon S3 存储桶启用了版本控制，则可以指定对象的版本。如果使用 S3 上传组件将文件传递给操作，则可以将此参数留空。
模拟输出
操作不与预览环境中的外部服务或资源交互。Mocked 输出字段用于提供 JSON 表达式，用于模拟连接器在预览环境中的行为，以进行测试。该代码片段存储在操作results的地图中，就像连接器对实时环境中已发布应用程序的响应一样。
使用此字段，您可以在不通过连接器与外部服务通信的情况下测试各种场景及其对自动化中其他操作的影响，例如模拟不同的结果值、错误场景、边缘情况或不愉快的路径。
亚马逊基石：GenAI Prompt
使用 Amazon Bedrock InvokeModel 操作使用操作属性中提供的提示和推断参数进行推断。该操作可以生成文本、图像和嵌入。
Properties
Connector
用于此操作运行的操作的连接器。要成功使用此操作，必须将连接器配置为使用 Amazon Bedrock Runtime 作为服务。应使用运行操作的正确凭据设置配置的连接器以及其他配置信息，例如包含操作中引用的任何资源的 AWS 区域。
模型
亚马逊 Bedrock 用于处理请求的基础模型。有关亚马逊基岩中模型的更多信息，请参阅亚马逊基岩用户指南中的亚马逊基岩基础模型信息。
输入类型
输入的输入类型发送到亚马逊 Bedrock 模型。可能的值为 “文本” 、“文档” 和 “图像” 。如果输入类型不可选择，则配置的模型可能不支持该输入类型。
用户提示
将提示发送到亚马逊 Bedrock 模型进行处理以生成响应。您可以输入静态文本，也可以传入来自应用程序另一部分的输入，例如来自使用参数的组件、自动化中的先前操作或其他自动化的输入。以下示例显示如何传入来自组件或先前操作的值：
要使用参数传递组件的值，请执行以下操作：
{{params.paramName}}要传递先前操作中的值，请执行以下操作：
{{results.actionName}}
系统提示符（克劳德模型）
亚马逊基岩模型在处理请求时使用的系统提示。系统提示符用于为 Claude 模型提供上下文、说明或指南。
请求设置
配置各种请求设置和模型推理参数。您可以配置以下设置：
温度：亚马逊基岩模型在处理请求时使用的温度。温度决定了基岩模型输出的随机性或创造力。温度越高，响应的创造性越强，分析能力也越差。可能的值是
[0-10]。最大代币：限制亚马逊基岩模型的输出长度。
TopP：在核采样中，该模型按递减概率顺序计算每个后续代币所有期权的累积分布，并在达到 TopP 规定的特定概率时将其切断。 你应该改变温度或 TopP，但不能同时改变两者
停止序列：导致模型停止处理请求和生成输出的序列。
有关更多信息，请参阅 Amazon Bedrock 用户指南中的基础模型推理请求参数和响应字段。
停止序列
输入亚马逊 Bedrock Guardrail ID 和版本。 护栏用于根据您的用例和负责任的人工智能政策实施保障措施。有关更多信息，请参阅《亚马逊基岩用户指南》中的使用亚马逊基岩护栏阻止模型中的有害内容。
模拟输出
操作不与预览环境中的外部服务或资源交互。Mocked 输出字段用于提供 JSON 表达式，用于模拟连接器在预览环境中的行为，以进行测试。该代码片段存储在操作results的地图中，就像连接器对实时环境中已发布应用程序的响应一样。
使用此字段，您可以在不通过连接器与外部服务通信的情况下测试各种场景及其对自动化中其他操作的影响，例如模拟不同的结果值、错误场景、边缘情况或不愉快的路径。
亚马逊 Bedrock：Invoke 模型
使用 Amazon Bedrock InvokeModel 操作使用请求正文中提供的提示和推理参数进行推断。您可以使用模型推理来生成文本、图像和嵌入。
Properties
Connector
用于此操作运行的操作的连接器。要成功使用此操作，必须将连接器配置为使用 Amazon Bedrock Runtime 作为服务。应使用运行操作的正确凭据设置配置的连接器以及其他配置信息，例如包含操作中引用的任何资源的 AWS 区域。
配置
要在InvokeModel命令中使用的请求的内容。
注意
有关该Amazon Bedrock InvokeModel操作的更多信息，包括示例命令，请参阅 Amazon Bedrock API 参考InvokeModel中的内容。
模拟输出
操作不与预览环境中的外部服务或资源交互。Mocked 输出字段用于提供 JSON 表达式，用于模拟连接器在预览环境中的行为，以进行测试。该代码片段存储在操作results的地图中，就像连接器对实时环境中已发布应用程序的响应一样。
使用此字段，您可以在不通过连接器与外部服务通信的情况下测试各种场景及其对自动化中其他操作的影响，例如模拟不同的结果值、错误场景、边缘情况或不愉快的路径。
JavaScript
运行自定义 JavaScript 函数以返回指定值。
重要
App Studio 不支持使用第三方库或自定义 JavaScript 库。
Properties
源代码
要由操作运行的 JavaScript 代码片段。
提示
您可以使用 AI 通过执行以下步骤来帮助您生成 JavaScript ：
-
选择展开图标打开展开的 JavaScript 编辑器。
-
（可选）：启用 “修改代码” 开关以修改任何现有代码 JavaScript。否则，人工智能将取代任何现有 JavaScript的。
在 “生成” 中 JavaScript，描述你想要做什么 JavaScript，例如:
Add two numbers。选择发送图标来生成您的 JavaScript.
调用自动化
运行指定的自动化。
Properties
调用自动化
操作将运行的自动化。
发送电子邮件
使用该Amazon SES SendEmail操作发送电子邮件。
Properties
Connector
用于此操作运行的操作的连接器。应使用运行操作的正确凭据设置配置的连接器以及其他配置信息，例如包含操作中引用的任何资源的 AWS 区域。
配置
要在SendEmail命令中使用的请求的内容。这些方法如下所示：
注意
有关该Amazon SES SendEmail操作的更多信息，请参阅SendEmail《亚马逊简单电子邮件服务 API 参考》。
模拟输出
操作不与预览环境中的外部服务或资源交互。Mocked 输出字段用于提供 JSON 表达式，用于模拟连接器在预览环境中的行为，以进行测试。该代码片段存储在操作results的地图中，就像连接器对实时环境中已发布应用程序的响应一样。
使用此字段，您可以在不通过连接器与外部服务通信的情况下测试各种场景及其对自动化中其他操作的影响，例如模拟不同的结果值、错误场景、边缘情况或不愉快的路径。
