🤖 Линейка включает Telegram-бота CloudAdvisor (ниже — по README продукта) и сценарии для мессенджеров вокруг облачных и IT-ресурсов: меньше ручных операций, ответы ближе к чату.
☁️ CloudAdvisor Bot (Telegram) — анализ данных CloudAdvisor API: отчёты по ресурсам, экспорт в Excel, графики, произвольные запросы на естественном языке через GigaChat и автоматическая рассылка сводок по расписанию.
📱 Главное меню (кнопки): Excel-отчёт по ресурсам (CPU, память, стоимость, даты); график CPU; TOP загруженных и ненагруженных; сводная статистика; расписание рассылки (день, время, вкл/выкл, тестовая отправка).
🧠 Произвольные запросы (GigaChat): при GIGACHAT_TOKEN в .env пользователь пишет фразу в чат или использует /query и /search — модуль llm.py отправляет запрос в GigaChat со схемой данных; возвращается JSON (тип запроса, фильтры, сортировка, лимит). При необходимости бот задаёт уточняющие вопросы и варианты кнопками; затем выполняется query_execution по кэшу CloudAdvisor, результат уходит в чат. Без токена GigaChat соответствующие команды недоступны или показывают подсказку.
📊 Поддерживаются фильтрация по полям, сортировка и топ N, агрегации, относительные периоды («за 7 дней», «в январе 2026»), тип memory_metrics при поддержке API. Упрощение терминов: прод/k8s/box/dev/test — подстановка фильтров. Большие ответы: сводка, Excel, постранично. Запросы «график по CPU» и т.п. могут завершаться графиком (matplotlib) и картинкой в чате.
⏰ Рассылка по расписанию: день недели и слоты времени; в сводке три блока (созданные за 7 дней, не менялись месяц, песочница с «box»), до 10 записей в блоке, при объёме — Excel; тестовая отправка.
⚙️ Требования: Python 3.10+, доступ к CloudAdvisor API и Telegram Bot API. Запуск: python main.py, long polling, планировщик каждую минуту, логи в консоль и bot_errors.log.
🔑 В .env: TELEGRAM_BOT_TOKEN, ALLOWED_USER_IDS (белый список), CLOUDADVISOR_API_TOKEN, опционально API_URL GraphQL, GIGACHAT_TOKEN и GIGACHAT_BASE_URL для NL-запросов.
🗂️ Стек кода: main.py, config, auth, api (GraphQL), cache, handlers, keyboards, schedule_storage, query_execution, formatters, excel_export, charts, llm, prompts, state; schedules.json для расписания.
💬 VK остаётся в названии карточки как часть экосистемы мессенджеров и облачных сценариев; детальное описание выше — по ветке Telegram + CloudAdvisor из README проекта.