Azure Logic AppsワークフローSDK(Microsoft.Azure.Workflows.Sdk)は、C#でLogic Appsのワークフロー定義をプログラム的に構築するためのフルエントビルダーAPIを提供します。 このSDKにより、開発者はJSON作成の代わりに型安全でIntelliSense対応のアプローチでワークフローを定義できます。
アーキテクチャの概要
SDKは、メソッドチェインを通じてワークフローを構成するために流暢なビルダーパターンを使用しています。
- エントリポイント:ワークフロー作成のためのWorkflowFactory、操作へのアクセスのためのWorkflowActionsおよびWorkflowTriggers
-
流暢な連鎖:
Trigger → .Then(Action1) → .Then(Action2) → ... - 依存注入: IWorkflowProvider および WorkflowProviderExtensions によるワークフロー登録のサポート
クラスライブラリ参照
ワークフローの構成とチェイン
ワークフロー操作を実行グラフに構成する方法を定義する型。
| タイプ | Description | Link |
|---|---|---|
| IChainableNode | 操作の作成に Then() メソッドパターンを提供する流暢なチェインディング契約 |
IChainableNode |
| IWorkflowOperation | 識別子および下流子接続を持つ名前付きワークフロー操作 | IWorkflowOperation |
| オペレーションチェーン | 指向性チェーントラッキングの開始・終了ノード;ファンインパターンのサポートJoin() |
オペレーションチェーン |
| ワークフローファクトリー | ステートフル、ステートレス、エージェントワークフロー定義を作成するためのファクトリーメソッド | ワークフローファクトリー |
アクションの種類
トリガー後に実行されるワークフローアクションの定義用タイプが発生します。
| タイプ | Description | Link |
|---|---|---|
| IWorkflowAction | 実行後設定付きのアクションステップのインターフェース | IWorkflowAction |
| IVariableワークフローアクション | 可変操作のための拡張アクションインターフェース | IVariableワークフローアクション |
| タイプ化されたワークフローアクションインターフェース | 強型型出力用の型安全インターフェース(IBodyWorkflowAction<T>、 IOutputWorkflowAction<T>) |
型付きアクションインターフェース |
| ワークフローアクションベース | 共通のアクション機能を提供する抽象基底クラス | ワークフローアクションベース |
| ワークフローBuiltInActions(ワークフロー組み込みアクション) | 組み込みアクション用のファクトリー:HTTP、Compose、Response、CustomCode、NestedWorkflow、Agent | ワークフローBuiltInActions(ワークフロー組み込みアクション) |
| ワークフローコントロールアクション | 制御フローの工場出荷時:スコープ、コンディション、フォーリッチャー、アンティル、スイッチ、終端 | ワークフローコントロールアクション |
| ワークフロー変数アクション | 変数操作用のファクトリー:初期化、セット、インクリメント、デクリメント、追加 | ワークフロー変数アクション |
| ワークフロー管理アクション | 拡張可能なマネージドコネクタアクション(コネクタ定義から自動生成) | ワークフロー管理アクション |
トリガーの種類
実行を開始するワークフロートリガーを定義するためのタイプです。
| タイプ | Description | Link |
|---|---|---|
| IWorkflowTrigger | ワークフロー実行を開始するルートトリガーのインターフェース | IWorkflowTrigger |
| 型付きワークフロートリガーインターフェース | 強型型出力用の型安全インターフェース(IOutputWorkflowTrigger<T>、 IBodyWorkflowTrigger<T>) |
型付きトリガーインターフェース |
| ワークフロートリガーベース | 共通トリガー機能を提供する抽象基底クラス | ワークフロートリガーベース |
| ワークフローBuiltInTriggers | 組み込みトリガーのファクトリー:HTTP Request、Recurrence、Conversational Agent | ワークフローBuiltInTriggers |
| ワークフロー管理トリガー | 拡張可能なマネージドコネクタトリガー(コネクタ定義から自動生成) | ワークフロー管理トリガー |
入場地点と登録
静的エントリーポイントと依存注入補助。
| タイプ | Description | Link |
|---|---|---|
| ワークフローアクション |
BuiltInおよびManagedアクション工場へのアクセスを提供する静的エントリーポイント |
ワークフローアクション |
| ワークフロートリガー |
BuiltInおよびManagedトリガー工場へのアクセスを提供する静的エントリーポイント |
ワークフロートリガー |
| IWorkflowProvider | ホスト登録のためのワークフロー定義を提供するインターフェース | IWorkflowProvider |
| ワークフロープロバイダー拡張 | DI拡張手法: AddWorkflowProvider<T>、 AddWorkflowProviders(assembly) |
ワークフロープロバイダー拡張 |
ランタイムとコンテキスト
ワークフロー実行時に使われるタイプ。
| タイプ | Description | Link |
|---|---|---|
| ワークフローコンテキスト | 動作やトリガー結果への実行時アクセスを提供する抽象コンテキスト | ワークフローコンテキスト |
| エージェントツールコンテキスト | AIエージェントツールのための型付きパラメータアクセスを提供するインターフェースとクラス | エージェントツールコンテキスト |
はじめに
Logic Apps Standard SDKをアプリケーションで使用するには:
SDK:プロジェクトに NuGetパッケージを追加してください - IWorkflowProviderを実装する: IWorkflowProvider インターフェースを実装してワークフロー定義を作成する
- WorkflowFactoryを活用:ステートフル、ステートレス、エージェントワークフロー向けに WorkflowFactory メソッドを使ってワークフロー定義を作成します
- アクションとトリガーへのアクセス: WorkflowActions と WorkflowTriggers を利用可能な操作へのエントリーとして使う
-
Fluent Chainingで構築:Fluent APIを使ってワークフローを構成:
trigger.Then(action1).Then(action2)
SDKは3種類のワークフロータイプをサポートしています: ステートフル (実行間の状態を維持する)、ステ ートレス (状態を維持せずに実行)、 エージェント (会話機能を備えたAI駆動のワークフロー)。