第3章 优先级协调前置条件清单：Agent能力矩阵、任务依赖图谱、资源可用性记录、冲突级别预判

3.1 适用场景

在执行多Agent RICE优先级协调之前，必须完成四项前置条件的采集与建模。这些前置条件是后续RICE分值计算、资源分配和冲突仲裁的数据基础。以下场景必须触发前置条件清单的构建或更新：

• 系统初始化：新部署的多Agent系统首次运行前，需完成全量前置条件录入。
• 任务集变更：新增/删除任务或调整任务依赖关系时，任务依赖图谱与冲突预判需同步更新。
• Agent扩缩容：增加/移除Agent实例后，能力矩阵与资源可用性记录必须重新校准。
• 资源波动：GPU/内存/API等共享资源出现明显性能变化时，资源可用性记录需刷新。
• 冲突升级：上一轮协调中出现未预判的高烈度冲突，需要重建冲突级别预判模型。

3.2 前置条件总览

四项前置条件共同构成了RICE协调的“数据底座”，其关系与分工如下表所示：

3.3 操作步骤

构建前置条件清单分四个子步骤，建议按序号依次执行，避免数据不一致。

步骤1：构建Agent能力矩阵

1. 定义能力维度：根据业务场景列出所有相关能力（如 NLP、视觉、规划、工具调用、记忆检索等）。
2. 收集评分数据：从Agent自评接口、历史任务完成质量、单元测试通过率三个渠道获取初始分值。
3. 归一化与校准：将原始分映射到 [0.0, 1.0] 区间，并经过交叉验证消除Agent自评偏差。
4. 输出矩阵：以结构化格式（JSON/YAML）持久化，示例：

{
  "agent_capability_matrix": {
    "dimensions": ["nlp", "vision", "planning", "tool_use"],
    "agents": {
      "Agent-Alpha":  { "nlp": 0.92, "vision": 0.35, "planning": 0.78, "tool_use": 0.88 },
      "Agent-Beta":   { "nlp": 0.40, "vision": 0.91, "planning": 0.55, "tool_use": 0.30 },
      "Agent-Gamma":  { "nlp": 0.65, "vision": 0.60, "planning": 0.93, "tool_use": 0.72 },
      "Agent-Delta":  { "nlp": 0.80, "vision": 0.75, "planning": 0.60, "tool_use": 0.95 }
    },
    "version": "v3.1",
    "last_updated": "2025-03-21T10:30:00Z"
  }
}

步骤2：绘制任务依赖图谱

1. 枚举任务节点：列出当前批次所有待协调任务，使用唯一 TaskID。
2. 标注依赖边：为每对任务确定依赖类型——blocking（阻塞）、triggering（触发）、information（信息传递）。
3. 环检测：使用拓扑排序验证图谱无循环依赖，若有环则回退至流程设计师修正。
4. 输出图谱：以邻接表或边列表格式持久化：

{
  "task_dependency_graph": {
    "tasks": ["T-01", "T-02", "T-03", "T-04", "T-05"],
    "edges": [
      { "from": "T-01", "to": "T-02", "type": "blocking" },
      { "from": "T-01", "to": "T-03", "type": "triggering" },
      { "from": "T-02", "to": "T-04", "type": "blocking" },
      { "from": "T-03", "to": "T-04", "type": "information" },
      { "from": "T-03", "to": "T-05", "type": "triggering" }
    ],
    "acyclic": true,
    "last_updated": "2025-03-21T10:35:00Z"
  }
}

步骤3：采集资源可用性记录

1. 接入监控探针：为每类共享资源（GPU、系统内存、API配额、专用缓存等）部署实时探针。
2. 定义容量指标：total（总量）、used（已用）、available（可用）、reserved（预留给高优任务）。
3. 快照记录：在每次协调触发前生成资源快照，避免使用过期的缓存数据。
4. 输出记录：

{
  "resource_availability": {
    "snapshot_id": "rs-20250321-104200",
    "timestamp": "2025-03-21T10:42:00Z",
    "resources": [
      { "id": "gpu-cluster-a",  "type": "gpu",    "total": 8,  "used": 5, "available": 3,  "reserved": 1 },
      { "id": "mem-pool-main",  "type": "memory", "total": 64, "used": 38,"available": 26, "reserved": 8 },
      { "id": "api-gateway-v3", "type": "api",    "total": 100,"used": 42,"available": 58, "reserved": 20 },
      { "id": "cache-redis-01", "type": "cache",  "total": 50, "used": 12,"available": 38, "reserved": 5 }
    ]
  }
}

步骤4：预判冲突级别

1. 提取冲突模式：从历史日志中归纳 Agent 对同一资源的竞争模式（读/写/互斥）。
2. 计算冲突概率：基于近100次调度的资源分配成功率，使用滑动窗口计算冲突概率 P_conflict。
3. 定级：按概率与影响范围划分为 high（P≥0.7）、medium（0.3≤P<0.7）、low（P<0.3）。
4. 输出预判表：

{
  "conflict_predictions": [
    {
      "conflict_id": "cfl-001",
      "agents": ["Agent-Alpha", "Agent-Beta"],
      "resource": "gpu-cluster-a",
      "conflict_type": "mutex",
      "probability": 0.82,
      "level": "high",
      "suggested_action": "time-slice or priority-based preemption"
    },
    {
      "conflict_id": "cfl-002",
      "agents": ["Agent-Gamma", "Agent-Delta"],
      "resource": "mem-pool-main",
      "conflict_type": "read-write",
      "probability": 0.45,
      "level": "medium",
      "suggested_action": "read-replica or shared access"
    }
  ]
}

3.4 输入输出物

3.5 责任边界

• 系统架构师：负责Agent能力矩阵的维度定义、评分校准与版本管理；对矩阵的完整性与准确性负责。
• 流程设计师：负责任务依赖图谱的建模与环检测；对图谱的拓扑正确性负责。
• 运维工程师：负责资源探针的部署与数据采集；对资源快照的实时性与精度负责。
• 调度管理员：负责冲突预判模型的训练与更新；对预判的召回率与误报率负责。
• 协调仲裁者（Coordinator）：最终检查四项前置条件是否齐全且通过验收，若有一项不合格则拒绝进入RICE计算。

3.6 记录材料

每次协调完成后，以下记录材料必须归档至持久化存储，保留不少于30天：

• 前置条件快照包：包含四项前置条件在本次协调开始时刻的完整JSON快照，打包为 precondition_snapshot_{timestamp}.zip。
• 变更日志：记录本次协调前对前置条件做出的所有修改（新增/更新/删除），包括操作人、时间戳、变更原因。
• 验收报告：由协调仲裁者签署的前置条件验收检查单（Pass/Fail + 备注）。
• 异常事件记录：若在准备前置条件过程中发生异常（如探针超时、数据格式校验失败），需单独记录异常详情与处理措施。

3.7 异常处理

3.8 验收标准

前置条件清单通过验收必须同时满足以下全部条件：

1. 完整性：四项前置条件均存在且非空，每项的数据字段完整率 ≥95%。
2. 时效性：所有数据的时间戳与当前协调触发时刻的偏差 ≤30秒（资源记录要求 ≤5秒）。
3. 一致性：Agent能力矩阵中的AgentID集合与任务依赖图谱中涉及Agent的集合一致；资源可用性记录中的资源ID与冲突预判表中的资源ID一一对应。
4. 拓扑合法性：任务依赖图谱通过拓扑环检测，无循环依赖。
5. 预判覆盖率：冲突级别预判覆盖了能力矩阵中所有可能出现竞争的资源类型，覆盖率 ≥90%。
6. 格式合规：四项前置条件的JSON Schema通过校验，无格式错误或非法值。

// 验收检查单示例（由协调仲裁者执行）
{
  "precondition_acceptance": {
    "session_id": "pa-20250321-104500",
    "check_items": [
      { "item": "agent_capability_matrix",  "status": "PASS", "detail": "完整度 97.3%, 版本 v3.1" },
      { "item": "task_dependency_graph",    "status": "PASS", "detail": "无环, 5 tasks, 5 edges" },
      { "item": "resource_availability",    "status": "PASS", "detail": "快照延迟 2.1s, 4 resources" },
      { "item": "conflict_predictions",     "status": "PASS", "detail": "覆盖 4/4 资源类型, 准确率 91%" }
    ],
    "overall": "ACCEPTED",
    "inspected_by": "Coordinator-01",
    "timestamp": "2025-03-21T10:45:00Z"
  }
}