25. Индекс Прод-готовности

Зачем это нужно?

Вы завершили основной курс и понимаете основы агентов. Теперь нужно перейти от "учебного агента" к "прод-агенту", который работает надёжно, безопасно и эффективно в реальных средах.

Эта глава — руководство по приоритизации и быстрый справочник по прод-темам. Она помогает понять, что внедрять первым, и предоставляет быстрые ссылки на детальные главы.

Реальный кейс

Ситуация: Вы построили рабочего агента локально. Хотите развернуть его в продакшен, но не знаете, с чего начать.

Проблема:

• Слишком много прод-тем для изучения сразу
• Не знаете, что критично vs. nice-to-have
• Нужно руководство по приоритизации

Решение: Этот индекс предоставляет приоритизированный roadmap: начните с обязательных блоков (observability, контроль стоимости, безопасность), затем добавляйте темы по мере роста.

Руководство по приоритизации

Режим 1: Срочно в прод за 1 день (минимальный набор)

Если вам нужно запустить агента в прод прямо сейчас, начните с этих трёх тем:

1. 19. Observability и Tracing — Без этого вы слепы. Нужно сразу.
2. 20. Cost & Latency Engineering — Критично для контроля бюджета.
3. 17. Security и Governance — Обязательный прод-блок.

Эти три темы дадут вам базовую прод-готовность: вы будете видеть, что происходит, контролировать стоимость и защищать систему.

Режим 2: Плановая доводка за 1–2 недели (расширенный набор)

Если у вас есть время на плановую доработку, добавьте темы по мере роста:

Неделя 1:

• 21. Workflow и State Management — Когда агенты выполняют долгие задачи
• 22. Prompt и Program Management — Когда промпты меняются часто
• 23. Evals в CI/CD — Автоматическая проверка качества

Неделя 2:

• 24. Data и Privacy — Если работаете с персональными данными

Обзор прод-тем

Обязательные прод-блоки (нужны сразу)

19. Observability и Tracing

Когда нужно: Сразу, как только агент выходит в прод.

Что внутри: Структурированное логирование, трейсинг agent runs и tool calls, метрики (latency, token usage, error rate), кореляция логов через run_id.

20. Cost & Latency Engineering

Когда нужно: Когда агент используется активно или работает с большими контекстами.

Что внутри: Бюджеты токенов, лимиты итераций, кэширование, fallback-модели, батчинг, таймауты.

17. Security и Governance

Когда нужно: Сразу, как только агент выходит в прод.

Что внутри: Threat modeling для tool-агентов, risk scoring, защита от prompt injection, RBAC к инструментам, dry-run режимы, аудит.

Темы по мере роста

21. Workflow и State Management в продакшене

Когда нужно: Когда агенты выполняют долгие задачи (минуты или часы), нужна идемпотентность или обработка ошибок с retry.

Что внутри: Очереди и асинхронность, масштабирование, распределённое состояние. Базовые концепции (идемпотентность, retries, дедлайны) описаны в Главе 11: State Management.

22. Prompt и Program Management

Когда нужно: Когда промпты меняются часто, есть несколько версий или нужен A/B тестинг.

Что внутри: Версионирование промптов, промпт-регрессии через evals, конфиги и feature flags, A/B тестинг.

23. Evals в CI/CD

Когда нужно: Когда промпты или код меняются часто и нужна автоматическая проверка качества.

Что внутри: Quality gates в CI/CD, версионирование датасетов, обработка flaky-кейсов, тесты на безопасность.

Специализированные темы

24. Data и Privacy

Когда нужно: Когда агент работает с персональными данными (PII) или секретами.

Что внутри: Обнаружение и маскирование PII, защита секретов, redaction логов, хранение и TTL логов.

Примечание: Прод-аспекты RAG и Multi-Agent описаны в базовых главах 06 и 07. Выбор модели и настройка декодинга описаны в Главе 01 и Lab 00.

Алгоритм приоритизации

Не пытайтесь изучить всё сразу. Используйте этот алгоритм:

1. Начните с обязательных прод-блоков:
2. Observability (логирование, трейсинг) — нужно сразу, без этого вы слепы
3. Cost & latency engineering — критично, если агент используется активно

4. Безопасность и Governance — обязательный прод-блок

5. Добавьте темы по мере роста:

6. Workflow/state — когда агенты выполняют долгие задачи или нужна идемпотентность
7. Prompt/program management — когда промпты меняются часто или есть несколько версий

8. Evals в CI/CD — когда нужна автоматическая проверка качества

9. Специализированные темы:

10. Data/privacy — если работаете с персональными данными
11. RAG/Multi-Agent прод-аспекты — см. прод-заметки в Главе 06 и Главе 07

Связь с другими главами

• Основы: Базовые концепции изучены в Главах 01-12
• Продвинутые паттерны: Экосистема и паттерны изучены в Главах 13-18
• Прод-темы: Детальные прод-руководства в Главах 20-24

Что дальше?

После внедрения прод-готовности ваш агент готов к развёртыванию в реальном мире. Продолжайте мониторинг, итерации и улучшения на основе прод-метрик и обратной связи пользователей.

---

Навигация: ← Data и Privacy | Оглавление | Приложение →