初めてのパイプラインを構築する
作成するもの
「作成するもの」というセクションこのチュートリアルを終えると、次のものが揃っています:
- プロンプトでエージェントをディスパッチする、保存済みのパイプラインテンプレート
- 手動で開始できるようにする、手動実行を有効にした状態
- 完了した 1 回の実行 — そのステップの入力と出力を確認できる状態
前提条件: 初めてのエージェントをディスパッチするを完了していること。これにより、アダプターとモデルを設定したエージェントができている状態になります。
パイプラインはステップからなる DAG です。テンプレートがグラフを定義し、run はその実行にあたります。背景にあるモデルについてはパイプラインと自動化を、ステップの語彙全体についてはパイプラインステップを参照してください。
ステップ 1: テンプレートを作成する
「ステップ 1: テンプレートを作成する」というセクション- 設定 → ワークスペース → パイプラインテンプレートに移動します
- 新しいテンプレートをクリックします
エディターは、新しいパイプラインという名前の用意されたスケルトン(ID は pipeline_N)で開きます。ヘッダーのタイトルをクリックして名前を変更します — このチュートリアルでは code_quality_check が良い名前です。ID のダイアログはなく、説明フィールドもありません。
キャンバスは空白ではありません。新しいテンプレートは Trigger → Step → terminal としてあらかじめ配線されています。ここで「Step」はプロンプトエージェントノードで、terminal は不可視のセンチネルです。エディターはこのセンチネルを、到達可能なすべてのシンクに再接続します。
設定するのは、すでに配置されている Step ノードです。
ステップ 2: ステップを設定する
「ステップ 2: ステップを設定する」というセクション- キャンバス上の Step ノードをクリックします
- 右側のノード設定パネルで次を設定します:
- エージェント: 前のチュートリアルで作成したエージェント
- プロンプトテンプレート: 「現在のブランチのコードを品質上の問題がないかレビューしてください。見つかったものを列挙してください。」
- Triggers from はそのままにします — このノードはすでに Trigger の後に発火するよう配線されています
ステップ 3: 保存する
「ステップ 3: 保存する」というセクションエディターのヘッダーで保存を押します。
チェックポイント。 「未保存の変更」の表示が消えます。
ステップ 4: 手動実行を許可する
「ステップ 4: 手動実行を許可する」というセクション- キャンバス上の破線のトリガーを追加タイルをクリックし(またはノードライブラリのトリガーセクションから手動実行をドラッグし)、手動実行を選びます。
- そのノードを選択します。右側のインスペクターで有効をオンにします — 「実行ページに表示し、手動で開始します。」
これは省略できず、見落としやすい項目です。新しいテンプレートはトリガー行がまったくない状態で作成されるため、これをオンにするまで実行ページに一覧表示されず、開始するものもありません。このスイッチはトリガーを即座に書き込みます。別の保存を待ちません。
同じスイッチは、エディターのヘッダーにある手動実行の背後にもあります。そこでは、テンプレートが宣言した入力と並んで表示されます。
ステップ 5: 実行する
「ステップ 5: 実行する」というセクション- サイドバーでパイプラインをクリックします
- ヘッダーのパイプラインを実行をクリックします
- 左のレールで
code_quality_checkを選びます - フォームのパイプラインを実行をクリックします — このテンプレートは入力を宣言していないため、入力するものはありません
チェックポイント。 実行が開始されたことをトーストが知らせ、Control Center が実行の詳細を開きます。
エンジンは実行レコードを作成し、トリガーを完了し、ステップをスケジュールし、エージェントをディスパッチし、終端センチネルへの入力ブランチが完了した時点で実行を完了します。
ステップ 6: 結果を確認する
「ステップ 6: 結果を確認する」というセクション実行内のステップをクリックして、その詳細パネルを開きます:
- 開始と終了のタイムスタンプ、そして所要時間
- 入力: ステップに渡されたステート
- 出力: ステップが生成したもの — ここではエージェントの応答
- エージェントのアクティビティ、ステップが実行した会話へのリンク付き
チェックポイント。 ステップが完了と表示され、その出力にエージェントのレビューが入っています。
ステップをさらに追加する
「ステップをさらに追加する」というセクションノードを追加するには、左側のノードライブラリから項目をキャンバスにドラッグするか、ノードのすぐ後ろでステップを追加(+)を押します。ノードの出力ポートから別のノードへドラッグすると接続できます。または、新しいノードを選択し、Triggers from でその上流ステップにチェックを入れます。
終端ノードは描画されず、選択もできません。エディターはそれを到達可能なすべてのシンクに再接続するため、用意された Step の後に追加したノードも実行されます。
テンプレートを作成し、もとからあるプロンプトエージェントノードを設定して保存し、手動で実行できるようにし、実行を開始して、ステップの入力と出力を確認しました。
パイプラインはこれよりはるかに大きくなります — 条件付きルーター、並列ブランチ、ジョインノード、For each のファンアウト、人間による承認ゲート — しかし形は変わりません。DAG 内のステップがステートを受け渡します。
次: Slack をワークスペースにブリッジする。このシーケンスの最後のチュートリアルです。
- パイプライントリガーを設定 — イベントやスケジュールからパイプラインを開始します
- パイプラインと自動化 — 背後にあるモデル
- パイプラインステップ — すべてのステップ種別