> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Kit

> 通过已连接的帐户在 Kit 中管理订阅者、标签、表单、广播和自定义字段。

# Kit

当你需要在 Kit 中管理订阅者、标签、表单、广播或自定义字段时，请使用此应用。它非常适合受众更新、活动设置和列表整理。

## 配置

| 选项 | 必需 | 说明 |
| - | - | - |
| 名称 | 否 | 工作流画布中此步骤的标签。 |
| Authentication | 是 | 此步骤要使用的已连接 Kit 帐户。 |
| Action | 是 | 要执行的 Kit 操作（例如 Get Account、Get Creator Profile、Create Subscriber、Get Subscriber）。 |
| Arguments | 是 | 根据操作的 schema 生成的各操作表单字段。每个文本字段都有一个 **Insert Variable** 按钮，可用于注入 `{{placeholder}}` 值。还提供一个 **Raw JSON** 选项卡，供高级用法使用。 |
| When the step fails | 否 | 控制当此步骤失败时，工作流应 **Terminate Workflow** 还是 **Continue**。 |

在你配置此步骤之前，请通过登录流程在你工作区的 **Integrations** 中连接 Kit。如果没有可用的有效连接，该步骤会显示一个警告，并提供指向 **Integrations** 的链接，而不是帐户选择器。

## Arguments form

当你选择一个操作时，**Arguments** 部分会渲染一个由该操作输入 schema 驱动的表单。引用现有记录的字段会包含下拉选择器。

当你更愿意手动编写完整的参数对象时，请切换到 **Raw JSON** 选项卡。任一选项卡中的更改都会保持同步。

## Common actions

| 操作 | 说明 |
| - | - |
| **Get Account** | 获取当前帐户详情。 |
| **Get Creator Profile** | 获取已连接帐户的创作者资料。 |
| **Create Subscriber** | 通过电子邮件地址创建或更新订阅者。 |
| **Get Subscriber** | 通过 ID 获取订阅者。 |
| **List Subscribers** | 列出帐户中的订阅者。 |
| **Update Subscriber** | 通过 ID 更新现有订阅者。 |
| **Create Tag** | 创建新标签。 |
| **List Tags** | 列出帐户中的标签。 |
| **Tag Subscriber** | 按 ID 为订阅者分配标签。 |
| **Tag Subscriber by Email** | 按电子邮件地址为订阅者分配标签。 |
| **Untag Subscriber by Email** | 从订阅者的电子邮件地址移除标签。 |
| **Create Broadcast** | 创建新的电子邮件广播。 |
| **Get Broadcast** | 通过 ID 获取广播。 |
| **Get Broadcast Stats** | 通过 ID 获取广播统计信息。 |
| **List Broadcasts** | 列出帐户中的广播。 |

删除记录等破坏性操作在工作流操作选择器中不可用。

## 输出

此步骤会将 Kit 响应存储为步骤输出。响应的结构取决于操作。

在后续步骤中使用完整输出引用：

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## 示例

1. 打开 **Integrations**，如果你还没有这样做，就连接 Kit。
2. 在你的工作流中添加一个 **Kit** 步骤。
3. 在 **Authentication** 中选择一个已连接帐户。
4. 在 **Action** 中选择 **Get Account**。
5. 填写必填字段。对任何字段值，使用 **Insert Variable** 引用前面步骤的输出。
6. 在步骤标题中点击 **Run** 以测试该操作，然后在 **Output** 中查看返回的有效负载。

## 用例

### 添加并标记订阅者

1. Create Subscriber
2. Tag Subscriber by Email
3. Get Subscriber

### 准备广播

1. List Email Templates
2. Create Broadcast
3. Get Broadcast Stats

### 组织表单注册

1. List Forms
2. Add Subscriber to Form
3. List Form Subscribers

## 注意事项

* 此步骤依赖于你工作区中已连接的 Kit 集成。
* 工作流操作选择器会显示一组精选操作。拥有 Kit 工具的代理可以使用更多操作。
* 登录界面可能会显示第三方授权品牌标识。

## 将 Kit 用作代理工具

你也可以在 **Agent Editor** 中将 Kit 添加为工具。打开该代理，点击 **Add tool**，然后选择 **Kit**。在工具设置面板中，选择代理应使用的已连接帐户。代理会在相关于对话时调用 Kit 操作。

另请参阅：[Integrations](https://docs.fetchhive.com/zh/workspace/integrations.md)、[Creating and Editing](https://docs.fetchhive.com/zh/workflows/creating-and-editing.md) 和 [Testing and Iteration](https://docs.fetchhive.com/zh/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.