Overview
The Agent Global Node serves as the central control hub for agent management, providing comprehensive orchestration capabilities that enable automated execution, detailed monitoring, and flexible integration options. This node transforms individual agent components into production-ready, automated systems with enterprise-grade features for scheduling, logging, and external connectivity.
Agent Management Interface
Agent Overview Display
The node provides essential agent information at a glance:
Agent Statistics:
Agent Steps: Current count showing "0 Agent Steps" indicating agent structure
Node Count: Displays "14 Nodes" showing the total components in the agent
Agent Name: Shows agent identification (e.g., "TEST")
Agent ID: Unique identifier for agent tracking and management
Visual Design
The interface features a distinctive rainbow gradient border, providing:
Visual Recognition: Easy identification of the Agent Global Node
Status Indication: Visual cues for agent state and health
Professional Appearance: Modern, engaging interface design
Automated Scheduling System
Set Auto Trigger Configuration
The node includes sophisticated scheduling capabilities through the "Set Auto Trigger" toggle system:
Trigger Activation
Toggle Control: Simple on/off switch for automated execution
Schedule Management: Enable or disable timed agent execution
Resource Management: Control automated resource consumption
Flexibility: Easy activation and deactivation of scheduling
Schedule Configuration Options
Time-Based Scheduling Schedule Type Selection:
Hourly: Execute agent every hour at specified minutes
Daily: Run agent once per day at designated time
Weekly: Execute agent weekly on specific days and times
Monthly: Schedule monthly execution on designated dates
Time Setting Interface Precise Time Control:
Hour Selection: 24-hour format time selection (00-23)
Minute Selection: Minute-level precision (00, 05, 10, 15, 20, 25, 30, etc.)
Timezone Support: "EST" timezone specification with automatic handling
Format Display: "mm:ss" format for clear time representation
Time Picker Features
Dropdown Selection: Intuitive time selection interface
Increment Options: Standard time increments for easy selection
Visual Feedback: Clear display of selected times
Validation: Automatic time format validation and error checking
Save Configuration
Save Button: Confirms and applies scheduling settings
Immediate Effect: Settings take effect upon saving
Persistence: Schedule settings maintain across system restarts
Modification: Easy editing and updating of existing schedules
Agent Execution Control
Manual Execution
Run Agent Button:
Immediate Execution: Instant agent triggering regardless of schedule
Testing Capability: Manual testing of agent functionality
Override Control: Execute agents outside of scheduled times
Development Support: Essential for agent development and debugging
Execution Status
The interface provides real-time execution feedback:
Processing Indicators: Visual feedback during agent execution
Completion Status: Clear indication when agents finish
Error Reporting: Immediate notification of execution issues
Performance Metrics: Execution time and resource usage information
Comprehensive Logging System
Agent Logs Interface
Log Access:
Agent Logs Button: Direct access to comprehensive execution history
Search Functionality: "Search Date" field for filtering log entries
Historical Data: Complete record of all agent executions
Performance Analysis: Detailed metrics for optimization
Log Information Display
Detailed Execution Records:
Execution Metadata
Date and Time: Precise timestamp of each execution (e.g., "1:58 PM, 04/23/2025")
Status Tracking: Execution status including "Error while running" notifications
Token Usage: Resource consumption tracking ("0" tokens used)
Cost Analysis: Financial impact tracking ("$0.000000" cost per execution)
Status Categories
Successful Executions: Completed agents with success indicators
Error States: Failed executions with error descriptions
In Progress: Currently running agents with progress indicators
Cancelled: Manually stopped or system-cancelled executions
Log Analysis Features
Searchable History: Filter logs by date, status, or execution parameters
Export Capabilities: Download log data for external analysis
Trend Analysis: Pattern recognition in execution success/failure rates
Resource Monitoring: Track token usage and cost patterns over time
Advanced Integration Capabilities
Email Integration System
Email Trigger Configuration Email Calling Settings:
Turn On Email Triggering: Toggle switch for email-based agent activation
Agent Email Address: Unique email endpoint (e.g., "[email protected]")
Email Processing: Automatic parsing of incoming emails for agent data
Security Controls: "Allow emails from any address (not just yours)" option
Email Trigger Features
Automatic Processing: Incoming emails automatically trigger agent execution
Content Extraction: Email content becomes available as agent input data
Attachment Handling: Process email attachments as agent inputs
Response Capabilities: Send automated email responses based on agent results
Security Options: Control email sender restrictions for enhanced security
Webhook Integration
Webhook Configuration Webhook Calling Settings:
Turn on Webhook: Toggle activation for HTTP-based triggers
Agent Webhook URL: Dedicated endpoint for external system integration
HTTP Methods: Support for POST, GET, and other HTTP methods
Data Processing: Automatic parsing of webhook payload data
Webhook URL Management
Unique Endpoints: Each agent receives a unique webhook URL
HTTPS Security: Secure webhook endpoints with SSL encryption
Rate Limiting: Built-in protection against excessive webhook calls
Error Handling: Robust error processing for malformed requests
Webhook Use Cases
Third-Party Integrations: Connect with external services and platforms
Real-Time Triggers: Instant agent execution from external events
Data Synchronization: Automatic processing of data updates
Event-Driven Automation: Respond to external system events automatically
API Integration System
API Calling Configuration API Settings:
Turn on API Calling: Enable REST API access to agent
API Endpoint: Direct URL for programmatic agent execution
Authentication: API key-based security for authorized access
Documentation: Comprehensive API documentation and examples
API Authentication Security Features:
API Key Management: Secure authentication tokens
Key Rotation: Ability to regenerate API keys for enhanced security
Access Control: Restrict API access to authorized applications
Usage Monitoring: Track API calls and usage patterns
API Documentation and Examples Developer Resources:
JSON Body Examples: Complete request format documentation
Parameter Specifications: Detailed input parameter descriptions
Response Formats: Expected output structure and data types
Error Codes: Comprehensive error handling documentation
Sample API Call Structure
{
"_documentation": {
"description": "Structure of input data for the agent",
"fields": {
"inputId": "Unique identifier of the input node (required)",
"inputText": "Text or content that will be processed by the agent (required)",
"links": "Array of links related to the input (optional)",
"files": "Array of files attached to the input (optional)",
"isExtraction": "Boolean: indicates if this input is for data extraction (optional, options: true, false)",
"typeOCR": "String: type of OCR applied to the input (optional, default: 'mistral_ocr', options: 'mistral_ocr', 'vision_ocr', 'google_ocr')"
},
"nestedFields": {
"links": {
"name": "Descriptive name of the link (optional)",
"url": "Complete URL of the link (optional)"
},
"files": {
"name": "File name with extension (optional)",
"base64": "File content encoded in base64 (optional)"
}
}
},
"variableInputs": [
{
"inputId": "YOUR_INPUT_NODE_ID",
"links": [
{
"name": "",
"url": ""
}
],
"files": [
{
"name": "",
"base64": ""
}
],
"isExtraction": true,
"typeOCR": "mistral_ocr"
}
]
}API Integration Features:
Copy Link: Easy access to API endpoint URLs
Copy API Key: Secure key management with one-click copying
Copy JSON Body Example: Ready-to-use request templates
Real-Time Testing: Built-in API testing capabilities
Agent Configuration and Management
General Settings
Agent Information Management
Agent Name: Editable agent identification
Agent Summary: Descriptive overview of agent purpose and functionality
Agent JSON: Complete agent configuration in JSON format
Regeneration Options: Ability to regenerate agent components
Advanced Configuration Options
Custom ID Management:
Allow passing in custom ID for Chat Sessions: Enable custom session identification
Target Input Node: Specify entry points for email and webhook data
API Input Node Selection: Choose designated nodes for API data processing
Integration Target Configuration
Data Flow Management:
Target Input Node: Dropdown selection for email and webhook data destination
API Input Routing: Specify which nodes receive API call data
Data Mapping: Configure how external data maps to agent inputs
Processing Priority: Set execution order for multi-input agents
Best Practices and Optimization
Scheduling Strategy
Optimal Schedule Design:
Resource Consideration: Schedule during low-usage periods when possible
Frequency Optimization: Balance execution frequency with resource costs
Time Zone Planning: Consider target audience time zones for optimal timing
Backup Scheduling: Plan redundant executions for critical agents
Monitoring and Maintenance
Proactive Management:
Regular Log Review: Monitor execution patterns and error trends
Performance Optimization: Analyze token usage and execution times
Error Pattern Analysis: Identify and resolve recurring issues
Resource Budget Management: Track costs and optimize resource usage
Security Best Practices
Integration Security:
API Key Protection: Secure storage and regular rotation of API keys
Email Sender Validation: Use restricted email sender options when possible
Webhook Security: Implement additional validation for webhook data
Access Logging: Monitor all external access attempts and usage patterns
Integration Planning
Effective Integration Design:
Single Point of Entry: Use one primary integration method when possible
Data Validation: Implement robust input validation for all external data
Error Recovery: Design agents to handle integration failures gracefully
Documentation: Maintain clear documentation for all integration endpoints
Use Cases and Applications
The Agent Global Node enables sophisticated automation scenarios:
Business Process Automation
Document Processing: Automated handling of incoming documents via email
Customer Communication: Triggered responses based on external events
Data Synchronization: Real-time updates between systems via APIs
Report Generation: Scheduled creation and distribution of reports
Integration Scenarios
CRM Integration: Webhook triggers from customer management systems
E-commerce Automation: Order processing via API integrations
Content Management: Automated content processing from multiple sources
Monitoring Systems: Alert processing and automated response agents
Development and Testing
Agent Development: Manual execution for testing and debugging
Performance Testing: Scheduled execution for load and performance analysis
Integration Testing: Validation of external system connections
Deployment Validation: Automated testing of production agents
The Agent Global Node provides enterprise-grade agent orchestration capabilities, enabling sophisticated automation with comprehensive monitoring, flexible scheduling, and seamless integration options for modern business applications.