前置条件检查清单

在正式开展工具调用场景挖掘之前,必须完成四项前置条件的系统化检查。该检查清单是后续所有跨域协作与任务拆解的基准线,遗漏任何一项将导致场景定义偏差或执行权限冲突。

前置条件检查流程 Agent能力基线 已有工具列表 业务域范围 组织授权 能力基线审查 工具清单确认 业务域边界界定 授权范围核验 全部通过 → 允许挖掘 任一未通过 → 终止并记录例外 说明:四个维度的检查顺序可并行,但结论必须全部达标。若某项不满足,需记录具体缺失项并触发补充流程。

适用场景

  • Agent 工具调用场景挖掘项目启动前
  • 已有业务需求文档或初步场景描述,但尚未明确 Agent 能力边界时
  • 跨部门协作(业务方、技术方、安全方)首次评审前
  • 工具列表发生重大变更(新增/弃用/版本升级)后需要重新审核

前置条件

执行本检查清单本身需要以下输入材料,若缺失需先补齐:

材料名称来源必备性
Agent 能力规格说明书(含模型版本、上下文长度、调用模式)技术负责人必备
正式维护的工具清单(包含工具名称、接口地址、授权级别、SLA)基础设施团队必备
业务域边界定义文件(包含 DDD 限界上下文或 BPMN 泳道图)业务分析师必备
组织授权矩阵(RBAC 或 ACL 规则)安全合规部必备

操作步骤

  1. 收集输入材料:从各责任方获取上述四份文件,检查版本日期。
  2. 审查 Agent 能力基线:逐项核对支持的工具调用类型(同步/异步/流式)、最大并发数、超时阈值、是否支持函数式调用(Function Calling)等。记录与预期能力的差异。
  3. 核对已有工具列表:对比工具列表与业务场景可能使用的工具集,确认每个工具的调用方式、认证方式、速率限制是否与 Agent 能力兼容。
  4. 界定业务域范围:明确本次挖掘覆盖的业务流程边界(例如“仅限订单全生命周期,不包括支付退款”),并标记不可达的子领域。
  5. 确认组织授权:验证工具调用所需的数据访问权限、系统操作权限是否已在当前组织授权矩阵中覆盖,若存在跨域授权需签署额外协议。
  6. 综合判定:所有检查项通过后标记为“允许挖掘”;如有未通过项需填写异常处理记录并终止当前挖掘。

输入输出物

类型名称格式/载体
输入前置条件检查材料包PDF/企业Wiki链接/共享文件夹
输出前置条件检查清单记录结构化的 Markdown / JSON / 电子表格
输出例外事项清单(若存在未通过项)同上,单独附页

输出物示例(检查清单核心字段):

{
  "check_id": "PRE-2025-03-001",
  "agent_capability": {
    "supports_function_calling": true,
    "max_concurrent_calls": 10,
    "timeout_ms": 30000,
    "compatibility_note": "无兼容性问题"
  },
  "tool_inventory": {
    "expected_tools": ["order_api", "inventory_svc", "notification"],
    "all_found": true,
    "auth_match": true
  },
  "domain_scope": {
    "scope_defined": "订单全生命周期(不含支付退款)",
    "boundary_conflict": false
  },
  "authorization": {
    "rbac_matrix_validated": true,
    "cross_domain_permissions": null
  },
  "overall_verdict": "PASS",
  "reviewer": "张三",
  "review_date": "2025-03-15"
}

责任边界

  • 产品负责人 / 业务架构师:提供业务域范围定义,并确认场景边界。
  • 技术负责人:提供 Agent 能力基线文档,并审查工具兼容性。
  • 安全合规负责人:提供并核验组织授权矩阵,签署跨域授权意见。
  • SOP 执行人(课程学员):在模板中逐项填写检查记录,并最终签署综合判定。
责任提醒: 若检查清单在后期发现遗漏或错判,将由对应材料的提供方与审查方共同承担纠正责任。

记录材料

所有检查过程应保留在以下载体中:

  • 检查清单 JSON 文件(版本管理仓库 Git)
  • 会议纪要(如对授权矩阵有争议需记录决议)
  • 材料签字页(电子签名或审批流截图)

记录保留期限:项目结束归档后至少保留 12 个月。

异常处理

异常现象处理动作负责人
Agent 能力不支持所需调用方式(如仅同步调用但场景需要流式)升级 Agent 版本或修改场景方案,记录变更技术负责人
工具清单中缺少关键工具申请新增工具接入,评估工期后暂停挖掘基础设施团队 + 产品负责人
业务域边界模糊(多个团队存在交叉)组织领域对齐工作坊,重新定义限界上下文业务架构师
组织授权不覆盖所需数据操作提交权限变更工单,待审批通过后再继续安全合规 + 申请方主管
异常升级规则: 如果异常处理超过 2 个工作日仍未解决,需自动上报项目委员会,暂停所有相关场景挖掘直至条件满足。

验收标准

  1. 输出物必须包含完整的检查清单记录(JSON 或结构化表格),且所有必填字段非空。
  2. 综合判定字段 overall_verdict 为 PASS 时才允许进入下一章“场景假设生成”。
  3. 所有材料来源签字/审批状态为已确认,无待办签字项。
  4. 异常处理若发生,必须附带例外事项清单并有处理方案与预计解决日期。
最佳实践: 建议将前置条件检查清单嵌入团队的一站式协作平台(如 Notion / Confluence),并设置自动化提醒——当材料更新后自动触发新一轮检查。