開発者は Co-Pilot for Automators を使用して、自然言語プロンプトで値を指定して変数をマッピングできます。

Co-Pilot for Automators Co-Pilot では、2 つの方法で変数を作成した開発が可能です。 最初に、開発者は1つまたは複数の変数のプロパティに関する指示を含む単一のプロンプトを送信して、それらを仕様に従って作成できます。 次に、変数が作成され、プロンプトで既存の変数が参照されない限り、変数を必要とする任意のアクションに自動的にマッピングされます。 自動的に作成された変数にはデフォルトの命名規則が使用されます。

変数をプロンプトする際のベストプラクティス

  • カスタム変数のプロパティとデフォルト値は、変数作成のプロンプト時に設定する必要があります。 最良の結果を得るには、すべてのプロパティを設定し、変数を作成するために単一のプロンプトを使用してください。
  • シナリオを促す前に変数を追加および作成することで、変数をプロンプトの入力として参照できます。 この注文を使用して効率を向上させます。

  • 既存の変数の値またはプロパティを変更（更新）するように促すことは、それらの更新に対する対応する 割り当て アクションをもたらします。

変数作成のプロンプト

新しい変数を作成します。
変数の名前、タイプ、変数の使用方法 (入力、出力、定数) などのプロパティは、あなたのプロンプトで認識されます。 既存の変数は別のプロンプトによって参照し、既存のアクションにマッピングできます。
例は、一度に入力されたプロンプトを示しています。
  1. Create an input string variable named Var1 and assign it the value "Hello, world!"
  2. Set the message box to display Var1.
ヒント: 代わりに、最初のプロンプトは短く入力できます。
Create an input string variable ‘Var1’ = "Hello, world!"
新しい変数をマッピングしてアクションを追加します。
自動化に新しいアクションを追加する際、単一のプロンプトで新しい変数を新しいアクションに簡単に作成し、同時にマッピングできます。
例:
Add a message box and assign it a new input string variable named Var1 with the value "Hello, world!"
1 つのプロンプトで複数の変数を作成する。
複数の変数を単一のプロンプトで作成する場合、各変数の指示を区切るためにコンマまたはピリオドを使用します。
例は、同じ出力をもたらす2つのプロンプトを示しています。
  • Create an input string variable named Var1, an output string variable named Var2, and an input and output variable named Var3. Assign Var1 the value "open", Var2 the value "closed", and Var3 the value "pending".
  • Create an input string variable 'Var1' = "open", an output string variable 'Var2' = "closed", and an input and output variable 'Var3' = "pending".
事前定義された（システムおよび文字列）変数の作成とプロパティの設定。
定義済み変数（日時、システム設定、文字列）は、メタデータを自動化に追加するためによく使用され、追跡や計算に役立ちます。 ユーザーシステムとマシンによってこれらの変数の値は事前に定義されていますが、これらの変数のプロパティはプロンプトを通じて割り当てたり活用したりすることができます。

次のプロンプトは、システム時間を取得し、それに加算し、計算結果をメッセージボックスでユーザーに返す手順を自動的に構築します。 Co-Pilot は自動的に変数を作成し、計算と返される表示のためにそれらをマッピングします。

例:
Get the current time and then add 5 minutes. In a message box, display the calculated time.
システム変数の取り扱いについての詳細は、定義済み変数をご覧ください。
シナリオ内でデータ型を自動的に変換します。
変数のデータ型は、シナリオを生成する際に Co-Pilot によって自動的に変換されることがあります。 この機能は、文字列から数値データにデータを移行するために必要な論理的ステップを自動的に作成し、計算を行い、メッセージ内で文字列としてユーザーにデータを返します。 これにより、自動化を開発する際に専門知識の必要性が減ります。

次の例は、ユーザーからの入力を収集するためのステップを自動的に構築し、入力から1を引き、その結果の数値を表示します。 Co-Pilot は自動的に入力用の文字列変数を作成し、計算のために値を数値に変換し、表示のために数値を再び文字列に変換します。

例:
1. Ask the user to enter a number. 2. Reduce that number by 1. 3. Display that number for 5 secs. 4. Repeat 2 and 3, until the number becomes 0 or -1.
ユニークなプロパティを持つ変数を作成します。
テーブルなどの変数、および固有のプロパティを持つ可能性のあるセッション タイプなどの変数がサポートされます。 これらの変数タイプのプロパティの完全なセットをプロンプトに含めてください。 テーブルタイプの変数の場合、次元とデフォルトのセル値は指示で指定できます。
例:
  • Create a terminal session variable named pSessTerminal.
  • Create a 3x4 table variable with default value 0, named pTableVar1.

変数を自動的に作成する

Co-Pilot は、変数作成の面倒な作業の一部を手助けすることで、開発者がオートメーションの結果やアクションの操作に集中できるようにします。 変数が存在せず、プロンプトで記述されているアクションに変数が必要な場合は、変数が自動的に作成され、それを必要とするアクションにマッピングされます。 変数がこのように作成されると、標準の命名規則が適用されます。これは変数のタイプ（pBool、pDict、pStr）によって決まります。 開発者は、準備ができたら、変数を手動で編集して、値やその他のプロパティを設定できます。

例:
Add a Prompt to the path of the folder
.

資格情報変数

資格情報変数は、Bot エディターでプロンプトによって認識して追加できます。 これらは一意の変数であり、Control Room リポジトリに保存されたファイルとしてそれが表す機密値を保護します。 資格情報変数には、作成時に 3 つのレイヤーと複数の属性が設定されます。 指示では3つのレイヤーと属性をすべて記述して、この変数を正確に呼び出し、これをオートメーションに追加する必要があります。
  • ロッカー名
  • 資格情報名
  • 属性: ユーザー名、パスワード、クライアント ID など。

資格情報変数の詳細については、次のトピックを参照してください。 「Bot エディター における資格情報と資格情報変数」をご参照ください。

追加の考慮事項: