Для LLM и ИИ-агентов¶
Документация доступна в двух машиночитаемых представлениях.
Индекс документации¶
Краткий индекс содержит ссылки на разделы документации и поясняет назначение каждого раздела. Используйте его, если ИИ-агент может самостоятельно открывать ссылки и загружать необходимые материалы.
Полная документация¶
Файл содержит весь раздел интеграции с партнёрскими сервисами в одном документе. Используйте его для систем без доступа к сайту, подготовки базы знаний или передачи полного контекста модели.
Рекомендации¶
- Начинайте с
llms.txt, чтобы не загружать лишний контекст. - Используйте
llms-full.txt, если агенту требуется анализ всей интеграции или проверка связей между сценариями, методами и моделями. - Считайте опубликованную документацию источником требований к интеграции. Секреты, токены и реальные персональные данные в контекст модели не передавайте.
Правила для агентов¶
- Не вызывайте удалённый
Bids/GetCurrentList; используйте объединённыйBids/GetList. - Определяйте источник записи по
isCreatedByPlatform, а не по наличиюexternalId. - Перед вызовом
GetListявно решите, нужна одна организация или все доступные: отсутствиеX-Organization-Idрасширяет область выборки. - Для обновления заявки сохраняйте
idCARGO.RUN и стабильныеexternalIdточек. - Не считайте
updatedAtкурсором ETA:estimatedEnterDateможет измениться без изменения заявки. - Передавайте непустой адрес каждой точки. Координаты можно опустить, но ошибка геокодирования требует исправления адреса, а не слепого повтора.