Agent 工作流与工具调用

⋯

快速回顾

项目 内容
执行分工 AgentScope 承载对话与 ReAct,Graph 调度动作内部 Workflow 和严格 P&E,Backend 管理持久运行
业务场景 作业安排与实际记录、维保建议、经营分析和知识问答
入口与专家 首轮理解并选择路径,简单查询由主助手完成,复杂调查可委派四类领域专家
工具入口 统一 Schema、当前授权、期限、复用和容量控制,具体操作复用业务 Service
写入授权 冻结审批、精确方案委托;范围委托仅允许新建作业
持久恢复 显式持续目标使用租约和 checkpoint;模型或业务效果未知先核对,不自动重放
预算与审计 片段容量和根有效期共同控制执行;累计配额可选开启,真实调用及业务回执持久记录

职责与实现概述

故障排查要联合查询资产、工单和手册,作业安排要核对设备、人员和占用。Agent 首轮理解请求并选择执行路径,主助手负责最终回答,复杂调查按需委派作业、维保、成本和知识专家;工具取得的真实回执与已读来源构成回答依据。

Backend 在模型外管理当前授权、冻结上下文、工具能力、执行期限、检查点和业务回执。AgentScope 运行对话与 ReAct,Graph 承载动作内部的固定流程及严格计划执行。领域专家共用当前用户范围、期限和取消信号,准备草案后统一进入父级冻结与执行链。

业务写入经冻结审批或有效委托,执行前复核授权、版本、指定人员与资源冲突。稳定幂等输入与逐项回执防止重复提交,租约和 checkpoint 支持持久目标恢复;审计关联请求、证据、授权及实际业务记录,使建议、待确认和已执行分别可查。

工作流与业务场景

Agent 工作流是什么样的?

面试回答

后端受理消息后先冻结本轮输入和有效 AI 设置,建立唯一运行记录。首次模型调用完成理解、参数提取和路径选择:普通交流直接回答,简单查询调用必要工具,开放调查使用 ReAct,固定业务动作进入内部 Workflow;用户明确要求持续推进时才启用持久目标。

主助手负责整合结果和最终答复,复杂调查可以委派作业、维保、成本、知识专家。只读查询取得足够证据就结束;需要办理业务时准备草案,经过冻结审批或有效委托后,由 Backend 再核对当前权限、版本、人员与冲突,写入并保存真实回执。

实现细节

层次或策略 当前职责
Backend Harness 管理运行、冻结上下文、租户、工具、租约、检查点、证据依赖、审批与回执
AgentScope / ReAct 普通对话及开放调查中的工具选择和动态补证
Graph Workflow 在动作函数内部执行固定版本的必要节点,受阻时停止该动作
严格 P&E Planner 提交计划,Backend 冻结依赖,Graph 调度 read/workflow/synthesis 步骤;Executor 只持有当前步骤能力
领域专家 investigate 取证,prepare 在父级允许时准备本领域草案;知识专家只读

例如安排下周作业:

  1. 明确经营单元、作业类型、时间和资源要求,缺少关键条件通过结构化补问确认。
  2. 查询候选资产、执行人和当前任务/维保占用,读取与要求有关的业务依据。
  3. 动作函数按固定流程校验,冻结草案、依据及指纹,交给审批或明确委托入口。
  4. 实际提交在事务和资源锁内复核,登记授权消耗与实际业务记录。
  5. 按真实回执展示成功、失败或未知;业务回答经证据、权限与完成条件检查后持久化发布。

专家能力取当前用户与目标能力、首轮冻结工具、领域清单、委派工具和当前启用状态的交集。纯调查可有界并发,含 prepare 的批次串行推进;专家共用父级期限和取消,不能递归委派、自行批准或直接发布用户正文。

不同业务场景怎样调用工具?

面试回答

工具选择取决于业务场景需要的信息。作业调度查询任务、设备、人员和已有安排;维保建议结合设备档案、维修记录与手册检索;经营分析从业务记录中取得指标;知识问答则检索说明书、规范和资料页,保留引用。

动态状态通过业务工具查询,维修方法通过专业资料检索取得,历史对话用于定位用户讨论的设备和任务。金额、工时等指标由业务查询和确定性计算产生,模型据此解释结果或组织方案。各场景最终返回草案、指标或带证据的答案,写操作经冻结审批或有效委托,并通过业务校验后执行。

实现细节

各场景的信息来源和输出见表。统计结果同时保留组织、时间和有效记录口径;缺少期间先澄清,缺少面积或工时分母返回 null 和原因。业务状态、专业知识和历史背景各有来源。

场景 获取的信息 输出
作业调度 任务要求、候选设备、人员及已有安排 调度草案、冲突与待补充条件
维保建议 设备档案、维保记录、相关手册 维保建议及资料依据
经营分析 明确期间、已审核 CNY 费用、有效计量与当前授权范围 Backend 计算指标、排除范围和不可计算原因
知识问答 说明书、维修资料和操作规范 带页码引用的回答

工具设计与资源校验

面试回答

工具按业务能力定义,注册表保存名称、说明、严格参数 Schema、动作权限、副作用、幂等和重试政策。模型选择工具与参数,执行器先核对身份、当前授权、参数和期限,再调用业务 Service;业务写入继续执行状态流转、指定人员和资源冲突校验。

这样普通接口和 Agent 复用同一套业务规则。例如创建工单先检查资产、权限和必填信息,再按冻结授权办理。模型拿到的是有限能力,数据库访问和事务由所属业务模块完成。

实现细节

内容 控制方式
名称、说明、Schema 帮助选择工具;严格校验必填项、类型及枚举,不隐式把字符串转换成数值
权限与副作用 取当前用户及当前任务能力交集,读取、草案准备和提交分别控制
期限与容量 受管理执行器、总期限、工具次数及重试政策
结果结构 状态、规范化范围、分页、观察时间、稳定证据 ID、类型化问题与回执
只读复用 成功或合法空结果在窗口内复用,复用前重验可见性;同键在途请求共享物理执行
写入幂等 冻结授权、稳定动作标识和真实业务 ID,不复用草案生成作为提交结果

复用标识包含租户、用户、冻结授权范围、引擎、Schema 版本和规范化参数;同批独立幂等读取可有界并行,动作、状态及发布串行。服务失败保留失败状态,未遍历完分页不能证明全范围无记录。

平台 AI 工作台沿同一注册表管理工具启停,在线维护模板正文和运行参数。提示词按首轮、调查、规划、步骤执行、最终回答及核验阶段装配,固定协议继续由后端维护;新运行冻结有效设置与模板版本,继续和恢复沿用原快照。工具当前启停在调用及复用前重新检查,平台诊断从已有活动读取真实记录并写读取审计。

调度方案如何检查资源和任务冲突?

面试回答

后端根据草案中的设备、执行人和时间范围做确定性检查。先确认资源存在且在授权范围内,再看设备当前状态、维保占用、已有任务,以及人员和设备在相关时段是否冲突,同时核对作业要求和候选资源是否匹配。

失败时返回具体资源、冲突记录和原因,Agent 据此换设备、调时间或请求补齐条件。草案记录候选安排,资源占用在业务写入时建立。用户确认期间其他请求可能改变安排,因此执行前再次复核,并在业务写入环节控制并发,保证同一资源的有效安排符合时间约束。

实现细节

检查项与处理方式见表。方案校验判断草案在当前条件下是否可行,执行复核与并发控制处理确认等待期间的资源变化。

检查项 依据 失败后的处理
资源与范围 设备、执行人及当前授权范围 返回具体资源和原因
可用状态 设备当前状态及维保占用 更换候选或调整安排
时间冲突 已有任务与相关时段占用 调整时间或候选
作业匹配 作业要求与候选资源条件 补齐条件或重新准备方案
写入前复核 当前安排与并发约束 避免检查后被其他请求占用

对有明确安排窗口的占用,以左闭右开区间 [start, end) 判断重叠,条件为 existing.start < proposed.end AND existing.end > proposed.start。执行中作业(含暂停)、处理中及待验收维保在明确释放前持续占用,超过预计结束时间也不会自动释放;设备、机手及维保分别核对。

执行时的再次查询仍可能被并发穿透。例如两个请求同时看到设备空闲,再分别插入不同任务,单条任务的状态条件无法阻止它们。当前保护覆盖同一资源的“查冲突与写占用”:事务使用 READ COMMITTED,先取得治理及业务锁,再按既定顺序锁人员与按 ID 排序的资产;锁内读取最新已提交占用后写入,所有相关入口遵循同一顺序。并发冲突后返回明确失败,不把未落库的草案当作预约成功。

人工确认与执行恢复

人工确认确认的是什么?

面试回答

确认绑定内容确定的冻结方案,包括动作、设备、人员、时间、关键字段和证据依据。后端使用冻结指纹保证展示、授权和执行对应同一份内容;关键参数或依据变化后重新冻结并确认。

写入授权可以来自审批,也可以由用户对精确方案明确委托。持续目标还支持限定资源、字段、数量和时间的范围委托,但这种方式只允许新建作业。维保、返工、实际作业、验收、计量更正和费用动作都必须绑定精确方案,实际提交仍检查当前业务权限、指定人员和自审规则。

实现细节

授权方式 绑定内容与适用条件
冻结审批 审批请求关联完整方案与证据,参与人当前权限须覆盖冻结依据
精确方案委托 绑定发起人、组织、根目标、冻结指纹、动作/字段/数量、有效期及撤销状态
新作业范围委托 限定资产和人员集合、可选字段、业务时间、数量上限;经营单元、作业类型等农业字段固定精确值

例如用户批准某台设备明天的作业方案,等待期间设备被其他任务占用,提交返回冲突。换设备或时间须重新取得精确确认;已有有效范围委托时,新方案也必须完全位于授权集合与约束内。

审批或委托表示真实用户的授权动作,模型文本“用户已同意”不能替代。授权消耗与业务写入在同一事务提交或回滚,撤销只阻止后续动作;已成功的业务保留事实和回执。显式只读、历史再生成、重试子任务和周期调查不能升级为写入。

执行失败或重复调用怎么办?

面试回答

每个提交动作绑定稳定幂等输入和持久执行记录,后端在事务内检查目标、冻结授权和当前业务事实,成功后返回实际业务 ID。重复提交先查已有回执,已成功动作不重复创建;批量方案逐项保留结果,只继续仍可执行的部分。

模型请求和业务提交都可能出现结果未知。模型调用检查点未完成时标为 model_unknown,业务效果无法确定时标为 unknown_effect,先核对真实状态,不自动重放。只读临时故障可以按政策有限重试,确定失败的动作修正后重新取得所需授权。

实现细节

结果 后续动作
明确成功 保存业务 ID 与回执,同内容跨片段不再提交
明确失败 保留原因,修正参数或重新准备方案;已拒绝动作需新的显式执行代次
业务效果未知 只查询执行记录与实际业务,不释放资格重新提交
模型效果未知 保留调用检查点与状态,不自动再次生成
批量部分成功 成功项保持,未完成项按冻结授权、当前版本及资源规则处理

普通问答断线只恢复持久状态和已发布正文,不自动重发生成。用户明确要求持续推进的目标使用同一 taskId 新增片段;Graph checkpoint 决定 Workflow/P&E 下一节点,SDK snapshot 保存 ReAct 上下文,恢复由 lease 和版本共同保护。

继续时重新过滤当前能力并刷新过期读取;内容指纹变化使依赖的结论、草案和步骤失效,无关成果保留。实质修订追加目标版本并撤销旧授权,普通继续沿用有效约束;同片段恢复不延长原期限,等待也计入根有效期。

审计与结果追踪

审计日志记录什么?

面试回答

审计要能够还原谁提出了什么目标、授权了哪份方案、调用过哪些工具,以及最终影响了哪些业务记录。因此会记录发起人、组织、运行及目标版本、冻结指纹、审批或委托,关键参数、工具调用时间、状态、错误、证据和执行回执。

审计分别记录建议、待确认草案和已执行结果。草案生成后保存版本与待确认状态,执行后关联创建或修改的业务记录 ID,并逐项记录成功或失败。界面和日志使用一致的状态,便于处理重复请求、定位失败和回溯实际变更。

实现细节

审计同时保存工具调用状态、用户确认和业务回执,支持从任务查调用、从调用查业务结果,并核对实际执行与确认版本是否一致。

正确性与成本验证

面试回答

工作流验证需要核对最终业务结果。只读查询检查数据和引用,写入任务检查草案、确认版本、权限、资源约束以及真正生成的业务记录。重点覆盖确认后资源变化、重复提交、执行超时和部分失败,要求系统既不越权,也不重复创建或擅自执行变更后的方案。

成本按一次完整任务统计,包括模型和工具调用次数、检索次数、输入输出 token、总耗时与失败重试,结合任务成功率和结果正确性评估。单个执行片段限制调用容量、期限和输入窗口;持久目标还有根有效期。累计模型/工具/Token 配额默认只统计,显式开启后才对持久目标执行锁内预留;片段容量或配额触顶时暂停并保留原因,普通查询按已有证据收尾。

实现细节

验证场景 核对标准
只读查询与分析 不进入业务写入;指标来自指定范围的业务查询
两个请求同时安排同一设备的重叠时段 最终不产生相互冲突的有效任务
确认后改变设备或时间 旧确认不能执行新版本
确认后设备被占用或成员被撤权 执行复核失败,不写入任务
同一动作并发提交或重复提交 最多一份业务结果,重复请求可查原回执
写入成功但响应超时 核对后返回原结果,不再次创建
批量动作部分失败 已成功项保留,剩余项按确认与恢复规则处理
工具持续失败或重复返回相同信息 有限重试,触达预算后停止调用

对每个任务记录 taskId、草案版本、确认与执行标识、最终业务 ID、调用次数、token、总耗时及失败原因。结合人工核对的目标结果,分别统计建议正确性和实际写入正确性,将完成情况落实到业务记录与执行回执。

易混点与回答检查

调查计划、持久目标、业务授权和真实执行分别保存;草案与专家结论经父级核验,完成状态由当前证据和实际回执决定。

复盘手记

搜索笔记

输入关键词,搜索所有主题与问答。