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

# 运行任务

> 使用目标、可选来源、实时状态和可复用 blueprint 启动 Hive Agent 运行

Hive Agent 运行从 blueprint 开始,并添加本次执行的目标、来源、状态、追踪、成本、节点和最终结果。

## 如何启动运行? <a href="#start-run" id="start-run" />

在编辑器中打开 Hive Agent。

点击 **Start Run**。

输入必填的 **Run objective**。

查看提示。Hive Agents 可能运行数分钟到数天,复杂运行可能快速产生费用。

点击 **Start Run**。

Fetch Hive 会启动运行、关闭对话框,并在编辑器中打开 **Run Console**,方便你不离开页面就查看进度。

## 运行结束时能否收到提醒? <a href="#run-finished-notification" id="run-finished-notification" />

在 **Start Run** 中开启 **Notify me when this run finishes**,可为单次运行覆盖 blueprint 默认值。开关初始值来自 **Notifications** 中的保存项。

投递使用与预算提醒相同的 **Send via**、**Email address** 和 **Telegram account** 设置。见 [Notifications](./notifications)。

## 如何附加来源? <a href="#sources" id="sources" />

在 **Start Run** 中打开 **Sources**,点击 **Add Source**。

| 来源类型                    | 作用                                |
| ----------------------- | --------------------------------- |
| **Website**             | 抓取一个 URL 的内容                      |
| **File Upload**         | 上传 PDF、Word、文本、markdown、CSV 或表格文件 |
| **Knowledge Base**      | 使用一个活跃 Knowledge Base 的全部可搜索内容    |
| **Knowledge Base Item** | 使用一个已有 Knowledge Base item        |

来源属于单次运行,不会成为 blueprint 默认值。

## 来源准备会做什么? <a href="#source-preparation" id="source-preparation" />

来源准备让 planner、executor 和 verifier 可以使用运行来源。

Website 和 file 来源会在 **PLAN** 前处理。如果必需来源失败,运行会在计划前失败。

## 需要什么设置? <a href="#setup-required" id="setup-required" />

workspace 必须有活跃的 **Default** API key 才能从 dashboard 启动 Hive Agent。缺少时,打开 [API Keys](../workspace/api-keys),创建或启用 key,并标记为 Default。

## 如何跟踪正在运行的任务? <a href="#track-running-task" id="track-running-task" />

运行状态会实时更新:准备来源、planning、executing、verifying、retrying、composing、预算检查和最终完成。

启动后,Fetch Hive 会在编辑器中打开 **Run Console**,无需离开页面即可跟踪进度。也可以打开 **Hive Agents** > **Logs** 查看历史表格;选择一次运行会打开同一个控制台。

在 Run Console 中,**Pass** 表示当前执行和验证轮次。**Attempts** 是某个具体节点在这些 pass 内记录的执行或验证尝试。Compose attempts 会在节点工作验证通过后单独计算。

需要详细调试时,从 Run Console 使用 **View technical trace** 打开技术详情页,查看 trace spans、子请求、耗时、成本、tokens、输入、输出和 metadata。

## 可以重新运行同一个 Hive Agent 吗? <a href="#rerun" id="rerun" />

可以。用同一个 blueprint 再启动一次运行,输入新的 **Run objective** 或不同来源。

另请参阅: [Logs](./logs)、[Notifications](./notifications) 和 [Troubleshooting](./troubleshooting)。