AgenticX Workflow Designer

Guide for building workflows that orchestrate agents, tasks, and execution paths.

Core Components

Component	Purpose
Workflow	Container for nodes and edges
WorkflowNode	A step in the workflow (agent + task)
WorkflowEdge	Connection between nodes (with optional conditions)
WorkflowEngine	Runtime executor for the workflow graph
WorkflowGraph	Graph representation of the workflow

Basic Workflow

from agenticx import Workflow, WorkflowNode, WorkflowEdge
from agenticx.core import WorkflowEngine

# Define nodes
research_node = WorkflowNode(
    id="research",
    agent=researcher_agent,
    task=research_task
)

analysis_node = WorkflowNode(
    id="analysis",
    agent=analyst_agent,
    task=analysis_task
)

# Define edges (sequential flow)
edge = WorkflowEdge(source="research", target="analysis")

# Build workflow
workflow = Workflow(
    id="research-pipeline",
    nodes=[research_node, analysis_node],
    edges=[edge]
)

# Execute
engine = WorkflowEngine()
result = engine.run(workflow)

CLI Workflow Creation

# Create workflow scaffold
agx workflow create research-pipeline --agents "researcher,analyst"

# List workflows
agx workflow list

# Run a workflow file
agx run workflows/research-pipeline.py --verbose

Workflow Patterns

Sequential Pipeline

Nodes execute one after another:

[Research] → [Analysis] → [Report]

edges = [
    WorkflowEdge(source="research", target="analysis"),
    WorkflowEdge(source="analysis", target="report"),
]

Parallel Execution

Multiple nodes execute concurrently:

         ┌→ [Web Search] ─┐
[Start] ─┤                 ├→ [Merge]
         └→ [DB Query]   ─┘