Создание AI-агента на базе Cursor в Telegram
Ключевые тезисы
- Для сложных задач, выходящих за рамки единичного запроса, эффективнее использовать AI-агентов, а не просто чат-интерфейсы.
- Cursor (от ChatGPT) — одна из лучших платформ для создания агентов на стандартных подписках.
- Агента можно наделить инструментами, памятью, базами данных и удобным интерфейсом (например, Telegram).
- Весь процесс настройки занимает 10-15 минут с использованием готовых файлов-инструкций.
Почему именно AI-агенты?
Для решения простых задач подходят браузерные версии ChatGPT/Gemini/Claude. Однако, когда работа требует:
- Последовательных действий и контекста.
- Подключения дополнительных инструментов (поиск, работа с файлами).
- Использования баз данных и удобного интерфейса (Telegram, голосовые сообщения).
- Понимания задачи с первого раза и её выполнения в нужном месте.
В таких случаях необходимы полноценные AI-агенты.
Выбор платформы: Cursor
- Конкуренты: Cursor (ChatGPT), Claude Code, Gemini.
- Почему Cursor? Стабильная работа на стандартных подписках, без необходимости покупки дорогих API-ключей. Компании субсидируют функционал агентов в своих экосистемах.
Подготовка: где взять инструкции?
Все необходимые файлы (чек-лист и промпты для Cursor) доступны в закреплённом сообщении под видео через Telegram-бота.
- 1 файл — пошаговый чек-лист для вас.
- 8 файлов — полная документация и промпты для самого Cursor, чтобы он выполнял настройку автоматически.
Шаг 1: Установка Cursor на VDS
Безопасность: Установка на личный компьютер рискованна (агент может получить доступ ко всем файлам). Рекомендуется использовать VDS (виртуальный выделенный сервер).
- Стоимость: от $4-6 в месяц.
- Локация: США (чтобы избежать региональных ограничений).
- Система: Ubuntu (версия 22.04 или 24.04).
Процесс установки:
- Подключиться к серверу.
- Выполнить команды из чек-листа по порядку:
- Обновление сервера.
- Установка Node.js 22.
- Установка Cursor.
- Авторизоваться в Cursor через
sign in with device code(используя стандартную подписку ChatGPT).
Шаг 2: Подключение Telegram-интерфейса
Для удобства работы (отправка файлов, голосовых сообщений) агента подключают к Telegram-боту.
- Создать бота через @BotFather.
- Получить API-ключ бота и свой Chat ID (через бота
@get_id_bot). - Загрузить подготовленный файл с инструкциями по подключению (
telegram_bridge) в папку проекта на сервере. - Отправить Cursor соответствующий промпт из файла и ввести по запросу API-ключ и Chat ID.
- Результат: Бот начинает отвечать в Telegram.
Шаг 3: Настройка работы с медиа
Чтобы бот мог работать с голосовыми сообщениями, видео и фото, необходимо:
- Добавить поддержку Telegram Markdown-разметки для красивых ответов.
- Решить проблему с голосовыми сообщениями: Cursor по стандартной подписке не может использовать Whisper (транскрибация) без API-ключа OpenAI.
- Решение: Создать API-ключ в личном кабинете OpenAI и отправить его агенту.
- После настройки бот сможет транскрибировать голосовые сообщения и принимать файлы.
Шаг 4: Настройка памяти агента
Рекомендуется использовать три уровня памяти:
- Оперативная (Agent.md): Проектный файл, который агент читает при запуске. Содержит его идентичность, основные задачи и правила (например, язык общения).
Желательно не больше 300 строк. - Долгосрочная (например, Obsidian): Внешнее хранилище для всех заметок, сессий и сгенерированного контентом.
- Внешняя (базы данных, инструменты).
Настройка осуществляется отправкой агенту специального промпта из файлаmemory.
Шаг 5: Добавление скиллов (Skills)
Скиллы — это готовые инструкции для повторяющихся задач (например, создание CLI-команд).
- Можно использовать официальные скиллы от OpenAI (выложены на GitHub) или проверенные скиллы от сообщества (например, от Anthropic для Claude).
Рекомендация: Использовать скиллы от проверенных компаний, а не случайные "самописные" из интернета.- Процесс: Агенту отправляется промпт со списком нужных скиллов, и он их самостоятельно устанавливает.
Шаг 6: Команды управления
Для удобства в Telegram-бота добавляются специальные команды:
- /newchat – Начать новую сессию, сохранив итоги предыдущей.
- /checkpoint – Сохранить итоги работы в память.
- /dream – Консолидировать память (перечитать, обобщить, удалить устаревшее).
- Команды добавляются через @BotFather с описанием их функций.
Шаг 7: Подключение инструментов
Без инструментов агент — просто чат. Ему можно подключить:
- Веб-поиск (работает "из коробки").
- Google Workspace, GitHub, веб-скрапинг (например, через Firecrawl).
- Для подключения большинства инструментов потребуются соответствующие API-ключи, которые агент запросит в процессе настройки.
Шаг 8 (рекомендация): Надсмотрщики (AI-надзиратели)
Для сложных или критичных задач полезно, чтобы основной агент консультировался с другими моделями ИИ (например, с агентом на базе Claude или Gemini). Это повышает точность и снижает риск ошибок.
Дальнейшее улучшение агента
В материалах есть список из 50+ рекомендаций по улучшению AI-агентов. Процесс:
- Отправить агенту рекомендацию и спросить, стоит ли её внедрять.
- Если рекомендация критична (оценка 9/10 или 10/10) — дать команду на внедрение.
- Агент самостоятельно доработает свою конфигурацию, становясь эффективнее.
Итог: Используя готовые инструкции, можно быстро развернуть мощного AI-агента в Telegram с памятью, инструментами и навыками, который будет решать сложные задачи автономно.