Agent Trace Schema 模板

适用场景

用于记录 Agent 执行过程，支撑过程评分、成本分析、归因和复现。

字段说明

本模板是第 14.12 节 Agent Trace 语义契约的可填写实现。第 8、17、21 章出现的 Trace 字段仅为对应场景的最小视图；字段语义以第 14.12 节为准，本工作表必须与其保持一致。

模板

trace_id:
run_id:
case_result_id:
case_id:
case_version:
goal:
initial_state:
environment:
steps:
  - step_id:
    timestamp:
    state_before:
    action_type:
    tool_name:
    arguments:
    observation:
    state_after:
    decision_evidence:
    expected_behavior:
    deviation:
    evaluator_notes:
    cost:
      input_tokens:
      output_tokens:
      estimated_cost:
        amount:
        currency:
        pricing_version:
        components:
          model:
          tool:
          sandbox:
    latency_ms:
    error:
final_state:
final_response:
metrics:
evaluation:
  task_success:
  process_safety:
  tool_accuracy:
  state_consistency:
  cost_acceptability:

填写示例

以下 ID、版本、时间、成本和延迟均为假设性教学示例，不代表真实运行结果或服务等级。

trace_id: trace_refund_001
run_id: run_refund_001
case_result_id: case_result_refund_001
case_id: eval_refund_member_partial_001
case_version: v2
goal: 判断会员部分退款对优惠券和积分的影响
initial_state:
  identity_verified: true
  refund_type: partial
steps:
  - step_id: 1
    timestamp: "2026-07-08T10:30:00Z"
    state_before:
      refund_type: partial
    action_type: tool_call
    tool_name: refund_rule_calc
    arguments:
      order_id: O123
      item_id: I456
      refund_type: partial
    observation:
      points_adjustment: requires_recalculation
    state_after:
      refund_rule_checked: true
    decision_evidence:
      policy_rule: high_risk_refund_requires_rule_check
      source: refund_policy_20260701
    expected_behavior: 正确调用退款规则工具
    deviation: none
    evaluator_notes: 工具选择与参数均符合 Case 约束
    cost:
      input_tokens: 1200
      output_tokens: 300
      estimated_cost:
        amount: 0.012
        currency: CNY
        pricing_version: refund_agent_pricing_202607
        components:
          model: 0.010
          tool: 0.002
          sandbox: 0
    latency_ms: 850
final_state:
  answer_based_on_tool: true
final_response: 需要结合订单明细重新计算优惠券分摊和积分调整
metrics:
  total_steps: 1
  total_latency_ms: 850
evaluation:
  task_success: pass
  process_safety: pass
  tool_accuracy: pass
  state_consistency: pass
  cost_acceptability: pass

常见误区