Документация Engee

Встроенные инструкции

Смотрите также:
Инструменты Engee MIND
Навыки Engee MIND
Программное управление моделированием

Встроенные инструкции задают базовые правила работы агента с Engee. Они передаются вместе с описаниями исполняющих инструментов, а подсказки о запуске, авторизации и навыках — в ответах инструментов. Поэтому пользователю не нужно вручную задавать большую системную инструкцию перед каждой задачей.

Это инструкции для агента, а не средство доказательства корректности. Итог все равно проверяют по сохраненным артефактам, диагностике и данным расчета.

Отличие от навыков

Слой Содержание Когда используется

Встроенные инструкции

Общие правила API, сохранения моделей, получения данных и диагностики

При работе с соответствующими инструментами

Навыки

Методика конкретной задачи, справочные файлы, проверки и формат результата

После выбора и загрузки через skill_load

Задание пользователя

Требования, ограничения, входные данные, допустимые действия

На протяжении текущей задачи

Ниже приведены основные правила работы для ИИ-агента, установленные встроенными инструкциями Engee MIND.

  1. Сначала состояние среды. Агент вызывает engee_status; запуск остановленной среды выполняется через engee_start, когда задача требует вычислений.

  2. Публичный API. Для моделей используется engee.* со строчной буквы. eval_code принимает Julia-код, а не Python или MATLAB.

  3. Создание модели до блоков. Сначала engee.create, затем добавление блоков и связей. Бинарный .engee нельзя заменять вручную сформированным текстовым файлом.

  4. Проверенные блоки и параметры. Путь блока получают через block_search, параметры и порты — через block_info. Значения для engee.set_param! передаются строками.

  5. Регулярное сохранение. Создание модели в сессии не создает файл автоматически. Модель сохраняют сразу после создания и после значимых изменений, например engee.save("MyModel", "/user/MyModel/MyModel.engee"; force=true). Перезапись допустима только для выбранного рабочего файла.

  6. Читаемая схема. Агент задает расположение блоков и проверяет соединения. Автоматическая раскладка не должна ухудшать схему с обратными связями.

  7. Данные текущего прогона. Для получения сигналов через Engee MIND используются блоки To Workspace с уникальными именами и collect(имя_переменной). Отсутствие данных нельзя подменять правдоподобными числами.

  8. Диагностика в исходной среде. Если модель не рассчитывается, агент читает диагностику, проверяет параметры и исправляет модель Engee. Подмена модели внешним расчетом требует отдельного решения пользователя.

  9. Явная передача файлов. Файл в сессии и файл на компьютере клиента — разные объекты. Для загрузки и получения файлов используются file_upload и file_download.

Что происходит при ошибке расчета

Агент проверяет наличие блока To Workspace, уникальность имен переменных, логи инициализации, соединения, параметры и настройки решателя. Пустой результат запуска не доказывает, что схема корректно отработала. Для анализа используется engee_diagnose, а для визуальной проверки — engee_screenshot открытой модели.

Числа проверяются на конечность, единицы измерения и физическую правдоподобность. Большие значения оцениваются относительно масштаба задачи: сами по себе они не доказывают ошибку. Совпадающие ряды при сравнении разных реализаций требуют проверки источников сигналов.

Что нужно задать пользователю

Укажите модель или проект, параметры с единицами, начальные условия, диапазон времени, допустимые изменения и критерии приемки. Например:

В модели `/user/Drive/Drive.engee` найди причину отсутствия данных скорости. Сохрани исправленную копию в `/user/Drive/Drive_fixed.engee`. Физические параметры не меняй. Покажи причину ошибки, данные повторного прогона и сравнение с ожидаемым установившимся режимом.