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

# 通知

> 预算暂停与 Hive Agent 运行结束时的邮件和 Telegram 提醒

Hive Agent 可以发送三种 dashboard 提醒。三者共用 blueprint 上的 **Notifications** 投递设置:**Send via**(Email 或 Telegram)、可选 **Email address** 和可选 **Telegram account**。

这些提醒与[公开 API 回调](./invoke-from-code)不同。回调是面向代码集成的 HTTPS webhook。Dashboard 通知是发给在 Fetch Hive 中工作的人的邮件或 Telegram 消息。

## 对比 <a href="#comparison" id="comparison" />

| 提醒类型               | 发送时机                                                                        | 是否 opt-in                 | 消息中的链接                                    |
| ------------------ | --------------------------------------------------------------------------- | ------------------------- | ----------------------------------------- |
| **Budget hint 审批** | 在 conservative 或 balanced strictness 下越过 **Budget Hint** 并暂停                | 暂停时始终发送                   | 指向[预算审批](./budget-approval)页面的 magic link |
| **Hard cap 审批**    | 达到 **Budget Cap** 且 **When hard cap is reached** 为 **Ask for approval** 时暂停 | 暂停时始终发送                   | 同一审批页面                                    |
| **运行结束**           | 运行进入 `completed`、`failed` 或 `cancelled`                                     | 默认关闭;可按 blueprint 或单次运行启用 | 指向 [Logs](./logs) 中该运行的深链接                |

Fetch Hive 目前不会为 Hive Agent 运行创建应用内铃铛通知。

## 接收人 <a href="#recipients" id="recipients" />

**预算审批** 发给 Hive Agent 创建者(若其仍是账户成员),否则发给账户所有者。

**运行结束** 提醒优先发给启动该次 dashboard 运行的用户。若运行没有关联用户(例如来自公开 API),则回退到相同的创建者 → 账户所有者规则。

若在 **Notifications** 中设置了 **Email address**,提醒会发到该地址;否则使用解析出的接收人账户邮箱。

## 配置投递 <a href="#configure-delivery" id="configure-delivery" />

打开 Hive Agent 编辑器,点击编辑器控制栏中的铃铛按钮打开 **Notifications**。

* **Notify when run finishes** — 运行结束提醒的 blueprint 默认值(默认关闭)
* **Send via** — **Email** 或 **Telegram**
* **Email address** 或 **Telegram account** — 可选投递目标

若选择 **Telegram** 但没有可用连接,Fetch Hive 会回退到 email。

[Creating and Configuring](./creating-and-configuring) 说明 Budget Settings 和 Notifications 控件。

## Budget hint 审批 <a href="#budget-hint-approval" id="budget-hint-approval" />

当运行越过 **Budget Hint (USD)** 且 Fetch Hive 暂停等待人工审核时发送。

常见原因:

* **Budget Strictness** 为 **Conservative**
* **Budget Strictness** 为 **Balanced** — 可能先以降低并发继续,随后再暂停

消息会汇总相对 hint 的花费。审批页上的 **Additional budget (USD)** 为可选。

等待期间状态为 `blocked`。详见 [Budget Approval](./budget-approval)。

## Hard cap 审批 <a href="#hard-cap-approval" id="hard-cap-approval" />

当累计花费加上预计的下一项 gated 工作达到 **Budget Cap (USD)**,且 **When hard cap is reached** 设为 **Ask for approval** 时发送。

消息包含相对 hard cap 的花费、下一项工作预估成本和建议增加的预算。

Hard cap 暂停时,审批页上的 **Additional budget (USD)** 为必填。

## 运行结束 <a href="#run-finished" id="run-finished" />

当运行进入终态时发送:`completed`、`failed` 或 `cancelled`。

当运行因预算处于 `blocked` 等待审批时**不会**发送 — 预算审批提醒已发出。

可在 **Notifications** 中开启 **Notify when run finishes** 作为默认值,或在 **Start Run** 中按单次运行覆盖。见 [Running Tasks](./running-tasks)。

## 不在本文范围 <a href="#not-covered" id="not-covered" />

* **应用内铃铛通知** — Hive Agent 运行目前不产生铃铛通知
* **公开 API 回调** — 见 [Invoke from Code](./invoke-from-code);在 [Logs](./logs) 中查看投递
* **Dashboard 实时更新** — 编辑器和日志页在运行期间通过 websocket 更新,不属于邮件/Telegram 提醒

另见:[Budget Approval](./budget-approval)、[Running Tasks](./running-tasks) 和 [Logs](./logs)。