~/docs/workflows
Workflows
Linking triggers to action services with detailed execution steps.
A workflow is a named declaration that links a trigger (a Task or Trigger service) to one or more action services. It is not executable code — it is a plan. Execution happens when a Task fires or a Trigger service callsnotifyEventsAi.
Detailed Steps
Every workflow has a detailedSteps field — a text description that strictly governs how the Events agent processes the request. The AI defines these steps when creating the workflow, and the Events agent follows them exactly when executing.
Important: Never include a step that tells the Events agent to spawn the Orchestrator. The Events agent must handle everything itself. It will ask for help only if it gets completely stuck.
How Execution Works
1A Task fires or a Trigger service calls
notifyEventsAi2OpenPieces starts a new conversation with the Events agent
3The Events agent reads the workflow's detailedSteps
4It calls the linked action services in order
5Results are returned and the execution completes
Schedule workflows with tasks.Tasks