提示词工程 -HIL 场景与洞见

# ============================================================================# 静态HIL实现：强制确认机制（悬崖边保护）# ============================================================================
def create_hybrid_hil_graph():    """创建混合架构的HIL图"""    graph = StateGraph(HILTransferState)        # 添加节点    graph.add_node("user_confirm", user_confirmation_node)      # 静态HIL节点    graph.add_node("process_user_confirm", process_user_confirmation)    graph.add_node("agent_processing", agent_processing_node)    graph.add_node("human_review", human_review_node)           # 动态HIL节点    graph.add_node("execute", execute_transfer_node)        # 🔑 核心机制：interrupt_before实现HIL暂停    # 这两个节点会自动暂停，等待人类输入    compiled_graph = graph.compile(        checkpointer=memory,        interrupt_before=["user_confirm", "human_review"]  # 静态+动态HIL中断点    )    return compiled_graph
def user_confirmation_node(state: HILTransferState) -> HILTransferState:    """静态HIL节点：无条件强制确认"""    # 🛑 静态HIL特征：所有转账都必须经过此节点    # 📋 显示确认信息，然后图会自动暂停等待用户输入    confirm_msg = f"""⏸️ 静态HIL - 用户确认💰 金额：¥{state['amount']:,.2f}🏦 路径：{state['from_account']} → {state['to_account']}📊 类型：{'大额转账' if state['amount'] > 100000 else '普通转账'}"""        state["messages"].append(SystemMessage(content=confirm_msg))    return state  # 返回后图会在interrupt_before处暂停
# ============================================================================# 动态HIL实现：智能求助机制（渴了求助）# ============================================================================
def agent_processing_node(state: HILTransferState) -> HILTransferState:    """Agent业务处理节点：智能判断是否需要人工审核"""    agent = create_business_agent()    message = f"请处理转账：从账户 {state['from_account']} 转账 ¥{state['amount']:,.2f} 到账户 {state['to_account']}，完成初始化和风险评估"    result = agent.invoke({"messages": [HumanMessage(content=message)]}, agent_config)        # 🤔 动态HIL触发逻辑：Agent基于工具返回结果智能判断    if result and "messages" in result:        for msg in result["messages"]:            if hasattr(msg, 'content'):                content = str(msg.content)                # 🚨 关键判断：Agent通过工具调用结果决定是否需要人类协作                if "需要人工审核: 是" in content:                    state["requires_human_review"] = True   # 标记需要动态HIL                elif "需要人工审核: 否" in content:                    state["requires_human_review"] = False  # 跳过动态HIL    return state
@tooldef perform_risk_assessment(session_id: str) -> str:    """Agent风险评估工具：动态HIL的触发源"""    session = transfer_sessions[session_id]    amount = session["amount"]        # 🔍 Agent智能评估逻辑    risk_score = 0    if amount > 500000:      # 50万以上高风险        risk_score += 3    elif amount > 100000:    # 10万以上中风险          risk_score += 2        # 🎯 动态HIL触发条件：基于量化标准而非Agent"感觉"    requires_review = risk_score >= 4 or (risk_score >= 2 and random.choice([True, False]))        # 📤 返回结构化结果，供Agent节点解析判断    result = f"风险评估完成 | 风险等级: {'HIGH' if risk_score >= 4 else 'MEDIUM' if risk_score >= 2 else 'LOW'}"    result += f" | 需要人工审核: {'是' if requires_review else '否'}"        return result
def route_after_agent_process(state: HILTransferState) -> Literal["human_review", "execute"]:    """智能路由：基于Agent分析结果决定流程走向"""    # 🔀 动态HIL路由逻辑：只有Agent标记需要时才触发人工审核    return "human_review" if state.get("requires_human_review", False) else "execute"
# ============================================================================# HIL实现的核心洞察# ============================================================================# 🛑 静态HIL = 预定义强制中断：所有危险操作都必须暂停等待确认# 🤔 动态HIL = 智能条件中断：Agent基于量化标准主动寻求人类协作# 🔑 关键机制 = interrupt_before：LangGraph自动暂停，等待人类输入后继续

💰 转账 ¥200万⏸️ 静态HIL: 请确认 → 用户输入"确认"🤖 Agent评估: 检测高风险⏸️ 动态HIL: 需要审核 → 审核员"批准"✅ 转账成功

# 智能反馈助手 - 动态HIL机制设计# 基于"爬山女儿渴了求助"的智慧
## 动态HIL：信息收集智能中断机制
### 核心设计：预定义信息完整性检查
information_completeness_check: |  对于每个反馈类型，Agent必须检查以下信息完整性：    故障反馈信息检查清单：  🔴 必填字段（缺失必须中断）：  - 异常现象: [具体发生了什么]  - 使用环境: [设备/系统/功能]    🟡 重要字段（缺失时智能引导）：  - 操作流程: [遇到问题时正在进行什么操作]  - 发生时间: [问题发生的具体时间]  - 影响范围: [问题影响的用户范围]
### 动态HIL触发逻辑（智能评估）
dynamic_assessment_logic: |  每次用户输入后，Agent按以下逻辑评估：    第1步：智能分类识别  if 用户描述包含["崩溃", "错误", "无法使用", "异常"]:      反馈类型 = "故障反馈"      加载对应检查清单    第2步：信息完整性评估  缺失_必填字段 = []  缺失_重要字段 = []    for 字段 in 必填字段列表:      if not 从用户描述中提取到(字段):          缺失_必填字段.append(字段)    第3步：触发HIL决策  if len(缺失_必填字段) > 0:      触发强制信息收集HIL()      return 等待用户补充  elif len(缺失_重要字段) > 0:      触发智能引导HIL()      return 建议用户补充  else:      继续工单创建流程()

🤔 我理解您遇到了软件问题，为了给您提供精准的技术支持，我需要补充一些关键信息。
📊 当前已知信息：✅ 问题类型：软件故障
📋 还需要以下关键信息才能为您创建工单：
┌──────── 📋 故障信息表单 ────────┐│ ⚠️ 异常现象: ________________  ││    示例：软件崩溃、按钮无响应、数据丢失  ││ 💻 使用环境: ________________  │  │    示例：PS2扫描仪、移动APP、网页版    ││                                    ││ 💡 【重要信息】以下信息有助于更快解决：││ 🕐 发生时间: ________________  ││    示例：今天上午10:30、昨天下午     ││ ⚙️ 操作流程: ________________  ││    示例：点击扫描按钮后、登录时       │└────────────────────────────────┘
请补充红色必填信息，这样我能为您创建准确的技术工单。您也可以提供蓝色重要信息，帮助技术团队更快定位问题。

✅ 信息收集完整，正在为您创建技术工单...
🎫 【工单创建成功】┌─────────────────────────────────────┐│ 📋 工单标题: 扫描仪软件点击扫描按钮卡死 ││ 🔖 问题类型: 故障                   ││ ⚡ 紧急级别: P2中优先级              ││ ⏱️ 处理承诺: 24小时内响应           ││ 👤 负责人: 技术支持部               ││ 🆔 工单编号: HD-20240315-001        ││ 📊 处理状态: 进行中                 │└─────────────────────────────────────┘
💡 我们将持续跟进处理进度并及时反馈。