Package com.tnsai.coordination.hierarchical

Class HierarchicalAgentOrchestrator

java.lang.Object
com.tnsai.coordination.hierarchical.HierarchicalAgentOrchestrator
public class HierarchicalAgentOrchestrator extends Object
Hierarchical agent orchestrator implementing the HLM (Hierarchical Language Model) pattern.

Provides explicit layer separation for complex multi-step tasks:

  • Strategic Layer: Goal decomposition - breaks down high-level objectives
  • Tactical Layer: Sub-task planning - coordinates implementation
  • Operational Layer: Action execution - performs concrete actions

HLM Pattern Benefits

  • Clear separation of concerns between planning and execution
  • Better handling of complex, multi-step tasks
  • Improved error recovery at each level
  • Parallel execution at operational level

Usage


 HierarchicalAgentOrchestrator orchestrator = HierarchicalAgentOrchestrator.builder()
     .strategicAgent(plannerAgent)      // High-level goal decomposition
     .tacticalAgent(coordinatorAgent)   // Sub-task breakdown
     .operationalAgents(workerAgents)   // Execution
     .build();

 HierarchicalResult result = orchestrator.execute("Build a web scraper for news sites");
 // Strategic: Decompose into components (crawler, parser, storage)
 // Tactical: Plan implementation order and dependencies
 // Operational: Write code, test, deploy each component
Since:
0.1.0

  • Method Details

    • builder

      public static HierarchicalAgentOrchestrator.Builder builder()
      Creates a new builder.

    • execute

      public HierarchicalResult execute(String goal)
      Executes a task through the hierarchical pipeline.
      Parameters:
      goal - The high-level goal to achieve
      Returns:
      The execution result

    • execute

      public HierarchicalResult execute(String goal, Map<String,Object> context)
      Executes a task through the hierarchical pipeline with context.
      Parameters:
      goal - The high-level goal to achieve
      context - Additional context for the task
      Returns:
      The execution result