Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
L'SDK App per la logica di Azure Workflow (Microsoft.Azure.Workflows.Sdk) fornisce API builder fluent per costruire definizioni di workflow di Logic Apps in modo programmatico in C#. Questo SDK consente agli sviluppatori di definire flussi di lavoro utilizzando un approccio tipo sicuro e abilitato a IntelliSense invece dell'authoring JSON.
Panoramica dell'architettura
L'SDK utilizza un pattern builder fluente per comporre flussi di lavoro tramite la catena di metodi:
- Punti di ingresso: WorkflowFactory per la creazione di flussi di lavoro, WorkflowActions e WorkflowTriggers per l'accesso alle operazioni
-
Catena fluente:
Trigger → .Then(Action1) → .Then(Action2) → ... - Iniezione di dipendenze: Supporto tramite IWorkflowProvider e WorkflowProviderExtensions per la registrazione del flusso di lavoro
Riferimento della Biblioteca della Classe
Composizione e Catena del Workflow
Tipi che definiscono come le operazioni di workflow sono composte in grafici di esecuzione.
| TIPO | Description | Link |
|---|---|---|
| IChainableNode | Il contratto di catena fluente fornisce il Then() modello di metodo per comporre le operazioni |
IChainableNode |
| IWorkflowOperation | Operazione di workflow nominata con identità e connessioni figlie a valle | IWorkflowOperation |
| OperationChain | Tracciamento diretto della catena nodi di inizio e fine; supporti Join() per pattern a ventaglio |
OperationChain |
| WorkflowFactory | Metodi di fabbrica per creare definizioni di workflow stateful, stateless e agent | WorkflowFactory |
Tipi di azione
I tipi per definire azioni di workflow che si eseguono dopo i trigger si attivano.
| TIPO | Description | Link |
|---|---|---|
| IWorkflowAction | Interfaccia per i passaggi d'azione con configurazione run-after | IWorkflowAction |
| IVariableWorkflowAction | Interfaccia di azione estesa per operazioni variabili | IVariableWorkflowAction |
| Interfacce di azione del flusso di lavoro tipizzate | Interfacce sicure di tipo (IBodyWorkflowAction<T>, IOutputWorkflowAction<T>) per output fortemente tipati |
Interfacce d'azione tipate |
| WorkflowBaseActionBase | Classe base astratta che fornisce funzionalità di azione comune | WorkflowBaseActionBase |
| WorkflowBuiltInActions | Factory per azioni integrate: HTTP, Compose, Response, CustomCode, NestedWorkflow, Agent | WorkflowBuiltInActions |
| WorkflowControlControlActions | Fabbrica per il flusso di controllo: Scopo, Condizione, ForEach, Fino a quando, Commuta, Termina | WorkflowControlControlActions |
| WorkflowVariableActions | Factory per operazioni variabili: Inizializza, Imposta, Incrementa, Diminui, Appende | WorkflowVariableActions |
| WorkflowGestiteAzioni | Azioni gestite estensibili dei connettori (generate automaticamente dalle definizioni dei connettori) | WorkflowGestiteAzioni |
Tipi di trigger
Tipi per definire trigger di workflow che avviano l'esecuzione.
| TIPO | Description | Link |
|---|---|---|
| IWorkflowTrigger | Interfaccia per il trigger root che avvia l'esecuzione del workflow | IWorkflowTrigger |
| Interfacce di trigger di workflow tipizzate | Interfacce sicure di tipo (IOutputWorkflowTrigger<T>, IBodyWorkflowTrigger<T>) per output fortemente tipati |
Interfacce a trigger tipizzati |
| WorkflowTriggerBase | Classe base astratta che fornisce funzionalità di trigger comune | WorkflowTriggerBase |
| TriggerWorkflowBuiltInTriggers | Factory per trigger integrati: HTTP Request, Recurrence, Conversational Agent | TriggerWorkflowBuiltInTriggers |
| TriggerGestitiWorkflow | Trigger di connettori gestiti estensionali (generati automaticamente dalle definizioni dei connettori) | TriggerGestitiWorkflow |
Punti di ingresso e registrazione
Punti di ingresso statici e aiuti per l'iniezione di dipenze.
| TIPO | Description | Link |
|---|---|---|
| WorkflowAzioni | Punto di ingresso statico che fornisce accesso e BuiltInManaged azioni alle fabbriche |
WorkflowAzioni |
| Trigger del flusso di lavoro | Punto di ingresso statico che fornisce accesso e BuiltInManaged innesco delle fabbriche |
Trigger del flusso di lavoro |
| IWorkflowProvider | Interfaccia per fornire definizioni di workflow per la registrazione host | IWorkflowProvider |
| WorkflowProvidersExtensions | Metodi di estensione DI: AddWorkflowProvider<T>, AddWorkflowProviders(assembly) |
WorkflowProvidersExtensions |
Runtime e contesto
Tipi utilizzati durante l'esecuzione del flusso di lavoro.
| TIPO | Description | Link |
|---|---|---|
| Flusso di lavoroContesto | Contesto astratto che fornisce accesso in runtime ai risultati delle azioni e dei trigger | Flusso di lavoroContesto |
| AgentToolContest | Interfaccia e classe che forniscono accesso ai parametri tipizzati per gli strumenti degli agenti AI | AgentToolContest |
Come iniziare
Per utilizzare l'SDK Standard di Logic Apps nella tua applicazione:
-
Riferisci l'SDK: Aggiungi il pacchetto NuGet
Microsoft.Azure.Workflows.Sdkal tuo progetto - Implementa IWorkflowProvider: Crea definizioni di workflow implementando l'interfaccia IWorkflowProvider
- Usa WorkflowFactory: Crea definizioni di workflow usando i metodi WorkflowFactory per workflow stateful, stateless o agent.
- Azioni di accesso e trigger: Usa WorkflowActions e WorkflowTriggers come punti di ingresso alle operazioni disponibili
-
Costruisci con Fluent Chaining: Composizione workflow usando l'API di Fluent:
trigger.Then(action1).Then(action2)
L'SDK supporta tre tipi di workflow: Stateful (mantiene lo stato tra le esecuzioni), Stateless (run senza mantenere lo stato) e Agent (workflow basati su AI con capacità conversazionali).