# Ví dụ thật: AI agent sửa lỗi phân trang API

Một API liệt kê sự kiện theo con trỏ bị mất bản ghi khi nhiều sự kiện có cùng
thời điểm. Bộ lọc loại sự kiện cũng được áp dụng quá muộn nên một trang có thể
trả thiếu kết quả. Dự án Python nhỏ này cho phép bạn kiểm tra cả lỗi ban đầu
và bản sửa bằng cùng một bộ test, không cần cài thư viện ngoài.

## Sản phẩm có trong gói

- `input/`: mã ban đầu với lỗi có chủ ý; 5 bài kiểm thử, trong đó 3 bài thất bại.
- `output/`: mã do OpenCode sửa qua AI Model Mark; cùng 5 bài kiểm thử đều đạt.
- `fix.patch`: thay đổi duy nhất trong mã ứng dụng. File test và README của
  dự án được giữ nguyên.
- `prompt.md`: lời giao việc đã dùng; `baseline-test.txt` và
  `verified-test.txt`: kết quả kiểm thử trước và sau; `agent-run.json`: tóm tắt
  sự kiện của lần chạy thực tế.

Lần chạy ghi lại dùng **OpenCode CLI trên Windows** với model hiển thị
`aimodelmark/gpt-6-astra`. Tác vụ của agent kéo dài **54,64 giây**. Con số này
chỉ là thời gian lần chạy mẫu, không phải cam kết tốc độ. Chúng tôi chưa đo
credit đã trừ trên tài khoản cho riêng lần chạy này, nên không công bố một
chi phí ước đoán.

## Tự kiểm chứng

1. Cài Python 3.10 trở lên. Trong thư mục `input`, chạy
   `python -m unittest -v`; bạn sẽ thấy 3 bài thất bại.
2. Trong thư mục `output`, chạy lại `python -m unittest -v`; cả 5 bài phải đạt.
3. Mở `fix.patch` để xem cách con trỏ so sánh cả thời điểm và ID, còn bộ lọc
   được áp dụng trước khi cắt trang.

Muốn tự làm lại bằng AI agent, hãy sao chép ba file trong `input/` sang một
thư mục làm việc mới. Cấu hình OpenCode với tài khoản AI Model Mark theo bài
hướng dẫn trên website, chọn `aimodelmark/gpt-6-astra`, rồi dán nội dung
`prompt.md`. Chạy bộ test trong thư mục mới sau khi agent hoàn thành. Tránh
đưa khóa API hoặc dữ liệu khách hàng vào prompt hay repository thử.

Người biên tập đã thiết kế dự án mẫu, test và prompt, sau đó chạy CLI và đóng
gói kết quả. Phần sửa `event_feed.py` trong `output/` do agent thực hiện; người
biên tập không chỉnh lại bản sửa. Đây là ví dụ về quy trình sửa lỗi có kiểm
chứng, không phải bằng chứng rằng mọi lỗi lập trình sẽ được sửa thành công.