Урок 3 із 6
Індексація, планування, редагування
6 хв читання
У твоєму репо 400 файлів, а модель за раз «бачить» лише кілька. То як агент змінює саме ті три рядки?
Індексація: прочитати ціле репо
Модель за раз тримає лише стільки тексту, а твоя кодова база значно більша за це вікно. Тож кодинговий агент спершу індексує репо: він ділить твої файли на фрагменти й будує мапу, по якій можна шукати — часто через ембединги, що дають знаходити код за змістом, а не за точними словами. Спитай про «потік логіну» — і він витягне потрібні файли, навіть якщо в жодному з них немає слова «логін».
Індексація перетворює репо, завелике, щоб прочитати, на мапу, по якій агент може шукати. Він дістає кілька релевантних файлів замість того, щоб читати все.
Планування: вирішити зміну
Маючи потрібні файли, агент планує. Він розбирається, що змінити й у якому порядку — яку функцію зачепити, які тести запустити, чи залежить одна правка від іншої. На більшій задачі він може спершу виписати план, а потім виконувати його крок за кроком. Хороший план — це те, що тримає багатофайлову зміну цілісною, а не купою випадкових правок.
Планування — це коли агент вирішує, що змінити, перш ніж щось міняти — різниця між хірургічною правкою і кашею.
Редагування: точний diff, а не переписування
Нарешті він редагує. Сучасні агенти не вставляють цілий новий файл — вони роблять маленький diff: зміни ці рядки, решту лиши. Це тримає правки придатними до рев'ю, уникає затирання коду, який не просили чіпати, і чисто застосовується, навіть коли файл змінюється навколо. Читай → плануй → редагуй — це внутрішній механізм за кожним кроком, який ти бачиш у циклі.
Пошук не ідеальний. Якщо індекс пропустить релевантний файл, агент планує зі сліпою плямою — тому чіткий запит, що називає потрібну ділянку, все одно допомагає, навіть із хорошою індексацією.
Три ходи
- —Індексуй — поділи репо на фрагменти й шукай за змістом, щоб знайти релевантні файли.
- —Плануй — виріши, що змінити й у якому порядку, перш ніж щось чіпати.
- —Редагуй — застосуй маленький, придатний до рев'ю diff, а не переписування файлу цілком.
Репо значно більше за контекстне вікно моделі. Як агент знаходить потрібні файли для зміни?
Продовжити в застосунку
Пройди весь курс «Як працюють AI-агенти для кодингу» — з відстеженням
Отримай персональний план, прогрес і стріки в застосунку — цей урок і кожен наступний, по порядку.