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