ドキュメントテンプレートテンプレートからインスタンス化する

推奨ルート・5分

テンプレートからワークフローをインスタンス化する

ユーザーの最初のワークフローの 90% はテンプレートから複製されます。この記事では「クローン作成→業務に合わせたカスタマイズ→オンライン化」の全プロセスをわかりやすく解説します。

Braidrun では、「テンプレートからのインスタンス化」が最も主流のワークフロー生成方法です。90% 以上のユーザーが最初のワークフローをホワイトボードから作成するのではなく、テンプレートからワークフローを複製し、その後自分のビジネスに合わせて調整します。この記事では、プロセスをボタンごとに詳しく説明します。

ワークフローを生成する 3 つの方法の比較

テンプレートからのインスタンス化 (このページ) — ⭐おすすめです。 5 分でランニングを始めることができ、専門家がすべての落とし穴を埋めてくれます。
AIアシスタントによる自然言語生成 — 適切なテンプレートが見つからない場合は、説明に従って AI に最初の草案を与えてから、それを改良していきます。
一から手書き — 上記のどちらにも当てはまらない場合にのみ選択してください。プラットフォームに十分慣れてから検討してください。

完全なプロセスの概要

テンプレートライブラリを参照し、カテゴリ/タグ/検索によって 1 つを選択します
テンプレートの詳細カードを読んで、前提条件と推定コストを確認します。
[このテンプレートを使用する] をクリックしてワークスペースにクローンを作成します
エディターの変数の説明に従ってビジネスパラメータを変更します。
認証情報センターでキーを入力します
最初にドライランして構造を確認し、その後再度実行します。
バインドスケジュール/Webhookトリガーをオンデマンドで実行

ステップ 1 · テンプレートギャラリーを参照する

1.1 入口を開ける

左側のメインナビゲーションは「テンプレートライブラリ」です。ページ構造:

上部のフィルターバー - 10 の業界カテゴリ + タグ + キーワード検索
テンプレートカードグリッド - 名前、説明、タグ、推定所要時間、複雑さを表示
右上隅の「My Collection」 - 長期テンプレートを収集し、次回から直接入力できます

1.2 一般的な選択戦略

ニーズは非常に具体的です — キーワードを直接検索します。たとえば、「TestFlight 証明書の有効期限のリマインダー」を実行したい場合、証明書の有効期限を検索すると、すぐにロックされます。
需要は幅広い — 業界初に基づくコンバージェンス。最もよく知っている業界カテゴリを選択し、2 ～ 3 ページをめくって、どのような種類のプロセスがあるかを大まかに把握してください。
「業界の他の企業が何をしているか見てみたい」 — 「複雑さ」で並べ替え、最も複雑なものを選択します。通常、それらはエンドツーエンドの成熟したプラクティスを表します。

ステップ 2 · テンプレートの詳細を読む

テンプレートカードをクリックして詳細ページに入ります。次の 4 つの部分に注目します。

2.1 「説明」セクション

2 つまたは 3 つの段落で、どのような問題を解決するか、どのようなシナリオに最適か、どのようなシナリオには適さないのか、使用前にどのような準備が必要かについて説明します。

2.2 「必要な認証情報」のリスト

このワークフローを実行するために必要な資格情報を明確にリストします。次に例を示します。

openai_api_key — OpenAI API キー (必須)
slack_webhook_url — Slack Incoming Webhook URL (配信用、オプション)
apple_appstoreconnect — App Store Connect JWT (Apple 関連のテンプレートにのみ必要)

「必須」資格情報のいずれかが欠落している場合、ワークフローは対応するステップに到達するときに失敗します。「optional」が省略されている場合、条件により当該ステップがスキップされます。

2.3 「所要時間と費用の目安」

完全な実行:

所要時間 - 2 分 / 15 分 / 1 時間（ワークフローの複雑さと外部依存関係の応答速度に応じて）
トークン使用量 - 平均 xxx 入力 / xxx 出力
$ 推定額 - プラットフォームのデフォルトのプリセットと OpenAI の単価に基づいて計算された概算値

2.4 「入力例と出力例」

特定の入力サンプル (コピーして 1 回実行できます) + 対応する出力サンプル (つまり、「おそらく何が得られるか」についてのアイデアが得られます)。

ステップ 3 · ワークスペースにクローンを作成する

右上隅の点 「このテンプレートを使用してください」。
ポップアップウィンドウでコピーに名前を付けます (デフォルトはテンプレート名 + タイムスタンプですが、よりビジネス的な意味のある名前に変更できます)。
ターゲットチームを選択します (複数のチームに所属している場合)。これにより、このワークフローを表示/編集できる人が決まります。
「OK」をクリックします。プラットフォームがコピーを生成します 独立したコピー、あなたの変更がテンプレートに反映されることはなく、テンプレートの以後の更新があなたのコピーを自動で変更することもありません。

テンプレートのバージョンとコピーのバージョン

クローンした時点で「どのテンプレートのどのバージョンからクローンしたか」が記録されます。その後テンプレートが新バージョンをリリースした際は、エディタで変更を先にプレビューしてからワンクリックでアップグレードできます —— 本ページ下部の「テンプレートのアップグレード」の節を参照してください。

ステップ 4 · ビジネスパラメータをカスタマイズする

4.1 変数セクションは、注意深く見る必要がある唯一の場所です。

エディターが開いたら、まず YAML を上部の変数セクションまでスクロールします。「ビジネス状況に応じてこのワークフローで調整する必要があるもの」はすべてここにあり、すでにコメントされています。

yaml

variables:
  target_date:
    type: string
    default: yesterday    # ← 改成你要跑哪一天的数据
    description: |
      支持 yesterday / last_7_days / last_30_days /
      或具体日期 2026-04-17

  top_n:
    type: number
    default: 10           # ← 要拉多少条新闻
    description: 抓取的新闻数量上限

  target_channel:
    type: string
    default: "#my_daily_digest"  # ← 改成你的 Slack 频道名或保留默认 webhook 目标
    description: Slack 目标频道或 Incoming Webhook 默认目标

4.2 コメントに従ってデフォルト値を変更する

デフォルト値は単なる「例」です。実際のビジネスの値に置き換えてください。変数を変更しても構造は壊れませんので、自由に変更してください。

4.3 段階的に動かないのは良い習慣です

テンプレートを初めて実行するときに、ステップセクションの構造を変更することはお勧めしません。まずデフォルトのプロセスで一度実行し、データフローを確認してから、変更するかどうかを決定します。

ステップ 5 · 資格情報センターを完了する

認証情報センターを開きます。
テンプレートの詳細ページにリストされている「必須」資格情報ごとに、対応する資格情報を作成します。名前は、YAML で引用されたものとまったく同じである必要があります。
「オプション」の資格情報は、現時点では作成しないままにしておくことができます。関連する手順はスキップされます。

よくある落とし穴: 資格情報名に基づくスペルミス

YAML で引用される名前は、資格情報センターの名前とまったく同じである必要があります (大文字と小文字は区別され、アンダースコア/ダッシュは区別されます)。「credential_not_found」エラーの半分以上はスペルの問題です。

ステップ 6 · 最初にドライランを実行し、次に実行します。

6.1 ドライランの意味

ドライランは、すべての LLM と副作用をスキップして、ゼロコストで DAG を実行します。お金を使う前に確認するのに役立ちます。

すべての変数が正しく入力されていますか?
変数はステップ間を流れます
条件/分類子の分岐が正しく選択されています。
依存する資格情報名は次のように解決できます。

6.2 実走行

ドライランが完了したら、ドライランのチェックを外し、再度「実行」をクリックします。今回は実際にLLMを調整し、実際の副作用を体験します。ページの右側にあるリアルタイムイベントストリームでは、各ステップの進行状況を確認できます。

6.3 ランニング後に注意すべきこと

「実行詳細の表示」 - ガントチャート＋各ステップの入出力
「商品列」 - 生成されたMarkdown / Excel / 画像を直接ダウンロードできます
「トークン・コスト」——今回はいくらかかりましたか？

ステップ 7 · 必要に応じてトリガーをバインドする

手動で実行すると、ワークフローをオンラインにする準備が整います。 3 つの一般的なトリガー方法:

スケジュール実行 — 毎日/毎週/毎月、または間隔で繰り返す
Webhook トリガー — 外部システムが POST でトリガーし、API Key で認証します（HMAC 署名にも対応）
API トリガー —— あなたの社内システムが API Key で REST API を呼び出して実行を開始します

テンプレートのアップグレード：テンプレートの新バージョンへの追従

クローンしたコピーがテンプレートの更新で自動的に変更されることはありません。元のテンプレートが新バージョンをリリースし、それに追従したい場合は「テンプレートからアップグレード」のフローを使います：まずプレビューを確認し、了承後にワンクリックでアップグレードします。

入口はどこか

2 か所から入れます：エディタのツールバーメニュー内の「テンプレートからアップグレード」、またはワークフロー設定パネルの変数エリア上部にある「アップグレードを確認」の案内です。開いたダイアログには現在のバージョンとターゲットバージョンが表示されます。

アップグレード前にプレビューを確認する

プレビューは変数の差分を 3 種類に分け、1 つずつ一覧表示します：

予約する — あなたが変更済みで、新テンプレートにも存在する変数は、アップグレード後もあなたの値が保持されます
新しい — 新テンプレートで追加された変数は、テンプレートのデフォルト値が入り、アップグレード後に必要に応じて調整します
削除 — 新テンプレートに存在しなくなった変数は、アップグレード後に破棄されます —— 了承前にこのリストを 1 つずつ確認してください

アップグレード時に何が起きるか

まず現在のワークフローをバージョンスナップショットとして自動保存します。後で戻したくなった場合は「バージョン」メニューでロールバックできます
ステップの DAG、Agent の prompt、コード、タイムアウトなどの構造的設定は新テンプレートで上書きされます
自分で選択したモデルは保持されます：同名の Agent のモデル選択と、対応するモデル認証情報の参照は新テンプレートで上書きされません
ワークフロー名、タグ、並列数といったあなた固有の設定は変更されません

以下の場合はアップグレードがブロックされます

終了していない実行がある —— それらが完了またはキャンセルされてからアップグレードしてください
すでに最新のテンプレートバージョンである —— 対応は不要です
元のテンプレートが削除済みである —— あなたのコピーには影響がなく、通常どおり実行を続けられます

古いワークフローに元テンプレートが記録されていない場合

初期にクローンしたワークフローは元テンプレートが登録されていない場合があり、その際はエディタメニューの同じ項目が「テンプレートを関連付け…」と表示されます。どのテンプレート由来かを追加登録すれば（同時に現在どのバージョンに対応するかも記録できます）、以後は通常どおりアップグレードのフローを利用できます。

上級: AI アシスタントが説明に従って変更します。

クローン作成後、ビジネス要件がテンプレートと完全に一致していない場合は、AI アシスタントに修正を依頼できます。

右下隅の FAB は AI アシスタントの引き出しを開きます
ニーズを説明してください - 例: 「step.deliver を Telegram から Feishu に変更する」
アシスタントは差分プレビューを表示し、それを受け入れるか拒否することができます。
満足したら「適用」をクリックします - 10 レベルの元に戻すスタックがいつでもロールバックから保護します

AI アシスタントや手書きにいつ切り替えるべきでしょうか?

シーン	推奨される方法	理由
ビジネスシナリオは従来型であり、対応するテンプレートがある	テンプレートからインスタンス化する	専門家によって設計され、5 分で実行可能
シーンにはテンプレートがありますが、大幅な変更が必要です	テンプレート + AI アシスタント	構造はコピーされ、細部はAIによって調整されます。
シーンが独特で適切なテンプレートがありません	AIアシスタントによる自然言語生成	要件の説明→初稿の取得→改良
あなたはすでにプラットフォームについて十分に精通しています	手書きの YAML	あらゆるフィールドを正確にコントロール

次のステップ

分類の詳細と代表的なテンプレート — 各業界カテゴリから選ばれた代表者が、各カテゴリで何ができるかを説明します。
ビジュアルエディター — クローン作成後にどのボタンをクリックする必要がありますか?
AIアシスタント — 自然言語を使用してワークフローを変更/生成する