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

Инструменты

Смотрите также:
Встроенные инструкции Engee MIND
Навыки Engee MIND
Сценарии использования Engee MIND

Инструмент (tool) — отдельная операция, которую агент вызывает через Engee MIND с формальными аргументами. Пользователь обычно формулирует задачу текстом; агент выбирает инструмент, передает параметры и анализирует ответ.

На данный момент доступны 17 инструментов. Клиент LLM может добавлять к техническим именам префикс сервера.

Справочник инструментов

В таблице указаны предметные аргументы. Для первой проверки передайте PAT в чат с агентом; выпуск описан в документации внешнего API Engee.

Инструмент Аргументы задачи Результат и назначение

engee_status

Нет

Состояние среды; без PAT — подсказки по авторизации и встроенным навыкам. Вызывается первым

engee_start

Нет

Запускает среду и ожидает готовности; возвращает сведения о найденных пользовательских навыках

engee_stop

Нет

Останавливает рабочую среду, освобождает вычислительные ресурсы

eval_code

code

Выполняет Julia-код в сессии; возвращает строковое представление последнего выражения

job_create

code, необязательный name

Создает длительное самостоятельное фоновое задание и возвращает job_id

job_status

job_id

Возвращает состояние IN_PROGRESS, DONE или ERROR и доступный результат

job_list

Нет

Показывает фоновые задания текущей пользовательской сессии

file_list

Необязательный path, по умолчанию /user

Список файлов и каталогов в сессии

file_upload

remote_path, content_base64

Загружает содержимое файла в сессию по абсолютному пути

file_download

remote_path

Возвращает имя, размер и содержимое файла из сессии для сохранения или отображения клиентом

engee_diagnose

model_name

Состояние модели, логи, блоки, соединения портов и скрипт модели

engee_screenshot

model_name

Создает PNG холста в сессии и возвращает его путь; модель должна быть открыта

block_categories

Нет

Категории библиотеки блоков и их наполнение

block_search

query, необязательный offset

Ищет блоки по имени, категории или ключевому слову; выдает до 30 совпадений за вызов

block_info

block_path из поиска

Точные параметры, допустимые значения, порты и признак прямого прохождения сигнала

skill_list

Нет

Перечень доступных навыков и их источников; учитывает пользовательские навыки в сессии

skill_load

skill_path

Текст навыка или его справочного файла

Как сочетаются инструменты

engee mind 2

Не все этапы нужны каждой задаче. Для просмотра справки можно загрузить общий навык без запуска пользовательской среды.

Примеры аргументов

Поиск блока:

{
  "query": "integrator",
  "offset": 0
}

Загрузка базового навыка:

{
  "skill_path": "engee_model"
}

Диагностика уже открытой модели в авторизованной среде:

{
  "model_name": "MyModel",
  "server": "https://engee.com",
  "token": "<PAT_ENGEE>"
}

<PAT_ENGEE> — заполнитель, а не действующий токен. Эти фрагменты описывают аргументы вызова инструмента, а не конфигурацию MCP-клиента.

Особенности исполнения и файлов

  • engee_stop останавливает всю рабочую среду. Несохраненные модели и переменные в памяти теряются; файлы, сохраненные в /user/, остаются доступными. Вызов engee.stop() внутри Julia останавливает моделирование, а не сессию.

  • job_create выполняется в отдельном контексте. Переменные из eval_code не переносятся туда автоматически. Длительное задание должно само загрузить входы, выполнить расчет и сохранить результаты.

  • file_download скачивает файл, а не каталог. Содержимое в Base64 должно быть декодировано клиентом в файл; длинная строка Base64 в чате не является удобной выдачей результата.

  • engee_screenshot создает снимок схемы; для передачи изображения пользователю затем нужен file_download по возвращенному пути.

  • eval_code изменяет модель и файлы в зависимости от переданного кода. Разрешение на этот инструмент фактически позволяет агенту выполнять вычисления в пользовательской среде; учитывайте это при настройке прав клиента.

Актуальный список конкретного сервера имеет приоритет над зафиксированным количеством в этой редакции.