Ответ не успел вернуться.
Агент отправил заявку в CRM и получил тайм-аут. Он не знает, успела ли система сохранить карточку. Если нажать «попробовать ещё раз», а первая запись уже существует, в отдел продаж уйдут две одинаковые заявки. Повторный запуск без дублей начинается с вопроса о состоянии записи, а его устойчивость зависит от того, как система отличает новую операцию от повторной попытки выполнить старую.
Как подготовить повторный запуск после тайм-аута?
Представь условную форму консультации. Сайт получил её под номером 581 и передал ИИ-агенту задачу создать карточку. CRM могла принять запрос, сохранить заявку и зависнуть на отправке ответа.
Снаружи это будет выглядеть так же, как недоступная CRM, до которой запрос вообще не дошёл. Содержимое двух журналов может отличаться: у агента ошибка ожидания, у CRM новая строка.
Особенно легко получить дубль, если новый запуск знает только исходный текст. Агент заново прочитал письмо, снова извлёк имя и тему и отправил запрос как новый. Система увидела второе обращение без признака связи с первым. Две карточки возникли из-за устройства процесса, и более удачная формулировка промпта этого не меняет.
При повторной заливке статьи в этот блог редакционный скрипт берёт сохранённый ID из файла в папке её slug и обновляет ту же запись. В запрос с текстом не входят статус и время публикации, поэтому повторная заливка сохраняет слот. Если локальный файл с ID пропал, скрипт может пойти по ветке создания, и это отдельный случай для сверки.
Начни с чтения результата. Если сервис позволяет поиск по номеру исходной заявки, проверь его. Сверь найденную карточку с входом и зафиксируй её идентификатор. Если данные не видны, учти задержку поиска и состояние ещё выполняющегося запроса.
Пустой результат сразу после тайм-аута сам по себе ничего не доказывает. Для диагностики входа полезен порядок передачи ошибки агенту: сохрани время, вход и ответ сервиса, чтобы следующий запуск опирался на факты.
Ключ одной операции
Для формы с номером 581 ключ можно представить как «сайт, заявка 581, создать карточку». В системе это строка или составное поле, которое передаётся при каждом повторе. Если сайт работает для нескольких организаций, добавь область, в пределах которой номер уникален.
Если одну и ту же форму надо сначала сохранить, а затем уведомить менеджера, у сохранения и уведомления будут разные ключи и независимые записи о результате.
Ключ лучше брать из идентификатора события или назначать при первом принятии задачи и сохранять. Время каждого запуска для этого не годится: оно меняется, и повтор снова выглядит новой операцией.
С хешем текста тоже легко ошибиться. Два человека могут оставить одинаковое сообщение «Нужна консультация», и это две разные заявки. А если поправить опечатку в том же обращении, хеш текста изменится и повтор будет выглядеть как новая заявка. Постоянный номер события сохраняет связь с первой попыткой.
Отдельно договорись, как выглядит исправление данных. Если операция создания получила номер карточки, дальнейшее изменение срока или ответственного можно оформить как самостоятельное обновление конкретной карточки.
Попытка отправить тот же ключ создания с другими параметрами должна приводить к понятному конфликту или отдельной проверке. Пример такого контракта есть в документации Stripe. Конкретный срок хранения ключей и реакцию на конфликт всегда бери из документации выбранного API.
Как CRM должна узнавать повтор?
Схема «сначала ищем, потом создаём» выглядит разумно. Она помогает восстановиться после сбоя, когда в системе уже видна карточка.
При двух параллельных попытках обе могут прочитать пустой список, обе пройти проверку и почти одновременно создать по записи. Поэтому чтение полезно для выяснения состояния, а защиту от гонки надо делать на стороне записи.
У своей системы можно хранить ключ с уникальным ограничением и записывать его вместе с карточкой в одной транзакции. Проигравшая попытка получает конфликт и читает существующий результат.
Если карточка создаётся во внешней системе, локальный журнал сам по себе проблему не закрывает. CRM может сохранить заявку, пока запись результата у тебя ещё не завершилась. При падении между этими двумя шагами понадобится возможность сверить состояние у внешнего сервиса.
| Что умеет система назначения | Что делать после тайм-аута |
|---|---|
| Принимает ключ идемпотентности | Сверить условия API и повторить с тем же ключом и параметрами |
| Гарантирует уникальность внешнего ID | Повторить в рамках этого контракта и при конфликте открыть существующую карточку |
| Позволяет только искать по метке | Искать результат и учитывать задержку выдачи. Конкурирующие записи остаются риском |
| Принимает создание без ключа и без поиска | Отметить неизвестный исход и передать сверку ответственному |
Уникальная карточка не защищает от двух писем об этой карточке. Если после сохранения идут уведомление, счёт или запись в другую систему, проверяй состояние каждого шага отдельно.
Восстановление с известного этапа
В учебном примере CRM присвоила карточке номер 34, но агент успел сохранить только ключ заявки. Задача на восстановление начинается с этого ключа. Если карточка найдена, агент записывает номер и продолжает с уведомления.
Если видно, что CRM отказала в записи из-за обязательного поля, имеет смысл сначала исправить вход. Если результат неизвестен и интерфейс поддерживает защищённый повтор, агент повторяет с тем же ключом. При неподтверждённой гарантии запрашивает сверку у человека, который может проверить CRM.
После восстановления полезно оставить короткий след: когда операция началась, какое действие пробовали сделать, какой номер вернул сервис и на чём остановилась цепочка. Это быстрее расшифровывать, чем полный лог разговора с моделью. В журнале достаточно идентификаторов и статусов. Копировать туда письма, ключи доступа и содержимое карточек без необходимости не нужно.
Свяжи журнал с тем, что ждёт пользователь. При записи заявки пользователю нужен номер карточки, а также стадия обработки. Надпись «скрипт успешно перезапустился» не доказывает, что карточка существует.
Эта разница разобрана в материале почему отчёт агента ещё не результат. При проектировании такого контура заодно реши, какие действия отдавать агенту в рабочей системе.
Как проверить, что дубли действительно исчезли?
Начни с тестового контура. Создай заявку с известным ключом, затем снова запусти то же действие. Проверь в базе или интерфейсе, что карточка одна и обе попытки связаны с её номером.
Теперь отправь две разные тестовые заявки с одинаковым текстом. Карточек должно быть две. Так ты проверяешь, что ключ отличает повторы, не уничтожая настоящие обращения.
Следующая проверка касается времени. Подай две попытки одновременно и посчитай строки. После этого смоделируй потерю подтверждения на тестовой операции: запись есть, а вызывающая сторона не успела пометить её как успешную.
Снова запусти процесс и проверь отдельно карточку и уведомление. Если второй запуск прошёл без ошибки, но отправил два письма, на этом этапе ещё есть работа.
Для контракта, который отклоняет изменение параметров, проверь отдельный случай. После подтверждённой записи заявки 581 повтори запрос со старым ключом и изменённой темой. Ожидаемый результат: конфликт параметров, одна карточка и прежняя тема.
Попроси владельца процесса заранее назвать, в каком случае повтор имеет право идти сам, а где нужна ручная сверка.
У отдела продаж ответ может зависеть от того, что запускает созданная карточка: простая очередь задач, письмо клиенту или передача в другое подразделение. Если внедряешь такой сценарий с командой, у практикума по ИИ-агентам есть программа и формат работы. Повтор с одним тестовым ключом можно взять как критерий приёмки своей интеграции.
Кто решает, сколько ждать между попытками?
Условная CRM может ограничивать поток запросов. Если сервис подсказывает время ожидания, перед следующей разрешённой попыткой учитывай его. Несколько запусков, которые одновременно повторяют запрос каждую секунду, создают ещё больше нагрузки.
Ограничь число попыток, добавь паузу и реши, когда дальше уже должен смотреть человек. Для рабочей карточки иногда лучше оставить понятную запись «исход неизвестен», чем удерживать весь поток до следующего утра.
Раздели сбои по простому признаку: что мы знаем про запись. Явный отказ в проверке обязательного поля даёт повод исправить вход. Временная ошибка сервиса даёт повод подождать, если известен контракт повтора. Отсутствие ответа требует проверки результата. Одинаковая стратегия для этих случаев приводит к бесполезным попыткам и затрудняет расследование.
Запиши в журнал причину следующего действия. Укажи, чего именно ждёшь: подтверждения записи от CRM или появления уже сохранённой карточки в поиске.
По окончании допустимого времени передай ответственному за ручную сверку ключ заявки, последний статус и ссылку на место сверки. Тогда он сможет продолжить с известного этапа без нового запуска всей цепочки.
Какие вопросы остаются перед включением повторов?
Частые вопросы
Для первого сценария достаточно зафиксировать ключ, ожидаемый результат и место, где ответственный проверит неизвестный исход.
