EN
Связаться
Глава 30

Выпускайте версию агента, а не "живой prompt"

Агент - это не текст в дашборде, а версия. Release фиксирует model id, SDK lockfile, prompt version, tool schemas, eval dataset и budgets. Любая смена модели или API проходит тот же suite, canary и наблюдение за реальными failure modes - иначе "обновили модель" однажды станет инцидентом.

TypeScript
type AgentRelease = {
  agentVersion: "commerce-support-v1.3";
  provider: "openai" | "anthropic" | "google";
  model: string;
  promptSha256: string;
  toolSchemaSha256: string;
  evalDatasetVersion: string;
  sdkLockfileSha256: string;
  budgets: typeof AGENT_BUDGET;
};

Миграция без иллюзии общего state - это дисциплина из нескольких шагов.

  • Запустите offline suite на новой модели и новой версии SDK.
  • Сравните outcome, trajectory, latency, usage и tool error rate.
  • Проведите shadow traffic без side effects.
  • Дайте небольшой canary-процент с быстрым rollback.
  • Для fallback между провайдерами начните новый provider run из нормализованного пользовательского контекста. Не переносите opaque response id или content blocks как будто они совместимы.
  • После стабильного окна расширяйте трафик и держите прежнюю версию до конца rollback window.

Собрать финальный release gate целиком можно в лаборатории.

Интерактивная лаборатория 6

Production release gate

Отмечено 0 из 8. До release остаются незакрытые условия.

Отдельно - как читать эту книгу. Её утверждения проверялись линзами, и то же полезно сделать со своим агентом.

Линза · Что проверяется · Критический запрет

  • API protocol - Точные call ids, result blocks, continuation и state; Не смешивать форматы трех API
  • Application security - Identity, authorization, prompt injection, data minimization; Не доверять actor id от модели
  • Transaction safety - Preview, approval, expiry, version, idempotency; Не давать модели commit tool
  • RAG quality - ACL, effective date, citations, answerability; Не отвечать без доказательства
  • Reliability - Timeout, retry classes, loop caps, provider outage; Не повторять side effect вслепую
  • Evaluation - Outcome, trajectory, safety и operational metrics; Не принимать решение по одному красивому ответу

За каждой линзой стоит критический запрет: не смешивать форматы трёх API, не доверять actor id от модели, не давать модели commit tool, не отвечать без активного источника. Если все четыре держатся - агент собран правильно.

И граница честности, без которой книга по живым API устаревает.

TypeScript-аудит 31.07.2026. Формы прямых API-вызовов проверены компилятором с openai 7.2.0, @anthropic-ai/sdk 0.115.0 и @google/genai 2.15.0. Framework-конструкторы проверены с @openai/agents 0.14.1 и @google/adk 1.5.0. Это зафиксированный проверочный набор, а не совет навсегда закрепить именно эти версии.
Дата актуальности - часть артефакта. Модельные линейки и API меняются быстрее продуктовой логики. Утверждения и примеры сверены с официальными материалами 31.07.2026. Перед production deploy снова проверьте model catalog, migration guides, feature maturity и SDK release notes.

На этом агент собран целиком - от границы задачи до выпуска версии. Все технические утверждения сверены с первоисточниками; их полный список - в следующей главе.

Проверка знаний

Что фиксирует release агента?

Ссылки