Подготовьте место для работы

Что мы здесь собираем

Я строю продукты с агентами. Для меня работа начинается с вопроса, что должно измениться у пользователя. Но до этого нужно подготовить место, где агент сможет читать файлы, менять код и запускать проверки. Иначе первый вечер уйдёт на переписку о том, почему команда не нашлась.

В методичке мы будем развивать «Полку», небольшой сервис для сохранения ссылок и заметок. Сначала он запускается на вашем компьютере. Затем на его примере разберём постановку задачи, инструкции в репозитории, проверку поведения, продолжение в новой сессии и выпуск. Это специально подготовленный учебный проект.

Можно проходить задания на своём продукте. Тогда выбирайте копию репозитория и отдельные тестовые данные. Если вы пока не знаете, как это устроить, начинайте с «Полки». Приёмы проще понять там, где цена ошибки невелика и видно всё приложение.

Скачать учебный пакет «Полка» · ZIP ↗

Выберите один способ работать с агентом

На Mac можно начать с Conductor. Он открывает репозиторий в отдельной рабочей области, показывает изменения и позволяет вести несколько задач. Пока создайте только одну область. Параллельная работа будет позже, когда появится что разделять.

Установите приложение с официального сайта и подключите поддерживаемого агента своим аккаунтом. Само приложение и доступ к модели имеют разные условия. До первого задания проверьте тариф выбранного агента и ограничения расхода. Стоимость инструментов не входит в покупку этой методички. Для первого прохода не нужны несколько подписок.

Если у вас уже есть работающий редактор с агентом, можете остаться в нём. Вам нужны доступ к папке проекта, просмотр изменений и терминал. На Windows используйте совместимый с вашей системой редактор; инструкции Conductor ниже относятся к его приложению для Mac. Суть заданий не меняется от расположения кнопки запуска.

Скачать Conductor ↗

Диктовка помогает сформулировать задачу

Wispr Flow можно использовать для ввода голосом в поле задачи. Он необязателен. Начните обычным текстом, если установка диктовки сейчас отвлекает от запуска. Скачивайте приложение с официального сайта, настройте русский язык и проверьте короткую фразу.

Диктуйте в поле сообщения, а команды вставляйте в терминал после чтения. Распознавание может изменить название файла, число или отрицание. Перед отправкой проверьте четыре места: что меняем, чего не трогаем, какой результат ждём и где работаем. Длинное голосовое не становится хорошим заданием только потому, что вы произнесли его быстро.

Wispr Flow ↗

Откройте папку и проверьте инструменты

Скачайте учебный пакет по ссылке в начале урока и распакуйте его в отдельную папку. Внутри находятся starter и reference. Откройте starter. Reference содержит разобранную реализацию для сверки; обращаться к ней лучше после собственной попытки. Не запускайте две папки одновременно на одном порту.

В терминале выполните команды ниже по одной. node --version должен показать Node.js 22 или новее. git --version должен вернуть номер версии Git. Если команда не найдена, установите инструмент с официального сайта, затем закройте и откройте терминал. Не просите агента переустановить всё окружение сразу.

Терминал выполняет команды в текущей папке. Проверьте её до запуска: в ней должны быть package.json и server.mjs. Если вы открыли родительскую папку архива, сначала перейдите в starter. Команда npm test запускает проверки и завершается. Команда npm start держит сервер работающим, пока вы его не остановите.

node --version
git --version
npm test
npm start

Установка Node.js ↗Установка Git ↗

Проверьте результат своими глазами

Откройте адрес, который напечатал сервер. Добавьте ссылку и короткую заметку, перезагрузите страницу. Запись должна остаться. Затем остановите сервер через Ctrl+C и убедитесь, что новая загрузка страницы больше не получает список. Так вы проверите и запуск, и остановку, а не только наличие красивого экрана.

Если порт занят, не завершайте незнакомый процесс. В обычном терминале задайте другой PORT согласно README пакета. Для Conductor сначала выполните раздел README про Git-репозиторий и задайте команду Run: npm start. Сервер берёт порт из CONDUCTOR_PORT, чтобы рабочие области не мешали друг другу. Этот же принцип позже понадобится для отдельных баз данных.

Сохраните команды, адрес и результат проверки в заметку. Для бесплатного первого урока достаточно локального файла. После покупки появится сохраняемая тетрадь. Подготовка закончена, когда вы сами можете повторить запуск и объяснить, что именно проверили. Установка десяти расширений к этому результату ничего не добавляет.