Telegram AI agent with Postgres memory and OpenRouter tools

# Setup & Configuration Guide

## 📋 **Setup Checklist**
```
□ Install N8N workflow platform
□ Set up PostgreSQL database
□ Configure AI Agent nodes
□ Test sub-workflow connection
□ Validate query limits
□ Deploy and monitor
```

---

## 🔧 **Database Configuration**
```
🎯 CRITICAL SETUP STEPS:
1. Create your PostgreSQL table
2. Replace [YOUR_TABLE_NAME] in templates
3. Update database schema in both agents
4. Set connection credentials in N8N
5. Test database connectivity
```

---

## 🤖 **Main Agent Setup**
```
📍 WHAT TO REPLACE:
• [YOUR_DATABASE_SCHEMA] → Your actual table structure
• [YOUR_ITEMS] → What you're querying (products, users, etc.)
• [CATEGORY_FIELD] → Your category column name
• [POPULARITY_FIELD] → Your popularity metric column
• [PRICE_FIELD] → Your price column name
```

---

## ⚙️ **Sub-Agent Configuration**
```
🔄 TEMPLATE REPLACEMENTS:
• [YOUR_TABLE_NAME] → Actual table name
• [field_name] → Your column names
• [verified_field] → Your verification column
• [popularity_field] → Your popularity column
• [description_field] → Your description column
```

---

## 🚨 **Critical System Limits**
```
⚠️ NEVER FORGET:
• Default LIMIT: 10 results
• Maximum LIMIT: 50 results
• NO unlimited queries allowed
• Always use ORDER BY with LIMIT
• System will break without limits!
```

---

## 🔗 **Workflow Architecture**
```
┌─────────────────┐
│   USER QUERY    │
└─────────┬───────┘
          │
┌─────────▼───────┐
│   MAIN AGENT    │ ← Interprets user needs
└─────────┬───────┘
          │
┌─────────▼───────┐
│   SUB-AGENT     │ ← Generates SQL query
└─────────┬───────┘
          │
┌─────────▼───────┐
│   DATABASE      │ ← Executes query
└─────────┬───────┘
          │
┌─────────▼───────┐
│   FORMATTED     │ ← Returns to user
│   RESPONSE      │
└─────────────────┘
```