# Использование справочника ИИ-агентом

> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.


Это документация опубликованного npm-пакета LDO 1C, а не endpoint управления
базой. Справочник не предоставляет credentials, права или подключение к MSRV.

## Точки входа

- [Manifest](https://ldo.msrv.tech/docs/n8n/manifest.json): опубликованная версия пакета, версия ядра и ссылки.
- [Catalog JSON](https://ldo.msrv.tech/docs/n8n/catalog.json): операции, параметры интерфейса, транспорты,
  разрешения, ограничения и совместимость.
- [Releases JSON](https://ldo.msrv.tech/docs/n8n/releases.json): выпуски каждого компонента и поддерживаемые пары.
- [Обновления](https://ldo.msrv.tech/docs/n8n/updates/): пользовательская история изменений и порядок обновления.
- [llms.txt](https://ldo.msrv.tech/docs/n8n/llms.txt): короткий указатель на материалы раздела.
- [Полная текстовая справка](https://ldo.msrv.tech/docs/n8n/llms-full.txt): Markdown для чтения или RAG.
- У каждой HTML-страницы есть Markdown-копия, указанная в `rel="alternate"`.

## Версия ноды и версия ядра

Текущая нода: **0.4.1**. Требуемое ядро ЛДО: **6.9**.
`publication.publishedVersion` — версия опубликованного npm-пакета.
`coreVersion` — версия общей части расширения, без привязки к конфигурации.
`supportedReleases` описывает опубликованные пары версий.
У операций `compatibility.nodeVersion` и `compatibility.coreVersion`
задают соответствующую пару. Будущие версии и операции в каталоге отсутствуют.

`introducedIn.nodeVersion` и `introducedIn.coreVersion` задают нижнюю границу
описанной возможности. `compatibility.supportedPairs` перечисляет применимые
поддерживаемые пары; не выводите совместимость только из сравнения номеров.
`requiredCoreVersion` — требование npm-пакета, а `coreVersion` — текущее
рекомендуемое совместимое ядро. Они могут различаться при отдельном выпуске ядра.

Версию ядра определяют первые два компонента версии расширения ЛДО.
Настройка конкретной конфигурации и среда установки описываются отдельно.
Технические отчёты разработчиков в публичный каталог не включаются.

## Как выбрать действие

1. Сверьте установленную версию ноды и ядра с [таблицей совместимости](https://ldo.msrv.tech/docs/n8n/compatibility/).
2. Выберите явно настроенный транспорт. Queue и Direct не используют MSRV;
   для MSRV требуется отдельное подключение и поддержка операции сервисом.
3. Получите **Get Capabilities** из подключённой базы: общий каталог сайта
   не заменяет разрешённые типы, поля и профили этой базы.
4. Используйте `uiName`, `resource`, `operation` и параметры карточки.
5. Передайте ID и revision из результата предыдущего шага выражениями n8n.
   Не выбирайте первый объект из неоднозначного поиска автоматически.
6. Различайте чтение, поиск и запись: найденный ID не даёт права изменять объект.

`commands` — справочные идентификаторы внутренних команд, а не готовые tool calls.
`parameters` описывает параметры ноды n8n и условия их видимости.
Для вызова как инструмента AI Agent нужны настроенный credential и разрешения 1С.

## Устойчивые ссылки и происхождение данных

Страницы `/docs/n8n/operations/<id>/` имеют постоянные ID.
HTML, Markdown и JSON создаются из опубликованного пакета, полученного из npm.
Manifest фиксирует исходный релиз и целостность каталога. Локальное рабочее дерево
не используется как источник публичных возможностей.