Documentation Index
Fetch the complete documentation index at: https://docs.enconvo.ai/llms.txt
Use this file to discover all available pages before exploring further.
Overview
EnConvo’s workflow engine supports advanced features beyond simple linear chains. This guide covers conditional branching, loops, variables, parallel execution, error handling, scheduled triggers, and more. All workflows use the visual node-based editor built with React Flow.Make sure you are familiar with basic workflow creation before diving into advanced features.
Conditional Branching
The If node lets you route workflow execution based on conditions.Simple Condition
Add an If node to create two branches — one for when the condition is true, another for when it is false.| Operator | Meaning | Example |
|---|---|---|
eq | Equals | {{input_text}} eq "yes" |
ne | Not equals | {{status}} ne "error" |
gt | Greater than | {{word_count}} gt 1000 |
lt | Less than | {{score}} lt 50 |
contains | Contains substring | {{input_text}} contains "urgent" |
is_empty | Value is empty | {{input_text}} is_empty |
Multiple Conditions (AND/OR)
Combine multiple conditions with AND or OR logic:- AND: All conditions must be true for the True branch
- OR: Any condition being true triggers the True branch
Nested Conditions
Chain multiple If nodes for complex decision trees:Loop Nodes
The Loop Items node iterates over a list, executing a sub-workflow for each item.Basic Loop
- Input: A list variable (array of items)
- Item Variable: Name for the current item (e.g.,
{{current_item}}) - Body: The actions to perform on each item
- Collect: Optionally collect all results into a new list
Example: Process Multiple URLs
Loop with Index
Access the current iteration index with{{loop_index}} for numbering or conditional logic within the loop.
Variable System
Variables allow data to flow between workflow nodes using Nunjucks/Jinja2 template syntax.Built-in Variables
| Variable | Description |
|---|---|
{{input_text}} | The initial input text passed to the workflow |
{{now}} | Current date and time |
{{working_directory}} | Current workspace directory |
{{responseLanguage}} | User’s configured response language |
{{clipboard}} | Current clipboard content |
{{selection_text}} | Currently selected text |
Node Output Variables
Reference the output of any previous node:Custom Variables
Define custom variables in workflow settings that can be referenced in any node:Translate to {{target_language}} and keep under {{max_length}} words.
Jinja2 Template Features
The variable system supports full Jinja2 templating:Delay Node
Add a wait step between actions. Useful for rate limiting or timed sequences.Parallel Execution
Run multiple nodes simultaneously when they do not depend on each other.Nested Workflow Calls
A workflow can invoke another workflow as a sub-step. This lets you build modular, reusable components.Error Handling
On-Failure Behavior
Each node can be configured with failure behavior:| Behavior | Description |
|---|---|
| Stop | Halt the entire workflow on error (default) |
| Skip | Skip the failed node and continue with the next one |
| Retry | Retry the node a specified number of times before failing |
Retry Configuration
Fallback Nodes
Connect a fallback branch from any node’s error output:External API Calls
Use the Code Runner or Web Fetch nodes to integrate with external services.HTTP Request via Code Runner
Web Fetch Node
Fetch and parse web content directly:AI Parameter Generation
Use an LLM node to dynamically generate parameters for subsequent nodes. This lets the AI decide how to proceed based on context.Scheduled Triggers (Cron)
Workflows can be triggered on a schedule using the Trigger Schedule node.Setting Up a Scheduled Workflow
Configure the schedule
Set the cron expression or use the visual scheduler:
- Every 5 minutes:
*/5 * * * * - Every hour:
0 * * * * - Daily at 9 AM:
0 9 * * * - Weekly on Monday:
0 9 * * 1
File Change Triggers
Use Watch Files Changes to trigger workflows when files are modified:Complete Workflow Examples
1. Automated Email Summary + Translation
Summarize new emails and translate the summary for a multilingual team.2. Daily News Collection + Knowledge Base
Collect daily news on configured topics and store in your knowledge base.3. Code Review Workflow
Automated code review with multi-aspect analysis.4. Batch Image Processing
Process a folder of images with compression and OCR.5. Customer Message Auto-Reply
Automatically categorize and respond to customer messages.Debugging Workflows
Run Logging
Every workflow execution is logged. View logs in:- Settings → Workflows → [Workflow Name] → Run History
- Each log entry shows node-by-node execution, timing, and any errors
Step-by-Step Testing
Test individual nodes before running the full workflow:- Select a node in the editor
- Click “Test This Node”
- Provide sample input
- Verify the output
Variable Inspector
During a test run, hover over any connection line to see the data flowing between nodes.Best Practices
Keep workflows modular
Keep workflows modular
Break complex workflows into sub-workflows. A single workflow should do one thing well. If it has more than 10 nodes, consider splitting it.
Use meaningful node names
Use meaningful node names
Rename nodes from defaults like “LLM Node 3” to descriptive names like “Categorize Customer Intent”. This makes debugging much easier.
Add error handling for external calls
Add error handling for external calls
Any node that calls external APIs (Web Fetch, Gmail, Slack) should have retry or fallback configured. Network failures are inevitable.
Test with edge cases
Test with edge cases
Test with empty inputs, very long inputs, unexpected formats, and error responses. Workflows that only work with perfect input will fail in production.
Use variables for configuration
Use variables for configuration
Put values like API endpoints, model names, and output formats in workflow variables rather than hardcoding them in node prompts. This makes workflows easier to update.
Monitor scheduled workflows
Monitor scheduled workflows
Set up hooks or IM Channel notifications for scheduled workflows so you know if they fail silently.
Next Steps
Creating Workflows
Start with the basics of workflow creation
Hooks
Trigger scripts and webhooks from workflow events
Built-in Extensions
Explore extensions to use in your workflows
Cron Jobs
Learn more about scheduled task management