> ## 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.

# 创建与编辑

> 创建工作流，在画布上添加步骤，配置启动输入，并使用步骤设置

# 创建与编辑

当你想在仪表板内构建多步骤流程时，请使用工作流编辑器。你从 **Workflows** 列表开始，打开画布，在 **Start** 与 **End** 之间添加步骤，并通过 **Step settings** 配置每个步骤。

## 概述

工作流构建器是 **Workflows** 下基于画布的编辑器。每个工作流都以 **Start** 和 **End** 开始，你可以通过 `+` 连接器在两者之间添加步骤。

你可以添加步骤、编辑其设置、添加 **Start** 输入、运行单个步骤、复制步骤、删除步骤，并在迭代时禁用或启用步骤。

## 如何创建工作流？ <a href="#create-workflow" id="create-workflow" />

在侧边栏中打开 **Workflows**。

点击 **Add Workflow**。

为工作流输入一个名称。如果你的工作区使用了类别，你也可以选择一个类别。

点击 **Save** 打开工作流编辑器。

{/* Add screenshot: Add Workflow modal */}

## 如何在画布上添加步骤？ <a href="#add-step" id="add-step" />

在编辑器中打开工作流。

从默认画布开始，顶部是 **Start**，底部是 **End**。

点击两个节点之间的 `+` 连接器。这会打开 **Search steps...**。

选择你想插入的步骤。当前的选择器将步骤按类别分组，例如 **AI**、**Research**、**Microsoft**、**Generation**、**Utilities** 和 **Integrations**。

选择步骤后，Fetch Hive 会将其插入到工作流中，并为该新步骤打开 **Step settings**。

{/* Add screenshot: Search steps dialog showing grouped step categories */}

## 如何配置启动输入和步骤设置？ <a href="#configure-workflow" id="configure-workflow" />

点击 **Start** 打开启动步骤设置。

使用 **Add Input** 定义工作流运行应接受的变量。对于每个输入，设置显示名称、变量名称、输入类型以及是否必填。

启动输入可以是 **Text** 或 **Array**。**Text** 用于单个值。当调用方需要传入 JSON 数组（例如 `["one", "two"]` 或 `[{"url":"https://example.com"}]`）时，请使用 **Array**。

启动输入还可以包含一个可选的 **Example value**。示例仅在设计时使用：它们帮助编辑器在任何工作流运行存在之前预览变量并连接后续步骤，但它们不是默认的运行值，也不会消耗任务额度。

使用 **Example value** 旁边的示例输入操作来加载已保存的示例或保存当前示例以便重复使用。

对于数组输入，请使用与调用方将提供的形状匹配的示例 JSON 数组。例如，`[{"name":"Fetch Hive","url":"https://fetchhive.com"}]` 让 **Iteration** 步骤可以使用 `{{companies}}` 作为其迭代器，并让迭代内部的步骤在工作流运行之前就能引用诸如 `{{company_loop.item.url}}` 等字段。

点击画布上的任意非终止步骤，可为该步骤打开 **Step settings**。

具体设置取决于步骤类型。例如，**AI Prompt** 在同一面板中暴露其提示消息、模型参数、响应格式选项和失败行为。当 **AI Prompt** 步骤使用 Anthropic Claude 模型时，其模型参数还包括 **Prompt Cache**，可选 **Disabled**、**5 minutes** 和 **1 hour**。

如果某个 AI 驱动的工作流步骤使用了已停用的模型，步骤设置会显示警告，且步骤测试或工作流运行会因 `model_deprecated` 而被阻止。请在运行工作流之前在该步骤上选择一个可用的模型。

某些只读步骤可以同时运行多个版本：Google Search、Google News、Google AI Mode、Google AI Overview、Bing Search、Exa Search、Exa Similar、Copilot Search、Website Scrape 和 RSS Feed。在步骤设置中打开 **Parallelization**，添加你想要运行的版本，并仅设置版本之间需要不同的字段。

当工作流运行时，Fetch Hive 会等待所有版本完成，并按版本顺序将步骤输出存储为数组。后续步骤可以使用与其他步骤输出相同的变量模式引用该数组，例如 `{{step_2.output}}`。

**Iteration** 体内的步骤不支持并行化。如果你需要多个搜索或抓取版本，请在迭代之前运行该并行化步骤并对其输出进行迭代，或在循环内保留非并行的步骤。

你的套餐控制单个步骤可以并行运行的版本数量。如果某个版本失败且该步骤设置为 **Continue**，Fetch Hive 会从输出数组中省略该失败版本，并按顺序保留成功的版本。如果没有任何版本成功，则输出为空数组。如果该步骤设置为 **Terminate Workflow**，则工作流会停止。

对于 Iteration 步骤，迭代自身的失败行为控制循环体。如果迭代设置为 **Continue**，则失败的体步骤会停止该项并在迭代输出中为该项留下 `null`，即使体步骤本身被设置为 **Terminate Workflow**。如果迭代设置为 **Terminate Workflow**，任何失败的体步骤都会停止工作流。

当你需要决定步骤错误后工作流应停止还是继续时，请使用 **When the step fails**。

{/* Add screenshot: Step settings sheet for an AI Prompt step */}

## 如何编辑、复制、禁用或删除步骤？ <a href="#manage-step" id="manage-step" />

将鼠标悬停在画布上的步骤节点上以显示步骤操作。

当你想从画布测试该步骤时，请使用 **Run Step**。

使用 **Disable step** 或 **Enable step** 控制该步骤是否参与工作流。

使用 **Duplicate step** 在工作流中插入当前步骤的副本。

如果要删除步骤，请使用 **Remove step**。Fetch Hive 会在删除前请你确认。

{/* Add screenshot: Remove step confirmation dialog */}

另请参阅：[测试与迭代](./testing-and-iteration) 和 [发布与版本管理](./publishing-and-versioning)
