Документация

Подключить агента

Шаг 2 пути: выпустить одноразовый ключ регистрации, поставить HolyAgent, ввести ключ модели и подключить первый канал.

Шаг 2 из 3. Занимает две–три минуты. В конце в карточке Узлы будет агент со статусом «в сети», версией и подключённым каналом.

Что вы делаете

HolyAgent — единственное, что ставится у вас. Он регистрируется в организации одноразовым ключом, получает постоянный ключ, хранит его у себя и дальше сам спрашивает у облака работу. Входящих портов и белого IP не нужно: машина может стоять за NAT.

Шаги

  1. В HolyCode откройте Персонал → Узлы → «Ключ регистрации агента…». Укажите имя агента (строчные латинские буквы, цифры, ., _, -) и срок действия, по умолчанию 72 часа. Ключ показывается один раз и годится только для этого имени.
  2. Скачайте HolyAgent для Mac и откройте его. Мастер первого запуска попросит:
    • ключ регистрации из первого шага;
    • ключ модели — Anthropic, OpenAI или Google. Ключ хранится на машине зашифрованным.
  3. Дождитесь, пока агент появится в карточке Узлы со статусом и версией. Одноразовый ключ после этого погашен; невостребованный можно отозвать там же.
  4. В панели агента откройте Каналы и подключите первый: Telegram — самый быстрый для пробы; WhatsApp, Instagram и голос — так же, мастер покажет, что нужно для каждого.

На сервере без панели агенту хватит трёх переменных окружения: адрес организации, имя агента и ключ регистрации; образ Docker готовится к публикации.

Скриншот: ключ регистрации и узел в списке — TODO

Что получилось

  • Узел в карточке Узлы: «в сети», версия, подключённый канал.
  • Агент получает роли команды, которую вы выпустили на первом шаге, и ждёт заданий.

Если что-то не так

  • Агент не появляется в узлах — проверьте, что имя в ключе совпадает с именем в мастере, и что ключ не истёк; выпустите новый.
  • Задания не приходят — у задания есть коннекторы, которых нет у узла (например, WhatsApp не подключён); подключите канал или выберите роль без него.
  • Пауза — если агент на паузе бюджета или оператора, снимите её в карточке узла; начатые задания доходят до конца, новые ждут.

Дальше

Первое сообщение и одобрение — дать агенту задание и одобрить первое сообщение наружу.