Что меняется для бизнеса. Проектировать повторяемые операции так, чтобы повтор запроса не создавал лишний бизнес-результат, а агент мог безопасно проверить фактическое состояние.
Как оценить эффект. Число дублей и ручных коррекций, время восстановления после сбоя и полнота подтверждений результата.
Кейс: AI-сотрудник в Progressive HQ
Сеть, инструмент или модель могут не сообщить, завершилась ли операция. Идемпотентный контракт позволяет повторить запрос без нежелательного дублирования результата.
Неизвестный исход — нормальный случай
После таймаута агент не должен сразу создавать объект заново. Система ищет операцию по ключу идемпотентности, проверяет состояние и возвращает уже созданный результат либо безопасный статус ожидания.
Это особенно важно для заказов, писем, платежных документов, публикаций и других действий с внешними последствиями.
Что зафиксировать в контракте
Опишите срок действия ключа, совпадение параметров, допустимые переходы состояния и поведение после частичного успеха. Логирование должно связывать повтор с исходной задачей, а не создавать новую историю.
Идемпотентность не исправляет неверную бизнес-логику: перед повтором всё равно проверяются права, актуальность данных и необходимость операции.
Следующий шаг
Agent-native системы: почему обычного API недостаточно
