デザイナー(GitHub Copilot)でワークフローを編集・管理します。

Copilot Studioで再設計されたビジュアルデザイナーでワークフローを作成・編集できます。 このデザイナーでは、自動化を作成、編集したり、アクションを追加、削除したり、エラーを確認したり、デザイナーを離れることなくワークフローを公開したりできる作業画面が用意されています。

デザイナーでワークフローを表示する

デザイナーでワークフローを表示するには、Copilot Studio を開き、ワークフローを選択して、対象のワークフローを選択し、ビルド タブを選択します。

ワークフローの表示方法の変更

ワークフローのサイズと複雑さによっては、操作しやすいように表示方法を調整することができます。 キャンバスの左下にあるツールバーを使ってビューを操作してください。

凡例:

1. 拡大: キャンバス上のワークフローのサイズを大きくします。
2. 縮小: キャンバス上のワークフローのサイズを小さくします。
3. フィット ビュー: キャンバス上のワークフロー全体に合わせてビューのサイズを変更します。
4. 整理: ワークフローとブランチを再構成して、よりクリーンなエンドツーエンドのビューを作成します。
5. 垂直レイアウト: ワークフローの垂直レイアウト ビューに切り替えます。

アクションの追加と削除

1. アクションを追加するカードで、[ ステップの追加] を選択します。 [追加] ウィンドウが開きます。

2. 追加で、ワークフローに実行させたいアクションや追加したいコネクタの名前を入力し、リストから選択します。 選択によっては、アクションを完了するためにさらに情報を提供する必要があるかもしれません。

アクションが不要と判断した場合は、アクションの右上にある 「削除 」アイコンを選択します。

ワークフローのパラメーターを確認する

ワークフロー内のトリガーまたはアクションのパラメーターを表示するには、そのカードを選択します。 右側に構成パネルが開きます。 パラメーターの値を入力するには、ドロップダウン リストでオプションを選択するか、式を入力して値を動的に設定します。

エラーを確認する

ワークフロー アクションのエラーは赤で示されます。 1 つのアクションのエラーの詳細を表示するには、エラーを選択します。 ワークフロー全体のすべてのエラーを一覧表示するには、ヘルス センター バナーを開きます。 個々のエラーの詳細を表示するには、エラーを選択します。

ワークフローを発行する

ワークフローにエラーがない場合は、発行できます。 キャンバス上部のメニューで、公開を選択します。

ワークフローのテスト

テストランは、デザイナーを離れずにステップや全体のワークフローを検証できます。 実際の上流データ、自分で模擬した値、または過去の実行の出力のいずれかを使ってください。

テストを実行するには、次の 2 つの方法があります。

両方のサーフェスが同じアイデアを共有します。入力 (実際またはモック) を提供し、実行してから出力を検査します。

ワークフロー内の 1 つのノードをテストする

ワークフロー内の任意のアクションやノードを開き、再生ボタン(テスト)を選択します。 次の 3 つのセクションがあります。

1. テストの実行/リセット: ステップをオンデマンドで実行するか、現在の入力と出力をクリアします。

   

2. 前回の実行から値を読み込む: このワークフローの最近の実行を表示するドロップダウン メニュー。 1 つを選択すると、その実行から上流ステップの出力が下の入力フィールドに取り込まれます。

3. 入力: アップストリーム ステップごとに 1 つの編集可能なフィールドがノード参照を出力します。 各行の右側にあるバッジには、そのフィールドの想定される型 (文字列、メールアドレス、日時、数値など) が表示されています。

4. 出力: ノード タイプに合わせてフォーマットされた、直近のテストのリアルタイム結果。

モック入力

既定では、入力フィールドは空白です。 次のようにすることができます。

• フィールドに任意の値を直接入力します。 フィールドは、右側のバッジに表示される型を受け入れます。
• ステップがそのフィールドに依存しない場合は、空欄にしてください。

前の実行から値を読み込む

以前にこのワークフローを実行したことがある場合は、手動でデータを入力する代わりに、実際のデータを再生できます:

1. [ 前の実行の値を読み込む ] ドロップダウンで、実行を選択します。

2. デザイナーは、その実行のステップ出力を取得し、ノードの入力スキーマを介してそれらを投影します。 一致する値が入力フィールドに書き込まれます。

3. シナリオを調整する場合は、後でフィールドを編集します。

ドロップダウンには、すべての状態の最新の 10 回の実行が表示されます。 実行において、上流のステップのいずれかの出力が含まれていない場合 (そのステップがスキップされたか、そのパスが実行されなかったため)、利用可能なフィールドのみに値が入力されます。 残りはそのままとなります。

以前にワークフローが実行されたことがない場合、過去の実行履歴はありませんと表示され、ドロップダウンは非表示になります。

テストの実行

[テストの実行] を選択します。 リクエストの処理中は、ボタンに処理中の状態が表示されます。出力セクションにはスピナーが表示され、その後に結果またはエラーが表示されます。

• リセット テスト では、入力と最後の出力の両方がクリアされます。
• テストでは、コネクタの API に対して分離してノードを実行します。 このテストでは、その後のワークフローはトリガーされません。

ワークフロー全体のテスト

上部のコマンド バーで、再生ボタン (テスト) を選択します。 テストは、ライブ ランタイムに対してワークフローをエンドツーエンドで実行します。

実行が開始される前に、デザイナーは次の手順を実行します。

1. 未保存の変更がある場合 (または初めての場合)、ワークフローを保存して公開します。
2. 初回実行時に新しい接続をインストールします。
3. 実行をトリガーします。 パスは、トリガーの種類によって異なります。

モックテスト用入力 (手動トリガー)

手動トリガーの場合、手動トリガー入力の入力 ダイアログには、トリガーで定義した入力項目ごとに 1 つのフィールドが表示されます:

• テキスト/数値/電子メール/日付: 適切な入力コントロール。
• ブール値: 切り替えスイッチ。
• 単一選択 (列挙型): ドロップダウン。
• 複数選択: 複数選択ドロップダウン。
• ファイル: ファイル選択。 コンテンツは実行の一部としてアップロードされます。
• オブジェクト/配列: JSON を貼り付けることができる複数行のテキスト領域。

実行を選択すると、その入力内容でワークフローが開始されます。キャンセルを選択すると、実行せずに終了します。 必須フィールドにはアスタリスクが付いています。 値が見つからないか無効な場合、インライン検証メッセージが表示され、固定されるまで実行はブロックされます。

テストを選択するたびに、ダイアログが表示されます。 実行の間に値が保存されないため、さまざまなシナリオをすばやく試すことができます。

実行を監視する

実行が進行中になったら:

• 実行がアクティブな間、コマンド バーに [キャンセル] ボタンが表示されます。
• 活動パネル (右側) の上部には、ステータス バッジ付きの現在の実行が一覧表示さます: 実行中、待機中、成功、失敗、キャンセル。 任意の実行を選択してキャンバス上で開き、各ステップの入力と出力を検査します。

過去の実行を選択する

活動パネルは、ワークフローの実行履歴としても機能します:

• 上部のドロップダウン メニューを使用して、すべて / 成功 / 失敗 / 実行中 でフィルターします。
• [ 最新の情報に更新] を選択して一覧を再フェッチします。
• 下部にある [ さらに読み込む ] を選択して、さらにページに戻ります。
• 実行を選択するとキャンバスに読み込まれます。各ノードには、受信した入力とその実行に対して生成された出力が表示されます。 データは、ドロップダウンから実行を選択するときにノード レベルの [テスト] タブが使用するデータと同じです。

各種類のテストを使用する場合

• 単一の AI ステップまたはコネクタのアクションに対して反復処理を行っていますか？ このノードをテストするを使用します。 処理が速く、公開元がいないため公開されず、重要なアップストリームの値だけをモック化できます。
• エンド ツー エンドの動作やトリガー ロジックの検証ですか？ フロー テストの実行を使用します。 実際の実行時間に対して、グラフ全体を検証します。
• 運用環境の問題を再現できますか？ 活動パネルから失敗した実行を開き、失敗したノードを開いて、そのテスト タブにある前回の実行から値を使用するを使用して、そのアクションにまったく同じ上流データを再生します。

トークンピッカーのサンプル値

上流ステップの出力を参照する式を書くと、トークンピッカーは各トークンの横にサンプル値を表示し、そのステップの実際のデータがどのようなものか確認できます。 サンプル値はワークフローの直近のテストランから自動的に取得されるため、ランを選んだりトークンを手動で追加したりする必要はありません。

その挙動は以下の通りです:

• サンプル値は各上流ステップの出力に対して行上にインライン表示されます。
• 最後に完了したランの成功した出力のみが表示されます。 スキップされた、到達しなかった、失敗したステップにはサンプル値がありません。
• ワークフローがまだ実行されていないか、最新の実行に参照されたステップが含まれていない場合、そのトークンの横にサンプル値は表示されません。

サンプル値は読み取り専用のプレビューデータです。 式を編集しても元の実行は変わらず、ピッカーを閉じても何かが破棄されることはありません。