メインコンテンツへスキップ
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. ランナー（実行時）

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

パース

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

解決

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

実行

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

処理

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

返却

結果を収集し呼び出し元に返す
主な機能：
  • 独立したステップの並列実行
  • 変数解決（{{steps.*.result}}）
  • ワークスペースシークレットからのクレデンシャル注入
  • タイムアウトとリトライ管理

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

公開されたワークフローは2つの連携インターフェースを提供します：
インターフェースエンドポイントユースケース
REST APIPOST /api/v2/external/flows/{flowId}/published-runプログラム的な連携
MCPサーバーModel Context ProtocolAIエージェントツール
認証：
  • すべての外部呼び出しにAPIキーが必要
  • キーはワークスペースにスコープ
  • レート制限が適用

​
実行フロー

1

トリガー

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

ロード

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

検証

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

実行

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

返却

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

​
セキュリティ境界

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

​
ワークスペース分離

各ワークスペースは以下を維持します：
  • クレデンシャル：APIキーとOAuthトークン
  • フロー：ワークフロー定義
  • バージョン：公開されたスナップショット
  • 実行履歴：実行ログと成果物
ワークスペースは互いに完全に分離されています。

​
次のステップ

実行モデル

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

APIリファレンス

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