Skip to main content

Advanced Workflows

Overview​

This guide covers advanced workflow features and patterns in Gentic.

Advanced Workflow Patterns​

Parallel Processing​

const workflow = await client.workflows.create({
  name: "Parallel Processing",
  steps: [
    {
      type: "parallel",
      config: {
        steps: [
          {
            type: "search",
            config: {
              knowledgeSourceId: "kb-1",
              query: "{{input}}"
            }
          },
          {
            type: "search",
            config: {
              knowledgeSourceId: "kb-2",
              query: "{{input}}"
            }
          }
        ]
      }
    }
  ]
});

Conditional Execution​

const workflow = await client.workflows.create({
  name: "Conditional Workflow",
  steps: [
    {
      type: "condition",
      config: {
        condition: "{{input.priority}} === 'high'",
        true: {
          type: "agent",
          config: {
            agentId: "priority-agent"
          }
        },
        false: {
          type: "agent",
          config: {
            agentId: "standard-agent"
          }
        }
      }
    }
  ]
});

Error Handling​

const workflow = await client.workflows.create({
  name: "Error Handling Workflow",
  steps: [
    {
      type: "try",
      config: {
        steps: [
          {
            type: "api",
            config: {
              url: "https://api.example.com",
              method: "POST"
            }
          }
        ],
        catch: {
          type: "agent",
          config: {
            agentId: "error-handler"
          }
        }
      }
    }
  ]
});

Advanced Features​

Workflow Composition​

const workflow = await client.workflows.create({
  name: "Composed Workflow",
  steps: [
    {
      type: "workflow",
      config: {
        workflowId: "sub-workflow-1"
      }
    },
    {
      type: "workflow",
      config: {
        workflowId: "sub-workflow-2"
      }
    }
  ]
});

State Management​

const workflow = await client.workflows.create({
  name: "Stateful Workflow",
  steps: [
    {
      type: "state",
      config: {
        key: "userContext",
        value: "{{input.user}}"
      }
    },
    {
      type: "agent",
      config: {
        agentId: "context-aware-agent",
        context: "{{state.userContext}}"
      }
    }
  ]
});

Event Handling​

const workflow = await client.workflows.create({
  name: "Event-driven Workflow",
  steps: [
    {
      type: "event",
      config: {
        event: "userAction",
        handler: {
          type: "agent",
          config: {
            agentId: "action-handler"
          }
        }
      }
    }
  ]
});

Best Practices​

  1. Workflow Design

    • Modular architecture
    • Clear error handling
    • State management
    • Event-driven patterns

  2. Performance Optimization

    • Parallel processing
    • Caching strategies
    • Resource management
    • Monitoring

  3. Testing and Debugging

    • Unit testing
    • Integration testing
    • Logging
    • Tracing

Next Steps​