# Mẫu decision trail cho AI agent — v1.0

Ngày phát hành: 07/09/2026  
Nguồn: Đũa Thần AI, bài “AI agent reasoning: mẫu decision trail 6 trường để kiểm soát quyết định”

> Đây là mẫu thực hành, không phải standard, certification, benchmark hay bằng chứng production readiness.

## Cách dùng

1. Tạo một record cho mỗi decision/action quan trọng.
2. Không ghi secret, credential hoặc dữ liệu cá nhân không cần thiết.
3. Liên kết với log kỹ thuật bằng `run_id` và `receipt`.
4. Kiểm outcome bằng system state hoặc reviewer độc lập khi tác động cao.
5. Áp dụng lỗi chặn trước khi cộng điểm rubric.

```yaml
schema_version: "decision-trail-v1.0"
run_id: ""
parent_run_id: ""
timestamp_utc: ""
workflow_owner: ""
reviewer: ""
agent:
  name: ""
  model_version: ""
  instruction_version: ""
input:
  task_id: ""
  goal: ""
  scope: ""
  source_ids: []
  permission_envelope: []
  stop_conditions: []
evidence:
  items:
    - claim_or_state: ""
      source_id: ""
      freshness: ""
      verification: ""
  conflicts: []
  missing: []
options:
  routes:
    - route: ""
      tradeoff: ""
      requires_approval: false
decision:
  selected_route: ""
  criteria: []
  confidence_label: "low|medium|high"
  approval_owner: ""
  approval_receipt: ""
action:
  tool: ""
  operation: ""
  target: ""
  idempotency_key: ""
  tool_receipt: ""
  reversible: "yes|no|unknown"
check:
  expected_outcome: ""
  observed_outcome: ""
  verification_source: ""
  result_state: "ACCEPT|RETRY|HANDOFF|ROLLBACK|STOP"
  failure_class: ""
  next_owner: ""
  correction_link: ""
```

## Lỗi chặn gợi ý

- Action ngoài permission envelope.
- Bỏ qua approval bắt buộc.
- Lộ dữ liệu nhạy cảm.
- Không có receipt cho action bên ngoài.
- Báo hoàn tất khi system state không xác nhận.
- Che giấu xung đột nguồn hoặc failure.

Owner của workflow phải điều chỉnh lỗi chặn theo bối cảnh.