Foundry Agent Service のエージェントから Azure Logic Apps でワークフローを実行する (プレビュー)

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

ロジック アプリ ワークフローを実行するエージェントのアクションを設定するには、次の手順に従います。

1. Foundry (クラシック) ポータルで、プロジェクトを開きます。

2. プロジェクトサイドバーの[ ビルドとカスタマイズ]で、[エージェント]を選択 します。

   エージェントのモデルをデプロイしなかった場合は、続行する前にウィザードが開き、このタスクを完了できます。 エージェントに対するアクションをサポートするモデルを必ず選択してください。 詳細については、「 モデルのデプロイ」を参照してください。

3. [ エージェントの作成とデバッグ ] ページの [ マイ エージェント] で、エージェントを選択します。

   

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

   

   注

   すべてのモデルがエージェント アクションをサポートしているわけではありません。 [アクション] セクションが使用できない場合は、GPT-4.1 以前のモデルをデプロイする必要があります。

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

   

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

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

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

   

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

   パラメーター	必須	価値	説明
   アクション名	イエス	< 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 の詳細の例を示しています。

   

8. 完了後は、次へ を選択します。

2: 接続を作成して認証する

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

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

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

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

   

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

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

4. 完了後は、次へ を選択します。

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

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

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

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

   1. [次へ]を選択して[リソース]セクションを終了した後、次のイベントを理解し、承認するステートメントを確認してください。

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

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

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

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

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

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

      

3. 完了後は、次へ を選択します。

4: ツールとしてのアクションの作成を完了する

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

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

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

   

2. 完了したら、[作成] を選択します。

   ウィザードによって、エージェントの [エージェント] ページが表示されます。 [セットアップ] セクションの [アクション] セクションに、Azure Logic Apps のツール名とアイコンが表示されます。次に例を示します。

   

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

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

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

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

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

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

   

6: リソースを削除する

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

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

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

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

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

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

1: 環境変数を設定する

システムで、次の環境変数を設定します。

サンプル コードについては、次を参照してください。

• GitHub の AzureLogicAppTool ユーティリティ

• Azure Logic Apps と Foundry エージェントの統合の完全なサンプル

  このサンプルでは、Foundry (クラシック) のエージェントを Azure portal の従量課金ロジック アプリと統合する方法を示します。

2: プロジェクト クライアントを作成する

Foundry プロジェクトやその他のリソースに接続するには、次の手順に従ってクライアント オブジェクトを作成します。

import os
from azure.ai.projects import AIProjectClient
from azure.identity import DefaultAzureCredential

# Initialize the AIProjectClient
project_client = AIProjectClient(
   endpoint=os.environ["PROJECT_ENDPOINT"],
   credential=DefaultAzureCredential()
)

3: ロジック アプリを登録する

トリガーの名前と情報を指定して、消費型ロジックアプリリソースを登録します。 AzureLogicAppToolユーティリティ コードを見つけるには、GitHub の完全なサンプルを参照してください。

from user_logic_apps import AzureLogicAppTool

# Logic app details
LOGIC_APP_NAME = "your_logic_app_name"
TRIGGER_NAME = "your_trigger_name"

# Register the logic app name with the agent tool utility by extracting the following values from environment variables
subscription_id = os.environ["SUBSCRIPTION_ID"]
resource_group = os.environ["resource_group_name"]

# Create and initialize AzureLogicAppTool utility
logic_app_tool = AzureLogicAppTool(subscription_id, resource_group)
logic_app_tool.register_logic_app(LOGIC_APP_NAME, TRIGGER_NAME)
print(f"Registered logic app '{LOGIC_APP_NAME}' with trigger '{TRIGGER_NAME}'.")

4: アクションとしてワークフローを使用してエージェントを作成する (ツール)

次のコードでは、エージェントを作成し、ロジック アプリをエージェント アクションまたはツールとしてアタッチします。 この例では、ロジック アプリ ワークフローが電子メールを送信します。

from azure.ai.agents.models import ToolSet, FunctionTool
from user_functions import fetch_current_datetime
from user_logic_apps import create_send_email_function

# Create the logic app action for the agent
send_email_func = create_send_email_function(
    logic_app_tool, logic_app_name
)

# Prepare the action tool for the agent
functions_to_use = {fetch_current_datetime, send_email_func}

# Create an agent and assign the toolset
functions = FunctionTool(functions=functions_to_use)
toolset = ToolSet()
toolset.add(functions)

agent = project_client.agents.create_agent(
    model=os.environ["MODEL_DEPLOYMENT_NAME"],
    name="SendEmailAgent",
    instructions="You're a specialized agent for sending emails.",
    toolset=toolset,
)
print(f"Created agent, ID: {agent.id}")

5: 通信用のスレッドを作成する

次のコードでは、スレッドを作成し、プロジェクト クライアントとエージェントの間の会話を開始するユーザー メッセージを追加します。

# Create a thread for communication
thread = project_client.agents.threads.create()
print(f"Created thread, ID: {thread.id}")

# Create a message in the thread
message = project_client.agents.messages.create(
    thread_id=thread.id,
    role="user",
    content="Hello, send an email to <RECIPIENT_EMAIL> with the date and time in '%Y-%m-%d %H:%M:%S' format.",
)
print(f"Created message, ID: {message['id']}")

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

エージェントがタスクを実行する方法をテストするには、エージェントを実行し、モデルでロジック アプリ ツールがどのように使用されているかを確認し、出力を確認します。

# Create and run the agent on the thread
run = project_client.agents.runs.create_and_process(
    thread_id=thread.id, agent_id=agent.id
)
print(f"Run finished with status: {run.status}")

if run.status == "failed":
    print(f"Run failed: {run.last_error}")

# Fetch, log, and display all messages
messages = project_client.agents.messages.list(thread_id=thread.id)
for message in messages:
    if msg.txt = msg.text_messages[-1]
    print(f"Role: {msg.role}: {last_text.text.value}")

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

リソースのクリーンアップが完了したらエージェントを削除し、課金が続行されないようにします。

# Delete the agent
project_client.agents.delete_agent(agent.id)
print("Deleted agent.")