> ## 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 的设置、来源、预算、取消、追踪和成本问题

当 Hive Agent 无法启动、暂停、来源准备失败或日志不清楚时,使用本页。

## 运行提示需要 Default API key <a href="#default-api-key" id="default-api-key" />

dashboard 启动的运行需要活跃的 **Default** API key。打开 [API Keys](../workspace/api-keys),创建或重新启用 key,并设为 Default。

## 来源准备失败 <a href="#source-preparation-failed" id="source-preparation-failed" />

检查 URL 是否可访问、文件格式是否受支持、Knowledge Base 是否活跃、item 是否仍存在、文件是否属于同一 workspace。

打开详情并查看来源错误。

## 运行被 blocked <a href="#blocked" id="blocked" />

blocked 运行通常需要预算批准或达到了预算 gate。检查 **Budget Settings**,然后批准或拒绝链接。即使所有节点已经验证通过,运行也可能在 Compose 阶段因预算而 blocked。

## 运行在 max passes 后失败 <a href="#max-passes" id="max-passes" />

运行可能因 **Max repeat passes** 或最终编写在 **Max compose attempts** 后仍未通过验证而停止。读取 verifier 或 compose check 原因,再调整 **PLAN**、**EXECUTE**、**VERIFY**、**REPEAT** 或 **COMPOSE**。

如果节点已经验证通过但 Compose 失败,打开最终响应区域并查看 Compose 问题。已验证节点输出仍会作为支持详情保留,但最终编写响应没有通过组装检查。

只有在最终编写前接受部分已验证节点输出时,才使用 **Best effort**。

## 运行已取消 <a href="#cancelled" id="cancelled" />

hard stop 会快速取消。partial result 会停止新工作、让已开始工作完成,并保留已验证输出,即使状态是 `cancelled`。如果在 Compose 期间取消,当前 compose attempt 可能会完成,但不会再安排新的 Compose attempt。

## 追踪详情延迟或不完整 <a href="#trace-delay" id="trace-delay" />

子 AgentRun 追踪可能晚于父阶段出现。子运行完成后刷新详情。

## 运行成本高于预期 <a href="#cost-high" id="cost-high" />

检查 **Max Concurrent Nodes**、pass 数、**Max compose attempts**、来源、节点数量、模型、工具调用、反复重试的节点和最终响应编写重试。

另请参阅: [Budget Approval](./budget-approval) and [Logs](./logs).
