Дмитрий Анашкин

Повторный запуск без дублей: как агенту пережить тайм-аут

Опубликовано 17 нояб. 2026 г.8 мин чтенияСредний
Повторный запуск без дублей: как агенту пережить тайм-аут
Плейбук
Повторный запуск без дублей
Дмитрий Анашкин · 8 мин
Чему вы научитесь
  • Разобрать тайм-аут по фактическому состоянию записи
  • Выбрать стабильный ключ для одного бизнес-действия
  • Проверить параллельный повтор и изменение параметров
Средний
1просмотров

Ответ не успел вернуться.

Агент отправил заявку в CRM и получил тайм-аут. Он не знает, успела ли система сохранить карточку. Если нажать «попробовать ещё раз», а первая запись уже существует, в отдел продаж уйдут две одинаковые заявки. Повторный запуск без дублей начинается с вопроса о состоянии записи, а его устойчивость зависит от того, как система отличает новую операцию от повторной попытки выполнить старую.

Как подготовить повторный запуск после тайм-аута?

Представь условную форму консультации. Сайт получил её под номером 581 и передал ИИ-агенту задачу создать карточку. CRM могла принять запрос, сохранить заявку и зависнуть на отправке ответа.

Снаружи это будет выглядеть так же, как недоступная CRM, до которой запрос вообще не дошёл. Содержимое двух журналов может отличаться: у агента ошибка ожидания, у CRM новая строка.

Особенно легко получить дубль, если новый запуск знает только исходный текст. Агент заново прочитал письмо, снова извлёк имя и тему и отправил запрос как новый. Система увидела второе обращение без признака связи с первым. Две карточки возникли из-за устройства процесса, и более удачная формулировка промпта этого не меняет.

При повторной заливке статьи в этот блог редакционный скрипт берёт сохранённый ID из файла в папке её slug и обновляет ту же запись. В запрос с текстом не входят статус и время публикации, поэтому повторная заливка сохраняет слот. Если локальный файл с ID пропал, скрипт может пойти по ветке создания, и это отдельный случай для сверки.

Начни с чтения результата. Если сервис позволяет поиск по номеру исходной заявки, проверь его. Сверь найденную карточку с входом и зафиксируй её идентификатор. Если данные не видны, учти задержку поиска и состояние ещё выполняющегося запроса.

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

Ключ одной операции

Для формы с номером 581 ключ можно представить как «сайт, заявка 581, создать карточку». В системе это строка или составное поле, которое передаётся при каждом повторе. Если сайт работает для нескольких организаций, добавь область, в пределах которой номер уникален.

Если одну и ту же форму надо сначала сохранить, а затем уведомить менеджера, у сохранения и уведомления будут разные ключи и независимые записи о результате.

Ключ лучше брать из идентификатора события или назначать при первом принятии задачи и сохранять. Время каждого запуска для этого не годится: оно меняется, и повтор снова выглядит новой операцией.

С хешем текста тоже легко ошибиться. Два человека могут оставить одинаковое сообщение «Нужна консультация», и это две разные заявки. А если поправить опечатку в том же обращении, хеш текста изменится и повтор будет выглядеть как новая заявка. Постоянный номер события сохраняет связь с первой попыткой.

Отдельно договорись, как выглядит исправление данных. Если операция создания получила номер карточки, дальнейшее изменение срока или ответственного можно оформить как самостоятельное обновление конкретной карточки.

Попытка отправить тот же ключ создания с другими параметрами должна приводить к понятному конфликту или отдельной проверке. Пример такого контракта есть в документации Stripe. Конкретный срок хранения ключей и реакцию на конфликт всегда бери из документации выбранного API.

Как CRM должна узнавать повтор?

Схема «сначала ищем, потом создаём» выглядит разумно. Она помогает восстановиться после сбоя, когда в системе уже видна карточка.

При двух параллельных попытках обе могут прочитать пустой список, обе пройти проверку и почти одновременно создать по записи. Поэтому чтение полезно для выяснения состояния, а защиту от гонки надо делать на стороне записи.

У своей системы можно хранить ключ с уникальным ограничением и записывать его вместе с карточкой в одной транзакции. Проигравшая попытка получает конфликт и читает существующий результат.

Если карточка создаётся во внешней системе, локальный журнал сам по себе проблему не закрывает. CRM может сохранить заявку, пока запись результата у тебя ещё не завершилась. При падении между этими двумя шагами понадобится возможность сверить состояние у внешнего сервиса.

Что умеет система назначенияЧто делать после тайм-аута
Принимает ключ идемпотентностиСверить условия API и повторить с тем же ключом и параметрами
Гарантирует уникальность внешнего IDПовторить в рамках этого контракта и при конфликте открыть существующую карточку
Позволяет только искать по меткеИскать результат и учитывать задержку выдачи. Конкурирующие записи остаются риском
Принимает создание без ключа и без поискаОтметить неизвестный исход и передать сверку ответственному

Восстановление с известного этапа

В учебном примере CRM присвоила карточке номер 34, но агент успел сохранить только ключ заявки. Задача на восстановление начинается с этого ключа. Если карточка найдена, агент записывает номер и продолжает с уведомления.

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

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

Свяжи журнал с тем, что ждёт пользователь. При записи заявки пользователю нужен номер карточки, а также стадия обработки. Надпись «скрипт успешно перезапустился» не доказывает, что карточка существует.

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

Как проверить, что дубли действительно исчезли?

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

Теперь отправь две разные тестовые заявки с одинаковым текстом. Карточек должно быть две. Так ты проверяешь, что ключ отличает повторы, не уничтожая настоящие обращения.

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

Снова запусти процесс и проверь отдельно карточку и уведомление. Если второй запуск прошёл без ошибки, но отправил два письма, на этом этапе ещё есть работа.

Для контракта, который отклоняет изменение параметров, проверь отдельный случай. После подтверждённой записи заявки 581 повтори запрос со старым ключом и изменённой темой. Ожидаемый результат: конфликт параметров, одна карточка и прежняя тема.

Попроси владельца процесса заранее назвать, в каком случае повтор имеет право идти сам, а где нужна ручная сверка.

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

Кто решает, сколько ждать между попытками?

Условная CRM может ограничивать поток запросов. Если сервис подсказывает время ожидания, перед следующей разрешённой попыткой учитывай его. Несколько запусков, которые одновременно повторяют запрос каждую секунду, создают ещё больше нагрузки.

Ограничь число попыток, добавь паузу и реши, когда дальше уже должен смотреть человек. Для рабочей карточки иногда лучше оставить понятную запись «исход неизвестен», чем удерживать весь поток до следующего утра.

Раздели сбои по простому признаку: что мы знаем про запись. Явный отказ в проверке обязательного поля даёт повод исправить вход. Временная ошибка сервиса даёт повод подождать, если известен контракт повтора. Отсутствие ответа требует проверки результата. Одинаковая стратегия для этих случаев приводит к бесполезным попыткам и затрудняет расследование.

Запиши в журнал причину следующего действия. Укажи, чего именно ждёшь: подтверждения записи от CRM или появления уже сохранённой карточки в поиске.

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

Какие вопросы остаются перед включением повторов?

Частые вопросы

Для первого сценария достаточно зафиксировать ключ, ожидаемый результат и место, где ответственный проверит неизвестный исход.

Источники

Отправь другу или себе в избранное в Telegram, чтобы не потерять.

Поделиться в Telegram
Было полезно?
Автор
Дмитрий Анашкин
Практик-интегратор ИИ в бизнес

Основатель NeuroDA и SMAIPL. Корпоративные воркшопы по ИИ, внедрение AI в бизнес-процессы.

Похожие гайды

Альтернативы Claude Code в 2026: OpenCode, Qwen Code и GigaCode - в чём уступают и когда хватает

С 12 ноября 2026 года Anthropic отдельно прописал правило для компаний из неподдерживаемых регионов и их сотрудников. Сравниваю три альтернативы Claude Code: модель, куда уходят данные, лицензия, что проверить. Показываю, когда замены хватает и как проверить её за вечер на своей задаче.

12 мин

Мультиагентные системы: как несколько ИИ работают над одной задачей

Одна модель тянет простую задачу, но сложный проект требует команды. Разбираем, как мультиагентные системы делят работу между несколькими ИИ, какие архитектуры для этого есть и когда несколько агентов реально нужны, а когда это лишнее усложнение.

12 мин

Замена ИИ-модели: как проверить её на своих задачах до перехода

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

9 мин

Мониторинг задач по расписанию: как поймать сбой, если скрипт молчит

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

8 мин

Связанные понятия