diff --git a/INSTALL.md b/INSTALL.md index 6e123e1..36ba761 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -286,6 +286,45 @@ их доустанавливать не нужно. Свой скилл добавляется командой `hermes skills install <источник>`. +### Границы возможностей + +Терминал и запуск кода **включены** — на них построены скиллы Excel, Word, PDF, PowerPoint +и почты: это запуск python-скриптов, другого способа в Hermes нет. + +Пакеты для документов установщик ставит сам на шаге 8: + +| Формат | Пакет | +|---|---| +| Excel `.xlsx` | `openpyxl` | +| Word `.docx` | `python-docx` | +| PowerPoint `.pptx` | `python-pptx` | +| PDF | `pypdf`, `reportlab`, `pdfplumber` | + +Проверено на живом доме: все четыре формата создаются и читаются обратно. + +Если пакеты не встали (нет интернета при установке) — доставить вручную: + +```powershell +uv pip install --python "<дом>\installs\<...>\venv\Scripts\python.exe" openpyxl python-docx python-pptx pypdf reportlab pdfplumber +``` + +Управление рабочим столом (`computer_use`) выключено. + +Ограничить сильнее — одной командой: + +```powershell +hermes config set agent.disabled_toolsets "[terminal, code_execution, computer_use]" +``` + +и вернуть обратно: + +```powershell +hermes config set agent.disabled_toolsets "[computer_use]" +``` + +> Эти правки не переживают обновление: установщик кладёт `config.yaml` из сборки +> заново. После обновления команду нужно повторить. + --- ## 9. Если что-то не работает diff --git a/README.md b/README.md index b1565da..962fe79 100644 --- a/README.md +++ b/README.md @@ -71,6 +71,26 @@ сам и ставит файл-маркер `.ailab-install.json`, по которому следующий запуск понимает, что это обновление, а не чужая установка. +## Что агент умеет + +| | | +|---|---| +| Документы | читает и **создаёт** Excel (`.xlsx`), Word (`.docx`), PowerPoint (`.pptx`), PDF — включая формы, объединение, шифрование и извлечение текста | +| Файлы | чтение и запись, поиск по содержимому | +| Терминал и код | **включены** — на них построены скиллы документов | +| Веб-поиск | через MCP-серверы, подключаются отдельно | +| Управление рабочим столом | **выключено** (`computer_use`) | + +Терминал и запуск кода включены осознанно. Без них не работают скиллы Excel, Word, +PDF и почты: они построены на запуске python-скриптов, а другого способа запустить +скрипт в Hermes нет. Пакеты для документов (`openpyxl`, `python-docx`, `python-pptx`, `pypdf`, `reportlab`, `pdfplumber`) установщик ставит сам на шаге 8 — на живом доме проверено создание и чтение всех четырёх форматов. + +Скрыть их у получателя можно так: + +```powershell +hermes config set agent.disabled_toolsets "[terminal, code_execution, computer_use]" +``` + ## Что не входит - API-ключи, `auth.json`, пароли dashboard — только свои, локальные. diff --git a/config.yaml b/config.yaml index 3fded01..244ac4e 100644 --- a/config.yaml +++ b/config.yaml @@ -13,15 +13,15 @@ fast_auto_seconds: 60 verbose: false reasoning_effort: medium - # Опасные инструменты выключены на уровне агента, а не скрыты в интерфейсе. - # terminal = произвольные команды + управление процессами; code_execution = запуск кода; - # computer_use = управление рабочим столом мышью и клавиатурой. - # Это реальное ограничение возможностей агента: вызвать их он не сможет. - # Файловые операции (file) оставлены: чтение документов — основная работа агента. - # Гранулярности «читать можно, писать нельзя» в Hermes нет. + # computer_use выключен на уровне агента, а не скрыт в интерфейсе: это управление + # рабочим столом мышью и клавиатурой, для работы агента оно не нужно. + # Это реальное ограничение: вызвать этот инструмент он не сможет. + # + # terminal и code_execution ВКЛЮЧЕНЫ осознанно. Без них не работают скиллы Excel, + # Word, PDF и почты: они построены на запуске python-скриптов, а другого способа + # запустить скрипт в Hermes нет. Включены вместе — code_execution без terminal + # смысла не имеет, а terminal без code_execution ломает часть скиллов на ровном месте. disabled_toolsets: - - terminal - - code_execution - computer_use terminal: backend: local diff --git a/distribution.yaml b/distribution.yaml index d200576..e9b98d2 100644 --- a/distribution.yaml +++ b/distribution.yaml @@ -1,5 +1,5 @@ name: ailab_scrume_agent -version: 1.3.8 +version: 1.3.9 description: "Личный помощник: документы, письма, договоры, расчёты, поиск, задачи." hermes_requires: ">=0.21.6" author: "AI laboratory SCRUM company"