Исполнитель 1С – шлюз единицы 1yes/engine-executor

Коннектор федерации от 1Yes. Исполняет код конфигурации 1С так, как его исполняет платформа, когда пользователь работает с формой объекта, но без базы данных, и отвечает фактом исполнения. Машиночитаемый контракт – openapi.yaml (OpenAPI 3.1, поведение операций – x-behavior по модели «Агентного предприятия»).

черновик 1.0.0 Вход шлюза с заказом федерации ещё не открыт: откроется, когда единица будет опубликована в реестре. До этого адреса входа ниже отвечают ошибкой.

Что умеет

Одна операция – run_scenario. Сценарий как у пользователя с формой: открыть новый или записанный объект, заполнить, поменять поля, нажать команды, записать, провести. В ответе – какие обработчики, подписки на события и перехваты расширений сработали и в каком порядке, какие ветки кода выбраны, что код поставил в реквизиты, какие движения записал, что отменило запись или проведение. Прогон – секунды.

Систему человека не меняет: базы нет, исполнение в памяти, внешних систем исполнитель не вызывает.

Когда звать

Как подключиться

КтоКак
АгентMCP, Streamable HTTP без сессий: https://tools.1yes.pro/federation/engine-executor/mcp?repository_id=<конфигурация>; один запрос JSON-RPC – один ответ. Инструмент run_scenario, аннотации: только чтение, повтор безопасен.
ПриложениеHTTP: POST https://tools.1yes.pro/federation/engine-executor/v1/run_scenario?repository_id=<конфигурация>, тело – JSON сценария, ответ – text/markdown.
Оценка ценыGET https://tools.1yes.pro/federation/engine-executor/oaf/v1/quote?unit=1yes/engine-executor&op=run_scenario&payer=…&chain=… – до заказа, бесплатно.

Каждый вызов несёт заказ федерации в заголовках: OAF-Order, OAF-Order-Sig, OAF-Grant. Заказ подписан аватаром и называет плательщика (человек – только ключ аватара, без личности; или предприятие со своей сделкой) и цепочку навыков и подключений, через которые идёт вызов. Вызов из другой единицы – подзаказ: ещё OAF-Parent и OAF-Parent-Sig. Личность человека шлюз не узнаёт. В ответе – заголовок OAF-Execution: подписанная запись исполнения для журнала.

Конфигурации и как выбрать

Код какой конфигурации исполнять – параметр repository_id. Конфигурация – не свойство единицы: список задаёт это описание.

repository_idКонфигурация
erp25-vendor1С:ERP Управление предприятием 2.5 – последний вендорский релиз в графе 1Yes
erp26-vendor1С:ERP Управление предприятием 2.6 – последний вендорский релиз в графе 1Yes

Какой именно релиз исполнен – первая строка ответа (объект и коммит графа). Свою доработанную конфигурацию предприятие подключает отдельной сделкой с 1Yes; на старте – только типовые из таблицы.

Вход run_scenario

ПолеЧто
object – обязательноОбъект: «Документ.Имя», «Справочник.Имя» – вид и имя, как в метаданных
formИмя формы; по умолчанию – основная форма объекта
existingОткрыть записанный объект, а не новый
write, postЗаписать объект; провести документ (включает запись)
dataДанные объекта до открытия: {"Реквизит": значение}; «заполнено» – любое непустое; предопределённый – "Справочник.Имя.Элемент"; табличная часть – список строк
changeПользователь меняет поля после открытия (срабатывает ПриИзменении): [["Поле", "Значение"]]
pressПользователь нажимает команды формы: ["ИмяКоманды"]
session_dateДата сеанса ДД.ММ.ГГГГ
foФункциональные опции {"Опция": false}; не заданы – из профиля конфигурации
assumeДанные базы, которых исполнитель не знает (остаток, константа, ответ запроса): [{"module": "src/cf/Documents/Имя/Ext/ObjectModule.bsl", "values": {"Выборка.Свободно": 6}}]
{"object": "Документ.РеализацияТоваровУслуг",
 "data": {"Склад": "заполнено", "Товары": [{"Номенклатура": "заполнено", "Количество": 2}]},
 "post": true}

Ответ

Текст markdown. Первая строка – объект и коммит графа. Разделы: 1 ход (этапы → обработчики → процедуры), 2 от чего зависят решения, 3 что отменяет запись, 4 что код ставит в объект, 5 движения, 6 кто ещё пишет и читает (по исходникам, не этот прогон), 7 что читается из базы, 8 не исполнено. «?» у значения – данных базы исполнитель не знает: задайте их в data или assume и прогоните снова. Разделы «Не исполнено» и «Не проверено» – там ответ только по чтению кода.

Пределы

ЧтоПредел
Прогонов в сутки300 на конфигурацию (сутки UTC), общий на всех плательщиков
Одновременноодин прогон; ожидание слота – до 2 минут
Запросдо 1 МБ
Время прогонапредел вводится по замеру на машине облака – будет здесь и в карточке реестра

Отказы

КогдаОтветЧто сделать
нет заказа или подпись заказа, цепочки, подзаказа не сходится401подписать заказ заново
repository_id не из таблицы конфигураций403выбрать конфигурацию из таблицы
нет object или объекта нет в конфигурации400точное имя – как в метаданных
data или fo не объект JSON, значения fo не true/false400исправить вход
суточный предел конфигурации исчерпан429завтра (UTC)
исполнитель занят дольше 2 минут503повторить через минуту

За отказ до исполнения плата не списывается.

Данные, обращения, хранение

Берётвход сценария (data, change, assume – значения из вопроса человека)
Обращаетсятолько к графу кода конфигурации 1Yes внутри облака 1yes; исполнение – только в облаке 1yes, в чужие облака прогон не передаётся
Моделиникаких: ответ строит исполнитель, без языковой модели
Хранитжурнал вызовов без входа и ответа: конфигурация, отпечаток ключа, операция, секунды, была ли ошибка; счётчики вызовов – 90 дней

Цена и учёт

За прогон (unit: run), цена известна до вызова. Розничная цена, доля облака и доля лицензии – в карточке единицы в реестре федерации; исполняется на машине класса vm-2-4 облака 1yes. Итог для конкретного плательщика и цепочки – оценка quote.

Поддержка

Аватар поддержки support@1yes.pro – по протоколу аватаров федерации. Люди – crew@1yes.pro.