Структура инструкций
Откройте main.py и посмотрите на инструкции агента: «Ты
coding-агент. Рабочая директория: …». Политикой это назвать сложно, скорее
бейджик на груди. Инструменты у него к этому моменту серьёзные, а вот
как себя вести, он не знает совсем: делать или сначала полчаса
рассуждать, тащить пакеты без спроса или спросить. В итоге поведение агента
решает не ваш код, а настроение модели в конкретный вечер. Пора отобрать
у неё это право.
main.py поле instructions обзаведётся двумя
секциями: Agency в духе «делай, а не рассказывай» и
Guardrails в духе «но не раздувай задачу». Агент начнёт
чаще сразу браться за инструменты вместо поэмы «я бы сделал так…».
Слова, которые встретятся
- instructions / системный промпт - текст, который модель читает как правила работы. Его легко спутать с вашим вопросом из командной строки, но это разные вещи: вопрос меняется каждый запуск, правила остаются.
- Agency - раздел в духе «тебе можно и нужно действовать»: читай, ищи, запускай команды, а отвечай уже по результатам.
- Guardrails - обратная сторона, «но не геройствуй»: правки мелкие, сначала посмотри, нет ли готового решения в проекте, новые зависимости только с разрешения человека.
Быстрый путь
- Откройте
main.py. - Замените короткий
instructions=...на текст с# Agencyи# Guardrails. - Прогоните знакомый промпт и сравните тон ответа.
Какие файлы трогаем
| Файл | Что делать |
|---|---|
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 на её месте появится настоящий вопрос человеку.
Проверьте
uv run python main.py . "Найди все TODO-комментарии и скажи, где они"
Хороший знак - когда в консоли сразу появляется вызов grep,
а за ним список найденных мест. Плохой - когда вы читаете задумчивое
«Я могу использовать grep, чтобы…» и не видите ни одного вызова.
Лектор вернулся, Agency надо усилить.
Готово, если:
- В
main.pyвinstructionsесть секции# Agencyи# Guardrails - Agency явно говорит действовать через tools, а не объяснять план
- Guardrails ограничивают scope (минимум правок, без самовольного pip)
- В промпт по-прежнему подставляется
{cwd}