Вы открываете статью про AI-агентов и видите слова «репозиторий», «контекст», «деплой» и «MCP». Знакомо? В этот момент хочется закрыть вкладку и забыть. Но давайте договоримся: вы не будете ничего программировать, а технические термины мы разберем на уровне «зачем это нужно», а не «как это устроено».
Цель этого текста — чтобы через вечер у вас на столе лежала работающая папка с вашим первым проектом, а не просто красивая переписка с чат-ботом.
1. Чем агент отличается от чата (и почему это меняет всё)
Обычный чат (ChatGPT или аналоги) — это собеседник. Он дает советы, пишет код, но руками ничего не делает. Вы копируете его ответы, вставляете в файлы, запускаете команды сами.
Агент — это руки. Он умеет:
- Читать и создавать файлы на вашем диске.
- Запускать программы и смотреть на результат.
- Лазить в интернет за данными.
- И, самое главное, работать циклом: сделал шаг, увидел ошибку, исправил, пошел дальше.
Главное отличие: разговор с чатом исчезает вместе с вкладкой. После работы агента остаются файлы, которые вы откроете завтра.
2. Где живет агент? Выбираем «дом»
Агент живет в оболочке. Их четыре типа, но для первого раза запомните только один.
- IDE (Среда разработки) — выглядит сложно (дерево папок, окно с кодом), но это ваш лучший друг на старте. Вы видите, какие файлы меняет агент, и можете нажать «отмена». Визуальный контроль снимает страх.
- Терминал — суровое черное окно. Ставится где угодно, но требует привычки.
- Расширение браузера — для быстрых правок.
- Облако — для работы на серверах.
Совет: Для первого месяца берите среду разработки (IDE). Когда видно, что именно изменилось, страх пропадает за два дня.
3. Проект = Папка. Это ваша память
Любая работа начинается с того, что вы указываете агенту папку. Это и есть ваш проект. Личный сайт — одна папка, телеграм-бот — другая, разбор документов — третья.
Внутри папки со временем появляется порядок:
Код: Выделить всё
moya-papka/
AGENTS.md // Инструкция для агента: "Кто я и чего нельзя делать"
README.md // Инструкция для людей: "Как это запустить"
docs/
plan.md // Текущий план работ
src/ // Код и файлы проекта
.env // Секреты (пароли, ключи)Золотое правило: Если решение принято и нигде не записано — через неделю его не существует. Файл AGENTS.md агент читает первым делом в каждой новой сессии. Это ваш голос в его голове.
4. GitHub: Машина времени и мост в интернет
Git — это «Сохранить как...» для всей папки. GitHub — это облачное хранилище для этих сохранений.
Зачем это вам:
- Откат. Агент сломал всё, что работало? Одна команда — и вы возвращаете вчерашний день.
- Видимость. Вы видите, что именно изменилось в файлах.
- Перенос. Открыли проект на другом ноутбуке — всё на месте.
- Деплой. Хостинг подключается к GitHub и забирает обновления автоматически.
Важно: Ключи и пароли в GitHub не кладем (для этого есть файл .env). Публичный репозиторий с секретами находят роботы за пару часов, и счет за чужие запросы придет вам.
5. Режимы работы: Почему «План» важнее «Результата»
У каждого агента есть переключатель режима. Самая недооцененная кнопка.
- Режим «Чтение» — просто смотрит.
- Режим «Планирование» — пишет план, но НЕ ТРОГАЕТ ФАЙЛЫ.
- Режим «Исполнение» — пишет код и меняет файлы.
- Автоматический режим — работает без вашего подтверждения (опасно для живых проектов).
Как начинать любую задачу:
Откройте сессию фразой: «Собери лендинг. Файлы пока не меняй, сначала покажи план».
Вы получаете 10 строк плана вместо 200 строк измененного кода. Править план — одна минута. Править готовый код — целый вечер.
6. Контекстное окно: Почему к вечеру агент глупеет
У агента есть «память» сессии — контекст. Туда попадают все ваши сообщения, открытые файлы и результаты команд. Это окно ограничено.
Когда оно забивается на 80%:
- Агент забывает начало разговора.
- Предлагает то, что вы уже отвергли.
- Правит файл, который просили не трогать.
Ритуал спасения:
Как только чувствуете путаницу, скажите агенту: «Запиши итоги и открытые вопросы в файл docs/resheniya.md».
После этого начинайте новую сессию. Файл — это память, сессия — это черновик. Закрыли сессию — потеряли договоренности.
7. MCP-коннекторы: Доступ к внешнему миру
По умолчанию агент видит только вашу папку. Коннекторы (протокол MCP) — это мостики к внешним сервисам.
Подключив коннектор, агент перестает просить у вас данные. Он сам:
- Забирает файлы из облачного диска.
- Смотрит аналитику сайта.
- Пишет заметки в ваш блокнот.
- Открывает браузер и делает скриншоты.
Это просто галочка в настройках. Кода вы не пишете. Но помните: каждый коннектор — это доступ к вашим данным. Подключайте только то, что нужно прямо сейчас.
8. Деплой: Как папка становится ссылкой в интернете
Пока проект лежит в папке — он ваш. Чтобы им пользовались другие, нужен деплой (размещение на сервере).
Цепочка выглядит так: Папка → GitHub → Хостинг → Ссылка.
Настройка занимает 5 минут и делается один раз.
- Сайт/Лендинг: Бесплатный хостинг (типа Netlify/Vercel). Подключили к GitHub — и каждое сохранение уезжает в интернет.
- Телеграм-бот: Нужен арендованный сервер (типа Railway) за $5 в месяц. Агент сам подключит базу данных и настроит переменные.
9. Ваша работа как человека (всего 4 пункта)
Из работы уходит «набор рук», остается «голова». Ваши задачи:
- Понимать «что и зачем». Устройство кода знать не обязательно.
- Ставить задачи словами. Обычным языком, с примерами и запретами.
- Принимать решения. Агент честно спросит, если есть развилка.
- Проверять. Открыть, нажать, прочитать. Агент склонен рапортовать об успехе раньше, чем он случился. Слово «Готово» — это не результат, это приглашение к проверке.
10. План первой недели
Чтобы не забросить на третий день, идите по шагам:
- Выберите одну настоящую боль. Сайт, разбор документов или бот. Учебные упражнения скучны.
- Установите ОДНУ среду с агентом. Не сравнивайте 5 инструментов — выберите один.
- Создайте папку и попросите агента написать файл-инструкцию (
AGENTS.md) о том, что за проект. - Первую сессию ведите в режиме «План». Не позволяйте трогать файлы, пока не прочитаете план.
- На второй день подключите Git. Привыкайте сохранять каждые 20 минут.
- Доведите до работающего состояния. Проект должен открываться и работать. Коннекторы и субагенты добавьте потом.
11. Грабли, на которые наступают все
- Сбор инструментов вместо работы. Пять установленных агентов и ноль проектов.
- Просьба «Всё и сразу». Крупная задача без плана — это хаос.
- Работа без сохранений. Сломанная папка без отката — это конец желания.
- Хранение договоренностей только в чате. Сессия закрылась — знания ушли.
- Вера отчетам. "Готово" в чате и "Работает" на экране — разные вещи.
Что запомнить
- Агент — это руки, а не только язык. Он оставляет файлы, а не письма.
- Проект — это папка. Порядок в папке важнее таланта.
- Начинайте с плана. Править план дешевле, чем править код.
- Контекст конечен. Записывайте итоги в файлы и начинайте новую сессию.
- Программировать не нужно. Технические слова (репозиторий, контекст, деплой) нужно знать как названия кнопок, а не как код.
Первая задача займет вечер и покажется медленной. Третья задача займет 20 минут. Дальше вы начнете формулировать задачи так, будто у вас есть личный ассистент. Потому что он у вас теперь есть.
