前置条件检查清单
在正式开展工具调用场景挖掘之前,必须完成四项前置条件的系统化检查。该检查清单是后续所有跨域协作与任务拆解的基准线,遗漏任何一项将导致场景定义偏差或执行权限冲突。
适用场景
- Agent 工具调用场景挖掘项目启动前
- 已有业务需求文档或初步场景描述,但尚未明确 Agent 能力边界时
- 跨部门协作(业务方、技术方、安全方)首次评审前
- 工具列表发生重大变更(新增/弃用/版本升级)后需要重新审核
前置条件
执行本检查清单本身需要以下输入材料,若缺失需先补齐:
| 材料名称 | 来源 | 必备性 |
|---|---|---|
| Agent 能力规格说明书(含模型版本、上下文长度、调用模式) | 技术负责人 | 必备 |
| 正式维护的工具清单(包含工具名称、接口地址、授权级别、SLA) | 基础设施团队 | 必备 |
| 业务域边界定义文件(包含 DDD 限界上下文或 BPMN 泳道图) | 业务分析师 | 必备 |
| 组织授权矩阵(RBAC 或 ACL 规则) | 安全合规部 | 必备 |
操作步骤
- 收集输入材料:从各责任方获取上述四份文件,检查版本日期。
- 审查 Agent 能力基线:逐项核对支持的工具调用类型(同步/异步/流式)、最大并发数、超时阈值、是否支持函数式调用(Function Calling)等。记录与预期能力的差异。
- 核对已有工具列表:对比工具列表与业务场景可能使用的工具集,确认每个工具的调用方式、认证方式、速率限制是否与 Agent 能力兼容。
- 界定业务域范围:明确本次挖掘覆盖的业务流程边界(例如“仅限订单全生命周期,不包括支付退款”),并标记不可达的子领域。
- 确认组织授权:验证工具调用所需的数据访问权限、系统操作权限是否已在当前组织授权矩阵中覆盖,若存在跨域授权需签署额外协议。
- 综合判定:所有检查项通过后标记为“允许挖掘”;如有未通过项需填写异常处理记录并终止当前挖掘。
输入输出物
| 类型 | 名称 | 格式/载体 |
|---|---|---|
| 输入 | 前置条件检查材料包 | 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 个工作日仍未解决,需自动上报项目委员会,暂停所有相关场景挖掘直至条件满足。
验收标准
- 输出物必须包含完整的检查清单记录(JSON 或结构化表格),且所有必填字段非空。
- 综合判定字段
overall_verdict为PASS时才允许进入下一章“场景假设生成”。 - 所有材料来源签字/审批状态为已确认,无待办签字项。
- 异常处理若发生,必须附带例外事项清单并有处理方案与预计解决日期。
最佳实践: 建议将前置条件检查清单嵌入团队的一站式协作平台(如 Notion / Confluence),并设置自动化提醒——当材料更新后自动触发新一轮检查。