工作流快速入门

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

前提条件

一个 Fetch Hive 工作区
如果你想运行公开的 cURL 示例,需要一个工作区 API 密钥 - 请参阅 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 中显示的措辞一致。

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 块。

下一步

提示词快速入门智能体快速入门

⌘I

​工作流快速入门

​前提条件

​第 1 步：创建工作流

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

​第 3 步：配置该步骤

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

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

​第 6 步：创建部署

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

​下一步