Разбирайте смены водителей и заказы автопарка прямо в чате
Подключите Yandex Fleet к ИИ-агенту: автомобили, водители, заказы, треки и транзакции. Агент соберёт смену, найдёт отмены и покажет блокировки баланса.
Как агент работает с Yandex Fleet
Агент ходит в Fleet API Яндекс.Такси и читает парк целиком: автомобили и профили водителей и курьеров, заявки на подключение, заказы вместе с их GPS-треками, транзакции и заблокированный баланс, условия работы парка и часы исполнителей на линии. Из этих кусков он и собирает разбор смены, сверку транзакций с условиями работы и картину того, кто действительно выходит на линию, а кто просто числится.
Каждый запрос здесь привязан к конкретному парку: идентификатор партнёра уходит и в заголовке, и в параметрах, и в теле запроса, поэтому агент всегда работает в границах одного автопарка и не смешивает данные разных. Заказ в Fleet — это не одна строка, а связка с водителем, машиной, треком и транзакциями, и статус заказа сам по себе не отвечает на вопрос, довезли ли пассажира: за этим агент идёт в трек и в историю транзакций.
По природе своей работа тут читающая: агент собирает отчёты, поднимает трек по спорной поездке, показывает водителей с растущими отменами и тех, у кого перед выплатой заблокирован баланс. Карточки водителей и машин он не правит без вашего явного запроса — в парке за такой правкой стоит живой человек и его смена. Выводы агент подкрепляет цифрами из тех же разделов, откуда их взял.
Лимиты у Fleet API жёсткие и разные по разделам: список заказов отдаётся в разы медленнее машин и транзакций, а выгрузка за длинный период упирается и в размер страницы, и в частоту запросов. Поэтому период агент режет на куски, идёт по страницам и заранее говорит, сколько это займёт, а не обрывает отчёт на середине. Треки и транзакции он поднимает точечно, по конкретным заказам, а не по всему парку сразу, и прямо сообщает, если раздел закрыт и данных нет.
Сценарии интеграции
Разбор смены
Агент соберёт заказы за смену и покажет, у каких водителей больше отмен и незавершённых поездок и как это меняется по дням.
Транзакции и выплаты
Агент сверит транзакции по водителям и заказам с условиями работы парка и покажет, у кого заблокирован баланс перед выплатой.
Кто реально на линии
Агент пройдёт по профилям водителей и карточкам автомобилей и покажет, кто выходит на линию, а кто только числится в парке.
Треки по спорным заказам
Агент поднимет GPS-трек конкретного заказа и часы на линии исполнителя, когда нужно разобрать жалобу или спорную поездку.
Заявки на подключение
Агент разберёт заявки водителей и курьеров, покажет, какие висят без движения, и назовёт тех, кто оформился, но так и не вышел на первый заказ.
Часы на линии за неделю
Агент сложит часы исполнителей на линии по дням и покажет, кто не добрал до нормы парка, а кто закрывает неделю с явной переработкой.
Примеры: Yandex Fleet
Четверо водителей дали 31 отмену из 486 заказов смены — это 64% всех отмен парка.
У одного 12 отмен подряд в вечерний час пик, при этом часы на линии он открутил полностью. По двоим ещё и баланс заблокирован перед выплатой — вытащить их треки за смену?
Ассистент может ошибаться — проверяйте его работу
За неделю парк наездил 3 180 часов на линии, до нормы не дотянули 14 водителей из 62.
- Больше 60 часов — 21 водитель, у двоих подряд идут смены без выходного
- От 40 до 60 часов — 27 водителей, это ядро парка
- Меньше 40 часов — 14 водителей
Часы брал из отчёта парка, а не постраничным обходом заказов: за неделю такой обход упирается и в размер страницы, и в частоту запросов. Уволенных из выборки убрал, иначе неделя размывается теми, кто на линию уже не выходит.
Ассистент может ошибаться — проверяйте его работу
Как подключить
Перед подключением
- Подключённый кабинет автопарка на fleet.yandex.ru
- Сотрудник с ролью «Директор» в парке
- Запас по времени: у Fleet API жёсткие лимиты выгрузок
- 1
Войдите под ролью «Директор»
Кабинет автопарка — fleet.yandex.ru. Раздел «API» редактирует только сотрудник с ролью «Директор»: под другой ролью создать ключ не получится.
- 2
Откройте «Настройки» → «API»
В меню Диспетчерской выберите «Настройки» и перейдите в раздел «API». Там создаются ключи и рядом показаны идентификаторы партнёра и клиента.
- 3
Создайте ключ и скопируйте три значения
Нужны ровно три: идентификатор партнёра (park_id), идентификатор клиента (X-Client-ID) и секретный API-ключ (X-API-Key). Ключ показывается один раз.
Частые вопросы
Тремя значениями из кабинета fleet.yandex.ru: секретный API-ключ, идентификатор клиента и идентификатор партнёра (park_id). Ключи создаются в разделе «Настройки» → «API» Диспетчерской, а редактировать его может только сотрудник с ролью «Директор».
Автомобили, профили водителей и курьеров, заявки, заказы и их GPS-треки, транзакции, заблокированный баланс, условия работы и часы на линии.
По умолчанию агент читает данные парка и собирает по ним отчёты. Изменения в карточках водителей и машин он не вносит без вашего явного запроса.
У Fleet API жёсткие лимиты, и список заказов отдаётся заметно медленнее остальных разделов. Длинные периоды агент собирает частями и предупреждает, сколько это займёт.