Claude API新功能翻车：AskUserQuestion超时静默失败，开发者实测“问了白问”

Anthropic最近给Claude的官方API加了个AskUserQuestion功能，想让模型在多轮对话里能主动向用户提问来澄清需求。但开发者一测就发现了问题：默认60秒超时后，它会静默失败，不返回任何错误或提示，用户根本不知道自己的回答已经被丢弃了。这种“问了白问”的现象在Agent开发场景里可能引发连锁反应，社区里已经冒出不少相关讨论。

功能初衷：让AI学会主动提问

AskUserQuestion想解决的是长对话中的上下文漂移。以前模型只能被动等用户输入，需求一模糊就容易产生幻觉或错误假设。新功能允许Claude在生成过程中主动插入问题，等用户确认后再继续，理论上能提升任务完成的准确率。

从API设计角度看，这个思路挺合理。在Agent开发中，模型经常要处理“帮我整理这份文档”这种模糊指令——整理成什么格式？保留哪些字段？删什么内容？主动提问能把模糊需求变成明确任务，减少返工。

技术实现：超时机制的致命细节

问题出在超时处理逻辑上。根据开发者实测和API文档，AskUserQuestion的工作流程大致是这样：

# 简化示意
def ask_user_question(question, timeout=60):
    # 发送问题给用户
    send_to_user(question)
    
    # 等待用户回答
    response = wait_for_response(timeout)
    
    if response is None:
        # 默认行为：静默返回None，不抛异常
        return None
    
    return response

关键问题在于：当response是None时，函数静默返回，调用方没收到任何错误信号。如果上层代码没显式检查返回值，就会继续执行后续逻辑——这时候模型既没拿到用户回答，也没收到“超时”的明确信号，处于一种信息真空状态。

实测场景：Agent开发中的灾难

想象一个文档处理Agent的典型场景：

Agent: 我发现这份报告有3个版本的摘要，你希望保留哪个？
[等待用户回答...]
[60秒后]
Agent: (继续执行，但不知道用户选了哪个)
Agent: 我已按"最新版本"完成整理。

用户可能正在仔细对比三个版本的差异，60秒后回来发现Agent已经自作主张完成了任务。更糟的是，用户不知道自己的回答被丢弃了，可能以为Agent理解了自己的意图——直到查看结果才发现完全不对。

这种静默失败在以下场景中风险极高：

• 金融数据处理：用户被问及“是否包含未审计数据”，超时后Agent可能默认包含
• 法律文档审核：用户被问及“是否保留敏感条款”，超时后可能默认保留
• 代码生成：用户被问及“使用Python还是JavaScript”，超时后可能生成错误语言的代码

社区反馈与临时解决方案

开发者社区已经提出几种规避方案。最直接的做法是在调用方代码里显式处理超时：

def safe_ask_user(question, timeout=60):
    response = claude.ask_user_question(question, timeout=timeout)
    
    if response is None:
        # 明确告知用户发生了什么
        return {"status": "timeout", "message": "问题超时未回答，请重新选择"}
    
    return {"status": "success", "answer": response}

另一种方案是缩短超时时间并配合重试机制：

MAX_RETRIES = 3
TIMEOUT = 30  # 缩短到30秒

for attempt in range(MAX_RETRIES):
    response = claude.ask_user_question(question, timeout=TIMEOUT)
    if response is not None:
        break
    # 主动告知用户
    send_notification("问题超时，请尽快回答")

对于Agent框架开发者，更稳健的做法是在设计阶段就避免依赖这种不确定的交互模式。龙虾（Lobster）这类成熟Agent框架通常采用显式的状态机设计，把“等待用户输入”作为一个明确的状态，超时后会触发预定义的回退逻辑，而不是静默继续。

API设计的启示：明确反馈比智能更重要

这件事暴露了API设计中一个常见误区：过度追求功能智能，却忽视了错误处理的明确性。一个好的API应该遵循“明确失败”原则——当事情出错时，调用方应该立即知道发生了什么，而不是去猜。

对于Claude团队，建议的改进方向包括：

1. 超时后返回明确的TimeoutError异常，而不是None
2. 在响应中包含元数据，比如{status: "timeout", elapsed: 60}
3. 提供可配置的超时后行为：抛异常、返回默认值、或触发重试

对于开发者，在使用任何涉及用户交互的API时，都应该假设“用户可能不回答”。在Agent开发中，这意味着每个提问点都需要有明确的回退策略——要么重试，要么使用安全的默认值，要么终止任务并清晰报告原因。

行业展望：Agent交互设计的成熟之路

AskUserQuestion的翻车是Agent开发走向成熟过程中的一个缩影。AI Agent从演示走向生产，交互设计的细节变得至关重要。用户不会像测试工程师那样耐心等60秒，也不会像开发者那样理解“静默失败”的含义。

对于正在构建Agent系统的团队，这件事的启示是：不要依赖API的隐式行为。在关键交互点，始终实现显式的状态检查和错误处理。对于Claude用户，建议暂时避免在生产环境中依赖AskUserQuestion的默认超时行为，或者在调用层增加足够的防护逻辑。

API设计的黄金法则是：让错误显而易见，让成功可预测。当AI开始主动提问时，它必须准备好处理“无人应答”的情况——而且要用用户能理解的方式说出来。