Biblioteca de Classes SDK Padrão de Aplicações Lógicas

O Azure Logic Apps Workflow SDK (Microsoft.Azure.Workflows.Sdk) fornece APIs de construtores fluentes para construir definições de workflow de Logic Apps programáticamente em C#. Este SDK permite aos programadores definir fluxos de trabalho usando uma abordagem segura para tipos e habilitada para IntelliSense, em vez de autoria JSON.

Visão geral da arquitetura

O SDK utiliza um padrão fluent builder para compor fluxos de trabalho através da cadeia de métodos:

Referência da Biblioteca de Turmas

Composição e Encadeamento de Fluxos de Trabalho

Tipos que definem como as operações de fluxo de trabalho são compostas em grafos de execução.

Tipo Descrição Link
IChainableNode Contrato de encadeamento fluente que fornece o Then() padrão de método para compor operações IChainableNode
IWorkflowOperação Operação de workflow nomeada com identidade e ligações filhas a jusante IWorkflowOperação
OperationChain Acompanhamento direcionado da cadeia de nós de início e fim; suportes Join() para padrões fan-in OperationChain
WorkflowFactory Métodos de fábrica para criar definições de fluxos de trabalho com estado, sem estado e agentes WorkflowFactory

Tipos de ação

Tipos para definir ações de fluxo de trabalho que se executam após os disparos.

Tipo Descrição Link
IWorkflowAction Interface para passos de ação com configuração de execução IWorkflowAction
IVariableWorkflowAction Interface de ação estendida para operações variáveis IVariableWorkflowAction
Interfaces de Ação de Fluxo de Trabalho Tipadas Interfaces seguras para tipos (IBodyWorkflowAction<T>, IOutputWorkflowAction<T>) para saída fortemente tipada Interfaces de Ação Tipada
WorkflowActionBase Classe base abstrata que fornece funcionalidades de ação comum WorkflowActionBase
WorkflowBuiltInActions Factory para ações incorporadas: HTTP, Compose, Response, CustomCode, NestedWorkflow, Agent WorkflowBuiltInActions
WorkflowControlControlActions Fábrica para o fluxo de controlo: Âmbito, Condição, ForEach, Até, Comutação, Terminar WorkflowControlControlActions
WorkflowVariableActions Factory para operações variáveis: Inicializar, Definir, Incrementar, Diminuir, Anexar WorkflowVariableActions
WorkflowManaged ActionsT Ações de conectores geridos extensíveis (gerados automaticamente a partir das definições dos conectores) WorkflowManaged ActionsT

Tipos de disparador

Tipos para definir gatilhos de workflow que iniciam a execução.

Tipo Descrição Link
IWorkflowTrigger Interface para o trigger raiz que inicia a execução do fluxo de trabalho IWorkflowTrigger
Interfaces de Gatilho de Fluxo de Trabalho Tipado Interfaces seguras para tipos (IOutputWorkflowTrigger<T>, IBodyWorkflowTrigger<T>) para saída fortemente tipada Interfaces de Disparo Tipado
WorkflowTriggerBase Classe base abstrata que fornece funcionalidade comum de gatilho WorkflowTriggerBase
WorkflowBuiltInTriggers Factory para triggers incorporados: HTTP Request, Recurrence, Conversational Agent WorkflowBuiltInTriggers
WorkflowManagedTriggers Disparadores de conectores geridos extensíveis (gerados automaticamente a partir das definições dos conectores) WorkflowManagedTriggers

Pontos de Entrada e Registo

Pontos de entrada estáticos e auxiliares de injeção de dependências.

Tipo Descrição Link
WorkflowAções Ponto de entrada estático que proporciona acesso e BuiltInManaged funcionamento das fábricas WorkflowAções
Triggers de Workflow Ponto de entrada estático que proporciona acesso e BuiltInManaged aciona fábricas Triggers de Workflow
IWorkflowProvider Interface para fornecer definições de workflow para registo de hosts IWorkflowProvider
WorkflowProvidersExtensions Métodos de extensão DI: AddWorkflowProvider<T>, AddWorkflowProviders(assembly) WorkflowProvidersExtensions

Tempo de execução & Contexto

Tipos usados durante a execução do fluxo de trabalho.

Tipo Descrição Link
WorkflowContexto Contexto abstrato que fornece acesso em tempo de execução a resultados de ação e disparo WorkflowContexto
AgentToolContext Interface e classe que fornecem acesso a parâmetros tipados para ferramentas de agentes de IA AgentToolContext

Introdução

Para usar o Logic Apps Standard SDK na sua aplicação:

  1. Referenciar o SDK: Adicione o pacote NuGet Microsoft.Azure.Workflows.Sdk ao seu projeto
  2. Implementar o IWorkflowProvider: Criar definições de fluxo de trabalho implementando a interface IWorkflowProvider
  3. Use o WorkflowFactory: Crie definições de fluxos de trabalho usando métodos WorkflowFactory para fluxos de trabalho com estado, sem estado ou de agente
  4. Ações de Acesso e Gatilhos: Use WorkflowActions e WorkflowTriggers como pontos de entrada para operações disponíveis
  5. Construir com Fluent Chaining: Compor fluxos de trabalho usando a Fluent API: trigger.Then(action1).Then(action2)

O SDK suporta três tipos de fluxos de trabalho: Stateful (mantém o estado entre execuções), Stateless (executa sem manter o estado) e Agent (workflows alimentados por IA com capacidades conversacionais).