システムアーキテクチャ

Jinba Flowは、ワークフロー自動化を実現するために連携する4つの主要コンポーネントで構成されています。

コンポーネント概要

フローエディタ

チャット、グラフ、YAMLを使用してワークフローを作成するビジュアルインターフェース

マニフェスト

ワークフロー定義のYAML表現

ランナー

マニフェストを処理しステップを実行する実行エンジン

API / MCP

ワークフローのトリガーと連携のための外部インターフェース

データフロー

コンポーネント詳細

1. フローエディタ（設計時）

フローエディタはワークフロー作成のための3つの方法を提供します：

方法	インターフェース	最適な用途
チャットパネル	自然言語	素早いプロトタイピング、非技術者向け
グラフエディタ	ビジュアルドラッグ＆ドロップ	フロー構造の理解
YAMLパネル	直接コード編集	精密な制御、バージョン管理

3つの方法すべてが同じ出力を生成します：マニフェスト。

2. マニフェスト（架け橋）

マニフェストはワークフローを定義するYAMLドキュメントです：

steps:
  - id: step_id
    tool: TOOL_NAME
    input:
      - name: param
        value: "{{reference}}"
    needs: [dependency_step]
    when: "condition"
    forEach: "{{collection}}"

フィールド	目的
`id`	ステップの一意識別子
`tool`	実行するツール
`input`	ツールに渡すパラメータ
`needs`	他のステップへの依存関係
`when`	条件付き実行
`forEach`	コレクションのループ

3. ランナー（実行時）

ランナーはマニフェストを解釈しワークフローを実行します：

パース

マニフェストYAMLを読み込み検証

解決

needsフィールドから依存グラフを構築

実行

トポロジカル順にステップを実行、可能な場合は並列化

処理

エラー、リトライ、条件スキップを管理

返却

結果を収集し呼び出し元に返す

主な機能：

独立したステップの並列実行
変数解決（{{steps.*.result}}）
ワークスペースシークレットからのクレデンシャル注入
タイムアウトとリトライ管理

4. API / MCP（デプロイ）

公開されたワークフローは2つの連携インターフェースを提供します：

インターフェース	エンドポイント	ユースケース
REST API	`POST /api/v2/external/flows/{flowId}/published-run`	プログラム的な連携
MCPサーバー	Model Context Protocol	AIエージェントツール

認証：

すべての外部呼び出しにAPIキーが必要
キーはワークスペースにスコープ
レート制限が適用

実行フロー

トリガー

API呼び出し、スケジュール、MCP呼び出し、または手動実行で開始

ロード

ランナーが公開済みマニフェストバージョンを読み込み

検証

入力パラメータを定義されたスキーマに対して検証

実行

依存グラフに従ってステップを実行

返却

APIレスポンスまたはMCP結果として結果を返す

セキュリティ境界

境界	保護
エディタ → マニフェスト	スキーマ検証で無効なYAMLを防止
API → ランナー	APIキー認証が必要
ランナー → ツール	ワークスペースごとのクレデンシャル分離
ランナー → 外部	安全なサンドボックス実行環境

ワークスペース分離

各ワークスペースは以下を維持します：

クレデンシャル：APIキーとOAuthトークン
フロー：ワークフロー定義
バージョン：公開されたスナップショット
実行履歴：実行ログと成果物

ワークスペースは互いに完全に分離されています。

次のステップ

実行モデル

ステップの実行方法を詳しく学ぶ

APIリファレンス

APIエンドポイントについて学ぶ

​コンポーネント概要

フローエディタ

マニフェスト

ランナー

API / MCP

​データフロー

​コンポーネント詳細

​1. フローエディタ（設計時）

​2. マニフェスト（架け橋）

​3. ランナー（実行時）

​4. API / MCP（デプロイ）

​実行フロー

​セキュリティ境界

​ワークスペース分離

​次のステップ