---
document_id: agent.error.query_too_broad
schema_version: 1
---

<!-- Generated by scripts.build_agent_guide; do not edit. -->

# query_too_broad

Recovery / 恢复动作: `narrow_query`
Billing / 计费: `not_charged`

- Cause / 原因: The conservative physical row or byte estimate is too large to admit safely, regardless of credits or result LIMIT. / 保守估算的物理扫描行数或字节数过大；无论 Credits 或结果 LIMIT 如何，都不能安全准入。
- Agent: Reduce the time range, add exact filters, or remove high-cardinality grouping; do not split calls merely to bypass the guard. / 缩短时间范围、增加精确筛选或移除高基数分组；不得仅为绕过门禁而拆分调用。
- User / 用户: Narrow the requested analysis scope. / 缩小分析范围。