Azure AI Foundry と Azure Logic Apps を使用してエージェントのアクションから自動化ワークフローを実行する (プレビュー)

適用対象: Azure Logic Apps (従量課金)

注

この機能はプレビュー段階であり、料金が発生する可能性があり、 Microsoft Azure プレビューの追加使用条件に従います。

Azure AI Foundry に、マルチステップ プロセスを自動化したり、さまざまなサービス、システム、アプリ、データ ソースと統合したりする必要がある AI アプリがある場合は、エージェントにアクションを追加して、Azure Logic Apps で自動化ワークフローを実行できます。

Azure AI Foundry では、エージェントはアクションと AI モデルを使用して、タスクを自律的または対話的に完了します。 たとえば、エージェントはアクションを使用して、AI モデルを使用して質問に回答し、情報を取得し、他のジョブを実行します。

Azure Logic Apps では、ロジック アプリ ワークフローによってプロセスが自動化され、Azure、Microsoft、サービス、システム、アプリ、データ ソースを他のエコシステムに統合できます。通常、追加のコードは必要ありません。 ワークフローでは、 1,400 以上のコネクタ を持つギャラリーからの事前構築済みのトリガーとアクションと、ランタイムネイティブまたは "組み込み" 操作が使用されます。

次の図は、Azure AI Foundry のエージェントに対するアクションが、Azure Logic Apps のロジック アプリ ワークフローにどのように関連しているかを示しています。

このガイドでは、Azure AI Foundry のエージェントにアクションを追加して、エージェントがマルチテナント Azure Logic Apps で実行される従量課金ロジック アプリ ワークフローを作成する方法について説明します。 ウィザードでは、定義済みのロジック アプリ ワークフローを使用してこのアクションを設定する手順を説明します。 アクションの追加が完了したら、Azure Logic Apps のグラフィカル デザイナーを使用して、シナリオのニーズに基づいてこのワークフローを拡張できます。

詳しくは、次のドキュメントをご覧ください。

• Azure AI Foundry とは
• Azure Logic Apps とは
• 従量課金ロジック アプリのワークフロー - ホスティング オプション

[前提条件]

• Azure アカウントとサブスクリプション。 Azure サブスクリプションがない場合は、無料の Azure アカウントにサインアップしてください。

• Azure AI Foundry プロジェクト。既定のハブを使用して作成されます。

  このプロジェクトでは、作業を整理し、AI アプリの構築中に状態を保存します。 ハブはプロジェクトをホストし、チームコラボレーション環境を提供します。

  ハブを使用してプロジェクトを作成するには、 最小特権の原則に基づいて、Microsoft Entra ロールベースのアクセス制御 (RBAC) に対して次のいずれかのロールが必要です。

  • 共同作成者 (最小特権)

  • 所有者

  他のロールがある場合は、ハブをあなたのために作成してもらう必要があります。 詳しくは、次のドキュメントをご覧ください。

  • プロジェクトの既定のロール

  • ハブの既定のロール

• プロジェクト用にデプロイされた Azure OpenAI サービス モデル。

  デプロイされたモデルがない場合は、「モデルの デプロイ」を参照してください。

• プロジェクト内のエージェント。

  この要件には、ワークフローの実行中にエージェントが使用するために Azure OpenAI サービスにモデルをデプロイすることが含まれます。

独自のワークフローを作成してアクションとして使用することはできますか?

はい。Azure AI Foundry ポータルのアクション ギャラリーから独自のロジック アプリ ワークフローを使用できるようにするには、ワークフローが次の要件を満たす必要があります。

• ワークフローを含むロジック アプリ リソースでは、 従量課金 ホスティング オプションが使用されます。

• ロジック アプリ リソースは、Azure AI Foundry で使用するのと同じ Azure サブスクリプションを使用します。

• このワークフローは、[HTTP 要求の受信時] トリガーという名前のトリガーで始まります。

• トリガーには説明が含まれています。この説明は、ワークフロー デザイナーのトリガー情報ウィンドウで指定します。

• ワークフローは 、応答 アクションで終了します。

AI アプリには、Azure、Microsoft、およびその他のサービスや製品と対話するワークフローを実行するためのほぼ無限のオプションと、データの管理、整形、変換、変換に役立つ操作が用意されています。 実行する操作用の事前構築済みコネクタが存在しない場合は、独自のコネクタを作成することもできます。

詳しくは、次のドキュメントをご覧ください。

• クイック スタート: Azure portal を使用して従量課金ロジック アプリ ワークフローの例を作成する
• Azure Logic Apps の コネクタとは
• グローバルなマルチテナント Azure で実行されるマネージド コネクタ
• Azure Logic Apps のマネージド コネクタのテクニカル リファレンス
• Azure Logic Apps ランタイムで実行される組み込み操作
• Azure Logic Apps のカスタム コネクタ

制限事項と既知の問題

このリリースには、次の制限事項または既知の問題があります。

制限事項	説明
ロジック アプリ ワークフローのサポート	現在、エージェント アクションは、マルチテナント Azure Logic Apps の消費ロジック アプリ ワークフローのみをサポートしています。 従量課金ロジック アプリ リソースには、ワークフローを 1 つだけ含めることができます。 詳細については、「 デプロイのホスティング オプション」を参照してください。 現在、エージェント アクションは、シングルテナントの Azure Logic Apps、App Service Environment、またはハイブリッド デプロイの標準ロジック アプリ ワークフローをサポートしていません。 Standard ロジック アプリには、複数のワークフローを含めることができます。 詳細については、「 デプロイのホスティング オプション」を参照してください。

エージェントにアクションを追加する

次の手順に従って、ロジック アプリ ワークフローを作成して実行するためのアクションをエージェントに設定します。

1. Azure AI Foundry ポータルにサインインし、プロジェクトを開きます。

2. プロジェクトの概要から、ポータルのナビゲーション メニューの [ ビルドとカスタマイズ] で [ エージェント] を選択します。 [ エージェント ] ページの [ マイ エージェント] で、エージェントを選択します。

   

3. エージェントの一覧の横にある [セットアップ] セクションで、[ アクション] セクションまで下にスクロールし、[ 追加] を選択します。

   

4. [ アクションの追加] ウィンドウで、[ Azure Logic Apps] を選択します。

   

5. [ アクションの選択] で、次のいずれかのラベルを持つ定義済みのアクションを選択します。

   アクション ラベル	説明
   Microsoft 作成	このアクションでは、Microsoft が作成したテンプレートを使用して、アクションのワークフローを作成します。
   ワークフロー	このアクションでは、Azure サブスクリプションの対象となるロジック アプリ ワークフローをテンプレートとして使用して、アクションのワークフローを作成します。 注: このオプションを選択した場合は、「 アクションの詳細を確認する」という名前のセクションに進んでください。 ワークフローがアクション ギャラリーに期待どおりに表示されない場合は、 要件を確認します。

   次の例では、 MSN Weather を使用して今日の天気予報を取得という名前の Microsoft 作成アクションを使用します。

   

6. [ ロジック アプリの追加] アクション ウィンドウの [ いくつかの基本情報を入力] で、次の情報を入力します。

   パラメーター	必須	価値	説明
   アクション名	イエス	< action-name>	わかりやすいが、タスクに重点を置いた動詞優先の簡潔なアクション名。 この名前は、Azure Logic Apps のロジック アプリ リソースとワークフローにも使用されます。 注: - アクション名には、文字、数字、および次の特殊文字のみを使用できます: -、 (、 )、 _、または '。 - 空白やその他の特殊文字は使用できません。 - 従量課金ロジック アプリのリソースとワークフローが組み合わされ、1 対 1 のリレーションシップがあるため、同じ名前が使用されます。 これに対し、Standard ロジック アプリ リソースには、異なる名前を使用する複数のワークフローを含めることができます。 この例では、 今日の Get-weather-forecast-を使用します。
   アクションの説明	イエス	< action-description>	アクションの目的を明確に記述する説明。 この例では、このアクションを使用して、グローバルなマルチテナントAzure Logic Appsで実行される、今日の天気予報を取得する呼び出し可能な従量課金ロジックアプリのワークフローを作成します。
   サブスクリプション	イエス	< Azure サブスクリプション>	使用する Azure サブスクリプション 。おそらく、プロジェクトとモデルと同じです。
   リソース グループ	イエス	< Azure リソース グループ>	使用する Azure リソース グループ。
   場所	イエス	< Azure リージョン>	ロジック アプリのリソースとワークフローをホストする Azure リージョン。

   次のスクリーンショットは、 サンプル アクション Get-weather-forecast-today の詳細の例を示しています。

   

7. 完了したら、[次へ] を選択します。

接続の作成と認証

アクションに必要な接続を作成し、関連するサービス、システム、アプリ、またはデータ ソースへのアクセスを認証するには、次の手順に従います。 基になるテンプレートは、このアクションとロジック アプリ ワークフローに使用するコネクタを指定します。

1. [ ロジック アプリの追加] アクション ウィンドウの [ 認証] で、作成して認証する必要がある接続を確認します。

2. [ 接続 ] 列で、関連するサービスまたはデータ ソースの [接続 ] を選択します。

   次のスクリーンショットは、MSN Weather サービスの作成と認証の接続例を示しています。

   

   一部の接続ではより詳細な情報が必要になるため、要求された情報を入力するプロンプトに従います。

3. 必要な接続ごとに、これらの手順を繰り返します。

4. 完了したら、[次へ] を選択します。

アクションの詳細を確認する

すべてのアクション情報が正しく表示されていることを確認します。 Microsoft が作成したアクションを選択した場合は、確認の声明を確認して同意します。

1. [ ロジック アプリの追加] アクション ウィンドウの [ リソース] で、指定されたすべてのアクション情報を確認します。

2. 選択した Microsoft 作成アクションの場合は、次の手順を実行します。

   1. [次へ] を選択して、[リソース] ページを離れた後に発生するイベントを理解したことを確認するステートメントを確認してください。

      • 前の手順に戻ることはできません。

      • このアクションにより、コンスンプション ロジック アプリのリソースが作成されます。

      • Azure Logic Apps に接続すると、Azure アカウントに料金が発生します。

        従量課金ロジック アプリ ワークフローの課金モデルの詳細については、次のドキュメントを参照してください。

        • 使用状況の測定、課金、および価格

        • Azure Logic Apps の価格 (従量課金プラン - マルチテナント)

   2. 同意するには、確認ボックスを選択します。次に例を示します。

      

3. 準備ができたら、[次へ] を選択します

アクションの作成を完了する

最後の手順では、エージェントがアクションを実行し、関連する Azure、Microsoft、および Microsoft 以外のサービスまたはリソースへのアクセスを認証するために使用されるツールに関する情報をポータルが生成する情報を確認します。

1. [ ロジック アプリの追加] アクション ウィンドウの [ スキーマ ] ページで、次の情報を確認し、ツールを呼び出す状況に関する説明を必ず入力します。

   パラメーター	説明
   ツール名	エージェントがアクションを実行し、Azure、Microsoft、外部サービス、データ ソース、または特殊な AI モデルにアクセスして、エージェントがデータの取得、タスクの実行、他のプラットフォームとの対話を行うために使用するツールの編集可能な名前。 注: - アクション名には、文字、数字、アンダースコア (_) 文字のみを使用できます。 - 空白やその他の特殊文字は使用できません。
   認証用の接続	毎回資格情報を要求することなく、エージェントが Azure、Microsoft、および外部リソースにアクセスするために使用する接続の読み取り専用の名前。 詳細については、「Azure AI Foundry ポータルでの接続」を参照してください。
   ツールを呼び出す方法について説明する	エージェントがツールを呼び出す状況を指定する説明。
   [スキーマ]	JavaScript Object Notation (JSON) 形式のロジック アプリ ワークフローのスキーマ。

   

2. 準備ができたら、 [作成] を選択します。

   ポータルはあなたを選択したエージェントのエージェントページに戻します。 [セットアップ] セクションの [アクション] セクションに、アクションを実行するツールの名前が表示され、ツール名の横に Azure Logic Apps のアイコンが表示されます。次に例を示します。

   

エージェント アクションをテストする

エージェントプレイグラウンドを使用してエージェントの新しいアクションを試すには、次の手順に従います。

1. [ エージェント ] ページの [セットアップ ] セクションの上部にある [ プレイグラウンドで試す] を選択します。

2. [ エージェントのプレイグラウンド ] ページのユーザー クエリ チャット ボックスで、天気に関する質問をします。次に例を示します。

   ロンドン の天気は何ですか? 結果を箇条書き形式で表示します。

   エージェントは、次の例のような応答を返します。

   

基になるロジック アプリとワークフローを確認する

アクションの実行後、基になるロジック アプリのリソースとワークフローを Azure portal で表示できます。 ワークフローの実行履歴を確認できます。ワークフローで発生する可能性がある問題をデバッグまたはトラブルシューティングするために使用できます。

1. Azure portal にサインインします。 ポータルのタイトル バーの検索ボックスに、作成したアクションの名前を入力します。

2. 結果の一覧の [ リソース] で、ロジック アプリ リソースを選択します。

   

3. ワークフローの実行履歴、入力、出力、およびその他の情報を表示するには、ロジック アプリ メニューの [開発ツール] で [ 実行履歴] を選択します。

4. [ 実行履歴 ] ボックスの一覧で、最新のワークフロー実行を選択します。次に例を示します。

   

5. 監視ビューが開き、ワークフロー内の各操作の状態が表示されたら、操作を選択して情報ウィンドウを開き、操作の入力と出力を確認します。

   次の使用例は、 今日の予測の取得という名前のアクションを選択します。次に例を示します。

   

   ワークフロー実行履歴の詳細については、「 ワークフローの状態と実行履歴を表示する」を参照してください。

デザイナーでワークフローを開く

ワークフローの定義と操作を確認するか、ワークフロー デザイナーを開いてワークフローを編集するには、次の手順に従います。

1. ロジック アプリのメニューの [ 開発ツール] で、デザイナーを選択します。

   デザイナーでワークフローが開きます。 トリガーとアクションを参照するワークフローの操作を確認できるようになりました。次に例を示します。

   

2. 操作のパラメーターと設定を表示するには、デザイナーで操作を選択します。次に例を示します。

   

3. ワークフローの動作を拡張するには、「トリガーまたはアクションを使用してワークフローを作成する」の手順に従って アクションを追加できます。

   このワークフローまたはその他のワークフローをアクション ギャラリーに表示し、エージェントでアクションとして実行するには、ワークフローが常に次の要件を満たしている必要があります。

   • ワークフローを含むロジック アプリ リソースでは、従量課金ホスティング オプションを使用する必要があります。

   • ロジック アプリ リソースでは、Azure AI Foundry で使用するのと同じ Azure サブスクリプションを使用する必要があります。

   • ワークフローは、 HTTP 要求の受信時 トリガーで開始する必要があります。

   • トリガーには説明が必要です。この説明は、デザイナーのトリガー情報ペインで確認できます。

   • ワークフローは 、応答 アクションで終了する必要があります。

   注意事項

   アクションを追加したりワークフローを変更したりすることはできますが、元のトリガーとアクションを編集して、ワークフロー、エージェント、アクションの関係が壊れないようにしないでください。 これらのパラメーターは連携するように設定されているため、これらの操作を変更すると、エージェントのアクションが中断されるリスクが生じます。 代わりに、エージェントにアクションとして追加できるカスタム バージョンまたは別のワークフローを作成することを検討してください。

   たとえば、トリガーでは、トリガーを呼び出すために必要な次のパラメーターを使用します。

   パラメーター	説明
   名前	この名前は、トリガーの HTTPS URL の一部です。 ワークフローの外部にある外部の呼び出し元 (他のサービスなど) は、この URL に HTTPS 要求を送信します。これにより、トリガーが起動され、ワークフローが開始されます。 トリガーは常にワークフローの最初のステップであり、トリガーを実行するために満たす条件を指定します。
   HTTPS URL	ワークフローを初めて保存すると、この URL が生成され、ワークフローに対してトリガーによって作成されるエンドポイントの呼び出しに使用されます。
   方式	この設定では、トリガーがすべての HTTPS メソッドを受け入れるか、特定の HTTPS メソッドのみを受け入れるかを指定します。
   要求本文の JSON スキーマ	トリガーが外部の呼び出し元から送信された HTTPS 要求で受け取ると予想される入力を検証する場合、このスキーマは、その入力の検証に使用する JSON スキーマを指定します。

4. 行った変更を保存するには、デザイナーのツール バーで [保存] を選択します。

デザイナーでワークフローをテストする

気象ワークフローに変更を加えた場合、または別のワークフローをテストする場合は、次の手順に従います。

1. デザイナーのツール バーで、[ 実行>ペイロードを使用して実行] を選択します。

2. [ ペイロードを使用して実行 ] ウィンドウが開いたら、[ 本文 ] フィールドに、予想されるトリガー入力を JSON 形式で指定します。次に例を示します。

   {
       "location": {
           "type": "London",
           "description": "Location for the weather"
       }
   }
   

3. 準備ができたら、[ 実行] を選択します。

   [ 出力 ] タブの 応答本文 には、ワークフローからの結果と応答が含まれます。

4. ワークフロー実行でエラーが発生する場合、またはトラブルシューティングが必要な場合は、ワークフローの実行履歴を開いて、 基になるロジック アプリとワークフローを確認するの関連する手順を使用して各操作の入力と出力を確認できるようにします。

課金と価格

従量課金ロジック アプリ ワークフローでは、"従量課金制" の課金モデルに基づいて料金が発生します。 このモデルの詳細については、次のリソースを参照してください。

• 使用状況の測定、課金、および価格
• Azure Logic Apps の価格 (従量課金プラン - マルチテナント)

Azure AI Foundry については、次のリソースを参照してください。

• Azure AI Foundry のコストを計画して管理する
• Azure AI Foundry の価格

リソースをクリーンアップする

このガイド用に作成したリソースが必要ない場合は、課金が継続されないようにリソースを削除します。 これらの手順に従って、これらのリソースを含むリソース グループを削除することも、各リソースを個別に削除することもできます。

1. Azure AI Foundry ポータルで、エージェントからアクションを削除するには、アクション名の横にある省略記号 (...) ボタンを選択し、[削除] を選択 します。

2. Azure portal のタイトル バーの検索ボックスに「リソース グループ」と入力し、[リソース グループ] を選択します。

3. デプロイされたハブ リソースを含むリソース グループを見つけます。

4. [概要] ページのツール バーで、[リソース グループの削除] を選択します。

5. 確認ウィンドウが表示されたら、リソース グループ名を入力して、[削除] を選択します。

関連コンテンツ

• Azure Logic Apps のコネクタとは
• Azure AI Foundry とは
• Azure Logic Apps とは