Documentation

Hierarchical Task

A component that allows you to create and execute structured tasks with defined inputs and outputs. The Hierarchical Task component provides a framework for creating modular, reusable operations in your workflow.

Hierarchical Task Component

Hierarchical Task component interface and configuration

Configuration Required: You must define both the description and expected output for your task to ensure proper execution. Make sure to clearly define the parameters your task expects.

Component Inputs

  • Description: Detailed explanation of what the task should accomplish

    Example: "Extract key information from the provided financial report including revenue, expenses, and profit margins."

  • Expected Output: Format specification for the task's output

    Example: "JSON object containing revenue (number), expenses (number), and profitMargin (percentage)"

  • Tools: Specific tools the task can use during execution

    Example: Selected tools might include database access, calculation helpers, or other components

Component Outputs

  • Task: The executed task result

    Example: The completed task with the expected output format containing the requested information

Configuration Options

Task Title

The name of your task component as it appears in the workflow

Default: "Hierarchical Task" Example: "Financial Report Analysis", "Customer Data Extraction"

Input Schema

Defines the expected inputs and their formats

Configuration through UI fields: - Description (required) - Expected Output (required) - Tools (optional)

Output Schema

Defines the structure of task results

Default output: - Task: The result of the executed task operation

Implementation Example

// Example configuration for a financial data analysis task const financialAnalysisTask = { description: "Analyze the quarterly financial report and extract key metrics", expectedOutput: "Return a structured JSON object with the following fields: - revenue (number, in millions) - expenses (number, in millions) - profit (number, in millions) - profitMargin (percentage) - yearOverYearGrowth (percentage)", tools: ["Calculator", "DatabaseQuery"] }; // Example integration in a workflow function processFinancialData(reportData) { // Connect the task component const taskResult = hierarchicalTaskComponent.execute({ description: financialAnalysisTask.description, expectedOutput: financialAnalysisTask.expectedOutput, tools: financialAnalysisTask.tools, context: { report: reportData } }); // Use the task result in subsequent operations return { analysis: taskResult.task, timestamp: new Date().toISOString() }; }

Use Cases

  • Data Processing: Create structured tasks for transforming and cleaning data
  • Content Generation: Define tasks that generate specific content formats
  • Information Extraction: Pull structured data from unstructured content
  • Analysis Operations: Perform complex analysis with clear output requirements
  • Modular Workflows: Build reusable task components for larger workflows

Best Practices

  • Be specific and detailed in your task description
  • Clearly define the expected output structure
  • Select only the necessary tools required for the task
  • Break complex operations into multiple smaller tasks
  • Use consistent naming conventions for similar tasks
  • Include validation criteria in your expected output
  • Document task components for reuse across projects