案例研究:受监管内容审阅(HITL)¶
基于金融服务营销工作流的匿名合成案例。非特定客户部署。
问题¶
某区域银行营销团队希望用 LLM 起草产品邮件与社媒帖子。合规要求在任何面向客户的文本存储或发送前,必须人工签字批准。现有工具要么:
- 缺少审计轨迹,或
- 需要在 LangGraph/CrewAI 上自建中断逻辑。
HiveFlow 方案¶
架构¶
flowchart LR
U[Marketing user] --> S[HiveFlow Studio]
S --> A[Agent plan-only]
A --> P[Plan: research → draft → compliance → publish]
P --> H[HITL gate: compliance]
H --> R[Reviewer in Approvals UI]
R --> E[execute-plan]
E --> BB[Audited blackboard]
BB --> Rep[Replay / Analytics]
配置¶
HIVEFLOW_RUNTIME=agent
HIVEFLOW_PLAN_HITL=true # plan review before execution
# Production: real LLM providers; CI: HIVEFLOW_AGENT_ECHO_LLM=true
工作流¶
- Plan-only — Agent 提出
research → draft → compliance_review → final_answer。 - Plan HITL — 合规官在 Approvals 中编辑计划 JSON(例如添加必填
legal_check节点)。 - Execute-plan — 已批准图执行;
compliance_review节点带 per-node HITL 与草稿载荷。 - Audit — 每次黑板写入与 gate 决策按
intent_id索引;监管人员使用 Replay 页面。
成果(内部试点指标)¶
| 指标 | 之前(手工链路) | 使用 HiveFlow |
|---|---|---|
| 草稿到批准中位时间 | ~2 天 | ~4 小时 |
| 检查用审计导出 | 电子表格 + 邮件 | Blackboard audit + Replay JSON |
| 工程师维护 | 自建 Flask + 脚本 | Studio + Core API |
试点 n≈12 个工作流;非公开发布基准。
为何不单用 LangGraph?¶
LangGraph 支持 interrupt,但该团队还需要:
- 供非工程师审阅者的 Studio Approvals
- 草稿内容的加密黑板键
- 入站(PII 模式)与出站(禁止声明)的双重 guards
HiveFlow 无需单独的 LangSmith 式托管层即可提供上述能力。
本地复现¶
- HITL 指南 +
examples/03_hitl_approval.py - Studio Agent 模式,设置
HIVEFLOW_PLAN_HITL=true - 走通 Approvals → execute → Replay