テンプレート
ワークフロー 一覧の テンプレートから作成 から、定義済みのグラフでワークフローを開始できます。 テンプレートはコードで定義されており、作成時に Node / Edge へ新しい UUID が割り当てられます。
API では次で取得・作成できます。
GET /api/v1/workflows/templates— テンプレート一覧POST /api/v1/workflows/from-template— テンプレートから作成
テンプレートの Agent Node は agent_id が空の状態で作成されます。
公開前に、エディタで対象の Agent を選択してください。
ユーザーテンプレート
自分で作った公開済み Revision を、再利用可能な ユーザーテンプレート として保存できます。 コード定義のテンプレートとは別枠で、ワークフロー 一覧の ユーザーテンプレート 領域に表示されます。
- 保存 — Workflow 詳細の 公開中の Revision カードで
⋯を開き テンプレートとして保存 を押します。draft(下書き)は保存対象外です。 - 使って作成 — 一覧のユーザーテンプレートで 使って作成 を押すと、新しい Workflow と 下書き Revision が作られ、エディタが開きます。Node / Edge には新しい ID が割り当てられます。
- 名前・説明の編集 — 一覧の 編集 から変更します。
- 内容の更新 — Workflow 詳細の公開中の Revision カードで
⋯を開き テンプレートを更新… を押すと、更新先のテンプレートを選ぶ画面が出ます。公開済み Revision の定義でテンプレートを置き換えます。過去にそのテンプレートから作成した Workflow は 変更されません。 - 削除 — 一覧の 削除 はテンプレートの行だけを消します。作成済みの Workflow・Revision・ Run・Scheduler Job は変更されません。
- ダウンロード — 一覧の JSON / YAML で定義をファイルに保存できます。
テンプレート利用では、実行・公開・Scheduler 登録は自動で行われません。エディタで内容を確認し、 必要なら Agent / Capability を直してから 検証 と 公開 を行ってください。
JSON / YAML の import / export
Workflow の定義は Workflow Definition Package v1 として JSON / YAML で持ち運べます。
- export — Workflow 詳細の 公開中の Revision カードで
⋯を開き JSON をダウンロード / YAML をダウンロード を押します。 draft は export できません。 - import — ワークフロー 一覧の JSON/YAML を import でファイルを選びます。 import は常に 新しい Workflow の下書き を作り、既存の Workflow・Revision・Run は変更しません。
package に含まれるのは format / version / name / description / inputs_schema /
nodes / edges だけです。Workflow / Revision / Template の ID、状態、Run、Event、
Scheduler 設定は含まれません。Node / Edge の ID は package 内だけで通用し、import 時に
すべて新しい ID へ割り当て直されます。
インポート後は現在の環境の Capability / Agent で再検証されます。未知の Capability / Agent などが あると、下書きと検証エラーが表示されるので、エディタで修正してから公開してください。 import だけでは公開・実行は行われません。
package は定義を平文で保存・共有します。API キーなどの秘密値は Node の入力や
inputs_schema に書かないでください。
機能追加の計画→レビュー→改稿→実行
template_key:plan_review_execute- 入力:
task(string、必須)
構成:
flowchart LR
P[Agent: 計画] --> L[Loop: 改稿ループ]
subgraph L
R[Agent: レビューと改稿] --> LR[loop_result: ループ結果]
end
L --> E[Agent: 実行]
E --> D[Terminal: 完了]
- 計画 Agent が
taskから計画(plan)を出力します。 - 改稿ループ(
max_iterations: 4)は、状態{plan, review, done}を持ちます。- 子グラフの entry は レビューと改稿 Agent。
continuation_conditionはloop.state.done equals false。- ループ結果 が
plan/review/doneを次の状態へ返します。
- ループ終了後、実行 Agent が
nodes.loop.output.final_state.planを受け取りsummaryを出力します。 - 完了 Terminal(
success)。
文脈付きリサーチ
template_key:contextual_research- 入力:
topic(string、必須)
構成:
flowchart LR
C[Capability: 文脈収集] --> T[Agent: テーマ整形]
T --> R[Capability: リサーチ実行]
R --> D[Terminal: 完了]
- 文脈収集 — Capability
research_context_snapshotで活動・既存テーマ・Vault 検索の文脈を集めます。 - テーマ整形 —
topicと収集したcontextから、Agent がthemeを出力します。 - リサーチ実行 — Capability
research_agentにthemeを渡します。 - 完了 Terminal(
success)。
スターターテンプレートの位置づけ
スターターテンプレートはコード定義です。自分で作った公開済み Revision を再利用したい場合は ユーザーテンプレート として保存してください。スターターテンプレートを土台に、エディタで Node / Edge を調整して使うこともできます。