IDE для профессиональной разработки на Go
GoLand JetBrains Air
Если вы когда-либо разрабатывали бэкенд-сервисы на Go, велика вероятность, что вам доводилось писать и пару обработчиков вебхуков. Они небольшие и редко привлекают много внимания — по крайней мере, до тех пор, пока что-нибудь не сломается. Сторонний провайдер отправляет подписанный запрос, после чего вы проверяете подпись, сохраняете событие и отвечаете. Звучит как три простых шага, но многое может пойти не так. Перехваченный запрос могут воспроизвести повторно, дубликат — сохранить дважды, а поддельная подпись может остаться незамеченной.
Кодинг-агенты вряд ли допустят ошибки такого рода, поэтому по мере того, как генерация кода становится всё дешевле, обработчики превращаются для них в отличную задачу. К тому же они способны написать обработчики быстрее вас. Но даже несмотря на их пригодность для этой задачи, если вы хотите избежать проблем в продакшене, вам всё равно придётся проверять, всё ли они сделали правильно.
Именно здесь на сцену выходит JetBrains Air в IDE. Этот инструмент предоставляет единое пространство для запуска предпочитаемых агентов, отслеживания их прогресса и проверки их работы. В этой статье мы создадим небольшой приёмник вебхуков, выполним ревью изменений и отправим обратную связь прямо из diff-представления, а затем запустим несколько параллельных сопутствующих задач (каждую в собственном рабочем дереве), которые позже будут объединены. Наконец, мы проверим объединенный результат с помощью инструментов GoLand, включая HTTP-клиент и инструменты работы с базами данных. А чтобы облегчить задачу, мы позволим агенту профилировать обработчик с помощью нашего нового навыка профилирования — goland-profiler.
Присоединяйтесь к нам, чтобы узнать, как всего за несколько минут создать работающий сервис, в надежности которого вы будете уверены.
Что мы создаем
Наш пример представляет собой небольшой сервис, который принимает подписанные платежные вебхуки в стиле Stripe и сохраняет каждое событие ровно один раз. Мы начинаем с пустого модуля Go, в котором нет ничего, кроме краткого файла BRIEF.md, который агенты будут использовать в качестве справочника. Вы можете скопировать его из demo repository: air-goland-demo.
Вот принципы нашего проекта:
- Только стандартная библиотека: наш проект использует net/http для маршрутизации, log/slog для логирования и хранилище в памяти, поэтому сервис запускается с помощью go run и не требует дополнительной настройки.
- Только один эндпоинт: POST /webhooks/{provider} принимает JSON-событие и сохраняет его один раз по его идентификатору. Новое событие получает статус 202 Accepted, а повторно отправленное — 200 OK.
- Подписанные запросы: каждый запрос содержит подпись, а всё, что имеет пропущенную или недействительную подпись, либо метку времени старше пяти минут, получает статус 401 Unauthorized.
Формулирование основных принципов — это то, что вам не обязательно сразу передавать на откуп агентам, поскольку именно здесь вы определяете критерии готовности (definition of «done»). Кроме того, поскольку несколько агентов будут использовать его одновременно, бриф — это то, что объединяет их работу. Естественно, чем лучше вы определите объем проекта, тем проще будет агентам следовать инструкциям и совершать меньше ошибок.
Сначала мы попросим агента собрать сервис на основе файла BRIEF.md: хранилище, обработчик, проверку подписи и main.go. Как только это будет готово, мы возьмем на себя три сопутствующие задачи: хранилище на базе SQLite, дополнительные тесты для проверки подписи и набор подписанных тестовых запросов для HTTP-клиента GoLand. Когда мы закончим, ядро сервиса должно напоминать наш репозиторий с демо-приложением — эталонную версию сервиса, которую вы можете использовать для тестирования нашего нового навыка Profiling (подробнее об этом позже). В эталонной версии сохранено только хранилище в памяти, поэтому в ней нет хранилища SQLite и настройки HOOKRELAY_DB, которую добавляет ваш агент.
Начало работы с Air в GoLand
В GoLand 2026.3 Air стал рабочим пространством ИИ по умолчанию (заменив AI Assistant), поэтому устанавливать ничего не нужно — вы увидите его на своем домашнем экране после обновления. Вы можете выбрать, с какими агентами хотите работать, включая Junie, Codex, Claude Code или любого другого агента, поддерживающего протокол Agent Client Protocol (ACP).
Есть три способа начать сеанс:
- Виджет агента: нажмите на виджет на главной панели инструментов, чтобы начать сеанс с текущим пресетом, или нажмите кнопку выпадающего списка рядом с ним, чтобы выбрать другого агента.
- Окно инструмента Agent Sessions: откройте его через View | Tool Windows | Agent Sessions.
- Глобальный промпт: дважды нажмите Ctrl в любом месте IDE, введите запрос и нажмите Enter. Если в редакторе выделен код, он будет использован в качестве контекста.
Каждый сеанс открывается во вкладке. Вы можете выбрать модель, уровень усилий и уровень доступа (то есть объем полномочий агента). При первой отправке запроса агент может попросить вас авторизоваться — с помощью учетной записи сервиса, JetBrains AI или ключа провайдера, который вы добавляете в разделе Settings | AI | Air | Accounts.
Запуск вашей первой задачи для агента
Сначала мы передадим разработку ядра сервиса агенту Codex. При правильно определенной области видимости один агент с достаточно надежной моделью должен справиться с созданием этого простого сервиса без каких-либо серьезных проблем.
- В окне инструмента Agent Sessions нажмите кнопку выпадающего списка рядом с New Session и выберите Codex.
- Выберите модель в селекторе моделей под текстовым полем.
- Введите запрос и нажмите Enter.
Вот промпт, который мы использовали:
Создайте сервис, описанный в BRIEF.md: хранилище событий в памяти за интерфейсом Store в internal/store, обработчик вебхуков в internal/webhook, верификацию подписи в виде middleware для net/http в internal/middleware и файл main.go, который связывает их воедино. Сохраняйте каждое событие один раз по его ID, отвечая 202 Accepted для нового события и 200 OK для дубликата, и выполняйте логирование с помощью log/slog. Добавьте табличные тесты и бенчмарк для обработчика.
Ревью изменений
Простая часть позади. Теперь пришло время разобраться в том, что создал агент, и проверить, всё ли он сделал правильно.
Когда агент завершает шаг, в сеансе отображается список измененных им файлов с добавленными и удаленными строками в разделе Since last turn. Нажмите на файл, чтобы открыть его diff, или нажмите Review, чтобы просмотреть их все по очереди. Поскольку этот сеанс работает непосредственно в вашем проекте, его изменения также отображаются в окне инструмента Commit (⌘K). Для сеансов, которые выполняются в рабочем дереве (к чему мы вернемся чуть позже), в заголовке сеанса отображается раздел Worktree Changes, содержащий все изменения, внесенные агентом по сравнению с базовой веткой.
К счастью, приёмники вебхуков дают сбои по вполне предсказуемым сценариям. Именно здесь вам пригодится ваш реальный опыт разработчика. Вместо того чтобы читать diff сверху вниз, вы можете проверить его по короткому списку типичных уязвимостей:
- Сравнение за постоянное время: подписи следует сравнивать с помощью hmac.Equal. Обычный оператор == или функция bytes.Equal возвращают результат при первом несовпадающем байте, что может раскрыть информацию о том, какая часть поддельной подписи была верной.
- Необработанное тело запроса (Raw body): HMAC должен охватывать метку времени и тело запроса ровно в том виде, в котором они поступили, а не в перекодированной версии разобранного JSON.
- Окно повтора (Replay window): устаревшие метки времени должны отклоняться, иначе перехваченный запрос можно будет воспроизводить бесконечно.
- Ограничение размера: без http.MaxBytesReader клиент может отправить тело запроса произвольного размера, и сервис прочитает его полностью.
- Однократное чтение: если middleware читает r.Body для проверки подписи, оно должно вернуть его на место для обработчика.
- Идемпотентные ответы: провайдеры повторяют любые запросы, не получившие ответ 2xx, поэтому дубликаты — включая те, что не успели сохраниться из-за состояния гонки — должны получать 200 OK.
- Тихие ошибки: ответы об ошибках должны содержать короткое фиксированное сообщение, в то время как подробности отправляются в логи. Мы рассматривали это в нашем руководстве по безопасной обработке ошибок в Go.
Давайте обратную связь в diff
Если вы обнаружите какие-либо ошибки, вы можете описать каждое изменение, которое хотите внести, в чате, но быстрее и надежнее будет указать агенту на нужную строку кода. В diff нажмите на значок чата на полях рядом со строкой или выделенным фрагментом, введите свое примечание и нажмите «Добавить примечание» (Add Note) или клавишу Enter. Вы также можете оставить несколько примечаний и отправить их вместе.
После отправки сообщения примечания остаются прикрепленными к нему как запись в режиме только для чтения, отражающая ваши требования. Агент продолжает работу с этого момента, а его список «С последнего шага» (Since last turn) показывает только то, что изменилось с того времени.
Когда вы будете довольны результатами, закоммитьте их из окна инструмента Commit (⌘K). Это станет нашей отправной точкой для последующих задач.
Запускайте больше задач параллельно
Обычно вы, вероятно, выполняли бы задачи, над которыми мы будем работать, последовательно. Но поскольку они практически не зависят друг от друга, вы можете распределить их между агентами одновременно и просматривать изменения по мере их поступления. Мы собираемся создать:
- Хранилище SQLite: постоянное хранилище, работающее через существующий интерфейс Store.
- Тесты для окна повтора (replay window): доказательство того, что middleware подписи отклоняет запросы старше пяти минут.
- Подписанные тестовые запросы: способ протестировать весь сервис с помощью HTTP-клиента GoLand.
Мы будем работать с рабочими деревьями (worktrees), чтобы агенты не мешали друг другу. Вот как их настроить:
- В окне инструмента Agent Sessions нажмите кнопку раскрывающегося списка рядом с «Новая сессия» (New Session) и выберите агента.
- Откройте список режимов запуска на панели инструментов над текстовым полем и выберите «Новое локальное рабочее дерево» (New Local Worktree). Сессия получит собственное рабочее дерево Git и ветку.
- В списке веток рядом с названием проекта выберите ветку с вашим первым коммитом в качестве базы.
- Выберите модель в селекторе моделей под текстовым полем.
- Введите промпт и нажмите Enter.
Мы собираемся передать задачу по созданию хранилища SQLite для Claude с помощью этого промпта:
Добавь реализацию интерфейса Store на базе SQLite в internal/store, используя чистый Go-драйвер modernc.org/sqlite, чтобы сервис по-прежнему запускался через go run. Сделай ID события первичным ключом, чтобы повторная вставка возвращала ту же ошибку, что и хранилище в памяти. В main.go используй SQLite, если HOOKRELAY_DB установлен в путь к файлу, и оставь хранилище в памяти по умолчанию. Добавь табличные тесты для временной базы данных. Драйвер — единственное исключение из правила использования стандартной библиотеки.
Две другие задачи довольно рутинные, поэтому они хорошо подходят для Junie Lite — нашего агента кодирования с экономичной моделью для повседневных задач, который работает с вашей учетной записью JetBrains. Вот промпты:
Добавь табличные тесты для middleware подписи в internal/middleware, чтобы проверить, что запрос отклоняется с ошибкой 401 Unauthorized, если его временная метка старше пяти минут, и принимается, если он находится в пределах этого окна. Изменяй только тестовые файлы.
Создай requests/webhooks.http для HTTP-клиента GoLand с тремя запросами POST {{host}}/webhooks/stripe: валидное событие, то же событие, отправленное повторно, и событие с неверной подписью. Подпиши первые два в скрипте перед запросом, как описано в BRIEF.md. В среде разработки помести хост в requests/http-client.env.json, а секрет — в requests/http-client.private.env.json. Для каждого запроса добавь проверку ответа на соответствие коду состояния, ожидаемому в брифе.
Теперь все три агента работают бок о бок, каждый в своем рабочем дереве. Окно инструмента Agent Sessions показывает, какие сессии находятся «В процессе» (In Progress), какие требуют вашего ввода, а какие завершились результатами, которые вы еще не просмотрели, поэтому нет необходимости постоянно переключаться между вкладками для проверки. Если вы включите «Время и стоимость» (Time and Cost) в меню фильтра, вы также сможете увидеть, как долго выполняется каждая сессия и сколько она стоила на данный момент.
Если агенту требуется ваше решение — например, разрешение на запуск go test — его сессия помечается как ожидающая ввода, и вы можете ответить прямо в его вкладке. Вы также можете ставить последующие промпты в очередь, пока агент занят. Они будут отправлены, как только он завершит текущий шаг.
Связываем все воедино
Каждое из новых дополнений было протестировано только по отдельности — хранилище SQLite с временным файлом, а новые тесты — с middleware, в то время как тестовые запросы еще никуда не отправлялись. Теперь, когда мы хотим объединить ветки, пришло время проверить все целиком.
Во-первых, вы хотите просмотреть каждое рабочее дерево так же, как вы делали это с исходным сервисом: просмотрите изменения и оставьте примечания в diff.
Помните, что тестовые запросы должны подписывать именно то, что проверяет middleware, обеспечивая ту же строку с тем же секретом в том же формате заголовка. Секрет должен находиться в http-client.private.env.json, а не в общем файле окружения или скрипте.
Когда вы будете довольны результатами, вы можете объединить эти три ветки:
- В своем проекте переключитесь на ветку, в которую должна попасть работа. Air выполняет cherry-pick в ту ветку, которая выбрана в данный момент, а не в базовую ветку рабочего дерева.
- В заголовке каждой сессии нажмите кнопку раскрывающегося списка рядом с «Коммит» (Commit), выберите «Коммит» (Commit) и выполните cherry-pick для всего.
Отправьте тестовые запросы
Файл приватного окружения находится в .gitignore, поэтому копия Junie Lite осталась в его рабочем дереве. Создайте свой собственный в requests/http-client.private.env.json:
Затем запустите сервис с SQLite: откройте конфигурацию запуска для main.go (Run | Edit), добавьте HOOKRELAY_DB=hookrelay.db в разделе Environment и запустите его. Затем откройте requests/webhooks.http, выберите dev в списке «Запустить с» (Run with) и нажмите «Запустить все запросы в файле» (Run All Requests in File).
Скрипт перед запросом подписывает каждый запрос перед отправкой, а проверка ответа после каждого из них сравнивает код состояния с тем, что ожидается в брифе. Это означает, что вам не нужно читать ответы самостоятельно — вкладка «Тесты» (Tests) окна инструмента Services перечисляет каждую проверку как пройденную или не пройденную.
Проверьте базу данных
База данных показывает, что сохранил HTTP-клиент. Откройте окно инструмента Database, нажмите +, выберите Data Source | SQLite и укажите на hookrelay.db в папке проекта. GoLand может сначала предложить загрузить драйвер SQLite. Затем откройте таблицу events или выполните быстрый запрос в консоли запросов (настройте имена таблиц и столбцов в соответствии с тем, что выбрал ваш агент):
Валидное событие и его дубликат должны оставить между собой одну строку. Поскольку база данных сохраняет свои данные между запусками, удалите hookrelay.db перед повторной отправкой запросов, иначе валидное событие станет дубликатом и его проверка не пройдет.
Позвольте агенту профилировать обработчик
Вуаля! Сервис наших агентов работает, но пока нет данных о том, как он ведет себя под нагрузкой. Вебхуки часто приходят «пачками» — например, после сбоя, когда провайдер разом отправляет всю накопленную очередь, — поэтому медленный обработчик — это не просто теоретическая проблема. Обычно в таких случаях вы обращаетесь к профайлеру. В GoLand 2026.3 вы можете поручить эту задачу агенту.
Чтобы продемонстрировать навыки профилирования на реальной задаче, мы переключимся на эталонную версию этого сервиса, которую можно найти по ссылке . Это готовый приемник, созданный по тем же требованиям, но с одним отличием: мы намеренно оставили в нем проблему с производительностью, чтобы вы могли повторить каждый шаг на своем компьютере.
Как помогают навыки
Навык (skill) — это набор инструкций, который обучает агента выполнению конкретного типа задач. Сам по себе агент может работать только с тем, что видит извне: он читает код, выполняет команды и анализирует их вывод. Навыки GoLand подключают поддерживаемые агенты к инструментам самой IDE, чтобы агенты могли использовать их более эффективно. Это позволяет им понимать, какой профиль снять, как его прочитать и как определить, действительно ли исправление сработало.
Навык goland-profiler поставляется вместе с Air и работает с Claude Code, Codex и Junie. Эти агенты могут запускать ваше приложение с профайлером GoLand, записывать CPU-профиль во время обработки трафика, а также считывать «горячие» пути и подсказки на уровне строк. Благодаря этому навыку ничего не нужно настраивать: агент загружает его, когда задача того требует, или вы можете подключить его явно, введя / в командной строке или нажав «Добавить» и выбрав «Навыки».
Как этим пользоваться
Чтобы опробовать навык, откройте демо-репозиторий в GoLand и оставайтесь на основной ветке (main). Сервису нужен трафик для профилирования, поэтому в репозитории есть небольшой генератор нагрузки, который отправляет подписанные события в течение 30 секунд. Начните новую сессию с таким запросом:
Запустите сервис с помощью /goland-profiler и запишите CPU-профиль, пока go run ./cmd/loadgen отправляет трафик. Скажите мне, на что обработчик тратит время процессора и память, и что бы вы изменили. Пока не меняйте код.
Мы рекомендуем сначала запросить диагностику, чтобы вы могли проверить интерпретацию профиля агентом, прежде чем он начнет действовать, и принять решение об изменениях на основе фактов.
Агент запускает сервис с профайлером, записывает данные CPU во время работы генератора нагрузки, считывает «горячие» пути и называет виновника: validateEventID компилирует регулярное выражение при каждом вызове. В нашем тесте на долю validateEventID пришлось 69% использования CPU, а regexp.MustCompile оказался самым ресурсоемким вызовом. Кроме того, постоянное выделение памяти нагружало сборщик мусора.
Впрочем, вам не обязательно верить агенту на слово. Захваченный профиль — это обычный Go-профиль, поэтому вы можете открыть его в окне инструментов Go Optimization и самостоятельно изучить flame-график, где regexp.MustCompile находится прямо под validateEventID и занимает большую часть ширины обработчика.
Исправление довольно простое: скомпилируйте шаблон один раз на уровне пакета, вместо того чтобы компилировать его при каждом запросе.
Совместное использование одного скомпилированного шаблона всеми запросами в данном случае безопасно, так как *regexp.Regexp может использоваться несколькими горутинами одновременно, но стоит убедиться в этом, прежде чем позволить агенту действовать самостоятельно. Мы попросили агента применить исправление и снова профилировать сервис под той же нагрузкой. Чтобы подкрепить разницу цифрами, мы также запустили BenchmarkHandler до и после изменений.
После внесенных изменений бенчмарк работает примерно в 4,6 раза быстрее, потребляя на 59% меньше байтов и совершая на 80% меньше аллокаций на запрос. Результаты могут отличаться в зависимости от машины, но снижение объема памяти и количества аллокаций должно быть примерно таким же.
Попробуйте сами
Вы можете повторить это упражнение на своем компьютере, чтобы поработать с навыком. В репозитории есть две ветки:
- main: готовый сервис с намеренно добавленной медленной валидацией ID события.
- fixed (используйте для справки): тот же сервис с регулярным выражением, скомпилированным один раз.
Чтобы попробовать:
- Клонируйте репозиторий и откройте его в GoLand 2026.3. Вам потребуется Go 1.27.3 или новее.
- Начните сессию Air с Claude Code, Codex или Junie.
- Попросите агента профилировать запущенный сервис — можно использовать запрос из предыдущего раздела.
- Как только агент применит исправление, сравните свою рабочую копию с нашей, выполнив git diff origin/fixed, или посмотрите на наше исправление отдельно с помощью git diff origin/main origin/fixed.
Исправление вашего агента не обязательно должно совпадать с нашим строка в строку. Но оно должно пройти те же проверки: тесты проходят, а в новом профиле больше нет компиляции регулярного выражения в топе списка.
Финальные проверки перед слиянием
Независимо от того, объединяете ли вы сервис или исправление профилирования, запустите проверки в последний раз на финальном коде. Затем сбросьте хранилище и снова запустите webhooks.http, чтобы первый запрос был новым событием, и перезапустите сервис, если он использует хранилище в памяти, или удалите hookrelay.db, если он использует SQLite. Если все в порядке, сделайте коммит через окно инструментов Commit (⌘K) и объедините ветку. Pull request — всегда хорошее место для человека, чтобы взглянуть на изменения, особенно если в роли водителя выступали три агента.
Пишите код так, как хотите
ИИ изменил правила игры в программировании настолько, что вопрос уже не в том, используете ли вы агентов, а в том, как вы их используете. В JetBrains мы поддерживаем любые ваши рабочие процессы. Будь то IDE или терминал, используете ли вы агентов для небольших задач или для управления целыми сервисами, действуете ли вы наобум или тщательно проверяете каждое изменение — Air всегда готов помочь вам с тем, что осталось неизменным: с вашим контролем над кодом.
Эта быстрая демонстрация лишь поверхностно затрагивает возможности Air в IDE, но это хорошая отправная точка для дальнейшего изучения. Дайте нам знать, как вам это новое дополнение к вашей IDE и какие функции нам стоит показать в следующий раз. Следите за новыми руководствами и навыками в ближайшие месяцы.
Удачного кодинга, команда GoLand











