Hermes Agent Windows запускается через PowerShell: установите официальный сценарий, настройте провайдера модели и проверьте первый диалог в новой консоли. На рабочем компьютере заранее согласуйте загрузку сценария, исходящий доступ и каталог пользовательских данных с ИТ-ответственным. Этот маршрут относится к нативной установке из исходного сценария; у настольного пакета и WSL другие пути.
Границы запуска
Официальная инструкция поддерживает нативный запуск на Windows 10 и Windows 11. Сценарий установки работает в PowerShell без прав администратора и добавляет команду hermes в пользовательский PATH.
Сначала определите, на каком компьютере пройдёт проба. Для личного устройства достаточно вашей учётной записи Windows и разрешённого доступа к GitHub. Для корпоративного устройства попросите ИТ-ответственного проверить домен загрузки, выполнение PowerShell-сценариев и политику установки программ. Команда из руководства скачивает исполняемый сценарий из сети, поэтому её запуск относится к обычному процессу согласования ПО. Если политика блокирует такой способ, используйте одобренный организацией пакет либо передайте вопрос администратору. Менять системные ограничения ради теста нельзя.
Подготовьте отдельную папку с обезличенным текстом для пробы. Рабочие документы, ключи доступа и клиентские данные пока оставьте вне неё. Также решите, какой разрешённый провайдер модели будет отвечать на запросы: без его настройки диалог может упереться в ошибку доступа. Сам Hermes предоставляет интерфейс и инструменты, а результат первого теста зависит ещё от выбранной модели, сети и учётных данных провайдера. Запишите имя ответственного за тест и разрешённый источник модели заранее: так при ошибке ясно, кому передать вопрос без пересылки секретов.
Разница с базовым обзором Hermes здесь прикладная: проверяем установку в Windows, новый сеанс PowerShell, каталог конфигурации и границы прав. Для выбора дальнейших действий полезен разбор допуска ИИ-агента к компьютеру. Первому запуску такой допуск ни к чему. Планируйте пробу так, чтобы результат можно было оценить без доступа к производственным системам.
PowerShell и установка
Откройте PowerShell под обычной учётной записью. Проверьте, что это согласованный компьютер и терминал имеет доступ к официальному адресу установки. Перед выполнением сетевого сценария откройте его страницу в браузере и сверьте издателя NousResearch. Официальное руководство приводит команду iex (irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1). Она получает сценарий и сразу исполняет его в текущем сеансе; поэтому решение о запуске принимайте по правилам вашей организации.
- Согласуйте источник сценария и доступ к сети. При ограничениях PowerShell передайте официальную инструкцию администратору, сохранив корпоративную политику.
- Запустите приведённую в документации команду в PowerShell. Следите за сообщениями установщика и отвечайте только на понятные запросы настройки.
- После завершения закройте окно и откройте новый PowerShell. Выполните
Get-Command hermes, затемhermes --version. - Если команда отсутствует, проверьте пользовательский PATH через новый сеанс и обратитесь к диагностике установщика. До появления команды переход к модели преждевременен.
Исходный установщик размещает файлы по умолчанию в пользовательском каталоге %LOCALAPPDATA%\hermes, создаёт запускатель в подкаталоге bin и добавляет его в User PATH. Установка из пакета MSIX устроена иначе: там работают псевдонимы приложения, а требование к версии Windows для пакета отличается. Если у вас уже стоит настольное приложение, проверьте Get-Command hermes -All, чтобы увидеть, какой запускатель выбран. Смешение путей может дать ложное впечатление, будто новая установка сломана. Если найдено несколько запускателей, запишите их пути и уточните у администратора, какую установку команда должна использовать. Повторный запуск установщика до выяснения пути может запутать диагностику.
Первый диалог
После проверки команды настройте провайдера через hermes setup или выберите его командой hermes model. Мастер может запросить учётные данные выбранного сервиса. Вводите их только в штатном интерфейсе, согласованном с ИТ-ответственным; в переписку и тестовый запрос секреты переносить нельзя. Выбор сервиса зависит от договорённостей компании о передаче данных и доступности его интерфейса из вашей сети. После настройки начните простой диалог без подключения дополнительных инструментов.
| Проверка | Действие в PowerShell | Ожидаемый признак |
|---|---|---|
| Запускатель | Get-Command hermes | Показан путь к исполняемому файлу или псевдониму приложения. |
| Версия | hermes --version | Команда завершается и показывает версию без ошибки запуска. |
| Модель | hermes model | Выбран разрешённый провайдер и сохранена настройка. |
| Ответ | hermes chat | На безличный вопрос получен осмысленный ответ. |
Для первого диалога спросите: «Назови три пункта плана внутренней проверки пустого тестового каталога». Такой запрос показывает, что модель отвечает, но вывод о доступе к файлам и качестве решений требует отдельной проверки. Затем завершите сеанс обычным способом и проверьте, что в рабочем каталоге всё осталось в исходном состоянии. Ошибку сети, отсутствующий провайдер и отказ в доступе фиксируйте раздельно: у них разные причины и разные ответственные. Для протокола достаточно текста запроса, факта ответа и сообщения об ошибке, если она возникла. Полный журнал с учётными данными в протокол включать нельзя.
Связанные с рабочими файлами возможности включайте после отдельной проверки прав. Для проектирования доступа пригодится схема прав и секретов ИИ-агента. Пробный ответ подтверждает лишь работоспособность цепочки «запускатель — провайдер — модель». Качество ответа оценивает человек по исходному вопросу и проверяемым фактам.
Какую безопасную задачу вы хотите проверить первой?
Файлы и права
Для установки исходным сценарием пользовательский каталог по умолчанию находится в %LOCALAPPDATA%\hermes. Официальное руководство относит туда конфигурацию, учётные данные, сессии, навыки и журналы. Путь может отличаться, если задан HERMES_HOME либо выбран другой каталог при установке. Поэтому перед ручной правкой запросите фактический путь командами hermes config path и hermes config env-path. Они показывают расположение файлов без раскрытия содержимого. Файлы с секретами открывайте только тем, кому это положено по роли.
Права Windows определяют, какие локальные файлы сможет открыть процесс под вашей учётной записью; настройки инструментов Hermes задают следующий рубеж. В рабочем контуре полезно выделить папку для теста с чтением только нужных материалов, отключить ненужные инструменты и отдельно согласовывать любые записи. Серверная сторона интеграции должна проверять полномочия при каждом запросе к данным или действию. Текстовая инструкция модели для этого недостаточна. Спорные выводы, отправку сообщений и изменение записей подтверждает ответственный сотрудник. Для каждого будущего инструмента заранее укажите ресурс и действие: чтение тестовой папки, запись черновика или запрос к внутреннему сервису. Каждое дополнительное действие требует своего разрешения.
Перед доступом к реальным данным составьте простой реестр: владелец источника, разрешённые операции, место хранения секрета, срок пересмотра доступа и журнал результата. Секреты храните в штатном хранилище вашей организации; официальный каталог .env внутри Hermes относится к пользовательским данным, а значит требует обычной защиты профиля и резервного копирования. Если роль пользователя изменилась, владелец системы отзывает доступ на стороне источника, а затем повторяет контрольный запрос. Дополнительные детали о разграничении смотрите в маршруте поиска по документам с учётом прав.
Исключения и приёмка
При отказе установки сначала отделите ошибку скачивания от ошибки выполнения сценария. Сохраните текст сообщения без токенов и персональных данных, укажите версию Windows и способ установки, затем передайте запись ИТ-ответственному. Если команда hermes отсутствует, откройте новый PowerShell и повторите Get-Command hermes. Официальное руководство объясняет это обновлением пользовательского PATH. Вручную переписывать системный PATH ради диагностики обычно незачем.
Если запускатель работает, а диалог молчит, запустите hermes doctor и проверьте выбранный провайдер через hermes model. Ошибку авторизации разбирайте у владельца учётной записи, ошибку сети — у администратора сети. При странных символах в консоли сначала проверьте терминал: руководство описывает настройку UTF-8 внутри Hermes и советует современный Windows Terminal. Любую проблему воспроизводите на безличном запросе, чтобы диагностический журнал можно было безопасно передать специалисту.
Возьмите пустой тестовый каталог и согласованный провайдер модели. Зафиксируйте вывод команд запуска, один ответ на безличный запрос и отсутствие неожиданных изменений в каталоге. После такой приёмки согласовывайте следующий источник и его права.
Приёмка состоит из наблюдаемых условий: новый терминал находит команду, версия выводится, выбранный провайдер отвечает, путь конфигурации известен, а тестовый каталог остался в ожидаемом состоянии. Отдельно проверьте отрицательный сценарий: пользователь без разрешения запрашивает закрытый материал через будущую интеграцию и получает отказ от сервера. Этот контроль проводят в проекте интеграции после простого диалога при установке. Для подключения к бизнес-процессу обсудите границы с командой внедрения ИИ-агентов: стоимость определяется составом данных, интеграций и прав, поэтому её рассчитывают под задачу. Если хотя бы одно условие приёмки нарушено, остановите расширение доступа, сохраните описание сбоя и повторите пробу после исправления причины. Решение о допуске к рабочим данным принимает владелец процесса.