Блок Start — это триггер по умолчанию для рабочих процессов, созданных в AACFlow. Он собирает структурированные входные данные и распределяет их по остальной части графа для редакторских тестов, API-развертываний и чат-интерфейсов.
Блок Start находится в стартовом слоте при создании рабочего процесса. Оставьте его там, когда хотите, чтобы одна и та же точка входа обслуживала редакторские запуски, запросы развертывания в API и чат-сессии. Замените его на триггеры Webhook или Schedule, когда вам нужен только событийно-ориентированный запуск.
Поля, предоставляемые блоком Start
Блок Start предоставляет разные данные в зависимости от поверхности выполнения:
- Поля Input Format — Каждое добавленное поле становится доступным как
<start.fieldName>. Например, полеcustomerIdпоявляется как<start.customerId>в последующих блоках и шаблонах. - Поля только для чата — Когда рабочий процесс запускается из боковой панели чата или развернутого чат-интерфейса, AACFlow также предоставляет
<start.input>(последнее сообщение пользователя),<start.conversationId>(идентификатор активной сессии) и<start.files>(вложения из чата).
Ограничьте поля Input Format именами, которые вы планируете использовать позже — эти значения являются единственными структурированными полями, общими для редакторских, API и чат-запусков.
Настройка Input Format
Используйте суб-блок Input Format для определения схемы, которая применяется во всех режимах выполнения:
- Добавьте поле для каждого значения, которое хотите собрать.
- Выберите тип (
string,number,boolean,object,arrayилиfiles). Поля типа файлов принимают загрузки из чата и API-вызовов. - Укажите значения по умолчанию, если хотите, чтобы модальное окно ручного запуска автоматически заполняло тестовые данные. Эти значения по умолчанию игнорируются при развернутых выполнениях.
- Измените порядок полей, чтобы контролировать их отображение в форме редактора.
Ссылайтесь на структурированные значения в последующих блоках с помощью выражений типа <start.customerId> в зависимости от подключенного блока.
Поведение в зависимости от точки входа
Когда вы нажимаете Run в редакторе, блок Start отображает Input Format как форму. Значения по умолчанию упрощают повторное тестирование без повторного ввода данных. Отправка формы немедленно запускает рабочий процесс, и значения становятся доступными как <start.fieldName> (например, <start.sampleField>).
Файловые поля в форме загружаются непосредственно в соответствующий
<start.fieldName>; используйте эти значения для передачи в последующие
инструменты или шаги хранения.
Развертывание в API превращает Input Format в JSON-контракт для клиентов. Каждое поле становится частью тела запроса, и AACFlow преобразует примитивные типы при приеме. Файловые поля ожидают объекты, ссылающиеся на загруженные файлы; используйте конечную точку загрузки файлов выполнения перед вызовом рабочего процесса.
API-вызывающие могут включать дополнительные необязательные свойства. Они сохраняются
внутри выходных данных <start.fieldName>, что позволяет экспериментировать
без немедленного переразвертывания.
В чат-развертываниях блок Start привязывается к активной беседе. Последнее сообщение заполняет <start.input>, идентификатор сессии доступен как <start.conversationId>, а вложения пользователя появляются в <start.files>, вместе с любыми полями Input Format, ограниченными как <start.fieldName>.
Если вы запускаете чат с дополнительным структурированным контекстом (например, из встраивания), он объединяется с соответствующими выходными данными <start.fieldName>, сохраняя согласованность последующих блоков с API и ручными запусками.
Развертывания в форму отображают Input Format как автономную, встраиваемую страницу формы. Каждое поле становится элементом формы с соответствующими элементами управления — текстовые поля для строк, числовые поля для чисел, переключатели для булевых значений и зоны загрузки файлов для файлов.
Когда пользователь отправляет форму, значения становятся доступными как <start.fieldName>, как и в других точках входа. Рабочий процесс выполняется с типом триггера form, и отправители видят настраиваемое сообщение с благодарностью после завершения.
Формы можно встраивать через iframe или делиться прямыми ссылками, что делает их идеальными для опросов, контактных форм и рабочих процессов сбора данных.
Использование данных Start в последующих блоках
- Подключайте
<start.fieldName>напрямую к агентам, инструментам или функциям, которые ожидают структурированные данные. - Используйте синтаксис шаблонов, например
<start.sampleField>или<start.files[0].url>(только для чата) в полях промптов. - Сохраняйте
<start.conversationId>под рукой, когда нужно группировать выходные данные, обновлять историю беседы или вызывать API чата.
Рекомендации
- Используйте блок Start как единую точку входа, когда хотите поддерживать как API, так и чат-вызывающие.
- Предпочитайте именованные поля Input Format вместо парсинга сырого JSON в последующих узлах; преобразование типов происходит автоматически.
- Добавляйте валидацию или маршрутизацию сразу после Start, если определенные поля необходимы для успешного выполнения вашего рабочего процесса.