Обзор

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

Обзор документации

Ключевые концепции

Топологическое выполнение

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

Отслеживание пути

Движок активно отслеживает пути выполнения через ваш рабочий процесс. Блоки Router и Condition динамически обновляют эти пути, гарантируя выполнение только релевантных блоков.

Обработка на основе слоев

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

Контекст выполнения

Каждый рабочий процесс поддерживает богатый контекст во время выполнения, содержащий:

• Выходные данные и состояния блоков
• Активные пути выполнения
• Отслеживание итераций циклов и параллельных операций
• Переменные окружения
• Решения маршрутизации

Снимки развертывания

Выполнения API, чата, расписания и вебхуков работают против активного снимка развертывания рабочего процесса. Ручные запуски из редактора выполняют текущее состояние черновика канваса, позволяя вам тестировать изменения перед развертыванием. Публикуйте новое развертывание всякий раз, когда вы изменяете канвас, чтобы каждый триггер использовал обновленную версию.

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

Программное выполнение

Выполняйте рабочие процессы из ваших приложений с помощью наших официальных SDK:

# TypeScript/JavaScript
npm install aacflow-ts-sdk

# Python
pip install aacflow-sdk

// Пример на TypeScript
import { AACFlowClient } from 'aacflow-ts-sdk';

const client = new AACFlowClient({ 
  apiKey: 'ваш-api-ключ' 
});

const result = await client.executeWorkflow('workflow-id', {
  input: { message: 'Привет' }
});

Лучшие практики

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

• Обрабатывайте ошибки корректно с соответствующими запасными путями
• Используйте переменные окружения для конфиденциальных данных
• Добавляйте логирование в блоки Function для отладки

Оптимизация производительности

• Минимизируйте вызовы внешних API там, где это возможно
• Используйте параллельное выполнение для независимых операций
• Кэшируйте результаты с помощью блоков Memory, когда это уместно

Мониторинг выполнений

• Регулярно просматривайте логи для понимания паттернов производительности
• Отслеживайте затраты на использование моделей ИИ
• Используйте снимки рабочих процессов для отладки проблем

Что дальше?

Начните с Основ выполнения, чтобы понять, как выполняются рабочие процессы, затем изучите Логирование для мониторинга ваших выполнений и Расчет стоимости для оптимизации ваших расходов.