---
name: llm_gateway
when: 'Token 预算, LLM 调用, 成本控制, 降级'
scope: ['*']
products:
  - '*'
id: ka-pattern-llm_gateway
asset_kind: pattern
lifecycle_status: active
authority: supporting
routes:
  - '*'
primary_triggers:
  - Token 预算
  - LLM 调用
  - 成本控制
  - 降级
priority: P2
specificity: 3
version: 1.1.0
last_reviewed: '2026-06-01'
consumes: []
emits: []
secondary_triggers: []
negative_triggers: []
type: pattern
stages: ["*"]
owner_mechanism_id: mc-engine-runtime
---

## 决策规则

- H1 handler 返回 h1_advisory warning，任务仍继续进入 executing
- 预算耗尽是 warning 不是 hard fail，不应阻断任务
- heartbeat 机制定期检查预算使用率
- 预算耗尽时建议降级到更便宜的模型（advisory 报告）

## 验收项

- [AC-01] H1 handler 返回 advisory 不阻断
- [AC-02] heartbeat 正常触发
- [AC-03] 预算超限产生 warning
- [AC-04] 预算使用率可观测

## 何时使用

advisory: 预算耗尽是 warning 不是 hard fail，不应阻断任务

## 是否 hard block

否。此能力为 advisory 状态，违规仅产生 advisory 警告，不阻断流程。

## 证据要求

- H1/H4 handler 测试通过
- heartbeat 测试通过
-

## 人工确认/降级边界

- 此能力可被开发者决策覆盖
- 升级到 enforced 需满足 promotion_conditions 并通过 lifecycle_test_files 测试
- 降级/禁用需经 sf_capability_update + 人工确认
