🏠 Главная › User Guide › profiles

sidebar_position: 2 lang: ru

Профили: запуск нескольких агентов

Запускайте несколько независимых агентов Hermes на одном компьютере — каждый со своей собственной конфигурацией, ключами API, памятью, сеансами, навыками и состоянием шлюза.

Что такое профили?

Профиль — это отдельный домашний каталог Hermes. Каждый профиль получает свой собственный каталог, содержащий свои собственные config.yaml, .env, SOUL.md, воспоминания, сеансы, навыки, задания cron и базу данных состояний. Профили позволяют запускать отдельных агентов для разных целей — помощника по программированию, личного бота, исследовательского агента — не смешивая штат Гермеса.

Когда вы создаете профиль, он автоматически становится отдельной командой. Создайте профиль с именем coder, и вы сразу же получите coder chat, coder setup, coder gateway start и т. д.

Быстрый старт

hermes profile create coder       # creates profile + "coder" command alias
coder setup                       # configure API keys and model
coder chat                        # start chatting

Вот и все. coder теперь является собственным профилем Hermes со своей конфигурацией, памятью и состоянием.

Создание профиля

Пустой профиль

hermes profile create mybot

Создает новый профиль с набором навыков. Запустите mybot setup, чтобы настроить ключи API, модель и токены шлюза.

Клонировать только конфигурацию (--clone)

hermes profile create work --clone

Копирует config.yaml, .env и SOUL.md вашего текущего профиля в новый профиль. Те же ключи API и модель, но новые сеансы и память. Отредактируйте ~/.hermes/profiles/work/.env для других ключей API или ~/.hermes/profiles/work/SOUL.md для другой личности.

Клонируйте все (--clone-all)

hermes profile create backup --clone-all

Копирует все — конфигурацию, ключи API, персональные данные, все воспоминания, полную историю сеансов, навыки, задания cron, плагины. Полный снимок. Полезно для резервного копирования или разветвления агента, у которого уже есть контекст.

Клонировать из определенного профиля

hermes profile create work --clone --clone-from coder

:::подсказка Honcho память + профили Когда Honcho включен, --clone автоматически создает выделенный узел AI для нового профиля, одновременно используя одно и то же рабочее пространство пользователя. Каждый профиль строит свои собственные наблюдения и идентичность. Подробности см. в разделе Honcho – Мультиагент/Профили.

Использование профилей

Псевдонимы команд

Каждый профиль автоматически получает псевдоним команды ~/.local/bin/<name>:

coder chat                    # chat with the coder agent
coder setup                   # configure coder's settings
coder gateway start           # start coder's gateway
coder doctor                  # check coder's health
coder skills list             # list coder's skills
coder config set model.default anthropic/claude-sonnet-4

Псевдоним работает с любой подкомандой Hermes — под капотом это просто hermes -p <name>.

Флаг -p

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

hermes -p coder chat
hermes --profile=coder doctor
hermes chat -p coder -q "hello"    # works in any position

Прикрепленное значение по умолчанию (hermes profile use)

hermes profile use coder
hermes chat                   # now targets coder
hermes tools                  # configures coder's tools
hermes profile use default    # switch back

Устанавливает значение по умолчанию, поэтому простые команды hermes нацелены на этот профиль. Нравится kubectl config use-context.

Знать, где ты

CLI всегда показывает, какой профиль активен:

Профили, рабочие пространства и песочница

Профили часто путают с рабочими пространствами или песочницами, но это разные вещи:

На серверной части терминала local по умолчанию агент по-прежнему имеет тот же доступ к файловой системе, что и ваша учетная запись пользователя. Профиль не запрещает ему доступ к папкам за пределами каталога профиля.

Если вы хотите, чтобы профиль запускался в определенной папке проекта, установите явный абсолют terminal.cwd в config.yaml этого профиля:

terminal:
  backend: local
  cwd: /absolute/path/to/project

Использование cwd: "." на локальном сервере означает «каталог, из которого был запущен Hermes», а не «каталог профиля».

Также обратите внимание:

Запуск шлюзов

Каждый профиль запускает свой шлюз как отдельный процесс со своим токеном бота:

coder gateway start           # starts coder's gateway
assistant gateway start       # starts assistant's gateway (separate process)

Различные токены ботов

Каждый профиль имеет свой собственный файл .env. Настройте разные токены бота Telegram/Discord/Slack в каждом:

# Edit coder's tokens
nano ~/.hermes/profiles/coder/.env

# Edit assistant's tokens
nano ~/.hermes/profiles/assistant/.env

Безопасность: токены блокировки

Если два профиля случайно используют один и тот же токен бота, второй шлюз будет заблокирован с явной ошибкой с указанием конфликтующего профиля. Поддерживается для Telegram, Discord, Slack, WhatsApp и Signal.

Постоянные службы

coder gateway install         # creates hermes-gateway-coder systemd/launchd service
assistant gateway install     # creates hermes-gateway-assistant service

Каждый профиль получает свое собственное имя службы. Они работают независимо.

Настройка профилей

Каждый профиль имеет свои:

coder config set model.default anthropic/claude-sonnet-4
echo "You are a focused coding assistant." > ~/.hermes/profiles/coder/SOUL.md

Если вы хотите, чтобы этот профиль работал в конкретном проекте по умолчанию, установите также свой собственный terminal.cwd:

coder config set terminal.cwd /absolute/path/to/project

Обновление

hermes update извлекает код один раз (общий) и автоматически синхронизирует новые связанные навыки со всеми профилями:

hermes update
# → Code updated (12 commits)
# → Skills synced: default (up to date), coder (+2 new), assistant (+2 new)

Навыки, измененные пользователем, никогда не перезаписываются.

Управление профилями

hermes profile list           # show all profiles with status
hermes profile show coder     # detailed info for one profile
hermes profile rename coder dev-bot   # rename (updates alias + service)
hermes profile export coder   # export to coder.tar.gz
hermes profile import coder.tar.gz   # import from archive

Удаление профиля

hermes profile delete coder

Это останавливает шлюз, удаляет службу systemd/launchd, удаляет псевдоним команды и удаляет все данные профиля. Вам будет предложено ввести имя профиля для подтверждения.

Используйте --yes, чтобы пропустить подтверждение: hermes profile delete coder --yes

:::примечание Вы не можете удалить профиль по умолчанию (~/.hermes). Чтобы удалить все, используйте hermes uninstall.

Завершение вкладки

# Bash
eval "$(hermes completion bash)"

# Zsh
eval "$(hermes completion zsh)"

Добавьте строку в ~/.bashrc или ~/.zshrc для постоянного завершения. Заполняет имена профилей после -p, подкоманд профиля и команд верхнего уровня.

Как это работает

Профили используют переменную среды HERMES_HOME. Когда вы запускаете coder chat, сценарий-оболочка устанавливает HERMES_HOME=~/.hermes/profiles/coder перед запуском Hermes. Поскольку более 119 файлов в кодовой базе разрешают пути через get_hermes_home(), состояние Hermes автоматически ограничивается каталогом профиля — конфигурация, сеансы, память, навыки, база данных состояний, PID шлюза, журналы и задания cron.

Это отдельный от рабочего каталога терминала. Выполнение инструмента начинается с terminal.cwd (или каталога запуска, если cwd: "." на локальном сервере), а не автоматически с HERMES_HOME.

Профиль по умолчанию — это просто ~/.hermes. Миграция не требуется — существующие установки работают идентично.