Поиск по справке платформы

Спросите ИИ-ассистента, как в 1С получить хеш файла или разобрать строку по разделителю, — и он, скорее всего, ответит без запинки: назовёт метод, перечислит параметры, покажет пример кода. Беда в том, что метод может быть выдуманным. Языковая модель отлично умеет звучать правдоподобно, но не обязана помнить, какие именно параметры принимает конкретный метод платформы и существует ли он вообще в той версии 1С, на которой стоит ваш проект. Она достраивает ответ по аналогии с тем, что видела в обучающих данных, — и выдаёт «фантомный» код, который потом приходится ловить в отладчике.

Модуль «Справка платформы» в one-s-mcp устраняет эту причину напрямую. Вместо того чтобы сочинять ответ по общим представлениям о 1С, ассистент идёт в официальную справку платформы — ту самую, что открывается в синтакс-помощнике Конфигуратора или EDT, — и берёт оттуда реальный метод с точной сигнатурой. Не догадку, а факт из документации именно вашей версии платформы.

Практически это выглядит так: вы формулируете задачу обычными словами прямо в диалоге с ассистентом, а он под капотом сверяется со справкой и возвращает не первое, что «показалось похожим», а то, что реально есть в документации платформы — с правильным именем метода, набором параметров и их порядком.

А чтобы этот индекс появился, справку по нужной версии платформы больше не обязательно собирать у себя часами: готовое издание можно скачать из нашего каталога и получить рабочий поиск за минуты — в том числе на машине без видеокарты.

Какую боль решает

Мы отдельно разбирали, почему ИИ выдумывает по 1С — не по злому умыслу, а потому что у модели общего назначения просто нет доступа к точным данным и она достраивает пробелы правдоподобными предположениями. Для методов и объектов самой платформы (в отличие от знания о вашей конкретной конфигурации — это работа других модулей one-s-mcp) справка платформы закрывает эту причину напрямую.

С этим связан целый набор более приземлённых неудобств:

• ИИ выдумывает методы платформы. Без справки ассистент уверенно подсказывает несуществующие методы и неправильные параметры — разработчик тратит время не на разработку, а на проверку и отладку кода, которого по-хорошему не должно было появиться.
• Не помнишь точное имя метода. Есть понимание задачи — «разобрать строку по разделителю», «получить хеш файла», — но нет уверенности, как именно называется нужный метод и у какого объекта он живёт.
• Путаница версий платформы. Состав методов в разных версиях 1С отличается. Подсказка «из головы» модели или из чужого примера в интернете может просто не подойти той версии, на которой работает конкретный проект.
• Долгий ручной поиск в синтакс-помощнике. Листать разделы справки в Конфигураторе или EDT медленно, особенно когда не знаешь точного раздела, где искать.
• Три справочника в разных местах. Объекты встроенного языка, конструкции языка и язык запросов — это три разных файла справки, и обычно их приходится листать по отдельности.

Как это работает

Модуль работает по поисковому индексу справки — единому по всем трём «справочникам разработчика»: объекты встроенного языка, конструкции языка и язык запросов. Индекс можно собрать у себя: исходные файлы справки не нужно нигде искать, они уже лежат на компьютере рядом с установленной платформой 1С, и модуль сам находит установленные версии и берёт файлы оттуда. А можно не собирать вовсе — скачать готовое издание нужной версии из нашего каталога. Когда ассистенту в разговоре нужен конкретный метод, он обращается к модулю и получает точную справку — а не догадку, собранную по памяти.

Искать можно не только по точному имени. Запрос на естественном языке — «как получить текущую дату на сервере», «разобрать строку по разделителю» — превращается в «смысловой отпечаток» (вектор), и модуль находит ближайшие по смыслу записи в справке. Поиск понимает и русские, и английские формулировки. Выдачу можно сузить: только методы, только свойства, только объекты — либо по конкретному объекту, либо по конкретной области справки (объекты языка, конструкции языка, язык запросов). Так разработчик находит нужный метод по описанию задачи, даже если совсем забыл, как он называется, — и не тратит время на ручное листание справки.

Помимо поиска по смыслу, у модуля есть две точные операции, которые особенно полезны самому ассистенту для уточнения деталей уже в ходе диалога: получить справку по конкретному методу указанного объекта (с поддержкой и русских, и английских имён) и перечислить все методы выбранного объекта целиком.

В ответе по методу идёт не только описание, но и настоящая сигнатура: строки синтаксиса, список параметров, возвращаемое значение и доступность метода — клиент, сервер и прочее. Раньше часть этого терялась, и ассистент дописывал параметры «по правдоподобию»; теперь дописывать нечего.

Собирать справку самому по-прежнему можно — но чаще этого делать не нужно. В окне справки видно, какие версии у нас уже есть готовыми, и любую из них можно просто скачать. Разница во времени велика: сборка справки одной версии на процессоре занимает около трёх часов против трёх с половиной минут на видеокарте — готовое издание убирает этот вопрос совсем. Собранное у себя издание можно и выложить обратно в каталог: так он и пополняется.

Отдельная забота — версии платформы. Справка хранится и ищется отдельно для каждой версии: у каждой своя «полка» в индексе. При индексации модуль сам находит установленные на компьютере версии платформы и может проиндексировать справку каждой из них. В запросе можно явно указать нужную версию, а если её не указали — берётся версия по умолчанию, которую приложение подставляет из настроек активной конфигурации проекта. Это уже работает и защищает от главной путаницы: подсказка для одной версии платформы, ошибочно применённая к другой, может просто не сработать или сработать не так, как ожидалось.

Сама работа идёт локально: индекс лежит на вашей машине, и поиск по нему не обращается наружу. Из интернета приходит только готовое издание справки, если вы решили не собирать его сами, — и приходит один раз. Чтение исходных файлов справки при своей сборке реализовано без сторонних зависимостей (раньше для этого требовалась Java — сейчас нет). Важно понимать: справка платформы общая и одинаковая для всех, у кого установлена та же версия 1С, — это не защита коммерческой тайны вашей конфигурации, а просто доступ к документации без необходимости открывать отдельное окно синтакс-помощника.

Справка платформы — не отдельный инструмент сама по себе, а часть общей картины, которую видит ассистент в one-s-mcp. Она дополняет знание о конкретной конфигурации клиента, её связях и стандартах разработки: ассистент понимает и то, «как устроена платформа» в целом, и то, «как устроен именно этот проект» — с его доработками, справочниками и регистрами. Одно без другого работает хуже: знание платформы без знания вашей базы не спасает от незнания конкретики проекта, а знание вашей базы без точной справки платформы всё равно рискует выдумыванием на уровне встроенных методов.

Что это даёт

• Ассистент перестаёт выдумывать методы платформы. Ответ строится по реальной справке, а не по памяти модели, — с точной сигнатурой и описанием прямо в диалоге, без переключения в Конфигуратор.
• Можно спрашивать по смыслу задачи. «Как получить хеш файла» находит реальный метод платформы, даже если вы не помните его точного имени, — экономит время на ручном листании справки.
• Подсказки соответствуют вашей версии платформы. Справка ищется в индексе именно той версии 1С, на которой работает проект, а не усреднённо по всем версиям сразу.
• Три справочника — одним поиском. Объекты языка, конструкции языка и язык запросов ищутся единым модулем, с возможностью сузить выдачу до нужной области.
• Справка появляется за минуты. Готовое издание нужной версии скачивается из каталога вместо многочасовой сборки — и работает на машинах без видеокарты. Собрать самому из установленной платформы по-прежнему можно.
• Сигнатура целиком, а не половина. В ответе по методу — строки синтаксиса, параметры, возвращаемое значение и доступность: меньше выдуманных параметров в коде, который пишет нейросеть.
• Платформа и ваш проект — в одной картине. Ассистент одновременно видит и общую справку платформы, и знание о вашей конкретной конфигурации, поэтому не путает «как устроена 1С вообще» с «как устроен именно ваш проект».

Честно об ограничениях

Есть места, где стоит расставить точки над «i», чтобы не выдавать желаемое за действительное.

Версия платформы для поиска сейчас берётся из настроек активной конфигурации проекта, а не определяется автоматически «на лету» в момент запроса. Автоматическое определение версии платформы и автоподбор нужной версии без ручной настройки — в дорожной карте, это ещё не готово. Если вы работаете с несколькими версиями платформы одновременно, сегодня версию по умолчанию задают настройки, а не динамическое распознавание в реальном времени; следить за статусом этой доработки можно на странице планов.

Индекс справки нужно один раз получить: либо скачать готовое издание из каталога, либо собрать самому — а для сборки на компьютере должна стоять сама платформа 1С, модуль берёт файлы справки оттуда. Без этого шага поиска не будет. Готовые издания привязаны к мажорной версии платформы, а не к каждой сборке: сборок тысячи, и отдельное издание на каждую смысла не имеет.

И ещё один момент, чтобы не путать два разных сообщения: справка платформы — это не про приватность вашего кода. Она общедоступна и одинакова у всех, кто пользуется той же версией 1С, поэтому речь здесь не о защите коммерческой тайны конфигурации (за это отвечают другие модули one-s-mcp, работающие с самой вашей базой), а о том, что индекс справки собирается из локально установленной платформы и не требует обращения в облако во время работы.

Что дальше

Хотите, чтобы ассистент отвечал по реальной справке платформы, а не сочинял правдоподобные методы, — скачайте one-s-mcp и подключите к своей версии 1С. Посмотреть, что ещё умеет ассистент, можно на странице всех возможностей.