第2章 前置条件梳理：验证目标、团队角色、数据基础、工具准备

适用场景

• 项目启动阶段：新Agent项目或新功能模块准备进入原型验证前，验证目标尚未明确定义。
• 多角色协作验证：涉及产品、算法、测试、运维等多个职能团队，需要统一分工与责任边界。
• 数据来源多样：业务系统、用户反馈、公开数据集等多源数据需要统一清洗与标注标准。
• 工具链首次搭建：Agent开发框架、监控链路、CI/CD流水线等工具环境需要首次配置或版本升级。

前置条件

1. 已完成项目立项或验证任务书签发。
2. 团队核心成员已到岗，并了解RICE框架基本概念（见本课程第1章）。
3. 初步确认数据来源渠道可用，且具备数据访问权限。
4. 目标验证环境（开发/测试集群）已分配资源配额。

操作步骤

前置条件梳理划分为四个并行子步骤，建议按“目标 → 角色 → 数据 → 工具”的顺序执行，但角色、数据、工具三个环节可在目标明确后并行推进。

步骤1：梳理验证目标

验证目标必须同时满足 明确、可量化、可观测 三个标准。建议使用目标模板进行结构化定义：

# 验证目标定义模板
validation_goal:
  id: "VG-2025-001"
  description: "智能客服Agent意图识别准确率验证"
  scope: "仅覆盖售前咨询场景，不包含售后投诉"
  metrics:
    - name: "意图识别准确率"
      type: "accuracy"
      threshold: "≥ 0.90"
    - name: "平均响应时间"
      type: "latency_p95"
      threshold: "≤ 2000 ms"
  observation_window: "连续运行72小时，取每日均值"

步骤2：确认团队角色

使用RACI矩阵明确每个角色在验证活动中的责任。最少必须覆盖以下四类角色：

• 产品经理（P）：定义验证目标、评审验证结果。
• 算法工程师（A）：提供模型、调优参数、分析验证数据。
• 测试工程师（T）：设计验证用例、执行验证、记录缺陷。
• 运维工程师（O）：搭建验证环境、配置监控、保障工具链可用。

步骤3：准备数据基础

数据准备需要完成 采集 → 清洗 → 标注 → 拆分 四个子任务。标注规范必须在数据准备前由算法与测试团队共同确认。

# 数据拆分比例（推荐）
data_split:
  train: 0.60
  validation: 0.20
  test: 0.20
# 标注一致性要求
label_agreement:
  metric: "Cohen's Kappa"
  threshold: "≥ 0.85"

步骤4：配置工具准备

工具链至少包含：Agent开发框架、链路追踪/监控系统、版本管理、CI/CD流水线。建议使用容器化部署以保证环境一致性。

# 工具就绪检查项（示例）
tools_checklist:
  - name: "LangChain"
    version: "≥ 0.3.0"
    status: "installed"
  - name: "LangSmith"
    version: "latest"
    status: "api_key_configured"
  - name: "Docker"
    version: "≥ 24.0"
    status: "daemon_running"
  - name: "GitLab CI"
    version: "≥ 16.0"
    status: "pipeline_defined"

输入输出物总表

责任边界

记录材料

每次前置条件梳理完成后，必须归档以下材料：

1. 验证目标定义表（含版本号、变更记录）
2. RACI矩阵（含角色签字确认）
3. 数据标注规范书（含标注示例与一致性要求）
4. 环境就绪检查清单（含工具版本与配置截图）

推荐使用集中式版本管理（如GitLab Wiki + YAML配置库）统一存放上述材料。

异常处理

验收标准

前置条件梳理是否完成的判断依据如下。所有检查项必须同时满足：