

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 自動化動作參考
<a name="automations-actions-reference"></a>

以下是 App Studio 中使用的自動化動作參考文件。

自動化動作通常稱為**動作**，是構成自動化之邏輯的個別步驟。每個動作都會執行特定任務，無論是傳送電子郵件、建立資料記錄、叫用 Lambda 函數或呼叫 APIs。動作會從動作程式庫新增至自動化，並可分組為條件式陳述式或迴圈。

如需有關建立和設定自動化及其動作的資訊，請參閱 中的主題[自動化和動作：定義應用程式的商業邏輯](automations.md)。

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

叫用 HTTP REST API 請求。建置器可以使用此動作，透過 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>

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

用於此動作提出之 API 請求的 **Connector**。連接器下拉式清單僅包含下列類型的連接器： `API Connector`和 `OpenAPI Connector`。根據連接器的設定方式，它可以包含重要資訊，例如登入資料和預設標頭或查詢參數。

如需 API 連接器的詳細資訊，包括使用 `API Connector`和 之間的比較`OpenAPI Connector`，請參閱 [連線至第三方服務](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 請求一起傳送的鍵/值對形式的查詢參數。如果選取連接器，其設定的查詢參數會自動新增，且無法編輯或移除。

**內文：**以 JSON 格式與 API 請求一起傳送的資訊。`GET` 請求沒有內文。

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

動作不會與預覽環境中的外部服務或資源互動。**模擬輸出**欄位用於提供 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>

要執行的操作。

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

用於此動作所執行操作的連接器。設定的連接器應設定適當的登入資料來執行操作，以及其他組態資訊，例如包含操作中參考之任何資源 AWS 的區域。

#### Configuration
<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>

#### 連接器
<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 Resource Name)。

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

要做為事件承載傳遞至 Lambda 函數的鍵值對。

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

動作不會與預覽環境中的外部服務或資源互動。**模擬輸出**欄位用於提供 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`或 的 JavaScript 表達式`false`。
+ *true 分支*，其中包含條件評估為 時執行的動作`true`。
+ *false 分支*，其中包含條件評估為 時執行的動作`false`。

將動作拖曳至條件動作，以新增至 true 和 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>

包含要更新之記錄的實體。

#### 條件
<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>

包含要刪除之記錄的實體。

#### 條件
<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>

動作要執行的資料動作。

#### Parameters
<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 筆記錄。如果沒有更多記錄或頁面，則不會定義字符。

## Amazon 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>

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

用於此動作所執行操作的連接器。設定的連接器應設定適當的登入資料來執行操作，以及其他組態資訊，例如包含操作中參考之任何資源 AWS 的區域。

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

要在 `PutObject`命令中使用的必要選項。選項如下：

**注意**  
如需 `Amazon S3 PutObject`操作的詳細資訊，請參閱《*Amazon Simple Storage Service API 參考*》中的 [PutObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html)。
+ **儲存貯體：**要在其中放置物件的 Amazon S3 儲存貯體名稱。
+ **金鑰：**要放入 Amazon S3 儲存貯體之物件的唯一名稱。
+ **內文：**要放入 Amazon S3 儲存貯體的物件內容。

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

動作不會與預覽環境中的外部服務或資源互動。**模擬輸出**欄位用於提供 JSON 表達式，模擬預覽環境中連接器的行為，以供測試之用。此程式碼片段會存放在動作的`results`映射中，就像在即時環境中發佈的應用程式的連接器回應一樣。

透過此欄位，您可以測試各種案例及其對自動化內其他動作的影響，例如模擬不同的結果值、錯誤案例、邊緣案例或不快樂的路徑，而無需透過連接器與外部服務通訊。

## Amazon 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>

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

用於此動作所執行操作的連接器。設定的連接器應設定適當的登入資料來執行操作，以及其他組態資訊，例如包含操作中參考之任何資源 AWS 的區域。

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

要在 `DeleteObject`命令中使用的必要選項。選項如下：

**注意**  
如需 `Amazon S3 DeleteObject`操作的詳細資訊，請參閱《*Amazon Simple Storage Service API 參考*》中的 [DeleteObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html)。
+ **儲存貯體：**從中刪除物件的 Amazon S3 儲存貯體名稱。
+ **金鑰：**要從 Amazon S3 儲存貯體刪除之物件的唯一名稱。

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

動作不會與預覽環境中的外部服務或資源互動。**模擬輸出**欄位用於提供 JSON 表達式，模擬預覽環境中連接器的行為，以供測試之用。此程式碼片段會存放在動作的`results`映射中，就像在即時環境中發佈的應用程式的連接器回應一樣。

透過此欄位，您可以測試各種案例及其對自動化內其他動作的影響，例如模擬不同的結果值、錯誤案例、邊緣案例或不快樂的路徑，而無需透過連接器與外部服務通訊。

## Amazon 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>

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

用於此動作所執行操作的連接器。設定的連接器應設定適當的登入資料來執行操作，以及其他組態資訊，例如包含操作中參考之任何資源 AWS 的區域。

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

要在 `GetObject`命令中使用的必要選項。選項如下：

**注意**  
如需 `Amazon S3 GetObject`操作的詳細資訊，請參閱《*Amazon Simple Storage Service API 參考*》中的 [GetObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html)。
+ **儲存貯體：**要從中擷取物件的 Amazon S3 儲存貯體名稱。
+ **金鑰：**要從 Amazon S3 儲存貯體擷取之物件的唯一名稱。

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

動作不會與預覽環境中的外部服務或資源互動。**模擬輸出**欄位用於提供 JSON 表達式，模擬預覽環境中連接器的行為，以供測試之用。此程式碼片段會存放在動作的`results`映射中，就像在即時環境中發佈的應用程式的連接器回應一樣。

透過此欄位，您可以測試各種案例及其對自動化內其他動作的影響，例如模擬不同的結果值、錯誤案例、邊緣案例或不快樂的路徑，而無需透過連接器與外部服務通訊。

## Amazon 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>

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

用於此動作所執行操作的連接器。設定的連接器應設定適當的登入資料來執行操作，以及其他組態資訊，例如包含操作中參考之任何資源 AWS 的區域。

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

要在 `ListObjects`命令中使用的必要選項。選項如下：

**注意**  
如需 `Amazon S3 ListObjects`操作的詳細資訊，請參閱《*Amazon Simple Storage Service API 參考*》中的 [ListObjects](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html)。
+ **儲存貯體：**要從中列出物件的 Amazon S3 儲存貯體名稱。

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

動作不會與預覽環境中的外部服務或資源互動。**模擬輸出**欄位用於提供 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>

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

用於此動作所執行操作的連接器。設定的連接器應設定適當的登入資料來執行操作，以及其他組態資訊，例如包含操作中參考之任何資源 AWS 的區域。

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

要在`AnalyzeDocument`命令中使用的請求內容。選項如下：

**注意**  
如需 `Amazon Textract AnalyzeDocument`操作的詳細資訊，請參閱《*Amazon Textract 開發人員指南*》中的 [AnalyzeDocument](https://docs.aws.amazon.com/textract/latest/dg/API_AnalyzeDocument.html)。
+ **文件/S3Object/儲存貯體：**Amazon 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>

動作不會與預覽環境中的外部服務或資源互動。**模擬輸出**欄位用於提供 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>

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

用於此動作所執行操作的連接器。設定的連接器應設定適當的登入資料來執行操作，以及其他組態資訊，例如包含操作中參考之任何資源 AWS 的區域。

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

要在`AnalyzeExpense`命令中使用的請求內容。選項如下：

**注意**  
如需 `Amazon Textract AnalyzeExpense`操作的詳細資訊，請參閱《*Amazon Textract 開發人員指南*》中的 [AnalyzeExpense](https://docs.aws.amazon.com/textract/latest/dg/API_AnalyzeExpense.html)。
+ **文件/S3Object/儲存貯體：**Amazon S3 儲存貯體的名稱。如果檔案透過 **S3 上傳**元件傳遞至 動作，則此參數可以保留空白。
+ **文件/S3Object/名稱：**輸入文件的檔案名稱。如果檔案透過 **S3 上傳**元件傳遞至 動作，則此參數可以保留空白。
+ **文件/S3Object/版本：**如果 Amazon S3 儲存貯體已啟用版本控制，您可以指定物件的版本。如果檔案透過 **S3 上傳**元件傳遞至 動作，則此參數可以保留空白。

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

動作不會與預覽環境中的外部服務或資源互動。**模擬輸出**欄位用於提供 JSON 表達式，模擬預覽環境中連接器的行為，以供測試之用。此程式碼片段會存放在動作的`results`映射中，就像在即時環境中發佈的應用程式的連接器回應一樣。

透過此欄位，您可以測試各種案例及其對自動化內其他動作的影響，例如模擬不同的結果值、錯誤案例、邊緣案例或不快樂的路徑，而無需透過連接器與外部服務通訊。

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

使用 `Amazon Textract AnalyzeID`操作來分析身分文件以取得相關資訊。

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

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

用於此動作所執行操作的連接器。設定的連接器應設定適當的登入資料來執行操作，以及其他組態資訊，例如包含操作中參考之任何資源 AWS 的區域。

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

要在`AnalyzeID`命令中使用的請求內容。選項如下：

**注意**  
如需 `Amazon Textract AnalyzeID`操作的詳細資訊，請參閱《*Amazon Textract 開發人員指南*》中的 [AnalyzeID](https://docs.aws.amazon.com/textract/latest/dg/API_AnalyzeID.html)。
+ **文件/S3Object/儲存貯體：**Amazon S3 儲存貯體的名稱。如果檔案使用 **S3 上傳**元件傳遞至 動作，則此參數可以保留空白。
+ **文件/S3Object/名稱：**輸入文件的檔案名稱。如果檔案透過 **S3 上傳**元件傳遞至 動作，則此參數可以保留空白。
+ **文件/S3Object/版本：**如果 Amazon S3 儲存貯體已啟用版本控制，您可以指定物件的版本。如果檔案透過 **S3 上傳**元件傳遞至 動作，則此參數可以保留空白。

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

動作不會與預覽環境中的外部服務或資源互動。**模擬輸出**欄位用於提供 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>

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

用於此動作所執行操作的連接器。設定的連接器應設定適當的登入資料來執行操作，以及其他組態資訊，例如包含操作中參考之任何資源 AWS 的區域。

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

要在`DetectDocumentText`命令中使用的請求內容。選項如下：

**注意**  
如需 `Amazon Textract DetectDocumentText`操作的詳細資訊，請參閱《*Amazon Textract 開發人員指南*》中的 [DetectDocumentText](https://docs.aws.amazon.com/textract/latest/dg/API_DetectDocumentText.html)。
+ **文件/S3Object/儲存貯體：**Amazon S3 儲存貯體的名稱。如果檔案使用 **S3 上傳**元件傳遞至 動作，則此參數可以保留空白。
+ **文件/S3Object/名稱：**輸入文件的檔案名稱。如果檔案透過 **S3 上傳**元件傳遞至 動作，則此參數可以保留空白。
+ **文件/S3Object/版本：**如果 Amazon S3 儲存貯體已啟用版本控制，您可以指定物件的版本。如果檔案透過 **S3 上傳**元件傳遞至 動作，則此參數可以保留空白。

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

動作不會與預覽環境中的外部服務或資源互動。**模擬輸出**欄位用於提供 JSON 表達式，模擬預覽環境中連接器的行為，以供測試之用。此程式碼片段會存放在動作的`results`映射中，就像在即時環境中發佈的應用程式的連接器回應一樣。

透過此欄位，您可以測試各種案例及其對自動化內其他動作的影響，例如模擬不同的結果值、錯誤案例、邊緣案例或不快樂的路徑，而無需透過連接器與外部服務通訊。

## Amazon Bedrock：GenAI 提示
<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>

#### 連接器
<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 用來處理請求的基礎模型。如需 Amazon Bedrock 中模型的詳細資訊，請參閱《[Amazon Bedrock 使用者指南》中的 Amazon 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}}`

#### 系統提示 (Claude 模型）
<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**：在核心取樣中，模型會以遞減的機率順序計算每個後續字符所有選項的累積分佈，並在達到 **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** 和**版本**。護欄用於根據您的使用案例和負責任的 AI 政策實作保護措施。如需詳細資訊，請參閱《[Amazon 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>

動作不會與預覽環境中的外部服務或資源互動。**模擬輸出**欄位用於提供 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>

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

用於此動作所執行操作的連接器。若要成功使用此動作，必須使用 **Amazon Bedrock 執行期**做為服務來設定連接器。設定的連接器應該設定適當的登入資料來執行操作，以及其他組態資訊，例如包含操作中參考之任何資源 AWS 的區域。

#### Configuration
<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>

動作不會與預覽環境中的外部服務或資源互動。**模擬輸出**欄位用於提供 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。否則，AI 將取代任何現有的 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>

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

用於此動作所執行操作的連接器。設定的連接器應設定適當的登入資料來執行操作，以及其他組態資訊，例如包含操作中參考之任何資源 AWS 的區域。

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

要在`SendEmail`命令中使用的請求內容。選項如下：

**注意**  
如需 `Amazon SES SendEmail`操作的詳細資訊，請參閱《Amazon Simple Email Service API 參考》中的 [SendEmail](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html)。 **

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

動作不會與預覽環境中的外部服務或資源互動。**模擬輸出**欄位用於提供 JSON 表達式，模擬預覽環境中連接器的行為，以供測試之用。此程式碼片段會存放在動作的`results`映射中，就像在即時環境中發佈的應用程式的連接器回應一樣。

透過此欄位，您可以測試各種案例及其對自動化內其他動作的影響，例如模擬不同的結果值、錯誤案例、邊緣案例或不快樂的路徑，而無需透過連接器與外部服務通訊。