Configuration

System Configuration Overview

ReCloud provides comprehensive configuration management enabling flexible deployment and fine-grained control over AI agent behavior, tool selection, and performance optimization.

Configuration Architecture

Multi-Level Configuration System

ReCloud implements a hierarchical configuration approach:

graph TD
    A[Global Settings] --> B[System Configuration]
    A --> C[Component Settings]
    A --> D[Project Overrides]

    B --> B1[API Keys]
    B --> B2[Model Selection]
    B --> B3[Security Policies]

    C --> C1[API Server Config]
    C --> C2[MCP Server Config]
    C --> C3[Desktop App Config]

    D --> D1[Tool Activation]
    D --> D2[Agent Behavior]
    D --> D3[Project Policies]

Configuration Types

Environment Variables

# API Configuration
GEMINI_API_KEY=your_api_key_here

# Agent Behavior
TOOL_USAGE_POLICY=balanced_usage
AGENT_BEHAVIOR_PROFILE=helpful_assistant
PROMPT_OPTIMIZATION_POLICY=on_demand_improve

# Model Configuration
DEFAULT_MODEL=gemini-2.5-flash
DEFAULT_TEMPERATURE=0.7
DEFAULT_MAX_OUTPUT_TOKENS=2048

Application Settings

Persistent configuration for user preferences and system settings.

Project-level Configuration

Per-project tool activation and behavior settings.

AI Model Configuration

Tool-Specific Model Mapping

ReCloud supports fine-grained model selection per tool:

const toolModelMap = {
  // Text Analysis
  'analyzeSentiment': 'ANALYZESENTIMENT_MODEL',
  'classifyText': 'CLASSIFYTEXT_MODEL',
  'detectBias': 'DETECTBIAS_MODEL',

  // Content Generation
  'generateCode': 'GENERATECODE_MODEL',
  'generateContent': 'GENERATECONTENT_MODEL',
  'generateChart': 'GENERATECHART_MODEL',

  // Computer Vision
  'analyzeImage': 'ANALYZEIMAGE_MODEL',
  'detectFaces': 'DETECTFACES_MODEL',
  'detectObjects': 'DETECTOBJECTS_MODEL'
};

Generation Parameters

Temperature Configuration

  • Range: 0.0 (deterministic) - 2.0 (highly creative)
  • Default: 0.7 (balanced creativity)

Token Limits

  • Default: 2048 tokens
  • Maximum: Configurable per deployment

Agent Configuration

Dynamic Directive Assembly

ReCloud implements a configuration system that enables contextual agent adaptation:

Tool Usage Policy

  • aggressive_usage: Maximum tool utilization
  • balanced_usage: Smart tool selection (recommended)
  • minimal_usage: Tools only when necessary

Behavior Profile

  • helpful_assistant: Comprehensive assistance
  • concise_executor: Brief, efficient responses
  • proactive_partner: Initiative-taking collaboration

Prompt Optimization Policy

  • always_improve: Continuous prompt enhancement
  • on_demand_improve: Quality-based optimization
  • disabled_improve: Static prompt usage

Configuration Assembly Process

sequenceDiagram
    participant TrayApp
    participant Environment
    participant ConfigBuilder
    participant MCP

    TrayApp->>Environment: Set settings
    Environment->>ConfigBuilder: Read preferences
    ConfigBuilder->>ConfigBuilder: Build configuration
    ConfigBuilder->>MCP: Apply configuration
    MCP->>MCP: Use configuration

Tool Configuration

Tool Activation Management

ReCloud provides granular control over tool availability:

System-wide Tool Control

  • Global Settings: Configure available tools across all projects
  • Category-based Control: Enable/disable entire tool categories
  • Performance Tuning: Adjust tool execution parameters

Project-level Tool Control

{
  "active_tools": [
    "analyzeSentiment",
    "generateCode",
    "generateQR",
    "systemMonitor"
  ],
  "disabled_tools": [
    "generateImage",
    "detectFaces"
  ]
}

Tool Categories

Text Analysis Tools (16 tools)

  • Sentiment analysis, entity recognition, language detection
  • Grammar correction, bias detection, plagiarism checking

Content Generation Tools (17 tools)

  • Code generation, content creation, image synthesis
  • Chart generation, SQL generation, test data creation

Computer Vision Tools (13 tools)

  • Image analysis, object detection, face recognition
  • Text extraction, image enhancement, format conversion

Data Processing Tools (8 tools)

  • Data analysis, cleaning, format conversion
  • Code debugging, anomaly detection, forecasting

Robotics & Automation Tools (11 tools)

  • Robotic control, task planning, safety constraints
  • Natural language command interpretation

Security Configuration

API Key Management

Secure Key Storage

  • Environment Variables: Primary key storage mechanism
  • Rotation Support: Automated key rotation capabilities
  • Access Logging: Comprehensive audit trails

Key Validation

const validateApiKey = (req, res, next) => {
  const apiKey = req.headers.authorization?.replace('Bearer ', '') ||
                 req.headers['x-api-key'] ||
                 req.body.apiKey;

  if (!apiKey || !isValidApiKey(apiKey)) {
    return res.status(401).json({ error: 'Valid API key required' });
  }

  req.apiKey = apiKey;
  next();
};

Access Control

Role-Based Access

  • Admin Access: Full system configuration and monitoring
  • User Access: Project-level tool configuration
  • API Access: Granular endpoint permissions

Network Security

  • CORS Configuration: Controlled cross-origin access
  • Rate Limiting: Abuse prevention and resource protection
  • Request Validation: Comprehensive input sanitization

Monitoring and Logging Configuration

Performance Monitoring

Metrics Collection

  • Request Latency: API response time tracking
  • Resource Usage: CPU, memory, and I/O monitoring
  • Error Rates: Comprehensive error tracking and alerting

Health Checks

// System health endpoint
GET /health

// Response
{
  "status": "healthy",
  "components": {
    "api": "up",
    "server": "up"
  },
  "metrics": {
    "uptime": "99.9%",
    "response_time": "150ms"
  }
}

Logging Configuration

Log Levels

  • DEBUG: Detailed execution information
  • INFO: General operational information
  • WARN: Warning conditions
  • ERROR: Error conditions requiring attention

Structured Logging

{
  "timestamp": "2024-01-01T12:00:00Z",
  "level": "INFO",
  "component": "ToolDispatcher",
  "message": "Tool execution completed",
  "tool": "analyzeSentiment",
  "duration": 1250,
  "correlationId": "req_123456"
}

Deployment Configuration

Environment-Specific Settings

Development Environment

NODE_ENV=development
LOG_LEVEL=debug
CACHE_ENABLED=false

Production Environment

NODE_ENV=production
LOG_LEVEL=info
CACHE_ENABLED=true
MONITORING_ENABLED=true

Scaling Configuration

Horizontal Scaling

  • Load Balancing: Multiple API instances
  • Session Management: Distributed session handling
  • Cache Synchronization: Consistent caching across instances

Resource Limits

const systemLimits = {
  maxConcurrentRequests: 100,
  maxMemoryUsage: '2GB',
  maxCpuUsage: 80,
  requestTimeout: 30000
};

Best Practices

Configuration Management

  1. Environment Separation: Maintain separate configurations for dev/staging/production
  2. Secret Management: Never commit sensitive data
  3. Version Control: Track configuration changes
  4. Documentation: Document all configuration options and their effects

Performance Tuning

  1. Monitor Metrics: Regularly review performance metrics
  2. Adjust Parameters: Fine-tune model selection and generation parameters
  3. Resource Planning: Scale resources based on usage patterns
  4. Cache Optimization: Configure caching strategies for optimal performance

Security Hardening

  1. Regular Updates: Keep all components updated with security patches
  2. Access Reviews: Regularly review and update access permissions
  3. Audit Logging: Enable comprehensive audit logging
  4. Backup Procedures: Maintain secure backup procedures for configurations

This comprehensive configuration system enables ReCloud to adapt to diverse deployment scenarios while maintaining optimal performance, security, and user experience.

Previous
System Overview
Next
Deployment
Slopbook® Engine - powered by Slopman