Концепции

Эта секция — mental-model OPORA. Если вы понимаете, как устроена платформа изнутри, workflow’ы перестают быть magic’ом и становятся предсказуемой инженерной практикой.

Читайте в порядке:

1. How it works — 5-минутное введение: space → agent → process → run → trace.
2. Agents & Processes — что живёт внутри каждого агента, что такое revision / deployment, как template-resolver режет {{trigger.*}} на runtime’е.
3. Runs & Traces — жизненный цикл run’а (queued → planning → running → done/failed), trace-events, retry policies.
4. Secrets & Connections — разница между secret’ом (шифрованная строка под AES-256) и OAuth-connection’ом (долгоживущая привязка к внешнему провайдеру с refresh-token rotation).
5. Approvals — human-in-the-loop: любой узел workflow’а можно гейтить approval’ом по space-роли или named- пользователю.
6. KPIs & Reports — auto-computed метрики на основе trace-событий (runs / cost / latency / success rate), weekly reports в PDF.
7. Webhooks — общая анатомия incoming webhook’а: HMAC / query-token / IP-whitelist варианты валидации, retry- семантика, raw-body-capture.

После прочтения вы сможете:

• Строить workflow-паттерны, а не «пытаться вспомнить какой виджет что делает»
• Объяснять коллегам, как OPORA обрабатывает ваш trigger — шаг за шагом с apical’ой до handler’а
• Диагностировать сбои по trace’у, а не «run красный — что-то сломалось»