Как давать ИИ-агенту правильный контекст кода

Что в ролике
Начинающим разработчикам, которые пользуются агентным кодированием, стоит давать агенту не длинный промпт, а подходящий контекст репозитория. Один и тот же запрос «добавь login endpoint» должен давать разный код в репозитории с FastAPI и Pydantic-моделью и в репозитории с Go-обработчиком. Для этого агент должен сам уметь искать и открывать файлы, а вы указываете ему направление, например «следуй паттерну из README». Полезно дать агенту компактную карту репозитория, версии зависимостей и lock-файл, потому что галлюцинации функций часто связаны с несовпадением версий. Также нужен тест, который агент может прогнать, документация с конвенциями и командами сборки в файле agents.md, и ваше описание, что значит «готово». Если вы не знаете, какие вопросы задавать, можно попросить агента провести интервью, объяснить устройство репозитория простым языком и составить план с допущениями. Но не нужно вываливать весь репозиторий: модели хуже работают с информацией в середине длинного контекста, поэтому лучше начинать свежую сессию под задачу и давать только нужные файлы.
Практика
- Что получишь
- Поймёте, какие шесть типов контекста давать агенту: код, структуру, зависимости, тесты, документацию и ваши намерения. Научитесь заставлять агента самого задавать нужные вопросы и не перегружать его лишними файлами.
- Первый шаг
- Перед следующим запросом к агенту скажите: «Проведи со мной интервью и задавай вопросы, пока не поймёшь, что нужно», и отвечайте на них.
- Цифры
- —6 типов контекста перечисляет автор: файлы и код, структура репозитория, зависимости, тест, документация и намерения разработчика
- —3 приёма, чтобы агент сам вытащил нужный контекст: интервью, объяснение репозитория простым языком, план с допущениями
- —Тысячи файлов в репозитории — пример масштаба, при котором одного предложения в промпте не хватит
- Честно
- Ролик образовательный, без ссылок на платные продукты или курсы, но выпущен на корпоративном канале IBM Technology. Все конкретные приёмы (agents.md, интервью с агентом, карта репозитория) описаны словами, а не показаны в интерфейсе, поэтому разглядывать экран не придётся.
Если слова незнакомы — 5 терминов
- агентное кодированиеразработка, где ИИ-помощник сам пишет и правит код по вашим указаниям
- промпттекстовое задание для ИИ-ассистента
- lock-файлфайл, фиксирующий точные версии всех зависимостей проекта
- галлюцинациивыдуманные ИИ функции или API, которых нет в реальной версии библиотеки
- репозиторийхранилище кода проекта со всей историей изменений
Компоненты
3 шт.Формат: разбор · для практикующих · уверенность разметки 0.9 · источник