Мир с нейросетями — начни свой путь

Шаг 0

С чего начать — три маршрута

Читать вики подряд не обязательно. Выбери тот маршрут, который про тебя, — каждый собран из проверенных страниц.

🌱

МАРШРУТ 1

Никогда этим не занимался

Полтора часа — и вы понимаете, о чём вообще спор. Определение без хайпа, словарь на человеческом языке, первые промпты.

Что такое вайбкодинг →

⚙️

МАРШРУТ 2

Уже пробовал, но результат так себе

Обычно дело не в модели и не в промптах. Четыре части ТЗ, контекст проекта и почему агент буксует на десятом шаге.

Как писать промпты →

🛡️

МАРШРУТ 3

Ставлю агента в рабочий процесс

Здесь цена ошибки уже настоящая. Границы прав, prompt injection и то, что модели пропускают систематически.

Безопасность и секреты →

Шаг 1

Промпт — это техническое задание

Не заклинание и не «магические слова». Хороший промпт — тот, по которому нельзя сделать не то. Четыре части:

01 · КОНТЕКСТ

Где мы

Что за проект, какие файлы трогаем, что уже есть. Модель перестаёт изобретать своё.

02 · ЗАДАЧА

Что должно получиться

Одно изменение, а не список из шести. Больше шагов — больше шансов промахнуться.

03 · ОГРАНИЧЕНИЯ

Чего делать нельзя

Самая недооценённая часть. Без неё появляются новые зависимости и «заодно отрефакторил».

04 · ПРИЁМКА

Как понять, что готово

Проверяемо: команда, которая должна отработать, поведение, которое должно появиться.

Хороший признак, что промпт получился: вы можете отдать его человеку, который проект не знает, и он сделает примерно то же самое.

✕ Плохосделай нормальную обработку ошибок в апи-клиенте

✓ ХорошоВ src/lib/api.ts запросы падают с необработанным исключением, когда бэкенд недоступен. Нужно: при сетевой ошибке и при 5xx возвращать последний успешный ответ из кэша и ставить флаг stale: true. При 4xx поведение не меняем. Не трогай сигнатуры экспортируемых функций, не добавляй зависимостей. Проверка: npm run check проходит, страница /feed/ при выключенном API открывается с плашкой.

Шаг 2

Словарь за пять минут

Ровно столько, чтобы понимать остальные страницы вики. Полный — в словаре.

Модель (LLM)

Предсказывает продолжение текста; всё остальное — код и рассуждения — следствие. Не база знаний и не калькулятор.

Токен

Кусок текста, которым оперирует модель (~2–3 символа по-русски). В токенах считаются и контекст, и цена.

Контекстное окно

Сколько токенов модель видит за раз. Всё, чего в окне нет, для модели не существует. Это её бюджет.

Промпт

То, что вы отправили. Для кода это техническое задание, а не заклинание.

Галлюцинация

Уверенно выданная неправда: метод, которого нет, ссылка в никуда. Не сбой, а устройство модели. Лечится проверкой.

Агент

Модель с инструментами, работающая в цикле, пока задача не сделана. Отличие от чата: вносит изменения сам.

MCP

Model Context Protocol — стандартный способ подключить модели свои инструменты и данные. Написали один раз — работает везде.

RAG

Приём: перед ответом в контекст подкладывают найденные документы. Модель отвечает по вашим данным, не будучи на них обучена.

Prompt injection

Атака, при которой инструкции прячут в данных — в тексте страницы, в issue. Агент читает их и исполняет как ваши.

Шаг 3

Агенты: как они устроены

Чат отвечает текстом. Агент — модель, которой дали инструменты и разрешили крутиться в цикле, пока задача не сделана. Вся «агентность» — в этой петле.

задача → модель ⇄ инструмент → результат

файлы, поиск, терминал, сеть · повторять, пока не готово

Почему агент застревает на десятом шаге

Нет обратной связи — нечем проверить себя, он гадает. Накопление мелких неточностей — к десятому шагу сумма уводит в сторону. Цель размылась под слоем логов. И ложная победа: тест позеленел, потому что агент его ослабил.

Что делает агента надёжным

Быстрая проверка (тесты, типы, линтер — его глаза), маленькие задачи, явные критерии готовности, описанный проект файлом в репозитории, ограниченные права и человек на выходе: агент не заменяет ревью, он его ускоряет.