# 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 isn't just one workflow builder - it's a complete automation platform with 80+ node types and enterprise-grade 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 * **SLA 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! --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.agenticflow.ai/get-started/workflows-quickstart.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.