> For the complete documentation index, see [llms.txt](https://docs.agenticflow.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.agenticflow.ai/get-started/workflows-quickstart.md). # Workflows Quickstart **New to AgenticFlow?** Start with [Your First 5 Minutes](/get-started/your-first-5-minutes.md) guide first. ## What Makes AgenticFlow Workflows Different? AgenticFlow has **TWO distinct workflow systems** for different use cases: 1. **Traditional Workflows** - Sequential step-based automation (like Zapier) 2. **Workforce** - Visual multi-agent workflow builder with React Flow This is a workflow automation platform with 80+ node types and advanced configuration features. *** ## System 1: Traditional Workflows (Sequential Automation) ### What Are Traditional Workflows? Linear, step-by-step automations that process data through a sequence of actions: **Real Examples from the Platform**: * Text processing → AI analysis → Email generation → Send * Web scraping → Data extraction → Google Sheets export * Image upload → AI enhancement → Background removal → Social media post * CSV import → Bulk analysis → Report generation → Notification ### Available Node Types (80+ Actual Nodes) **AI & Language Models**: * `openai_ask_assistant` - GPT model interactions * `openai_ask_chat_gpt` - Chat completions * `claude_ask` - Anthropic Claude integration * `gemini_ask` - Google's Gemini AI * `pml_llm` - PixelML language models * `perplexity_search` - AI-powered search * `straico_prompt_completion` - Multi-model AI platform **Image Processing**: * `generate_image` - AI image generation * `enhance_image_v2` - Image enhancement * `face_swap` - Face replacement * `remove_background` - Background removal * `magic_upscale` - AI upscaling * `inpainting` - Fill image areas * `comfyui_gen_image` - Custom ComfyUI workflows **Data Operations**: * `web_scraping` - HTML content extraction * `firecrawl_scrape` - Advanced web scraping * `api_call` - HTTP API integration * `google_search` - Search integration * `dataset_import` - Data import/export * `knowledge_retrieval` - RAG search **Communication**: * `email_sender` - Template-based email * `telegram_send_message` - Telegram integration * `telegram_send_photo` - Media sending **Video & Audio**: * `text_to_speech` - Voice generation * `speech_to_text` - Transcription * `image_to_video` - Video creation * `lipsync` - Video lip synchronization * `youtube_upload` - YouTube integration **Integrations**: * `mcp_run_action` - Model Context Protocol tools * `replicate_run_model` - Replicate AI models * `fal_run_model` - Fal.ai integration * `google_sheet_export` - Spreadsheet creation ### Building a Traditional Workflow #### Step 1: Create New Workflow 1. **Click "Workflows"** in sidebar 2. **Click "New Workflow"** 3. **Choose "Build from Scratch"** or **Select Template** #### Step 2: Configure Basic Info * **Name**: Descriptive workflow name * **Description**: What this workflow does
#### Step 3: Build Your Workflow **The Interface**: * **Form-based Builder**: Step-by-step configuration * **Drag-and-Drop Reordering**: Rearrange workflow steps * **Variable System**: Use `{{variable}}` syntax to pass data between steps * **Real-time Validation**: Immediate error checking **Building Process**: 1. **Add Input Node**: Define what data comes into the workflow 2. **Add Processing Nodes**: Choose from 80+ available actions 3. **Configure Each Step**: Set parameters using form interfaces 4. **Add Output Node**: Define what results are returned 5. **Connect with Variables**: Use `{{step_name.output}}` syntax
#### Step 4: Test Your Workflow **Execution Modes**: * **Single Run**: Test with specific inputs * **Table Run**: Bulk processing with CSV data * **API Execution**: Programmatic triggering * **Scheduled Runs**: Time-based automation **Real-time Monitoring**: * **Status Tracking**: `created | not_started | queued | running | success | failed | cancelled` * **Progress Visualization**: See each step's execution state * **Error Handling**: Detailed error messages and retry options * **Performance Metrics**: Execution time and resource usage
*** ## System 2: Workforce (Visual Multi-Agent Builder) ### What is Workforce? A visual, node-based workflow builder using **React Flow** for complex multi-agent scenarios: **Technology**: * **React Flow**: Professional node-based editor * **Flowgram.ai Integration**: Advanced layout and collaboration features * **Real-time Collaboration**: Multi-user editing * **Auto-layout**: Intelligent node positioning ### Workforce Node Types ```typescript WorkforceNode Types: - WorkforceAgentNode // AI Agent interactions - WorkforceToolNode // Workflow/tool execution - WorkforceTriggerNode // Workflow triggers - WorkforceStateModifierNode // State management ``` **Connection Types**: * `next_step` - Sequential flow * `condition` - Conditional branching * `ai_condition` - AI-powered decisions ### Building a Workforce Workflow #### Visual Editor Features * **Drag-and-Drop Canvas**: Intuitive node placement * **Connection System**: Visual data flow arrows * **Real-time Execution Overlay**: See execution progress in real-time * **Keyboard Shortcuts**: Power-user productivity features * **Auto-layout**: Automatic node organization #### Agent Integration * **Multiple AI Providers**: OpenAI, Claude, Gemini, Perplexity, DeepSeek * **Tool Orchestration**: Agents can use traditional workflows as tools * **Knowledge Integration**: Hybrid search across knowledge bases * **MCP Client Support**: Extended tool capabilities
*** ## Advanced Workflow Features ### Connection System (300+ Integrations) **Connection Categories**: * **AI Services**: OpenAI, Claude, Gemini, Replicate, FAL * **Communication**: Email, Slack, Telegram, SMS * **Data**: Google Sheets, Databases, APIs * **Storage**: Cloud storage, file systems * **Automation**: Zapier-like integrations **Authentication Types**: * OAuth2 (with automatic refresh) * API Key authentication * Basic authentication * Custom authentication headers ### Bulk Processing System **Table Workflows**: * **CSV Upload**: Process hundreds of rows efficiently * **Progress Tracking**: Real-time progress for bulk operations * **Error Handling**: Failed row identification and retry * **Parallel Processing**: Optimized for large datasets **Performance Features**: * **Queue Management**: Efficient job processing * **Resource Optimization**: Dynamic scaling based on load * **Cache Layer**: Redis-based performance optimization ### API & Integration Features **REST API Access**: * **Programmatic Control**: Full workflow automation via API * **Webhook Triggers**: External system integration * **Authentication**: Multiple auth methods (Basic, Bearer token) * **Rate Limiting**: Built-in API protection **Enterprise Features**: * **Workspace Management**: Team-based workflow organization * **Role-based Access**: Granular permission controls * **Audit Logging**: Complete execution history * **Performance Monitoring**: Performance tracking and alerting ### Template System **Pre-built Templates**: Categories include: * **Marketing**: Content generation, social media automation * **Data Processing**: CSV analysis, web scraping, data enrichment * **Content Creation**: Blog posts, video generation, image processing * **Analysis**: Sentiment analysis, competitive research * **Communication**: Email campaigns, customer support automation **Template Features**: * **One-click Cloning**: Duplicate and customize workflows * **Public Marketplace**: Share workflows with community * **Version Control**: Template updates and change tracking * **Collaboration**: Team template libraries *** ## Choosing the Right System ### Use Traditional Workflows When: * **Sequential Processing**: Step-by-step data transformation * **Bulk Operations**: Processing large datasets (CSV files) * **Simple Logic**: Linear workflows without complex branching * **Integration Focus**: Connecting multiple services in sequence * **Scheduled Automation**: Time-based recurring tasks **Examples**: * Email marketing sequences * Data processing pipelines * Content generation workflows * API integrations and data sync ### Use Workforce When: * **Complex Decision Trees**: Multiple conditional paths * **Multi-Agent Scenarios**: Different AI specialists for different tasks * **Real-time Collaboration**: Teams building workflows together * **Visual Complexity**: Workflows with many branches and conditions * **Agent Orchestration**: Managing multiple AI agents working together **Examples**: * Customer service routing (different agents for different issues) * Complex analysis workflows (research → analysis → reporting → decision) * Multi-step approval processes * Dynamic content creation with multiple review stages *** ## Practical Example: Building Your First Workflow Let's build a "Content Analyzer" that processes text and generates insights: ### Traditional Workflow Approach **Steps**: 1. **Text Input** - User provides content to analyze 2. **Sentiment Analysis** - AI determines emotional tone 3. **Key Topics** - Extract main themes 4. **Summary Generation** - Create concise summary 5. **Action Items** - Generate next steps 6. **Email Report** - Send results to user **Node Configuration**: ``` Input: Text Content ↓ ({{text_content}}) Sentiment Analysis: OpenAI Ask Assistant ↓ ({{sentiment_analysis.result}}) Topic Extraction: Claude Ask ↓ ({{topics.result}}) Summary Generation: GPT-4 ↓ ({{summary.result}}) Email Generation: Template + Send Email ``` ### Testing and Iteration 1. **Start Simple**: Build with 2-3 nodes first 2. **Test Each Step**: Run individual nodes to verify output 3. **Add Complexity**: Gradually add more processing steps 4. **Monitor Performance**: Check execution times and costs 5. **Optimize**: Adjust model choices and parameters *** ## Cost Management ### Credit System (Actual Implementation) **Bucket-Based Credits**: * **Workspace Credits**: Shared across team members * **Expiring Buckets**: Subscription credits expire monthly * **Non-Expiring**: Top-up credits persist * **Automatic Refunds**: Failed workflows get credit refunds **Cost Factors**: * **Base Execution**: \~4.0 credits per workflow run * **Node Costs**: Different nodes have different pricing * **Model Costs**: GPT-4 more expensive than GPT-3.5 * **External API Calls**: Additional costs for third-party services **Cost Optimization**: * Choose appropriate models for each task * Use caching when possible * Optimize workflow logic to reduce unnecessary steps * Monitor usage in workspace billing dashboard *** ## Troubleshooting Common Issues ### Workflow Not Running * **Check Credits**: Ensure workspace has sufficient credits * **Verify Connections**: Ensure all external services are connected * **Validate Variables**: Check variable syntax `{{variable_name}}` * **Review Logs**: Use execution logs to identify failures ### Performance Problems * **Node Optimization**: Choose faster models when appropriate * **Parallel Processing**: Use workforce for concurrent execution * **Cache Strategy**: Implement caching for repeated operations * **Resource Limits**: Monitor timeout settings ### Integration Issues * **Connection Status**: Verify OAuth tokens haven't expired * **API Limits**: Check third-party service rate limits * **Data Format**: Ensure data matches expected node input formats * **Error Handling**: Implement proper error handling in workflows *** ## What's Next? ### Advanced Features to Explore 1. **MCP Integration**: Connect to Model Context Protocol tools 2. **Custom Connections**: Build integrations with your internal systems 3. **Webhook Automation**: Set up external trigger systems 4. **Bulk Processing**: Handle large-scale data operations 5. **Multi-Workflow Orchestration**: Chain workflows together ### Learning Path 1. **Master Templates**: Study pre-built workflows for your industry 2. **Build Progressively**: Start simple, add complexity gradually 3. **Join Community**: Share workflows and get feedback 4. **Monitor Performance**: Use analytics to optimize workflows 5. **Scale Up**: Move from single workflows to workflow orchestration *** ## Getting Help & Resources **Community & Support**: * **Discord**: - Real-time help * **Documentation**: Complete guides for all features * **Support**: * **Feature Requests**: **🎨 Visual Guides**: * [**Workflows Hub**](/workflows/04-workflows.md) - **Complete drag-and-drop guide** * [**Agents Hub**](/ai-agents/03-agents.md) - 11-tab agent configuration * [**Workforce Hub**](/workforce/05-workforce.md) - Multi-agent team orchestration **Related Guides**: * [Agents Quickstart](/get-started/agents-quickstart.md) - Build AI assistants * [MCP Integration](/integrations/agenticflow-mcp.md) - Connect external tools * [Templates Guide](/get-started/templates.md) - Use pre-built solutions *** **🎉 Congratulations!** You now understand AgenticFlow's comprehensive workflow system. Whether you need simple sequential automation or complex multi-agent orchestration, you have the tools to build sophisticated business automation. **Questions?** [Join our Discord community](https://qra.ai/discord) - we're here to help you build amazing workflows!