Table of Contents

Namespace JD.AI.Workflows

Classes

AgentRequest

Represents a request processed by the agent that may require workflow orchestration.

AgentStepDefinition

A single step definition within an AgentWorkflowDefinition.

AgentWorkflowBuilder

Builds executable workflows from AgentWorkflowDefinition definitions, wiring steps to a Semantic Kernel.

AgentWorkflowDefinition

Agent-level workflow definition that maps to a WorkflowFramework workflow. This is the serializable, versioned description persisted to the catalog.

AgentWorkflowDetector

Workflow detector that delegates to an IPromptIntentClassifier for TF-IDF-based intent classification.

DryRunStep

A single step preview in a dry-run.

FileWorkflowCatalog

File-based workflow catalog that persists definitions as JSON files. Uses a flat directory structure: {baseDir}/{name}-{version}.json.

HotSwappingIntentClassifier

Wraps an IIntentClassifierManager and a IPromptIntentClassifier so that callers can use the manager transparently without knowing about hot-swapping.

InMemoryWorkflowCatalog

Thread-safe in-memory implementation of IWorkflowCatalog. Suitable for testing and ephemeral use.

IntentClassifierFileWatcher

Background service that watches the ML.NET model file for changes and hot-swaps the active classifier when the file is updated.

IntentClassifierManager

Default implementation of IIntentClassifierManager.

MlNetIntentClassifier

ML.NET-based intent classifier that loads a pre-trained model from a .zip file and classifies prompts as workflow or conversation intent. Implements IPromptIntentClassifier so it is a drop-in replacement for TfIdfIntentClassifier.

StepEvent
TagWorkflowMatcher

Tag-only workflow matcher — simpler variant without exact name matching.

TfIdfIntentClassifier

TF-IDF-inspired intent classifier that determines whether a prompt describes an actionable process that should be routed through the workflow pipeline. Any imperative action that implies a repeatable, definable process is a workflow — even single verbs like "deploy" or "review". The downstream pipeline handles catalog lookup and planning mode if no workflow is defined yet. Zero external dependencies, thread-safe, sub-millisecond classification.

WorkflowArtifact

Exported workflow artifact in a specific DSL format.

WorkflowBridge

Bridges JD.AI workflow definitions to WorkflowFramework's execution engine. Translates AgentWorkflowDefinition into Workflow<AgentWorkflowData> and runs it.

WorkflowBridgeResult

Result of executing an agent workflow through the WorkflowBridge.

WorkflowDryRunResult

Result of a workflow dry-run.

WorkflowEmitter

Emits workflow definitions in JSON, C# builder, or Mermaid diagram format.

WorkflowExecutionCapture

Captures step-level execution events during a workflow run. Implements WorkflowFramework.IWorkflowEvents for direct integration with IWorkflowBuilder<T>.WithEvents.

WorkflowGenerator

Generates structured workflow definitions from natural language descriptions. Uses a prompt-based approach: the description is analyzed and decomposed into steps with tool mappings, parameters, and control flow.

WorkflowMatchResult

Match result from the workflow catalog.

WorkflowMatcher

Two-tier workflow matcher: exact name match (score=1.0) → tag overlap scoring. Empty/whitespace tags are filtered to prevent spurious matches.

WorkflowOrchestrator

Orchestrates the full workflow pipeline:

  1. Classify prompt (is this a workflow?)
  2. Match against catalog (do we have a workflow for this?)
  3. Optionally advise from history before execution
  4. If match found, execute via WorkflowBridge
  5. If no match, return "planning needed" result
  6. Optionally ingest the run result into the history graph
WorkflowOrchestratorResult

Result of the full detect-match-execute pipeline.

WorkflowRefinementResult

Result of an AI-powered workflow refinement.

Structs

IntentClassification

Result of intent classification indicating whether a prompt represents a workflow.

Interfaces

IAgentWorkflowDetector

Detects whether an agent request should be routed through a workflow pipeline.

IHotSwappableClassifier

Optional interface implemented by classifiers that support hot-reloading of their underlying model without full replacement.

IIntentClassifierManager

Manages the active IPromptIntentClassifier and enables hot-swapping to a new classifier (e.g. ML.NET model) without restarting the Gateway.

IPromptIntentClassifier

Classifies prompt intent before it reaches an LLM agent.

IWorkflowBridge

Bridges JD.AI workflow definitions to WorkflowFramework execution.

IWorkflowCatalog

Persists and retrieves versioned workflow definitions.

IWorkflowEmitter

Emits workflow definitions in various DSL formats.

IWorkflowMatcher

Matches incoming requests against catalogued workflows for reuse.

IWorkflowOrchestrator

Orchestrates the full workflow pipeline: classify → match → execute. Single entry point for the detect-match-execute workflow pipeline.

Enums

AgentStepKind

Step kind within an agent workflow.

StepEventKind
WorkflowExportFormat

Supported export formats.

WorkflowOutcome

Outcome of the orchestrator pipeline: pass-through, planning needed, executed successfully, or execution failed.