Человек в цикле

Блок "Человек в цикле" приостанавливает выполнение воркфлоу и ожидает человеческого вмешательства перед продолжением. Используйте его для добавления шлюзов утверждения, сбора обратной связи или получения дополнительного ввода в критических точках принятия решений.

Когда выполнение достигает этого блока, воркфлоу приостанавливается на неопределенное время, пока человек не предоставит ввод через портал утверждения, API или вебхук.

Параметры конфигурации

Отображаемые данные

Определяет, какие данные отображаются утверждающему. Это контекст, показанный в портале утверждения, чтобы помочь им принять обоснованное решение.

Используйте визуальный конструктор или редактор JSON для структурирования данных. Ссылайтесь на переменные воркфлоу, используя синтаксис <blockName.output>.

{
  "customerName": "<agent1.content.name>",
  "proposedAction": "<router1.selectedPath>",
  "confidenceScore": "<evaluator1.score>",
  "generatedEmail": "<agent2.content>"
}

Уведомление

Настраивает, как утверждающие получают оповещения, когда требуется утверждение. Поддерживаемые каналы включают:

Slack — Сообщения в каналы или личные сообщения
Gmail — Email со ссылкой на утверждение
Microsoft Teams — Уведомления в канале команды
SMS — Текстовые оповещения через Twilio
Вебхуки — Пользовательские системы уведомлений

Включите URL утверждения (<blockId.url>) в ваши сообщения уведомлений, чтобы утверждающие могли получить доступ к порталу.

Форма возобновления

Определяет поля, которые заполняют утверждающие при ответе. Эти данные становятся доступными последующим блокам после возобновления воркфлоу.

{
  "approved": {
    "type": "boolean",
    "description": "Утвердить или отклонить этот запрос"
  },
  "comments": {
    "type": "string",
    "description": "Опциональная обратная связь или объяснение"
  }
}

Получите доступ к данным возобновления в последующих блоках, используя <blockId.resumeInput.fieldName>.

Методы утверждения

Портал утверждения

Каждый блок генерирует уникальный URL портала (<blockId.url>) с визуальным интерфейсом, показывающим все приостановленные выходные данные и поля формы для ввода возобновления. Адаптивный для мобильных устройств и безопасный.

Поделитесь этим URL в уведомлениях, чтобы утверждающие могли просмотреть и ответить.

REST API

Программно возобновляйте воркфлоу:

POST /api/workflows/{workflowId}/executions/{executionId}/resume/{blockId}

{
  "approved": true,
  "comments": "Looks good to proceed"
}

Создавайте пользовательские UI утверждения или интегрируйте с существующими системами.

Вебхук

Добавьте инструмент вебхука в раздел Notification для отправки запросов утверждения во внешние системы. Интегрируйте с системами тикетов, такими как Jira или ServiceNow.

Распространенные варианты использования

Утверждение контента — Просмотр AI-генерируемого контента перед публикацией

Agent → Human in the Loop → API (Publish)

Многоэтапные утверждения — Цепочка нескольких шагов утверждения для решений с высокими ставками

Agent → Human in the Loop (Manager) → Human in the Loop (Director) → Execute

Валидация данных — Проверка извлеченных данных перед обработкой

Agent (Extract) → Human in the Loop (Validate) → Function (Process)

Контроль качества — Просмотр AI-выходных данных перед отправкой клиентам

Agent (Generate) → Human in the Loop (QA) → Gmail (Send)

Выходные данные блока

url — Уникальный URL для портала утверждения resumeEndpoint — URL конечной точки API возобновления response — Отображаемые данные, показанные утверждающему (json) submission — Данные отправки формы от утверждающего (json) submittedAt — Временная метка ISO, когда воркфлоу был возобновлен resumeInput.* — Все поля, определенные в форме возобновления, становятся доступными после возобновления воркфлоу

Доступ с использованием <blockId.resumeInput.fieldName>.

Пример

Приостановленные выходные данные:

{
  "title": "<agent1.content.title>",
  "body": "<agent1.content.body>",
  "qualityScore": "<evaluator1.score>"
}

Ввод возобновления:

{
  "approved": { "type": "boolean" },
  "feedback": { "type": "string" }
}

Использование в последующих блоках:

// Блок "Условие"
<approval1.resumeInput.approved> === true

Пример ниже показывает портал утверждения, как его видит утверждающий после приостановки воркфлоу. Утверждающие могут просмотреть данные и предоставить вводы как часть возобновления воркфлоу. Портал утверждения может быть доступен напрямую через уникальный URL, <blockId.url>.

Связанные блоки

Условие — Ветвление на основе решений утверждения
Переменные — Хранение истории утверждения и метаданных
Ответ — Возврат результатов воркфлоу вызывающим API