概要

Simの実行エンジンは、ブロックを正しい順序で処理し、データフローを管理し、エラーを適切に処理することで、ワークフローに命を吹き込みます。これにより、Simでワークフローがどのように実行されるかを正確に理解することができます。

ドキュメント概要

主要概念

トポロジカル実行

ブロックは依存関係の順序で実行され、スプレッドシートがセルを再計算する方法に似ています。実行エンジンは、完了した依存関係に基づいて、どのブロックが実行可能かを自動的に判断します。

パス追跡

エンジンはワークフロー内の実行パスを積極的に追跡します。ルーターおよび条件ブロックはこれらのパスを動的に更新し、関連するブロックのみが実行されるようにします。

レイヤーベースの処理

ブロックを一つずつ実行する代わりに、エンジンは並列実行可能なブロックのレイヤーを識別し、複雑なワークフローのパフォーマンスを最適化します。

実行コンテキスト

各ワークフローは実行中に以下を含む豊富なコンテキストを維持します：

• ブロックの出力と状態
• アクティブな実行パス
• ループと並列反復の追跡
• 環境変数
• ルーティング決定

デプロイメントスナップショット

すべての公開エントリーポイント（API、チャット、スケジュール、Webhook、手動実行）は、ワークフローのアクティブなデプロイメントスナップショットを実行します。キャンバスを変更するたびに新しいデプロイメントを公開することで、すべてのトリガーが更新されたバージョンを使用するようになります。

デプロイモーダルは完全なバージョン履歴を保持しています。任意のスナップショットを検査し、ドラフトと比較して、以前のリリースを復元する必要がある場合はワンクリックで昇格またはロールバックできます。

プログラムによる実行

公式SDKを使用してアプリケーションからワークフローを実行できます：

# TypeScript/JavaScript
npm install simstudio-ts-sdk

# Python
pip install simstudio-sdk

// TypeScript Example
import { SimStudioClient } from 'simstudio-ts-sdk';

const client = new SimStudioClient({ 
  apiKey: 'your-api-key' 
});

const result = await client.executeWorkflow('workflow-id', {
  input: { message: 'Hello' }
});

ベストプラクティス

信頼性を考慮した設計

• 適切なフォールバックパスでエラーを適切に処理する
• 機密データには環境変数を使用する
• デバッグ用にFunction ブロックにログ記録を追加する

パフォーマンスの最適化

• 可能な限り外部APIコールを最小限に抑える
• 独立した操作には並列実行を使用する
• 適切な場合はMemoryブロックで結果をキャッシュする

実行の監視

• パフォーマンスパターンを理解するために定期的にログを確認する
• AIモデル使用のコストを追跡する
• 問題をデバッグするためにワークフロースナップショットを使用する

次のステップ

ワークフローの実行方法を理解するには実行の基本から始め、次に実行を監視するためのログ記録や支出を最適化するためのコスト計算を探索してください。