Кому и зачем стоит прочитать эту статью?
Эта статья будет полезна трем категориям читателей:
- Предпринимателям и фрилансерам, которые тонут в ежедневной рутине разбора писем и хотят делегировать первичный анализ ИИ, чтобы не пропускать важные запросы от клиентов.
- Специалистам и инженерам, ищущим простые способы автоматизации процессов без развертывания сложных серверных сред и лишних финансовых затрат.
- Любителям DIY(сделай сам)-автоматизации. Этот скрипт — наглядный пример того, как связать разрозненные сервисы в одну экосистему.
Главное, что нужно понимать: этот материал — не просто готовая закрытая инструкция, которую нужно скопировать и забыть. Это в первую очередь демонстрация возможностей и гибкий фундамент. Моя цель — на простом, осязаемом примере показать, как работают современные автономные сценарии. Для кого-то этот скрипт станет готовым решением «из коробки», а для кого-то — отправной точкой и вдохновением для создания собственных, куда более сложных систем.
Используя этот шаблон, вы можете взять любую доступную нейросеть (например, бесплатный DeepSeek через его веб-интерфейс), "скормить" ей этот код и попросить переписать или модернизировать его под ваши личные уникальные задачи.
Создаем цифровой комфорт: Если вам близка тема умной автоматизации, чистых инженерных решений и настройки систем своими руками — подпишитесь на канал «Технокомфорт». Здесь я делюсь проверенным личным опытом и практическими кейсами, которые делают технологии прикладными. Ваша подписка — лучшая мотивация для выхода новых гайдов!
Архитектура решения: мощь нативных облачных скриптов
Вся прелесть этого подхода заключается в технологической чистоте. Нам не нужно держать включенным домашний компьютер, настраивать Linux-сервер или оплачивать сторонние платформы автоматизации. Наш агент разворачивается внутри Google Apps Script (GAS) — встроенной серверной среды разработки, которая выполняет код непосредственно внутри облачной инфраструктуры Google.
Мозг агента — модель Gemini 2.5 Flash. Она спроектирована специально для мультимодальных и быстрых задач, обладает огромным окном контекста и предоставляет разработчикам щедрые лимиты в рамках бесплатного тестирования (до 15 запросов в минуту), чего для обработки почты хватает с избытком.
Важнейший технический нюанс: поскольку скрипт выполняется на серверах Google, их внутренние запросы к собственному API Gemini идут напрямую. Это значит, что у облака Google нет никаких региональных ограничений на подключение к своей же нейросети — система будет работать стабильно и автономно круглые сутки.
Как работает эта связка:
- Автономность: Встроенный в облако планировщик (триггер) будит скрипт каждые 10 минут.
- Фильтрация и анализ: Скрипт мгновенно отсекает очевидный технический мусор и передает текст содержательных писем через API нейросети.
- Категоризация: ИИ анализирует контекст и возвращает строгий -ответ. Письма автоматически размечаются ярлыками. Суть чеков, квитанций и уведомлений о подписках парсится, и краткая выжимка (например, сумма или дата окончания услуги) отправляется вам в Telegram.
- Интеллектуальный ответ: Если письмо пришло от реального человека, Gemini не просто присылает уведомление, но и автоматически создает готовый черновик ответа в вашем Gmail. Вам остается лишь зайти, проверить текст и нажать кнопку отправки.
Пошаговый гайд по настройке
Шаг 1. Подготовка компонентов и получение API-ключей
- База данных: Создайте пустую Google Таблицу. Из её адресной строки скопируйте уникальный ID — это длинная строка символов между /d/ и /edit. Сохраните её, она нам понадобится для кода.
- Канал уведомлений (Telegram): * Найдите в Telegram бота @BotFather и отправьте команду /newbot. Задайте имя вашему ассистенту и скопируйте выданный токен (API TOKEN).
Чтобы бот знал, куда писать, узнайте свой персональный ID (например, через бота @userinfobot). - Получение API Gemini (Google AI Studio):
Платформа Google AI Studio сейчас имеет ограничения по IP для пользователей из РФ, поэтому для входа вам потребуется сноровка (тут надеюсь, что вы найдете ответ в интернете или среди знакомых). На работу самого скрипта в будущем это никак не повлияет.
Перейдите на сайт aistudio.google.com под своим Google-аккаунтом.
Нажмите «API key», а затем «Create API key».
Скопируйте сгенерированный ключ (он начинается на AIzaSy...). Совет: создайте таким образом 2 разных ключа(в разных учетных записях - это увеличит доступный бесплатный лимит). Наш скрипт поддерживает ротацию — если один ключ временно исчерпает минутный лимит запросов, система автоматически переключится на второй.
Шаг 2. Развертывание кода
В меню вашей созданной Google Таблицы перейдите в раздел Расширения -> Apps Script. Очистите открывшееся окно редактора от стандартного шаблона и поочередно перенесите туда три логических блока нашего боевого скрипта.
Полный код ИИ-агента
Блок 1: Конфигурация и логика планировщика
Внесите ваши технические данные (токены, ID таблицы и ключи Gemini) в объект CONFIG.
Блок 2: Бизнес-логика и контекстный анализ Gemini
Этот блок отвечает за первичную фильтрацию шума, отправку запроса к API Gemini 2.5 Flash и обработку структурированного ответа.
Блок 3: Сервисные и интерфейсные функции
Обеспечивают интеграцию с Telegram API, проверку уникальности писем (чтобы избежать дублирования записей) и автоматическое форматирование лог-таблицы.
Шаг 3. Автоматизация расписания
Сохраните проект (иконка дискеты). Чтобы агент перешел в полностью автономный режим, настроим внутренний триггер событий:
- В левой панели редактора Apps Script перейдите в раздел «Триггеры» (иконка часов).
- Нажмите кнопку «Добавление триггера» в правом нижнем углу.
- Выберите запускаемую функцию: startSmartMailAssistant.
- Выберите источник события: «По времени».
- Задайте тип триггера: «Минутный таймер» и укажите интервал (например, «Каждые 10 минут»). Нажмите «Сохранить».
При первом запуске и сохранении Google запросит стандартные разрешения на доступ скрипта к вашей почте и связанной таблице. Это безопасная внутренняя процедура авторизации — весь код выполняется строго в контуре вашего аккаунта.
Развернутый результат: как это работает на практике?
Когда вы закроете вкладку с кодом, система начнет жить своей жизнью. Давайте разберем сценарий: вам на почту одновременно приходят три разных письма. Спустя 10 минут срабатывает облачный триггер. Вот что произойдет на ваших глазах:
1. В интерфейсе Gmail
Скрипт автоматически создаст три новых ярлыка: [AI] Реальные люди, [AI] Квитанции и [AI] Подписки. Каждое входящее письмо мгновенно получит соответствующий тег, распределяя хаос по папкам.
Если письмо было от реального человека (например, партнер предлагает обсудить контракт), вы зайдете во входящие и увидите, что под его письмом уже создан и сохранен черновик ответа. ИИ вежливо поблагодарит за предложение, выделит ключевые тезисы и напишет профессиональный отклик в вашем стиле. Вам останется лишь внести правки (если нужно) и нажать одну кнопку отправки.
2. В вашем мессенджере Telegram
Вам не нужно постоянно обновлять почту. Бот пришлет интерактивные уведомления:
- «💰 Зафиксирована квитанция/чек. Детали: Оплата Яндекс Плюс на сумму X рублей от 04.06.2026».
- «⚠️ Окончание подписки! Инфо: Домен истекает через 7 дней, требуется продление».
- «👤 Письмо от человека: Иван Иванов (ivan@email.com). Тема: Запрос информации. Суть: Клиент просит выслать прайс-лист и примеры. ✍️ В черновиках Gmail создан авто-ответ».
Кстати, эти же уведомления возможно настроить в Max.
3. В вашей базе логов (Google Таблица)
Таблица превратится в структурированный архив . Каждая строка — это четкая запись: точная дата, уникальный ID сообщения (чтобы избежать дубликатов), данные отправителя, присвоенная ИИ категория, текстовая краткая выжимка и статус финального действия («Создан черновик ответа» или «Оставлено во входящих»). Вы получаете прозрачный и защищенный лог всей вашей корреспонденции.
Итог
Мы развернули гибкую систему автоматизации, используя исключительно штатные облачные технологии. Этот пример наглядно доказывает, что программирование и искусственный интеллект стали доступными прикладными инструментами, способными подстроиться под любые творческие или деловые задачи.