ИИ для логистики: тарифы и сроки доставки СДЭК в чате

Агент ходит в API СДЭК на api.cdek.ru: считает стоимость и срок доставки по направлению, весу и габаритам, поднимает справочники регионов, городов и пунктов выдачи, читает заказы вместе с историей их статусов и забирает печатные формы и фото по готовности. Подбор ПВЗ он делает не по одному городу, а с оглядкой на габариты посылки и режим работы пункта — иначе клиент приедет к закрытой двери.

Статусы в доставке приходят не по расписанию, и опрашивать заказ по кругу бессмысленно, поэтому СДЭК шлёт события сам: смену статуса заказа, готовность печатной формы и готовность фото. Агент ловит их вебхуком, привязывает к номеру заказа СДЭК и по накопленной истории видит, какая посылка стоит на одном статусе дольше обычного — то есть застряла, а не просто едет.

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

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