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

# 工作流快速入门

> 创建工作流、在编辑器中运行、创建工作流部署,并通过公开 API 调用

# 工作流快速入门

在本指南结束时,你将拥有一个在控制台中运行的工作流,以及一个可以从你的应用调用它的公开 cURL 代码片段。

## 前提条件

* 一个 Fetch Hive 工作区
* 如果你想运行公开的 cURL 示例,需要一个工作区 API 密钥 - 请参阅 [API Keys](../workspace/api-keys)

## 第 1 步：创建工作流

在侧边栏打开 **Workflows**，然后点击 **Add Workflow**。

输入 **Name**。如果你的工作区使用类别,你还可以选择 **Category**。点击 **Save** 打开工作流编辑器。

## 第 2 步：添加第一个步骤

在编辑器中,点击 **Start** 和 **End** 之间的 **+** 连接器。

这会打开 **Search steps...**。选择 **AI Prompt** 以最快地完成你的第一个工作流。

新步骤出现在画布上后,点击它打开 **Step settings**。

## 第 3 步：配置该步骤

在 **Step settings** 中添加一条简短指令,让工作流有具体的事情可做。

如果你的工作流需要调用方提供输入,请先在 **Start** 步骤上定义该输入,然后在你的 **AI Prompt** 步骤中引用它。

让第一个版本保持简单。此快速入门不需要 **Copilot**、高级步骤类型或多个分支。

## 第 4 步：在编辑器中运行工作流

点击顶部的 **Run Workflow**。

这会打开 **Run History**。点击 **Start** 以打开 **Start a new Workflow Run**，然后点击 **Start Workflow Run**。

这是 UI 中的两步流程。**Run Workflow** 本身不会立即启动工作流。

## 第 5 步：保存一个命名版本

点击顶部的 **Save Version**。

输入对所做更改的描述,然后保存版本。这会给你一个可以日后参考的命名版本。

## 第 6 步：创建部署

点击 **Deploy**，然后选择 **Create a Deployment**。

输入一个 **Deployment key** 并保存。这会创建你可以通过公开 API 调用的实时工作流部署。

## 第 7 步：复制公开 invoke 代码片段

在侧边栏打开 **More** 并点击 **Get Code**，或从部署页打开 **Code Snippet**。

选择你的 **Deployment** 和 **Variant**。对话框会显示 `POST /v1/workflow/invoke` 的 cURL 代码片段。

公开载荷现在使用 `deployment` 和 `variant`，与 UI 中显示的措辞一致。

```bash theme={null}
curl 'https://api.fetchhive.com/v1/workflow/invoke' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  --data-raw '{
    "deployment": "YOUR_DEPLOYMENT_NAME",
    "variant": "YOUR_VARIANT_NAME",
    "inputs": {
      "topic": "State of enterprise AI in 2026"
    }
  }' \
  --compressed
```

如果你希望 Fetch Hive 立即返回并稍后发送最终结果,UI 在代码片段对话框中支持 **Callback delivery** 切换。这会添加一个带有 `enabled` 和 `callback_url` 的 `async` 块。

## 下一步

* [工作流](../workflows/overview)
* [工作流步骤](../workflows/steps/overview)
* [发布与版本管理](../workflows/publishing-and-versioning)