interactor-workflows

The Interactor Workflows skill provides a robust framework for defining, validating, and executing state-machine based automations. It is designed for developers who need to manage complex, multi-step processes that require conditional logic, data persistence, and human intervention. By decoupling business logic from execution, you can define workflows as a set of states—including action, halting, and terminal states—and transition rules that dictate the flow of data. This is particularly effective for scenarios such as approval pipelines, multi-level purchase order processing, onboarding, and ticket routing systems. Developers interact with the workflow engine via a RESTful API to manage definitions, trigger new instances, and handle external user inputs during halting states.

• State-machine architecture with support for action, halting, and terminal states.

• Human-in-the-loop capability enabling pauses in execution for external user input via forms.

• Flexible data model supporting immutable input schema validation and mutable runtime data storage.

• Conditional transitions based on input values, runtime data, and complex logic.

• Built-in validation endpoint to verify workflow integrity before deployment.

• Native support for webhooks to trigger downstream notifications upon workflow completion or status changes.

• Integration with the broader Interactor ecosystem, including credential management and authentication providers.

• Always configure Interactor authentication using the interactor-auth skill before attempting to deploy or manage workflows.

• Utilize JSON Schema to define strict input requirements, ensuring consistency across workflow instances.

• Use the set step with the data. prefix to store and track runtime states across the lifecycle of a workflow.

• Leverage halting states for critical approval steps; the system will wait for an explicit resume signal with user input before continuing.

• Terminal states are ideal for triggering final HTTP callbacks to your application to finalize external transactions.

• Monitor workflow instances via the API to provide real-time updates and status tracking in your frontend interfaces.