メインコンテンツへスキップ

ビジュアルおよび Python ワークフロー

モダンな EKB ワークフローには2つのビルダースタイルがあります。Tools キャンバスで自分で作成することも、Autopilot（Build モード）に作成を頼むこともできます。このページでは、2つのスタイルの違い、Autopilot の役割、フローチャートとサマリービューの読み方を説明します。

クラシックな V1 対 V2 のプロダクトラインと移行については、ワークフロー概要およびWorkflow Builder V2をご覧ください。

Visual 対 Python の比較一覧​

Visual（Workflows v2）Python（Workflows v3 / コードモード）
編集するものトリガー、エージェント、ツール、条件、出力のドラッグアンドドロップキャンバスワークフローロジックを定義する Python ソース
読み方キャンバスのグラフプレーン英語のステップラベル、接続アプリ、折りたたみ可能なループ/分岐カードを備えた読みやすいフローチャート — 任意の Developer（コード）ビュー付き
最適な用途目視で組み立てて検査したいプロセスコードで表現しやすいロジック、または Autopilot が Python でエンドツーエンドを作成すべきロジック
エディター内の Autopilotチャット / create-with-AI フローで支援構築と改善の間に Autopilot チャットはキャンバスにドッキングしたまま
手動の「New Flow」/ 空白ツール手動作成のデフォルト空白の手動作成ではデフォルトではない（下記参照）

Tools 一覧のワークフローに Python バッジが付いている場合は、コードモード（v3）のワークフローです。

ワークフローの作成​

Autopilot で構築（どちらのスタイルにも推奨）​

  1. プロジェクトを開きます（読み取り専用の Autopilot システムプロジェクトではありません）。
  2. Build モードの Autopilot を使うか、Tools を開いて Build workflow with AI / Autopilot の作成フローを開始します。
  3. ワークフローに何をすべきかを説明します（コンテキストとしてファイルを添付できます）。
  4. 作成ダイアログには、Autopilot がデフォルトで Workflows v3 / Python と Workflows v2 / Visual のどちらを作成するかが表示されます。
  5. Autopilot が計画し、必要に応じて確認質問をして、ワークフローを構築します。チャットを続けて改善できます。
ヒント

新しい Autopilot チャットは Agent モードがデフォルトです。Autopilot にワークフローの作成や変更をしてほしいときは Build に切り替えてください。Autopilot モードをご覧ください。

Autopilot の作成時に Visual 対 Python を制御するのは誰か？
スーパー管理者の設定 — Default new Autopilot workflows to Workflows v3 — がデフォルトを選択します：

  • オン — Autopilot はデフォルトで Python / コードモードのワークフローを作成
  • オフ — Autopilot はデフォルトで **Visual（v2）**のワークフローを作成

手動の空白ワークフロー作成は Visual ビルダーのままです。

手動作成（Visual）​

  1. Tools に移動します。
  2. New Flow を使うか空白のカスタムツールを作成します。
  3. トリガーを追加し、ノードをキャンバスにドラッグして接続し、実行してから公開します。

詳細：Workflow Builder V2。

Autopilot が構築したワークフロー​

Autopilot が Build モードでワークフローを構築するとき、通常：

  1. トリガー、ステップ、アプリ、出力を明確化
  2. Visual または Python モードでワークフローを作成（上記のプラットフォームデフォルトに従う）
  3. ステップ / Python ソースを構成
  4. 適用可能なら検証とテスト
  5. 作成した内容のサマリーを提示

同じチャットで継続できます：ステップの改善、失敗の修正、または追加の作成なしに結果を実行・推論するために Agent モードへ切り替え。Autopilot の仕組みをご覧ください。

エディターにドッキングした Autopilot​

Python（コードモード）のワークフローでは、Autopilot はエディターのキャンバスにドッキングしたままになるため、フローチャートと（Developer ビューで）ソースの更新を見ながら変更を説明できます。

Visual のワークフローでは、Autopilot チャット / 「create with AI」フローを使って作成・反復します。キャンバスは引き続きノードをドラッグして構成する場所です。

フローチャートとサマリービュー​

フローチャート（Python ワークフロー）​

Python ワークフローは読みやすいフローチャートとしてレンダリングされます：

  • プレーン英語のステップラベル（生のコード識別子だけではない）
  • フロー上に明示された接続アプリ
  • 複雑な制御フロー向けの折りたたみ可能なループと分岐カード
  • Overview 対 Developer の詳細：Overview はビジネスフローを強調；Developer はグラフと並べて Python ソースを公開

過去の実行を検査するときも同じフローチャートが使われ、ステップごとのステータスが重ねられるため、何が実行され、スキップされ、失敗したかが分かります。

サマリー（Visual および Python）​

Visual と Python の両方のワークフローがサマリービューをサポートします — ワークフローが何をするかの一目で分かる構造化ステップ付きの説明です。サマリーは公開に関連して生成/更新されます。公開後にワークフローを変更した場合、サマリーを最新に保つには再公開が必要になることがあります。

スーパー管理者は、ワークフローサマリーやステップノートを書くどのモデルを使うかを構成できます（プラットフォームのモデル設定）。

どちらを使うべきか​

目標推奨
ノードのドラッグと条件の配線でプロセスを組み立てるVisual
Autopilot に分岐やデータロジックをコードで書かせるPython
反復しながら Autopilot をライブのフローチャートの隣にドッキングしたままにするPython
既存の V2 キャンバスドキュメントとノードカタログに従うVisual → Workflow Builder V2
チャットから「週次レポートのワークフローを構築して」Autopilot Build モード（モード = プラットフォームのデフォルト）

関連​