接続タグは、接続されたブロックから利用可能なデータを視覚的に表現するもので、ブロック間のデータ参照やワークフロー内の前のブロックからの出力を簡単に参照する方法を提供します。
接続タグとは?
接続タグは、ブロックが接続されたときに表示されるインタラクティブな要素です。これらは、あるブロックから別のブロックへ流れるデータを表現し、以下のことを可能にします:
- ソースブロックから利用可能なデータを視覚化する
- 宛先ブロックで特定のデータフィールドを参照する
- ブロック間の動的なデータフローを作成する
接続タグを使用すると、複雑なデータ構造を覚える必要なく、前のブロックから利用可能なデータを簡単に確認し、 現在のブロックで使用することができます。
接続タグの使用方法
ワークフローで接続タグを使用する主な方法は2つあります:
ドラッグ&ドロップ
接続タグをクリックして宛先ブロックの入力フィールドにドラッグします。利用可能な値を示すドロップダウンが 表示されます。
- 接続タグにカーソルを合わせると利用可能なデータが表示されます
- タグをクリックして入力フィールドにドラッグします
- ドロップダウンから特定のデータフィールドを選択します
- 参照が自動的に挿入されます
山括弧構文
入力フィールドに <> と入力すると、前のブロックから利用可能な接続値のドロップダウンが表示されます。
- 接続データを使用したい入力フィールドをクリックします
<>と入力して接続ドロップダウンを表示させます- 参照したいデータを閲覧して選択します
- 入力を続けるか、ドロップダウンから選択して参照を完了します
タグの構文
接続タグはデータを参照するためのシンプルな構文を使用します:
<blockName.path.to.data>ここで:
blockNameはソースブロックの名前path.to.dataは特定のデータフィールドへのパス
例えば:
<agent1.content>- ID「agent1」を持つブロックからコンテンツフィールドを参照<api2.data.users[0].name>- ID「api2」を持つブロックのデータフィールドからユーザー配列の最初のユーザーの名前を参照
動的タグ参照
接続タグは実行時に評価されるため:
- 常に最新のデータを参照します
- 式で使用したり、静的テキストと組み合わせたりできます
- 他のデータ構造内にネストできます
例
// Reference in text
"The user's name is <userBlock.name>"
// Reference in JSON
{
"userName": "<userBlock.name>",
"orderTotal": <apiBlock.data.total>
}
// Reference in code
const greeting = "Hello, <userBlock.name>!";
const total = <apiBlock.data.total> * 1.1; // Add 10% tax数値コンテキストで接続タグを使用する場合は、型変換の問題を避けるために、参照されるデータが実際に数値であることを確認してください。