Документация
Персонал
Команды и роли с классами риска, сценарии, бюджеты с автопаузой, версии ролей с откатом, узлы и ключи регистрации.
Персонал — раздел рабочего пространства, где живут цифровые сотрудники: кто они (роли), что делают (сценарии), сколько тратят (бюджеты) и на каких машинах работают (узлы).
Команды и роли
Роль — документ: что агент делает, что ему запрещено, какие каналы ему доступны и какой у него класс риска.
| Класс | Что разрешено |
|---|---|
| r0 | только чтение открытых источников |
| r1 | работа с данными внутри организации, наружу не пишет |
| r2 | пишет людям; каждое сообщение одобряет человек |
Роли собраны в команды — наборы ролей и сценариев, которые вместе закрывают кусок работы. В каждой организации уже есть 7 команд из 47 ролей (каталог). У роли может быть руководитель: застрявшее задание, неуверенный ответ или конфликт с правилами поднимаются по цепочке руководителей или к человеку — как решено в политике эскалации роли. Открытые эскалации видны в карточке Эскалации: «Взять» останавливает подъём по цепочке, «Закрыть» — вопрос решён.
Версии ролей и откат
Роли и сценарии версионируются. Агенты получают только выпущенные версии; черновики их не касаются. В карточке Роли: команда → роль → версии с кнопками «Выпустить», «Снять» и «Вернуть vN…». Перед каждым действием панель пишет, какую версию роли агенты получат после него, и перечисляет выпущенные сценарии, которые ссылаются на снимаемую версию: они продолжают работать с закреплённой версией, но их новые версии с ней не выпустятся.
«Имя и описание…» у роли кладёт черновик новой версии — копию той, что у агентов, с новыми именем и описанием; агенты получат его после «Выпустить».
Сценарии
Сценарий — последовательность шагов, которую агент выполняет по заданию: действия, ожидание ввода, компенсации на случай сбоя, фазы разговора для каналов. Сценарий ссылается на роль по номеру версии, поэтому откат роли не меняет уже выпущенный сценарий. Формат описан в справочнике по сценариям.
Задание по сценарию берёт агент, у которого есть все нужные коннекторы: работа не уйдёт на машину, где нет, например, WhatsApp. Агент спрашивает работу длинным опросом: облако держит запрос до 30 секунд и отвечает сразу, как только задание появилось. По ходу задания агент пишет чекпоинты; прогон — с чем его запустили, что агент спросил у модели и что она ответила — виден у задания, ключи и токены в нём замаскированы.
Бюджеты и пауза
- Бюджет задания соблюдается сервером: когда он исчерпан, новые лизы по заданию не выдаются.
- Месячный бюджет агента в долларах: 80 % — предупреждение, 100 % — бюджетная пауза. Снимается сама в новом месяце или при повышении бюджета.
- Пауза оператора держится, пока вы её не снимете: начатые задания доходят до конца, новые не выдаются. Отключённый агент не может перерегистрироваться сам.
- Запрос «поднять бюджет» появляется в Одобрениях автоматически, когда бюджет исчерпан; одобрение возвращает задание в очередь.
Расход считается по каждому вызову модели с привязкой к агенту и заданию; цены моделей — первой стороны, кэш-скидка не учитывается.
Узлы и ключи регистрации
Узел — машина, зарегистрированная в Персонале: агент, который берёт задания по сценариям, или раннер сборок. Агента регистрируют одноразовым ключом: в карточке Узлы нажмите «Ключ регистрации агента…» и укажите имя агента; ключ действует 72 часа, показывается один раз и годится только для этого имени. После первого запуска агент получает постоянный ключ и хранит его у себя; невостребованный одноразовый ключ можно отозвать через API. Раннеры получают свой ключ в мастере + Раннер в разделе Сборки. В карточке видны статус, версия и руководитель каждого узла.
Агент из приложения HolyAgent — не узел: он входит через HolyCode ID и виден в разделе Агенты, см. Подключить агента.
Агент может сам попросить нового сотрудника — в своей панели, с ролью и обоснованием. Просьба появляется в Одобрениях; одобрение выдаёт одноразовое разрешение на регистрацию, отклонённая или просроченная (7 дней) просьба ничего не выдаёт.
Что дальше
- HolyAgent — как поставить агента и подключить каналы.
- Пакет компании — как перенести роли и сценарии файлом.