交互与用户体验 / 系统课时

展示工具调用的分步状态

展示工具调用的分步状态

当 AI 助手需要连续读取附件、查询数据或操作外部系统时,单独显示“正在处理”无法让用户知道任务进展。本课将工具调用拆成可核验的状态节点,明确计划、请求、执行、成功和失败的展示条件,并通过创建任务的案例设计完整的进度反馈与异常恢复交互。

学习目标

  • 区分计划行为、实际工具请求、执行中、成功和失败,避免界面提前宣告完成。
  • 为多步骤工具任务设计状态卡片、结果摘要和必要的用户确认操作。
  • 处理部分成功、超时、重试与取消,并用明确的验收条件检查交互正确性。

区分计划行为与真实执行

AI 可以先告诉用户准备做什么,但这不代表对应工具已经被调用。例如,“接下来将读取附件”只是计划;只有调度器实际发起读取请求后,才能显示“请求已发送”。

建议将每个工具步骤的状态定义为以下几类:

状态 进入条件 用户看到的文案
计划中 生成待执行步骤,尚未发起调用 准备读取附件
等待确认 涉及写入等需要授权的操作,尚未获得确认 等待确认创建任务
请求已发送 工具请求实际发出,尚未确认开始执行 正在请求任务服务
已受理 工具已接受,可能仍在排队 已受理,等待执行
执行中 执行系统报告已开始处理 正在创建任务
成功 收到成功结果,并满足该步骤的完成条件 已创建 2 条任务
失败 收到明确失败结果 创建失败:权限不足
待核验 请求结果不明,例如提交后连接中断 结果未确认,正在核验

这些状态不能仅根据助手生成的自然语言判断。尤其不能因为模型说了“已经完成”,就将尚无工具结果的步骤标记为成功。

工具调用从计划到执行结果的状态转换图

图中“待核验”是必要的独立状态。工具请求超时可能意味着操作失败,也可能意味着操作已经成功但响应丢失。此时直接显示失败并允许无条件重试,可能产生重复写入。

为每个步骤提供可以核验的反馈

一个实用的工具步骤卡片应包含步骤名称、当前状态、开始时间、结果摘要和可执行操作。用户需要查看过程时可以展开详情,不需要时则只看当前进度与最终结果。

以“查询任务清单”为例,可以这样组织卡片:

界面元素 示例内容 设计要求
步骤名称 查询现有任务 使用用户能理解的动作名称
当前状态 执行中 状态来自工具执行事件
持续时间 1.4 秒 使用真实计时,避免伪造进度
成功摘要 找到 8 条任务 取自工具返回结果
失败摘要 查询失败:没有访问权限 提供具体原因,不暴露内部堆栈
后续操作 重试、查看详情 根据状态决定是否显示

对于进度反馈,可以采用以下产品原型参数:

  • 步骤在启动加载指示之前就结束,例如请求发出后不足 400 毫秒收到明确结果,可直接呈现终态,完成记录仍保留。
  • 达到 400 毫秒仍无最终结果:展示当前真实阶段(等待受理、排队或执行)和可见的活动指示器。
  • 超过 8 秒仍无结果:按实际阶段提示“仍在排队”或“仍在执行”;可查看详情,支持取消时提供取消入口。
  • 只有工具实际报告了已处理数量和总数量,才能显示百分比。例如处理 6 个文件中的 3 个,可以显示 50%;没有进度数据时使用不确定进度指示器。

以上时间属于交互设计初始建议值,不是工具平台的固定超时规则。真正的超时与取消条件必须以执行系统返回的状态为准。

用创建任务的案例拆解完整流程

假设用户提出:“读取会议纪要,找出行动项,并添加到我的任务清单。”系统从两页附件中识别出 3 条行动项,查询后发现其中 1 条已经存在,因此准备新增 2 条。

建议将交互拆成以下阶段:

  1. 先显示“准备读取附件、检查重复任务并创建新任务”。这些属于计划步骤,暂时不显示成功标记。
  2. 发起附件读取工具请求。工具返回两页可解析文本后,将“读取附件”标记为成功,并显示“已读取 2 页”。
  3. 根据文本识别 3 条行动项,再调用任务查询工具。查询成功后显示“发现 1 条已有任务,准备新增 2 条”。文本分析不是工具调用时,不应伪装成一次已完成的外部工具调用。
  4. 在写入前显示确认面板,列出拟创建的 2 条任务及其标题、截止日期等实际可用信息,等待用户确认。
  5. 用户确认后,发起创建请求。只有在真实发送请求后,状态才从“等待确认”变为“请求已发送”。
  6. 收到工具结果后,按每条任务的实际写入结果更新界面,再给出整体摘要。

现在假设创建接口返回:一条创建成功,另一条由于权限问题失败。界面应该显示如下结果:

步骤 最终展示
读取附件 成功:读取 2 页
查询现有任务 成功:发现 1 条重复任务
创建 2 条任务 部分完成:1 条成功,1 条失败
整体任务 新增 1 条,重复而跳过 1 条,明确失败 1 条

此时不能出现“全部任务创建成功”。“部分完成”是多项操作的聚合结果,详细记录应分别保留每个子项的成功、失败或待核验事实。收到结果时按本次操作和子项标识匹配;超时但尚无结果的子项应显示待核验,不能归入失败数量。

结果区域可以提供“查看已创建任务”“查看失败原因”和“重试失败项”。如果工具返回了真实任务标识,成功项还可以关联到对应记录;没有返回定位信息时,不应生成虚假的跳转链接。

处理失败、重试和取消的边界

失败反馈需要告诉用户发生了什么、已有成果是否保留,以及下一步可以做什么。不同异常不能全部合并成“出错了,请重试”。

异常情况 正确反馈 可提供的操作
权限不足 当前账号无权创建任务 查看权限说明、重新授权
工具明确返回失败 显示失败步骤和错误原因 修正条件后重试
提交后网络中断 创建结果尚未确认 查询执行结果
批量任务部分失败 显示成功和失败数量 仅处理失败项
用户取消执行 停止尚未发出的后续操作;已提交项等待取消结果或核验 查看已完成步骤

重试必须关联原步骤,同时作为一次新的执行尝试记录。对于可能产生外部副作用的创建、发送和删除操作,先核验既有结果;如系统提供幂等请求机制,应沿用同一业务操作的幂等标识,避免重复提交。

取消同样不能被理解为撤销所有操作。假设系统已经创建了第一条任务,用户在第二条执行前点击取消,界面应保留第一条的成功事实,并明确表示后续步骤已停止,而不是将整个任务恢复为“未执行”。

可以用以下四项检查交互原型:

  • 停留在计划状态时,不能出现成功勾选或“已完成”文案。
  • 请求发出但结果未知时,不能自动认定执行成功或失败。
  • 三项操作中只有两项成功时,整体结果必须显示部分完成,并定位剩余问题。
  • 用户重试或取消后,原有成功记录仍然可查看,不得被新的状态覆盖。

完成这些检查后,用户看到的每个成功标记都应对应真实执行证据,每个异常提示也都应对应明确的恢复路径。这样即使任务跨越多个工具,界面也能准确区分准备做的事、正在做的事和已经完成的事。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

展示工具调用的分步状态

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通