COURSE_01 · PYTHON
AGENT_HARNESS
Собираем harness coding-агента с нуля на Python. Цикл инструментов, безопасный shell, sandbox-абстракция, обрезка контекста, субагенты и точки расширения.
Адаптация курса Build Your Own AI Coding Agent Harness (Vercel Academy) под Python. Текст уроков — на русском.
uv,
ключ DEEPSEEK_API_KEY
(с platform.deepseek.com).
В уроке 1.1 сначала: uv init →
uv add pydantic-ai →
потом уже uv run python main.py ….
Оглавление
Цикл агента
От чатбота без инструментов к агенту с read, grep
и bash под allowlist.
Дизайн инструментов
Контракт описаний, фабрика операций, режимы подтверждения.
Системный промпт
Agency, guardrails, сборка промпта, проверка работы, AGENTS.md.
Абстракция Sandbox
Один интерфейс — local, in-memory и cloud бэкенды.
Управление контекстом
Pruning, лимиты вывода, cache control.
- 5.1Проблема
- 5.2Pruning старых результатов
- 5.3Дизайн вывода инструментов
- 5.4Cache control
Делегирование субагентам
Explorer, executor и инструмент task.
- 6.1Зачем делегировать
- 6.2Explorer
- 6.3Executor
- 6.4Task tool
Жизненный цикл sandbox
State machine, snapshot/restore, durable workflows.
- 7.1State machine
- 7.2Snapshot и restore
- 7.3Durable workflows
- 7.4Hard-won lessons
Human-in-the-loop
Структурированные вопросы и конфиг approval.
- 8.1Структурированные вопросы
- 8.2Approval config
Планирование и верификация
Todo-инструмент, быстрый контекст, verification contract.
- 9.1Todo tool
- 9.2Быстрое понимание контекста
- 9.3Verification contract
Поверхности
CLI, streaming и web — один агент, разные рендереры.
- 10.1CLI entry point
- 10.2Streaming и рендер tools
- 10.3Web surface
Расширяемость
Skills, custom tools, extension points.
- 11.1Система skills
- 11.2Custom tools
- 11.3Extension points