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

Словарь

Термины документации одной строкой: от организации и региона до пакета компании.

  • HolyCode — платформа и рабочее пространство в облаке, в которое входят люди.
  • HolyAgent — агент на ваших машинах: модели по вашим ключам, каналы, память, навыки.
  • HolyBuild — агент-программист: берёт задачи из HolyCode, возвращает ветку и сборку.
  • Организация — команда людей и агентов с одним входом и одними данными.
  • Регион — где живут данные организации: US (мир) или RU (Россия и Азия); выбирается при создании и не меняется.
  • Рабочее пространство — разделы для людей: Чат, Задачи, Проекты, Одобрения, Персонал, Сборки.
  • Персонал — раздел с ролями, командами, сценариями, бюджетами и узлами.
  • Роль — документ о том, что агент делает, что запрещено и какие каналы доступны; версионируется.
  • Класс риска — r0 только чтение, r1 работа с данными без выхода наружу, r2 пишет людям после одобрения.
  • Команда — набор ролей и сценариев под одну задачу бизнеса; семь готовых в каталоге.
  • Сценарий — граф шагов формата hpl/v1, по которому агент выполняет задание.
  • Задание — одно исполнение сценария; у него есть чекпоинты и транскрипт прогона.
  • Чекпоинт — запись агента по ходу задания: что сделано, что дальше.
  • Транскрипт прогона — с чем задание запустили, что агент спросил у модели, что она ответила.
  • Одобрение — карточка в очереди, где человек решает: сообщение наружу, бюджет, найм, выкат.
  • Бюджет — лимит на задание (соблюдает сервер) и месячный лимит на агента Персонала (80 % предупреждение, 100 % пауза).
  • Пауза — состояние агента, в котором новые задания не выдаются; ставит оператор или бюджет.
  • Узел — машина, зарегистрированная в Персонале, с версией, статусом и руководителем: агент, подключённый ключом регистрации, или раннер сборок. Агент из приложения — не узел: он в разделе Агенты.
  • Ключ регистрации — одноразовый ключ из Персонал → Узлы для подключения агента Персонала, действует 72 часа; после первого запуска агент хранит постоянный ключ. Приложению он не нужен: оно входит через HolyCode ID.
  • Ключ доступа — ключ для скриптов и внешних систем с правами read или read, write.
  • Коннектор — канал или интеграция, которые нужны сценарию; задание уходит только узлу, у которого они есть.
  • Канал — WhatsApp, Telegram, Instagram или голос, подключённые на машине агента.
  • Навык — папка с SKILL.md: что агент умеет и как это делать.
  • Пакет компании — роли, сценарии и навыки одним файлом для переноса и хранения в git.
  • Эскалация — подъём застрявшего задания или неуверенного ответа по цепочке руководителей или к человеку.
  • Раннер — HolyAgent в режиме сборок, берёт сборки проектов с кодом; добавляется из Сборки → Добавить → Раннер одноразовым ключом на 24 часа, виден на вкладке Раннеры.