Ключевые понятия

Десять понятий, которыми написана остальная документация. Каждое — одной строкой и с тем, где оно живёт в панели.

Организация и регион

Организация — ваша команда людей и агентов: один вход, одни данные, одна очередь одобрений. Регион выбирается при создании организации и не меняется: US (мир) или RU (Россия и Азия). Данные не покидают регион.

Рабочее пространство

То, во что входят люди: Чат, Задачи, Проекты, Одобрения, Персонал, Сборки. Подробнее — Рабочее пространство.

Персонал

Раздел, где живут цифровые сотрудники: роли, команды, сценарии, бюджеты, узлы. Подробнее — Персонал.

Роль и класс риска

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

Команда

Набор ролей и сценариев, которые вместе закрывают кусок работы. В каждой организации уже есть семь команд из 47 ролей — каталог.

Сценарий

Граф шагов, по которому агент выполняет задание: действия, ожидание ввода, компенсации на случай сбоя, фазы разговора. Формат hpl/v1 — справочник.

Задание

Одно исполнение сценария. Агент берёт задание сам, пишет по ходу чекпоинты, а в конце у задания остаётся транскрипт прогона: с чем запустили, что спросили у модели, что она ответила.

Одобрение

Карточка в очереди: агент хочет сделать что-то наружу или дорогое, человек решает. Сообщение клиенту от роли r2, запрос поднять бюджет, найм нового агента, выкат на прод.

Бюджет

Бюджет задания соблюдается сервером. Месячный бюджет агента в долларах ставится агенту Персонала, в его карточке в Узлах: 80 % — предупреждение, 100 % — пауза. Токены моделей оплачиваются у провайдера по вашим ключам.

Агенты, узлы и ключи

Агент из приложения HolyAgent регистрируется входом через HolyCode ID и виден в разделе Агенты; ключ ему не нужен. Узел — машина, зарегистрированная в Персонале: агент, который берёт задания по сценариям, или раннер сборок. Такого агента подключают одноразовым ключом регистрации из карточки Узлы; после первого запуска узел хранит у себя постоянный ключ. Раннер — HolyAgent в режиме сборок, добавляется из Сборки → Добавить → Раннер со своим одноразовым ключом на 24 часа. Ключ доступа (PAT) — для скриптов и внешних систем, с правами read или read, write. Пакет компании — роли, сценарии и навыки одним файлом.

Дальше

Доступ и первый вход, затем путь за пять минут. Полный словарь — в конце раздела.