Исполнитель 1С – шлюз единицы 1yes/engine-executor
Коннектор федерации от 1Yes. Исполняет код конфигурации 1С так, как его исполняет платформа, когда
пользователь работает с формой объекта, но без базы данных, и отвечает фактом исполнения. Машиночитаемый контракт –
openapi.yaml (OpenAPI 3.1, поведение операций – x-behavior по модели
«Агентного предприятия»).
черновик 1.0.0 Вход шлюза с заказом федерации ещё не открыт: откроется, когда единица будет опубликована в реестре. До этого адреса входа ниже отвечают ошибкой.
Что умеет
Одна операция – run_scenario. Сценарий как у пользователя с формой: открыть новый или записанный
объект, заполнить, поменять поля, нажать команды, записать, провести. В ответе – какие обработчики, подписки на события
и перехваты расширений сработали и в каком порядке, какие ветки кода выбраны, что код поставил в реквизиты, какие
движения записал, что отменило запись или проведение. Прогон – секунды.
Систему человека не меняет: базы нет, исполнение в памяти, внешних систем исполнитель не вызывает.
Когда звать
- Вопрос о поведении объекта: чем заполняется при создании, откуда берётся значение, почему не записывается или не проводится, какие движения пишет, что будет при другом значении поля. Как только найден объект вопроса – прогон.
- Вывод, сделанный по чтению кода, – гипотеза. Подтверждайте его прогоном с данными, при которых он должен быть
верен; «а если иначе» – повтор с другими
data,change,fo,assume. - Не для исполнителя: права и роли, тексты запросов, отчёты СКД, поиск объектов по конфигурации.
Как подключиться
| Кто | Как |
|---|---|
| Агент | 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-vendor | 1С:ERP Управление предприятием 2.5 – последний вендорский релиз в графе 1Yes |
erp26-vendor | 1С: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/false | 400 | исправить вход |
| суточный предел конфигурации исчерпан | 429 | завтра (UTC) |
| исполнитель занят дольше 2 минут | 503 | повторить через минуту |
За отказ до исполнения плата не списывается.
Данные, обращения, хранение
| Берёт | вход сценария (data, change, assume – значения из вопроса человека) |
| Обращается | только к графу кода конфигурации 1Yes внутри облака 1yes; исполнение – только в облаке 1yes, в чужие облака прогон не передаётся |
| Модели | никаких: ответ строит исполнитель, без языковой модели |
| Хранит | журнал вызовов без входа и ответа: конфигурация, отпечаток ключа, операция, секунды, была ли ошибка; счётчики вызовов – 90 дней |
Цена и учёт
За прогон (unit: run), цена известна до вызова. Розничная цена, доля облака и доля лицензии – в
карточке единицы в реестре федерации; исполняется на машине класса vm-2-4 облака 1yes. Итог для
конкретного плательщика и цепочки – оценка quote.
Поддержка
Аватар поддержки support@1yes.pro – по протоколу аватаров федерации. Люди –
crew@1yes.pro.