Sim

连接标签

连接标签是连接块中可用数据的可视化表示,提供了一种在工作流中引用块之间数据和前置块输出的简便方式。

什么是连接标签?

连接标签是块连接时出现的交互元素。它们表示可以从一个块流向另一个块的数据,并允许您:

  • 可视化源块中可用的数据
  • 在目标块中引用特定的数据字段
  • 在块之间创建动态数据流

连接标签使您可以轻松查看前置块中可用的数据,并在当前块中使用这些数据,而无需记住复杂的数据结构。

使用连接标签

在工作流中使用连接标签主要有两种方式:

拖放操作

点击连接标签并将其拖动到目标块的输入字段中。一个下拉菜单会显示可用的值。

  1. 将鼠标悬停在连接标签上以查看可用数据
  2. 点击并拖动标签到输入字段
  3. 从下拉菜单中选择特定的数据字段
  4. 引用会自动插入

尖括号语法

在输入字段中键入 <>,即可看到前置块中可用连接值的下拉菜单。

  1. 点击任意输入字段,选择您想使用的连接数据
  2. 键入 <> 以触发连接下拉菜单

  3. 浏览并选择您想引用的数据
  4. 继续输入或从下拉菜单中选择以完成引用

标签语法

连接标签使用简单的语法来引用数据:

<blockName.path.to.data>

其中:

  • blockName 是源块的名称
  • path.to.data 是特定数据字段的路径

例如:

  • <agent1.content> - 引用 ID 为 "agent1" 的块中的内容字段
  • <api2.data.users[0].name> - 引用 ID 为 "api2" 的块中数据字段的用户数组中第一个用户的名称

动态标签引用

连接标签在运行时进行评估,这意味着:

  1. 它们始终引用最新的数据
  2. 它们可以在表达式中使用,并与静态文本结合
  3. 它们可以嵌套在其他数据结构中

示例

// 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

在数字上下文中使用连接标签时,请确保引用的数据实际上是数字, 以避免类型转换问题。

连接标签