オートメーションアクションのリファレンス

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

App Studio で使用されるオートメーションアクションのリファレンスドキュメントを次に示します。

一般的にアクションと呼ばれるオートメーションアクションは、オートメーションを構成するロジックの個々のステップです。各アクションは、E メールの送信、データレコードの作成、Lambda 関数の呼び出し、APIs呼び出しなど、特定のタスクを実行します。アクションはアクションライブラリのオートメーションに追加され、条件ステートメントまたはループにグループ化できます。

オートメーションとそのアクションの作成と設定については、「」のトピックを参照してください自動化とアクション: アプリのビジネスロジックを定義する。

API を呼び出す

HTTP REST API リクエストを呼び出します。ビルダーはこのアクションを使用して、APIs を使用して App Studio から他のシステムまたはサービスにリクエストを送信できます。たとえば、これを使用してサードパーティーのシステムや自社開発アプリケーションに接続し、ビジネスクリティカルなデータにアクセスしたり、専用の App Studio アクションでは呼び出せない API エンドポイントを呼び出すことができます。

REST APIsRESTful API とは」を参照してください。

プロパティ

コネクタ

このアクションによって行われた API リクエストに使用するコネクタ。コネクタドロップダウンには、 API Connectorおよび タイプのコネクタのみが含まれますOpenAPI Connector。コネクタの設定方法に応じて、認証情報やデフォルトのヘッダー、クエリパラメータなどの重要な情報を含めることができます。

API Connector と の使用の比較など、API コネクタの詳細についてはOpenAPI Connector、「」を参照してくださいサードパーティーのサービスに接続する。

API リクエスト設定プロパティ

プロパティパネルから API リクエストの設定 を選択して、リクエスト設定ダイアログボックスを開きます。API コネクタが選択されている場合、ダイアログボックスにはコネクタ情報が含まれます。

メソッド： API コールのメソッド。可能な値は以下のとおりです。

パス： リソースへの相対パス。

ヘッダー： API リクエストで送信されるキーと値のペアの形式のヘッダー。コネクタが選択されている場合、設定されたヘッダーは自動的に追加され、削除することはできません。設定されたヘッダーは編集できませんが、同じ名前の別のヘッダーを追加して上書きできます。

クエリパラメータ： API リクエストで送信されるキーと値のペアの形式のクエリパラメータ。コネクタが選択されている場合、その設定済みクエリパラメータは自動的に追加され、編集または削除することはできません。

本文： API リクエストとともに JSON 形式で送信される情報。GET リクエストの本文はありません。

モック出力

アクションは、プレビュー環境の外部サービスやリソースとやり取りしません。モック出力フィールドは、テスト目的でプレビュー環境でコネクタの動作をシミュレートする JSON 式を提供するために使用されます。このスニペットは、ライブ環境で公開されたアプリのコネクタレスポンスと同様に、アクションのresultsマップに保存されます。

このフィールドを使用すると、コネクタを介して外部サービスと通信することなく、さまざまな結果値、エラーシナリオ、エッジケース、不満のあるパスのシミュレートなど、自動化内の他のアクションに対するさまざまなシナリオとその影響をテストできます。

呼び出し AWS

AWS サービスから オペレーションを呼び出します。これはサービス AWS またはオペレーションを呼び出すための一般的なアクションであり、目的の AWS サービスまたはオペレーション専用のアクションがない場合に使用する必要があります。

プロパティ

サービス

実行するオペレーションを含む AWS サービス。

Operation

実行するオペレーション。

コネクタ

このアクションによって実行されるオペレーションに使用されるコネクタ。設定済みコネクタは、オペレーションを実行するための適切な認証情報と、オペレーションで参照されるリソースを含む AWS リージョンなどのその他の設定情報を使用して設定する必要があります。

設定

指定されたオペレーションを実行するときの JSON 入力。 AWS オペレーションの入力の設定の詳細については、「」を参照してくださいAWS SDK for JavaScript。

Lambda を呼び出す

既存の Lambda 関数を呼び出します。

プロパティ

コネクタ

このアクションによって実行される Lambda 関数に使用されるコネクタ。設定済みコネクタは、Lambda 関数にアクセスするための適切な認証情報と、Lambda 関数を含む AWS リージョンなどのその他の設定情報を使用して設定する必要があります。Lambda のコネクタの設定の詳細については、「」を参照してくださいステップ 3: Lambda コネクタを作成する。

関数名

実行する Lambda 関数の名前。これは関数名であり、関数 ARN (Amazon リソースネーム) ではないことに注意してください。

関数イベント

イベントペイロードとして Lambda 関数に渡されるキーと値のペア。

モック出力

アクションは、プレビュー環境の外部サービスやリソースとやり取りしません。モック出力フィールドは、テスト目的でプレビュー環境でコネクタの動作をシミュレートする JSON 式を提供するために使用されます。このスニペットは、ライブ環境で公開されたアプリのコネクタレスポンスと同様に、アクションのresultsマップに保存されます。

このフィールドを使用すると、コネクタを介して外部サービスと通信することなく、さまざまな結果値、エラーシナリオ、エッジケース、不満のあるパスのシミュレートなど、自動化内の他のアクションに対するさまざまなシナリオとその影響をテストできます。

[Loop] (ループ)

ネストされたアクションを繰り返し実行して、項目のリストを一度に 1 つずつ反復処理します。たとえば、 レコードの作成アクションをループアクションに追加して、複数のレコードを作成します。

ループアクションは、他のループまたは条件アクション内にネストできます。ループアクションは、並列ではなく順番に実行されます。ループ内の各アクションの結果は、同じループ反復内の後続のアクションにのみアクセスできます。ループの外部またはループの異なる反復でアクセスすることはできません。

プロパティ

ソース

反復処理する項目のリスト。一度に 1 つの項目。ソースは、前のアクションの結果、または JavaScript 式を使用して指定できる文字列、数値、またはオブジェクトの静的リストの結果です。

例

次のリストには、ソース入力の例が含まれています。

現在の項目名

反復する現在の項目を参照するために使用できる変数の名前。現在の項目名は、2 つ以上のループをネストし、各ループから変数にアクセスできるように設定できます。たとえば、2 つのループを持つ国と都市をループする場合は、 と を設定currentCountryして参照できますcurrentCity。

条件

オートメーションの実行時に評価される 1 つ以上の指定された論理条件の結果に基づいてアクションを実行します。条件アクションは、次のコンポーネントで構成されます。

条件アクションにドラッグして、アクションを true ブランチと false ブランチに追加します。

プロパティ

条件

アクションの実行時に評価される JavaScript 式。

レコードの作成

既存の App Studio エンティティに 1 つのレコードを作成します。

プロパティ

エンティティ

レコードを作成するエンティティ。エンティティを選択すると、レコードを作成するエンティティのフィールドに値を追加する必要があります。フィールドのタイプ、およびフィールドが必須かオプションかは、エンティティで定義されます。

レコードの更新

App Studio エンティティの既存のレコードを更新します。

プロパティ

エンティティ

更新するレコードを含むエンティティ。

条件

アクションによって更新されるレコードを定義する基準。条件をグループ化して、1 つの論理ステートメントを作成できます。グループまたは条件を ANDまたは ORステートメントと組み合わせることができます。

フィールド

条件によって指定されたレコードで更新されるフィールド。

値

指定されたフィールドで更新される値。

レコードの削除

App Studio エンティティからレコードを削除します。

プロパティ

エンティティ

削除するレコードを含むエンティティ。

条件

アクションによって削除するレコードを定義する基準。条件をグループ化して、1 つのロジックステートメントを作成できます。グループまたは条件を ANDまたは ORステートメントと組み合わせることができます。

データアクションを呼び出す

オプションのパラメータを使用してデータアクションを実行します。

プロパティ

データアクション

アクションによって実行されるデータアクション。

パラメータ

データアクションで使用されるデータアクションパラメータ。データアクションパラメータは、データアクションの入力として使用される値を送信するために使用されます。データアクションパラメータはオートメーションアクションを設定するときに追加できますが、データタブで編集する必要があります。

詳細設定

Invoke data action アクションには、次の詳細設定が含まれます。

Amazon S3: オブジェクトを配置する

Amazon S3 PutObject オペレーションを使用して、指定された Amazon S3 バケットにキー (ファイルパス) で識別されるオブジェクトを追加します。

プロパティ

コネクタ

このアクションによって実行されるオペレーションに使用されるコネクタ。設定済みコネクタは、オペレーションを実行するための適切な認証情報と、オペレーションで参照されるリソースを含む AWS リージョンなどのその他の設定情報を使用して設定する必要があります。

設定

PutObject コマンドで使用する必須オプション。オプションは以下のとおりです:

モック出力

アクションは、プレビュー環境の外部サービスやリソースとやり取りしません。モック出力フィールドは、テスト目的でプレビュー環境でコネクタの動作をシミュレートする JSON 式を提供するために使用されます。このスニペットは、ライブ環境で公開されたアプリのコネクタレスポンスと同様に、アクションのresultsマップに保存されます。

このフィールドを使用すると、コネクタを介して外部サービスと通信することなく、さまざまな結果値、エラーシナリオ、エッジケース、不満のあるパスのシミュレートなど、オートメーション内の他のアクションに対するさまざまなシナリオとその影響をテストできます。

Amazon S3: オブジェクトの削除

Amazon S3 DeleteObject オペレーションを使用して、指定された Amazon S3 バケットからキー (ファイルパス) によって識別されるオブジェクトを削除します。

プロパティ

コネクタ

このアクションによって実行されるオペレーションに使用されるコネクタ。設定済みコネクタは、オペレーションを実行するための適切な認証情報と、オペレーションで参照されるリソースを含む AWS リージョンなどのその他の設定情報を使用して設定する必要があります。

設定

DeleteObject コマンドで使用する必須オプション。オプションは以下のとおりです:

モック出力

アクションは、プレビュー環境の外部サービスやリソースとやり取りしません。モック出力フィールドは、テスト目的でプレビュー環境のコネクタの動作をシミュレートする JSON 式を提供するために使用されます。このスニペットは、ライブ環境で公開されたアプリのコネクタレスポンスと同様に、アクションのresultsマップに保存されます。

このフィールドを使用すると、コネクタを介して外部サービスと通信することなく、さまざまな結果値、エラーシナリオ、エッジケース、不満のあるパスのシミュレートなど、オートメーション内の他のアクションに対するさまざまなシナリオとその影響をテストできます。

Amazon S3: オブジェクトの取得

Amazon S3 GetObject オペレーションを使用して、指定された Amazon S3 バケットからキー (ファイルパス) によって識別されるオブジェクトを取得します。

プロパティ

コネクタ

このアクションによって実行されるオペレーションに使用されるコネクタ。設定済みコネクタは、オペレーションを実行するための適切な認証情報と、オペレーションで参照されるリソースを含む AWS リージョンなどのその他の設定情報を使用して設定する必要があります。

設定

GetObject コマンドで使用する必須オプション。オプションは以下のとおりです:

モック出力

アクションは、プレビュー環境の外部サービスやリソースとやり取りしません。モック出力フィールドは、テスト目的でプレビュー環境のコネクタの動作をシミュレートする JSON 式を提供するために使用されます。このスニペットは、ライブ環境で公開されたアプリのコネクタレスポンスと同様に、アクションのresultsマップに保存されます。

このフィールドを使用すると、コネクタを介して外部サービスと通信することなく、さまざまな結果値、エラーシナリオ、エッジケース、不満のあるパスのシミュレートなど、オートメーション内の他のアクションに対するさまざまなシナリオとその影響をテストできます。

Amazon S3: オブジェクトを一覧表示する

Amazon S3 ListObjects オペレーションを使用して、指定された Amazon S3 バケット内のオブジェクトを一覧表示します。

プロパティ

コネクタ

このアクションによって実行されるオペレーションに使用されるコネクタ。設定済みコネクタは、オペレーションを実行するための適切な認証情報と、オペレーションで参照されるリソースを含む AWS リージョンなどのその他の設定情報を使用して設定する必要があります。

設定

ListObjects コマンドで使用する必須オプション。オプションは以下のとおりです:

モック出力

アクションは、プレビュー環境の外部サービスやリソースとやり取りしません。モック出力フィールドは、テスト目的でプレビュー環境でコネクタの動作をシミュレートする JSON 式を提供するために使用されます。このスニペットは、ライブ環境で公開されたアプリのコネクタレスポンスと同様に、アクションのresultsマップに保存されます。

このフィールドを使用すると、コネクタを介して外部サービスと通信することなく、さまざまな結果値、エラーシナリオ、エッジケース、不満のあるパスのシミュレートなど、オートメーション内の他のアクションに対するさまざまなシナリオとその影響をテストできます。

Amazon Textract: ドキュメントを分析する

Amazon Textract AnalyzeDocument オペレーションを使用して、検出された項目間の関係について入力ドキュメントを分析します。

プロパティ

コネクタ

このアクションによって実行されるオペレーションに使用されるコネクタ。設定済みコネクタは、オペレーションを実行するための適切な認証情報と、オペレーションで参照されるリソースを含む AWS リージョンなどのその他の設定情報を使用して設定する必要があります。

設定

AnalyzeDocument コマンドで使用するリクエストの内容。オプションは以下のとおりです:

モック出力

アクションは、プレビュー環境の外部サービスやリソースとやり取りしません。モック出力フィールドは、テスト目的でプレビュー環境でコネクタの動作をシミュレートする JSON 式を提供するために使用されます。このスニペットは、ライブ環境で公開されたアプリのコネクタレスポンスと同様に、アクションのresultsマップに保存されます。

このフィールドを使用すると、コネクタを介して外部サービスと通信することなく、さまざまな結果値、エラーシナリオ、エッジケース、不満のあるパスのシミュレートなど、オートメーション内の他のアクションに対するさまざまなシナリオとその影響をテストできます。

Amazon Textract: コストを分析する

Amazon Textract AnalyzeExpense オペレーションを使用して、テキスト間の財務関係について入力ドキュメントを分析します。

プロパティ

コネクタ

このアクションによって実行されるオペレーションに使用されるコネクタ。設定済みコネクタは、オペレーションを実行するための適切な認証情報と、オペレーションで参照されるリソースを含む AWS リージョンなどのその他の設定情報を使用して設定する必要があります。

設定

AnalyzeExpense コマンドで使用するリクエストの内容。オプションは以下のとおりです:

モック出力

アクションは、プレビュー環境の外部サービスやリソースとやり取りしません。モック出力フィールドは、テスト目的でプレビュー環境内のコネクタの動作をシミュレートする JSON 式を提供するために使用されます。このスニペットは、ライブ環境で公開されたアプリのコネクタレスポンスと同様に、アクションのresultsマップに保存されます。

このフィールドを使用すると、コネクタを介して外部サービスと通信することなく、さまざまな結果値、エラーシナリオ、エッジケース、不満のあるパスのシミュレートなど、オートメーション内の他のアクションに対するさまざまなシナリオとその影響をテストできます。

Amazon Textract: ID を分析する

Amazon Textract AnalyzeID オペレーションを使用して、ID ドキュメントの関連情報を分析します。

プロパティ

コネクタ

このアクションによって実行されるオペレーションに使用されるコネクタ。設定済みコネクタは、オペレーションを実行するための適切な認証情報と、オペレーションで参照されるリソースを含む AWS リージョンなどのその他の設定情報を使用して設定する必要があります。

設定

AnalyzeID コマンドで使用するリクエストの内容。オプションは以下のとおりです:

モック出力

アクションは、プレビュー環境の外部サービスやリソースとやり取りしません。モック出力フィールドは、テスト目的でプレビュー環境でコネクタの動作をシミュレートする JSON 式を提供するために使用されます。このスニペットは、ライブ環境で公開されたアプリのコネクタレスポンスと同様に、アクションのresultsマップに保存されます。

このフィールドを使用すると、コネクタを介して外部サービスと通信することなく、さまざまな結果値、エラーシナリオ、エッジケース、不満のあるパスのシミュレートなど、オートメーション内の他のアクションに対するさまざまなシナリオとその影響をテストできます。

Amazon Textract: ドキュメントテキストを検出する

Amazon Textract DetectDocumentText オペレーションを使用して、入力ドキュメント内のテキスト行とテキスト行を構成する単語を検出します。

プロパティ

コネクタ

このアクションによって実行されるオペレーションに使用されるコネクタ。設定済みコネクタは、オペレーションを実行するための適切な認証情報と、オペレーションで参照されるリソースを含む AWS リージョンなどのその他の設定情報を使用して設定する必要があります。

設定

DetectDocumentText コマンドで使用するリクエストの内容。オプションは以下のとおりです:

モック出力

アクションは、プレビュー環境の外部サービスやリソースとやり取りしません。モック出力フィールドは、テスト目的でプレビュー環境でコネクタの動作をシミュレートする JSON 式を提供するために使用されます。このスニペットは、ライブ環境で公開されたアプリのコネクタレスポンスと同様に、アクションのresultsマップに保存されます。

このフィールドを使用すると、コネクタを介して外部サービスと通信することなく、さまざまな結果値、エラーシナリオ、エッジケース、不満のあるパスのシミュレートなど、オートメーション内の他のアクションに対するさまざまなシナリオとその影響をテストできます。

Amazon Bedrock: GenAI プロンプト

Amazon Bedrock InvokeModel オペレーションを使用して、アクションプロパティで提供されるプロンプトパラメータと推論パラメータを使用して推論を実行します。アクションは、テキスト、イメージ、埋め込みを生成できます。

プロパティ

コネクタ

このアクションによって実行されるオペレーションに使用されるコネクタ。このアクションを正常に使用するには、Amazon Bedrock ランタイムをサービスとしてコネクタを設定する必要があります。設定済みコネクタは、オペレーションを実行するための適切な認証情報と、オペレーションで参照されるリソースを含む AWS リージョンなどのその他の設定情報を使用して設定する必要があります。

モデル

Amazon Bedrock がリクエストを処理するために使用される基盤モデル。Amazon Bedrock のモデルの詳細については、「Amazon Bedrock ユーザーガイド」の「Amazon Bedrock 基盤モデル情報」を参照してください。

入力タイプ

Amazon Bedrock モデルに送信する入力の入力タイプ。指定できる値は、テキスト、ドキュメント、イメージです。入力タイプを選択できない場合、設定されたモデルではサポートされていない可能性があります。

ユーザープロンプト

Amazon Bedrock モデルに送信され、レスポンスを生成するために処理されるプロンプト。静的テキストを入力するか、パラメータ、オートメーションの以前のアクション、または別のオートメーションを使用して、コンポーネントなど、アプリケーションの別の部分から入力を渡すことができます。次の例は、コンポーネントまたは以前のアクションから値を渡す方法を示しています。

システムプロンプト (Claude モデル）

リクエストの処理時に Amazon Bedrock モデルで使用されるシステムプロンプト。システムプロンプトは、Claude モデルにコンテキスト、手順、またはガイドラインを提供するために使用されます。

リクエスト設定

さまざまなリクエスト設定とモデル推論パラメータを設定します。以下の設定を設定できます。

詳細については、「Amazon Bedrock ユーザーガイド」の「基盤モデルの推論リクエストパラメータとレスポンスフィールド」を参照してください。

停止シーケンス

Amazon Bedrock ガードレール ID とバージョンを入力します。ガードレールは、ユースケースと責任ある AI ポリシーに基づいて保護を実装するために使用されます。詳細については、「Amazon Bedrock ユーザーガイド」の「Amazon Bedrock ガードレールを使用してモデルの有害なコンテンツを停止する」を参照してください。

モック出力

アクションは、プレビュー環境の外部サービスやリソースとやり取りしません。モック出力フィールドは、テスト目的でプレビュー環境でコネクタの動作をシミュレートする JSON 式を提供するために使用されます。このスニペットは、ライブ環境で公開されたアプリのコネクタレスポンスと同様に、アクションのresultsマップに保存されます。

このフィールドを使用すると、コネクタを介して外部サービスと通信することなく、さまざまな結果値、エラーシナリオ、エッジケース、不満のあるパスのシミュレートなど、オートメーション内の他のアクションに対するさまざまなシナリオとその影響をテストできます。

Amazon Bedrock: モデルを呼び出す

Amazon Bedrock InvokeModel オペレーションを使用して、リクエスト本文で指定されたプロンプトパラメータと推論パラメータを使用して推論を実行します。モデル推論を使用して、テキスト、イメージ、埋め込みを生成します。

プロパティ

コネクタ

このアクションによって実行されるオペレーションに使用されるコネクタ。このアクションを正常に使用するには、Amazon Bedrock ランタイムをサービスとしてコネクタを設定する必要があります。設定済みコネクタは、オペレーションを実行するための適切な認証情報と、オペレーションで参照されるリソースを含む AWS リージョンなどのその他の設定情報を使用して設定する必要があります。

設定

InvokeModel コマンドで使用するリクエストの内容。

モック出力

アクションは、プレビュー環境の外部サービスやリソースとやり取りしません。モック出力フィールドは、テスト目的でプレビュー環境でコネクタの動作をシミュレートする JSON 式を提供するために使用されます。このスニペットは、ライブ環境で公開されたアプリのコネクタレスポンスと同様に、アクションのresultsマップに保存されます。

このフィールドを使用すると、コネクタを介して外部サービスと通信することなく、さまざまな結果値、エラーシナリオ、エッジケース、不満のあるパスのシミュレートなど、オートメーション内の他のアクションに対するさまざまなシナリオとその影響をテストできます。

JavaScript

カスタム JavaScript 関数を実行して、指定された値を返します。

プロパティ

ソースコード

アクションによって実行される JavaScript コードスニペット。

オートメーションを呼び出す

指定されたオートメーションを実行します。

プロパティ

自動化を呼び出す

アクションによって実行されるオートメーション。

E メールの送信

Amazon SES SendEmail オペレーションを使用して E メールを送信します。

プロパティ

コネクタ

このアクションによって実行されるオペレーションに使用されるコネクタ。設定済みコネクタは、オペレーションを実行するための適切な認証情報と、オペレーションで参照されるリソースを含む AWS リージョンなどのその他の設定情報を使用して設定する必要があります。

設定

SendEmail コマンドで使用するリクエストの内容。オプションは以下のとおりです:

モック出力

アクションは、プレビュー環境の外部サービスやリソースとやり取りしません。モック出力フィールドは、テスト目的でプレビュー環境でコネクタの動作をシミュレートする JSON 式を提供するために使用されます。このスニペットは、ライブ環境で公開されたアプリのコネクタレスポンスと同様に、アクションのresultsマップに保存されます。

このフィールドを使用すると、コネクタを介して外部サービスと通信することなく、さまざまな結果値、エラーシナリオ、エッジケース、不満のあるパスのシミュレートなど、オートメーション内の他のアクションに対するさまざまなシナリオとその影響をテストできます。