MODULE_03 · УРОК 3.1

Структура инструкций

Откройте main.py и посмотрите на инструкции агента: «Ты coding-агент. Рабочая директория: …». Политикой это назвать сложно, скорее бейджик на груди. Инструменты у него к этому моменту серьёзные, а вот как себя вести, он не знает совсем: делать или сначала полчаса рассуждать, тащить пакеты без спроса или спросить. В итоге поведение агента решает не ваш код, а настроение модели в конкретный вечер. Пора отобрать у неё это право.

ЧТО ПОЛУЧИТСЯ В main.py поле instructions обзаведётся двумя секциями: Agency в духе «делай, а не рассказывай» и Guardrails в духе «но не раздувай задачу». Агент начнёт чаще сразу браться за инструменты вместо поэмы «я бы сделал так…».

Слова, которые встретятся

  • instructions / системный промпт - текст, который модель читает как правила работы. Его легко спутать с вашим вопросом из командной строки, но это разные вещи: вопрос меняется каждый запуск, правила остаются.
  • Agency - раздел в духе «тебе можно и нужно действовать»: читай, ищи, запускай команды, а отвечай уже по результатам.
  • Guardrails - обратная сторона, «но не геройствуй»: правки мелкие, сначала посмотри, нет ли готового решения в проекте, новые зависимости только с разрешения человека.

Быстрый путь

  1. Откройте main.py.
  2. Замените короткий instructions=... на текст с # Agency и # Guardrails.
  3. Прогоните знакомый промпт и сравните тон ответа.

Какие файлы трогаем

Файл Что делать
main.py Править. Только строку/блок instructions= у Agent(...).
tools / approval / local_bash Не трогать.

Было

main.py - сейчас примерно так:

agent = Agent(
    "deepseek:deepseek-chat",
    deps_type=Path,
    tools=[Tool(bash_fn, takes_ctx=False)],
    instructions=(
        f"Ты coding-агент.\nРабочая директория: {cwd}\n"
        "Используй инструмент read..."
    ),
)

И ведь работает. Ровно до того момента, когда вы просите «найди TODO и скажи где»: в один запуск модель послушно зовёт grep, в другой выкатывает план на пол-экрана и ждёт аплодисментов. Ничего не сломалось, просто на этот счёт у неё нет никаких указаний, и она импровизирует.

Стало - правьте instructions так

main.py - новый блок instructions

instructions = f"""Ты coding-агент. Рабочая директория: {cwd}

# Agency
- ПОЛЬЗУЙСЯ инструментами: читай файлы, ищи по коду, запускай команды - потом отвечай.
- НЕ объясняй, что ты «сейчас сделаешь». Сделай, потом коротко отчитайся.
- Для поиска - grep, для просмотра файла - read.
- bash - только если задача не закрывается read/grep.

# Guardrails
- Меняй по минимуму: маленькие правки лучше «великого рефакторинга».
- Сначала поищи существующий паттерн в проекте, не плоди сущности.
- Новые зависимости (pip/uv add) - только если пользователь явно попросил.
"""

agent = Agent(
    "deepseek:deepseek-chat",
    deps_type=Path,
    tools=[Tool(bash_fn, takes_ctx=False)],
    instructions=instructions,
)

Текст выглядит почти банально, но каждая строка там появилась не просто так:

  • «Сделай, не рассказывай» стоит первым, потому что модели обожают роль лектора. Без прямого указания сначала сделать, а потом коротко отчитаться, вас ждёт хорошо структурированное сочинение вместо работы.
  • Имена инструментов упомянуты и здесь, и в docstring, и это осознанный повтор. Одно упоминание модель проскакивает довольно бодро, два уже реже.
  • «Не ставь пакеты без спроса» пока чистая просьба, но это задел на будущее: в модуле 8 на её месте появится настоящий вопрос человеку.
ЭТО ЕЩЁ НЕ МАГИЯ Если после модуля 2 инструменты у вас и так выбираются нормально, разница в ответах окажется довольно тонкой, и это ожидаемо. Главный выигрыш в другом: политика теперь лежит в одном месте, её можно править целиком и потом скопировать субагенту, а не выковыривать по кускам из всего кода.

Проверьте

uv run python main.py . "Найди все TODO-комментарии и скажи, где они"

Хороший знак - когда в консоли сразу появляется вызов grep, а за ним список найденных мест. Плохой - когда вы читаете задумчивое «Я могу использовать grep, чтобы…» и не видите ни одного вызова. Лектор вернулся, Agency надо усилить.

Готово, если:

  • В main.py в instructions есть секции # Agency и # Guardrails
  • Agency явно говорит действовать через tools, а не объяснять план
  • Guardrails ограничивают scope (минимум правок, без самовольного pip)
  • В промпт по-прежнему подставляется {cwd}
ЭКСПЕРИМЕНТ Вырежьте блок Agency, оставьте Guardrails. Тот же промпт. Вернулся лектор? Потом наоборот. Так вы увидите, какая секция ловит какое поведение - дешевле, чем гадать по звёздам.