AI-агенты и MCP¶

Тестер может выступать локальным MCP Runner для внешнего ИИ-агента. В таком режиме агент работает с приложением 1С так же, как пользователь: запускает сценарии Тестера, получает состояние интерфейса, нажимает кнопки, вводит значения и анализирует результат. Прямого доступа к базе данных тестируемого приложения, метаданным или экспортным методам его конфигурации у такого скрипта нет.

Настройка¶

В общих настройках Тестера задайте значение MCP Сервер, например localhost:8080, и перезапустите приложение. После этого MCP-клиент может подключаться к адресу:

[mcp_servers.runner]
url = "http://127.0.0.1:8080/mcp"
enabled = true

Для запуска сценариев через MCP должны быть настроены репозитории сценариев на диске. Инструмент execute_script принимает путь к существующему .bsl файлу, поэтому файл должен находиться в смонтированной папке, известной Тестеру.

Инструменты Runner¶

execute_script запускает один существующий файл .bsl. Обязательный аргумент - script_path, абсолютный путь к файлу сценария.

runner_status не принимает аргументов и используется для проверки статуса, если выполнение сценария еще идет или MCP-клиент получил тайм-аут. Возможные статусы: busy, completed, failed, idle. Завершенный результат возвращается один раз и после чтения считается полученным.

Одновременно может выполняться только один execute_script. Если Runner занят, повторно запускать тот же сценарий не нужно; следует опрашивать runner_status.

Сценарии для агента¶

Сценарий MCP Runner пишется на встроенном языке 1С и использует обычный API Тестера. Для автономной работы важно сначала наблюдать интерфейс, а затем выполнять действие:

Подключить ();
ЗакрытьВсё ();
возврат ПолучитьГлавноеМеню ();

После перехода к форме агент может получить дерево элементов:

Подключить ();
Коммандос ( "e1cib/list/Catalog.Items" );
возврат ПолучитьЭлементыАктивногоОкна ();

После действия, меняющего состояние формы, удобно возвращать только изменения:

Подключить ();
Нажать ( "#FormCreate" );
возврат ПолучитьИзмененияОкна ();

Для таких сценариев полезны методы ПолучитьГлавноеМеню, ПолучитьЭлементыАктивногоОкна, ПолучитьИзмененияОкна, ВнестиЗначение, ПолучитьСодержимоеТаблицы и ПолучитьСодержимоеТабличногоДокумента.

Готовое окружение¶

В папке assistant находится пример конфигурации агентского окружения, инструкции для агента и стартовые навыки. Его можно использовать как основу для собственных виртуальных пользователей.