Документация
HolyAgent
Установка на Mac, сервер и телефон, вход через HolyCode ID, агент для Персонала, модели, каналы, навыки, память и история настроек.
HolyAgent — агент на ваших машинах и единственное, что ставится у вас. Ключи моделей, каналы и память живут на машине; в облако уходят только задания, статусы и транскрипты прогонов, как вы настроите. Телеметрии нет.
Установка
| Где | Что ставить |
|---|---|
| Mac (Apple Silicon) | приложение из ленты релизов; обновляется само, данные в ~/.holyagent переживают обновление |
| Сервер | образ Docker готовится к публикации; напишите нам, если нужен раньше |
| iPhone | оболочка в тестировании, доступ по запросу |
Панель агента открывается локально на той машине, где он стоит. В приложение вы входите через HolyCode ID — той же учёткой, что и в рабочее пространство.
Подключение к организации
Приложение подключается само: вы входите через HolyCode ID, и на профиле по умолчанию мастер настройки берёт аккаунт из этого входа и регистрирует машину на него. Ключ выпускать и вставлять не нужно. Машина появляется в HolyCode в разделе Агенты — как ваш агент. По шагам, с мастером и первым каналом, — Подключить агента.
Агент для Персонала
Агент, который берёт задания по сценариям Персонала, работает без окна — обычно на сервере — и подключается одноразовым ключом:
- В HolyCode: Персонал → Узлы → «Ключ регистрации агента…» и имя агента (строчные латинские буквы, цифры,
.,_,-). Ключ действует 72 часа, показывается один раз и годится только для этого имени. - Агенту хватит переменных окружения: адрес организации, имя агента и ключ регистрации.
- Агент регистрируется, получает постоянный ключ и появляется в Узлах со статусом и версией. Одноразовый ключ после этого погашен.
Необязательно можно указать страны и языки, с которыми агент работает, набор коннекторов и сколько заданий он берёт одновременно (по умолчанию 5).
Модели
Провайдеры моделей подключаются на шаге мастера Авторизация и потом в панели агента: API-ключ, OAuth или вход через CLI для облачного провайдера (Anthropic, OpenAI, Google, Cerebras); локальные Ollama и LM Studio уже встроены. Ключи хранятся на машине зашифрованными. Провайдеров может быть несколько: агент переключает модель по настройке роли и задания. Токены оплачиваются у провайдера напрямую.
Каналы
WhatsApp, Telegram, Instagram и голос подключаются в панели агента, в разделе Каналы связи, и работают физически на этой машине: переписка с клиентами не проходит через облако. Что нужно для каждого канала, покажет мастер подключения. Сообщение наружу от роли класса r2 агент отправит только после одобрения в рабочем пространстве.
Навыки и память
Навык — папка с SKILL.md: что агент умеет и как это делать. Навыки включаются по агенту в панели, переносятся между установками пакетом компании. Память — что агент знает о вашем бизнесе — лежит в папке агента на машине.
История настроек
Каждое сохранение настроек агента пишет версию (хранятся последние 50). Панель агента → настройки → Подробнее → История настроек: что поменялось и кнопка отката к любой версии; сам откат тоже становится версией.
Несколько машин
Каждая машина — отдельный агент. Приложение на каждом Mac регистрируется само при входе; агент для Персонала получает свой ключ регистрации и становится отдельным узлом в Узлах. Роли и каналы у машин могут отличаться: например, WhatsApp только на одной машине, а голос — на другой. Задание Персонала уйдёт на тот узел, у которого есть все нужные коннекторы.
Чтобы машина ещё и собирала проекты с кодом, добавьте на неё раннер — см. Подключить агента.