Structured Workflow Engine MCP Server

# 🤖 BA Agent Telegram Bot - Complete Guide > **Sophia** - современный Business Analyst агент с поддержкой голоса и мультимодальности ## 📋 **Что это?** Современный n8n workflow, который создает **Sophia** - остроумного BA агента, работающего через Telegram бот с голосовой поддержкой и долгосрочной памятью. ### ✨ **Ключевые возможности:** - 🎙️ **Голосовые сообщения** - автоматическая транскрипция через Whisper - 💬 **Текстовые сообщения** - умная обработка через AI - 🧠 **Долгосрочная память** - Vector Store для контекста - 📋 **BRD/TRD генерация** - автоматическое создание документов - 💅 **HTML форматирование** - красивые ответы в Telegram ## 🚀 **Быстрый старт** ### **1. Создайте Telegram бота** ```bash # В Telegram найдите @BotFather и создайте бота: /newbot → "Sophia BA Agent" → @sophia_ba_bot # Сохраните Bot Token ``` ### **2. Настройте credentials в n8n** - **Telegram Bot API**: добавьте Bot Token - **OpenAI API**: добавьте API Key для GPT-4o + Whisper ### **3. Импортируйте workflow** ```bash # В n8n: Import from File → ba-agent-workflow.json # Обновите credential IDs в импортированных нодах ``` ### **4. Тестируйте** ``` Отправьте боту: "Привет!" или [голосовое сообщение] Попробуйте: "Создай BRD для CRM системы" ``` ## 🏗️ **Архитектура (2024)** ``` Telegram Bot → Voice/Text Detection → Whisper/Direct → Smart Routing → AI Agents → Vector Memory → HTML Response ``` ### **Современные компоненты:** - **Telegram Trigger Node** (не webhook!) - **OpenAI Whisper** для голоса - **LangChain AI Agents** с памятью - **Vector Store** для контекста - **HTML форматирование** ## 🎯 **Функциональность** ### **Голосовая мультимодальность** ``` 🎤 Пользователь: [Говорит] "Создай BRD для CRM" 🤖 Sophia: Понял! Создаю BRD для CRM системы... ``` ### **Smart Routing** - **"BRD/business requirements"** → BRD Agent - **"TRD/technical requirements"** → TRD Agent - **Все остальное** → Chat Agent ### **Contextual Memory** ``` 👤 "Помни: я работаю в финтехе" 🤖 "✅ Запомнила!" [Позже...] 👤 "Создай BRD" 🤖 "🏦 Создаю BRD с учетом финтех специфики..." ``` ## ⚙️ **Технические детали** ### **Современные n8n nodes (проверено через Context7):** ```json { "telegramTrigger": "нативная интеграция", "langchain.agent": "AI агенты последнего поколения", "vectorStoreInMemory": "долгосрочная память", "openAi": "GPT-4o + Whisper" } ``` ### **Voice Processing Pipeline:** ``` Voice Message → File Download → Whisper API → Text Processing → AI Response ``` ### **Memory Management:** ```javascript sessionKey: "{{ $('Telegram Bot Trigger').item.json.message.from.id }}" memoryKey: "ba_conversations" maxTokens: 8000 ``` ## 🔧 **Настройка** ### **AI Agents Configuration:** ```json { "model": "gpt-4o", "temperature": 0.7, "maxTokens": 2000, "sessionIdType": "customKey", "systemMessage": "HTML-formatted prompts" } ``` ### **Whisper Settings:** ```json { "model": "whisper-1", "language": "auto", "temperature": 0 } ``` ### **HTML Форматирование:** ```javascript // Автоматическое экранирование для Telegram $json.output.replace(/&/g, '&amp;') .replace(/>/g, '&gt;') .replace(/</g, '&lt;') ``` ## 🧪 **Тестирование** ### **Базовые команды:** - `"Привет"` - обычный чат - `"BRD для CRM"` - генерация BRD - `"TRD для API"` - создание TRD - `[Голосовое сообщение]` - тест транскрипции ### **Продвинутые сценарии:** - `"Помни: я использую Agile"` - тест памяти - `"Что я говорил про Agile?"` - проверка контекста - Длинные голосовые сообщения - тест Whisper ## 🚨 **Troubleshooting** | Проблема | Решение | |----------|---------| | Voice file download failed | Проверьте Bot Token | | Vector Store error | Обновите n8n до v1.24.0+ | | HTML не отображается | Установите parse_mode: "HTML" | | Agent не отвечает | Проверьте OpenAI API Key | ## 📊 **Производительность** - 🎙️ **Voice processing**: 3-5 сек - 💬 **Text processing**: 1-2 сек - 📋 **Document generation**: 5-10 сек - 🧠 **Memory retrieval**: <1 сек ## 🔗 **Интеграции** ### **Готовые:** - GitHub, Google Calendar, Gmail - Slack/Discord, Jira/Asana - AWS S3, любые HTTP APIs ### **Coding Agent Integration:** ```json { "type": "n8n-nodes-langchain.agent", "agentType": "toolsAgent", "tools": ["Code Tool", "GitHub Tool", "HTTP Request Tool"] } ``` ## 💡 **Уникальные фичи** ### **1. Мультимодальность** Единственный n8n workflow с полной поддержкой голоса через Whisper ### **2. Персонализированная память** Vector Store запоминает контекст каждого пользователя ### **3. Smart Document Routing** Автоматическое определение типа запроса (BRD/TRD/Chat) ### **4. Sophia Personality** ```javascript // Современный system prompt с HTML форматированием `You are <b>Sophia</b>, a brilliant and witty Business Analyst. 📅 <b>Today is:</b> {{ DateTime.now() }} 👤 <b>User:</b> {{ $json.message.from.first_name }} <b>🎯 PERSONALITY:</b> • Professional yet approachable • Witty with dry humor • Empathetic to business challenges` ``` ## 🆕 **2024 Updates** - ✅ **telegramTrigger** вместо webhook - ✅ **langchain.agent** вместо aiAgent - ✅ **vectorStoreInMemory** для памяти - ✅ **HTML formatting** для Telegram - ✅ **Whisper integration** для голоса ## 🎉 **Результат** **Современный BA Agent готов к работе!** - ✅ Telegram Bot (не webhook) - ✅ Мультимодальность (голос + текст) - ✅ AI Agents (LangChain) - ✅ Vector Memory (долгосрочный контекст) - ✅ Document Generation (BRD/TRD) - ✅ Coding Agent Integration **Sophia готова стать вашим лучшим BA помощником! 🚀💼** --- > 📁 **Файлы в этой папке:** > - `ba-agent-workflow.json` - основной n8n workflow > - `ba-agent-telegram-bot-readme.md` - этот документ