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

# オートメーションの構築
<a name="building-automations"></a>

Amazon Quick Automate には、さまざまなニーズやスキルレベルに合わせて自動化を作成するための複数の方法が用意されています。このセクションでは、使用可能な作成方法とツールについて説明します。

## 前提条件
<a name="building-prerequisites"></a>

オートメーションを作成する前に、特定のオートメーショングループ内にプロジェクトを作成する必要があります。自動化グループは、その自動化を構築するときに使用できる統合と認証情報を制御します。オートメーションでやり取りする予定の外部システムに必要な統合と認証情報が設定されていることを確認します。

プロジェクトを作成したら、**構築の開始**ボタンをクリックして開始します。

**注記**  
オートメーショングループの統合と認証情報を管理するには、所有者のアクセス許可が必要です。

## 作成方法
<a name="creation-methods"></a>

自動化を構築するための 3 つのアプローチから選択します。Amazon Quick Automate を初めて使用する場合は、次のことをお勧めします。
+ まず、サンプルの自動化について説明します。
+ 自然言語を使用したシンプルなオートメーションの作成を試す
+ 基本を理解したら、手動編集を試す

### サンプルオートメーションの使用
<a name="using-sample-automations"></a>

一般的な自動化パターンを示す構築済みのサンプルを調べることで、すぐに開始できます。これらのサンプルは、さまざまな自動化機能の実践的な例を提供し、Amazon Quick Automate の機能に慣れるための学習リソースとして機能します。サンプルオートメーションを使用するには:
+ 検索して、業界別のさまざまなサンプルを調べます。
+ サンプルをクリックして、オートメーションの概要を表示します。
  + 統合が必要な場合は、前提条件として表示されます。
+ **Start with sample** をクリックして、キャンバスでオートメーションを開きます。
+ これで、オートメーションを表示、編集、テストできるようになります。

### 自然言語を使用した の作成
<a name="creating-with-natural-language"></a>

Automation Assistant は、以下を通じて自動化を作成するための AI を活用したアプローチを提供します。
+ チャットインターフェイス - プロセスを自然言語で会話的に説明する
+ ドキュメントのアップロード - プロセスのステップと要件を説明するドキュメントをインポートします。

どちらの方法でも入力を提供すると、自動化アシスタントは 2 ステップのガイド付きエクスペリエンスを通じて自動化を生成します。
+ **大まかな計画**
  + まず、 Assistant は要件を分析し、高レベルのオートメーションプランを生成します。この計画は、自動化の一環として関連するアクションを論理的にグループ化する**プロセスステップ**で構成されます。各プロセスステップには、最初は自然言語の手順が含まれています。
  + 各プロセスステップの手順を確認して編集し、**生成**をクリックしてそのステップの低レベルアクションを作成します。
+ **低レベルのアクション**
  + 次に、アシスタントはステップの指示に基づいて低レベルのアクションとプロセスロジックを構築します。
  + 生成されたアクションを確認して編集します。**Run** または **Debug** をクリックしてテストを開始します。

自然言語入力を提供するためのベストプラクティス:
+ 新規採用者をトレーニングしているかのように、ステップバイステップのプロセスを指定します。
+ 各ステップの実行に必要な正確な詳細を含めます。
  + メッセージを送信する場合の E メールアドレス
  + ドキュメントをアップロード/ダウンロードする場合のファイル名と場所
  + ウェブサイトに移動する場合の URL

### ゼロからの作成 (空白の自動化)
<a name="creating-from-scratch"></a>

ビジュアルデザイナーインターフェイスを使用して自動化を手動で構築します。
+ プロジェクト概要に移動する
+ **ビルドの開始** をクリックします。
+ **スキップ**を選択してキャンバスにアクセスする

デザイナーインターフェイスには、いくつかの主要なコンポーネントがあります。
+ **Canvas** - オートメーションを視覚化します。キャンバスのズームインとズームアウト、プロセスステップの展開と折りたたみ、アクションの順序変更を行うことができます。
+ **アクションパネル** - アクションパネルには、オートメーショングループ内で使用可能なすべてのオートメーションアクションの包括的なリストがあります。検索およびフィルタリングして、カテゴリ (エージェント、プロセスフロー、ウェブブラウザなど) 別に整理されたアクションを検索できます。アクションをキャンバスにDrag-and-dropしてオートメーションを構築します。アクション間を移動するときに見つかったプラス記号をクリックして、キャンバスに直接新しいアクションを追加することもできます。
+ **プロパティパネル** - アクションを追加するか、プロセス内の既存のアクションをクリックすると、プロパティパネルで、そのアクションの動作を制御する入出力パラメータを設定できます。
+ **設定パネル** - ランタイム設定を作成および編集し、オートメーションで使用できる認証情報を調べることができます。
+ **変数パネル** - オートメーションで使用されるすべての変数を表示します。変数の作成は、オートメーションに新しいリファレンスを直接追加することでシームレスです。

## ランタイム設定と変数
<a name="runtime-configurations-variables"></a>

ランタイム設定を使用すると、オートメーションで使用される簡単に編集できる設定を作成できます。ランタイム設定の例は次のとおりです。
+ ウェブサイト URLs
+ ファイル名と場所
+ 件名や送信者リストなどの E メール設定

変数は、オートメーションの実行時にアクション間で情報を保存および渡すために使用されます。出力プロパティに新しい参照名を指定するだけで、自動化に新しい変数を追加します。一般的な変数タイプは次のとおりです。
+ 文字列 - プレーンテキスト (名前、説明など)
+ 数値 - 数値 (数量、スコアなど)
+ ブール値 - True/False 値
+ 配列 - 項目のコレクションまたはリスト
+ オブジェクト - キーと値のペア
+ ファイル - ドキュメントとメディア (PDFs、画像など)
+ データテーブル - 行と列を含むスプレッドシートのようなデータ

## オートメーションの編集
<a name="editing-automations"></a>

自動化を作成したら、自動化アシスタントを使用するか、キャンバスで直接編集することで、自動化を変更できます。

### Automation Assistant の使用
<a name="using-automation-assistant"></a>

Automation Assistant は、自然言語による変更に役立ちます。以下の操作を実行できます。
+ オートメーション全体、特定のステップ、または特定のアクションの更新をリクエストする
  + チャットを特定のステップに絞り込むには、最初にステップを選択します。
+ 質問をして、実際の自動化に基づいて製品内のヘルプと提案を取得する
+ ニーズに基づいて式とコードを書くためのヘルプを求める

Assistant で を編集するには:
+ ツールバーの **Build with Assistant** をクリックします。
+ 変更内容の説明
+ 提案された変更を確認して確認する
  + チャットには変更の概要が含まれています。**変更を拒否**をクリックして、以前のバージョンに戻ります。
+ 更新されたオートメーションをテストする

### キャンバスの編集
<a name="editing-on-canvas"></a>

ビジュアルデザイナーで直接変更を行います。
+ 変更するステップまたはアクションを選択する
+ プロパティパネルを使用して設定を調整する
+ drag-and-drop

**注記**  
すべてのアクションには、アクションの複製や削除などの一般的なアクションを含むオプションのメニューがあります。

**編集のベストプラクティス:**
+ 増分変更を行う
+ 重要な変更のたびにテストする

**注記**  
変更はライブバージョンに自動的に保存されます。これらの変更をデプロイする場合は、更新されたバージョンをコミットしてデプロイします。

**ヒント**  
構築中に問題が発生した場合:  
Automation Assistant を使用してヘルプを取得する
特定の要件については、アクションドキュメントを確認してください。

## 自動化入出力
<a name="automation-inputs-outputs"></a>

Amazon Quick Automate で再利用可能なパラメータ化されたオートメーションを作成する入出力スキーマを定義します。開始ノードと終了ノードを使用して入出力スキーマを定義することで、静的オートメーションを、実行されるたびに異なるデータを受け入れる再利用可能なワークフローに変換できます。値をハードコーディングする代わりに、実行時に提供される型付き入力パラメータと、自動化の完了時にキャプチャされる構造化出力値を定義します。入力と出力は、手動実行、API コール、スケジュールされたトリガーなど、すべての呼び出しメソッドで機能します。

入力と出力を使用する主な利点:
+ **再利用性** – 自動化自体を変更せずに、異なるデータで同じ自動化を実行します。
+ **型の安全性** – Amazon Quick Automate は、実行を開始する前にスキーマに対して入力データを検証し、無効なデータの実行を防ぎます。
+ **API 統合** – 自動生成されたスキーマにより、プログラムによる検出と外部システムとの統合が可能になります。
+ **オブザーバビリティ** – 構造化された出力は、監査とレビューの実行アーティファクトとしてキャプチャされます。

### サポートされているデータ型
<a name="automate-supported-data-types"></a>

入力フィールドと出力フィールドでは、次のデータ型がサポートされています。
+ **Text** – プレーンテキスト値 (例: text1、text2)
+ **数値** – 小数を含む数値 (例: 3.14、100)
+ **ブール値** – 真または偽の値
+ **ファイル** – 最大サイズが 5 MB のファイルオブジェクト

### ノードの開始と終了
<a name="start-and-end-nodes"></a>

すべてのオートメーションには、デフォルトで空白の Start ノードと End ノードが含まれます。これらのノードを編集してスキーマを作成し、オートメーションで入力を使用し、オートメーションから返すように出力データを更新できます。Start ノードは実行時に入力データを受信し、End ノード (End Process ノードを含む) は実行時に出力データを収集し、自動化が完了すると構造化アーティファクトとして返します。

#### Start
<a name="start-node"></a>

Start ノードは、オートメーションがトリガーされたときに入力パラメータを受け入れるエントリポイントです。デフォルトでは空白です。

プロパティ:
+ **入力形式** – オートメーションが受け入れる入力パラメータのスキーマを定義します。「入力スキーマと出力スキーマの定義」で説明されている入力スキーマエディタを使用して を編集します。
+ **入力変数** – 入力形式で定義され、ユーザーによって提供されるオートメーションの入力値を保存する変数。

#### 修了
<a name="end-node"></a>

End ノードは、自動化が正常に完了したときに出力値を収集して返す終了ポイントです。End ノードのプロパティを使用して、オートメーションの変数からの出力値を設定できます。オートメーションは、オートメーションの構造に基づいて複数の End ノード (End Process) を持つことができます。

プロパティ:
+ **出力形式** – オートメーションが返す出力パラメータのスキーマを定義します。「入力スキーマと出力スキーマの定義」で説明されている出力スキーマエディタを使用して、スキーマ**を編集**および追加または変更するを選択します。
+ **出力データ** – オートメーションの変数の値を、定義した出力フィールドにマッピングします。終了ノード (出力スキーマ) で作成する出力変数ごとに、返すデータを含むオートメーション変数を指定します。**出力データの編集**エディタを使用して、**出力値**フィールドでこれらのマッピングを設定します。

### 入力スキーマと出力スキーマの定義
<a name="defining-input-output-schemas"></a>

スキーマは、オートメーションが入力として受け入れ、出力として生成するデータの構造を定義します。オーサリングスタジオは、オートメーションキャンバスで入力スキーマと出力スキーマを直接定義するためのビジュアルフォームビルダーを提供します。

入力スキーマを定義するには:
+ Amazon Quick Automate でオートメーションを開きます。
+ キャンバスの開始****ノードを選択して、スキーマエディタを開きます。プロパティペインからスキーマエディタを開くこともできます。これを行うには、**開始**ノードを選択し、プロパティペイン**の入力形式で****編集**を選択します。
+ **\+Add フィールド**を選択して入力フィールドを追加します。
+ 入力フィールドごとに、次のプロパティを設定します。
  + **名前** – フィールドの一意の識別子。
  + **Type** – フィールドが受け入れるデータのタイプ。詳しくは「サポートされているデータ型」を参照してください。
  + **必須** – オートメーションの実行時に フィールドを指定する必要があるかどうか。
  + **デフォルト値** (オプション) – このオプションは、**必須フィールド**がクリアされている場合にのみアクティブになります。デフォルト値は、テストを実行したり、オートメーションをトリガーしたりすると、入力フォームにあらかじめ入力されています。
  + **説明** – フィールドが表す内容の説明。
+ **保存** を選択して、オートメーションでスキーマを保存します。

出力スキーマを定義するには:
+ キャンバスの終了****ノードを選択して、出力スキーマエディタを開きます。プロパティペインからスキーマエディタを開くこともできます。これを行うには、**終了**ノードを選択し、プロパティペインの**出力形式で****編集**を選択します。
+ **\+Add フィールド**を選択して出力フィールドを追加します。
+ 出力フィールドごとに、次のプロパティを設定します。
  + **名前** – フィールドの一意の識別子。
  + **Type** – 出力のデータのタイプ。
  + **説明** – 出力が表す内容の説明。
+ **[保存]** を選択します。

**注記**  
開始ノードからの入力と、任意の終了ノードからの出力を定義できます。オートメーションに複数の End ノードがある場合、1 つの End ノードのスキーマを追加または変更すると、すべての End ノードスキーマが変更されます。

### 開始ノードからの入力値の使用
<a name="using-input-values"></a>

オートメーションに Start ノードで定義された入力スキーマがある場合、 `inputs` ディクショナリを使用してワークフロー全体でこれらの入力値にアクセスできます。ランタイムは、このディクショナリを自動的に検証し、オートメーションの実行時に指定された値を入力します。

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

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

### End ノードでの出力値の設定
<a name="setting-output-values"></a>

End ノードは、オートメーションから出力として返される値を定義します。これを設定するには、**Output Data** プロパティを使用します。このプロパティは、エディタで出力値を設定するための 2 つのインタラクションモードを提供します。**出力値**フィールドの横にあるコードアイコン (`</>`) を選択して、モードを切り替えます。

出力を設定するための 2 つのモード:
+ **変数選択モード (ドロップダウン)** – デフォルトのインターフェイスには、オートメーションで使用可能なすべての変数のドロップダウンリストが表示されます。各出力フィールドに割り当てる変数を選択します。
+ **式モード (コード)** – 任意の出力値フィールドの横にあるコードアイコン (`</>`) を選択して、式モードに切り替えます。このモードでは、カスタム式の入力、計算の実行、ネストされたデータへのアクセス、リテラル値の設定を行うことができます。

### Build with Assistant を使用したスキーマの定義
<a name="defining-schemas-with-assistant"></a>

ビルド with 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>
+ **ライブバージョン** - キャンバスで編集できるオートメーションの現在の作業コピー。変更は編集時にライブバージョンに自動的に保存されます。
+ **コミット済みバージョン** - デプロイできるオートメーションの読み取り専用スナップショット。自動化の新しいバージョンをコミットして重要な更新を追跡し、必要に応じて元に戻すことができます。
+ **デプロイされたバージョン** - コミットされたバージョンをデプロイしてアクティブ化し、スケジュールに従って実行できます。

**注記**  
各バージョンは、独自のランタイム設定値を維持します。ライブバージョンのランタイム設定を変更しても、以前にコミットまたはデプロイされたバージョンには影響しません。

### コミットバージョン
<a name="committing-versions"></a>

バージョンをコミットするには:
+ キャンバスツールバーで**コミット** をクリックします。
+ 変更を説明するメモを追加する
+ バージョン番号をインクリメントする方法を選択します。
  + 小規模な更新用のマイナーバージョン (例: 1.05 → 1.06) (デフォルト)
  + 大幅な変更のためのメジャーバージョン (例: 1.0 → 2.0)
+ **コミット をクリックします。**

**重要**  
オートメーションに検証エラーがある場合、バージョンをコミットすることはできません。コミットを試みる前に、すべてのエラーを解決します。

バージョンをコミットする場合:
+ コミットされたバージョンが読み取り専用スナップショットになる
+ 現在のランタイム設定は、コミットされたバージョンで保存されます。
+ そのスナップショットに基づいて新しいライブバージョンが作成され、編集が続行されます。

**重要**  
コミットされたバージョンのみをデプロイできます。ライブバージョンをデプロイする前に、最初にコミットする必要があります。

### バージョンの表示
<a name="viewing-versions"></a>

2 つの場所でバージョンを表示します。
+ **キャンバス内のバージョンドロップダウン** - デフォルトでライブバージョンになります。ドロップダウンから以前のバージョンを選択して、キャンバスの読み取り専用モードで表示します。
+ **バージョンタブ** - プロジェクトの詳細内にあります。バージョン番号、バージョンがコミットされた日時、バージョンをコミットしたユーザー、およびバージョンノートを含む完全なバージョン履歴を表示します。アクションメニューをクリックすると、バージョンの詳細を表示したり、バージョンをデプロイしたりできます。

### 以前のバージョンの復元
<a name="restoring-previous-versions"></a>

以前のバージョンを復元し、ライブバージョンとして編集を続けるには:
+ キャンバスの上にあるバージョンドロップダウンからバージョンを選択します。
+ **ライブバージョンの復元**を選択する
+ 選択したバージョンが現在のライブバージョンを置き換えます
+ ライブバージョンの編集を続行して必要な調整を行う
+ 新しいバージョンとしてコミットしてスナップショットを作成するか、更新をデプロイする

**注記**  
バージョンを復元すると、新しい作業コピーが作成されますが、バージョン履歴は削除されません。

### ベストプラクティス
<a name="version-best-practices"></a>
+ 変更の目的を追跡するための明確なバージョンノートを追加する
+ 重要な更新後にバージョンをコミットする
+ コミットする前に変更をテストする
+ コミットする前にランタイム設定を確認する