Описание API сервиса Яндекс Магистрали для ИИ-агентов

Яндекс Магистрали — система управления логистическими процессами для вашего бизнеса. Вы можете подключить ИИ-агента, чтобы автоматизировать свои процессы. С помощью этой документации агент сможет объяснить, как работает API, подготовить код интеграции или выполнить запрос через настроенный клиент.

Как попробоватьКак попробовать

1. Передайте агенту ссылку. Скопируйте запрос и отправьте его в чат с агентом.

   Ознакомься с документацией по API сервиса Яндекс Магистрали https://yamagistrali.ru/docs/ru-x-ai/llms.txt и подготовь клиент для работы.
   

2. Попробуйте первый запрос. Подставьте название организации. Если действуете как исполнитель, замените «заказчика» на «исполнителя».

   Помоги мне проверить доступ к API сервиса Яндекс Магистрали на тестовом стенде.
   Используй подготовленный клиент и проверь, есть ли у меня активный профиль
   заказчика в организации [название организации].
   

   Для вызовов API получите токен для своего стенда и настройте его передачу клиенту.

3. Выберите свою задачу. Ориентируйтесь на свою роль в организации, от имени которой работаете.

   Для заказчика

   • Создать заказ на перевозку
   • Найти заказы и посмотреть детали

   Посмотреть все сценарии

   Для исполнителя

   • Найти заказы
   • Сделать ставку на торгах
   • Создать рейс

   Посмотреть все сценарии

Справочник и правилаСправочник и правила

• Порядок работы для агента — как подготовить запрос и обработать ответ.
• Методы API и схема OpenAPI — запросы, параметры и ответы.
• Генерация клиента — настройка клиента по схеме OpenAPI.
• Персональные и чувствительные данные — какие сведения передавать и раскрывать.
• Синхронизация заказов и рейсов — как читать ленты изменений и сохранять курсоры.

Для самостоятельной проверки используйте инструкцию для разработчиков.