---
metadata:
  - name: generator
    content: Diplodoc Platform v5.70.0
description: >-
  Как передать ИИ-агенту документацию по API сервиса Яндекс Магистрали,
  поставить первую задачу и настроить доступ.
vcsPath: motorway/magacg/support/docs/src/ru-x-ai/index.md
updatedAt: '2026-11-12T12:16:53.000Z'
alternate:
  - href: https://yamagistrali.ru/docs/ru-x-ai/index.md
    type: text/markdown
    title: Markdown version
  - href: https://yamagistrali.ru/docs/ru-x-ai/llms.txt
    rel: describedby
---

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

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

## Как попробовать {#kak-poprobovat}

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

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

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

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

    Для вызовов API [получите токен для своего стенда](https://yamagistrali.ru/docs/ru-x-ai/guides/api-access.md#get-token) и [настройте его передачу клиенту](https://yamagistrali.ru/docs/ru-x-ai/guides/secrets.md).

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

    **Для заказчика**
    - [Создать заказ на перевозку](https://yamagistrali.ru/docs/ru-x-ai/catalog/customer/customer-create-order.md)
    - [Найти заказы и посмотреть детали](https://yamagistrali.ru/docs/ru-x-ai/catalog/customer/customer-list-orders.md)

    [Посмотреть все сценарии](https://yamagistrali.ru/docs/ru-x-ai/catalog/customer/index.md)

    **Для исполнителя**
    - [Найти заказы](https://yamagistrali.ru/docs/ru-x-ai/catalog/executor/executor-get-order-details.md)
    - [Сделать ставку на торгах](https://yamagistrali.ru/docs/ru-x-ai/catalog/executor/executor-create-update-cancel-bid.md)
    - [Создать рейс](https://yamagistrali.ru/docs/ru-x-ai/catalog/executor/executor-create-manage-flight.md)

    [Посмотреть все сценарии](https://yamagistrali.ru/docs/ru-x-ai/catalog/executor/index.md)

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

- [Порядок работы для агента](https://yamagistrali.ru/docs/ru-x-ai/concepts/agent-workflow.md) — как подготовить запрос и обработать ответ.
- [Методы API и схема OpenAPI](https://yamagistrali.ru/docs/ru-x-ai/methods/index.md) — запросы, параметры и ответы.
- [Генерация клиента](https://yamagistrali.ru/docs/ru-x-ai/guides/generate-client.md) — настройка клиента по схеме OpenAPI.
- [Персональные и чувствительные данные](https://yamagistrali.ru/docs/ru-x-ai/concepts/sensitive-data.md) — какие сведения передавать и раскрывать.
- [Синхронизация заказов и рейсов](https://yamagistrali.ru/docs/ru-x-ai/concepts/order-sync.md) — как читать ленты изменений и сохранять курсоры.

Для самостоятельной проверки используйте [инструкцию для разработчиков](https://yamagistrali.ru/docs/ru/pages/api/access/access.md).