Docs
Формат сценариев
Сценарий hpl/v1: граф заданий и шагов, роли по версиям, коннекторы, бюджеты, компенсации и неизменяемая публикация.
This reference page is in Russian for now; the English version is on its way. The glossary maps the terms.
Сценарий — то, что агент выполняет по заданию: не «агент сам решит», а описанный граф шагов с ограничениями. Формат называется hpl/v1; в панели сценарии живут в разделе Персонал, файлом переносятся пакетом компании.
Из чего состоит
| Поле | Что задаёт |
|---|---|
format | всегда hpl/v1 |
pipeline_id, name, description | идентификатор и имя сценария |
input_schema, output_schema | что сценарий принимает на вход и отдаёт на выходе |
allowed_connectors | какие коннекторы (каналы, интеграции) сценарию разрешены; задание уйдёт только агенту, у которого они есть |
jobs | задания — узлы ациклического графа; задание агента ссылается на роль по неизменяемому role_id и номеру version |
terminal_states | какие состояния считаются концом |
metadata | служебные данные |
Каждое задание состоит из шагов. У шага объявлены явно:
connector— через что выполняется шаг;timeout_seconds,retry,idempotency_strategy— время, повторы и защита от двойного выполнения;manual_review— нужна ли проверка человеком (так реализованы одобрения сообщений наружу);budget_class,max_cost_usd— сколько шаг может стоить;side_effect,reversible,compensation_step_id— есть ли внешний эффект, обратим ли он и какой шаг его отменяет при сбое;artifacts— что шаг сохраняет и как долго.
Разговорные сценарии для каналов делятся на фазы разговора: агент ведёт диалог по фазе, пока не соберёт нужные данные, и только потом делает шаг с внешним эффектом.
Версии и публикация
Сценарий версионируется. Агенты получают только выпущенные версии; черновики их не касаются. Выпущенная версия неизменяема и адресуется каноническим хешем SHA-256 источника: одобрение привязано к хешу действия и не пережимается другой версией. Откат — «Вернуть vN…» в панели: агенты получают прежнюю версию, более новые выпущенные снимаются, черновики не трогаются.
Сценарий ссылается на роль по номеру версии. При переносе в другую организацию номера версий переписываются на местные — это делает импорт пакета компании.
Проверка
Схема hpl/v1 проверяет структуру и может построить порядок исполнения «всухую» — без вызова коннекторов и без запуска агентов. Что сценарий действительно выполняет, определяет агент на вашей машине с нужными коннекторами.