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

Персонал

Команды и роли с классами риска, сценарии, бюджеты с автопаузой, версии ролей с откатом, узлы и ключи регистрации.

Персонал — раздел рабочего пространства, где живут цифровые сотрудники: кто они (роли), что делают (сценарии), сколько тратят (бюджеты) и на каких машинах работают (узлы).

Команды и роли

Роль — документ: что агент делает, что ему запрещено, какие каналы ему доступны и какой у него класс риска.

КлассЧто разрешено
r0только чтение открытых источников
r1работа с данными внутри организации, наружу не пишет
r2пишет людям; каждое сообщение одобряет человек

Роли собраны в команды — наборы ролей и сценариев, которые вместе закрывают кусок работы. В каждой организации уже есть 7 команд из 47 ролей (каталог). У роли может быть руководитель: застрявшее задание, неуверенный ответ или конфликт с правилами поднимаются по цепочке руководителей или к человеку — как решено в политике эскалации роли. Открытые эскалации видны в карточке Эскалации: «Взять» останавливает подъём по цепочке, «Закрыть» — вопрос решён.

Версии ролей и откат

Роли и сценарии версионируются. Агенты получают только выпущенные версии; черновики их не касаются. В карточке Роли: команда → роль → версии с кнопками «Выпустить», «Снять» и «Вернуть vN…». Перед каждым действием панель пишет, какую версию роли агенты получат после него, и перечисляет выпущенные сценарии, которые ссылаются на снимаемую версию: они продолжают работать с закреплённой версией, но их новые версии с ней не выпустятся.

«Имя и описание…» у роли кладёт черновик новой версии — копию той, что у агентов, с новыми именем и описанием; агенты получат его после «Выпустить».

Сценарии

Сценарий — последовательность шагов, которую агент выполняет по заданию: действия, ожидание ввода, компенсации на случай сбоя, фазы разговора для каналов. Сценарий ссылается на роль по номеру версии, поэтому откат роли не меняет уже выпущенный сценарий. Формат описан в справочнике по сценариям.

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

Бюджеты и пауза

  • Бюджет задания соблюдается сервером: когда он исчерпан, новые лизы по заданию не выдаются.
  • Месячный бюджет агента в долларах: 80 % — предупреждение, 100 % — бюджетная пауза. Снимается сама в новом месяце или при повышении бюджета.
  • Пауза оператора держится, пока вы её не снимете: начатые задания доходят до конца, новые не выдаются. Отключённый агент не может перерегистрироваться сам.
  • Запрос «поднять бюджет» появляется в Одобрениях автоматически, когда бюджет исчерпан; одобрение возвращает задание в очередь.

Расход считается по каждому вызову модели с привязкой к агенту и заданию; цены моделей — первой стороны, кэш-скидка не учитывается.

Узлы и ключи регистрации

Узел — машина, зарегистрированная в Персонале: агент, который берёт задания по сценариям, или раннер сборок. Агента регистрируют одноразовым ключом: в карточке Узлы нажмите «Ключ регистрации агента…» и укажите имя агента; ключ действует 72 часа, показывается один раз и годится только для этого имени. После первого запуска агент получает постоянный ключ и хранит его у себя; невостребованный одноразовый ключ можно отозвать через API. Раннеры получают свой ключ в мастере + Раннер в разделе Сборки. В карточке видны статус, версия и руководитель каждого узла.

Агент из приложения HolyAgent — не узел: он входит через HolyCode ID и виден в разделе Агенты, см. Подключить агента.

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

Что дальше

  • HolyAgent — как поставить агента и подключить каналы.
  • Пакет компании — как перенести роли и сценарии файлом.