Thực hành AI Agent · Skill

Cài và dùng AI Agent
đối soát ảnh chuyển khoản

Biến ảnh khách gửi qua Zalo và danh sách đơn hàng thành báo cáo đối soát Excel, phát hiện giao dịch trùng và dashboard theo dõi công nợ.

  • 4 bước thực hành
  • Không cần biết lập trình
  • Codex hoặc Claude Code

Bạn muốn làm theo công cụ nào?

Mục lục ⌄
  1. Mở đầuThẻ nhiệm vụ
  2. Bước 1Cài Skill có sẵn
  3. Bước 2Chuẩn bị dữ liệu
  4. Bước 3Chạy đối soát
  5. Bước 4Kiểm tra báo cáo
  6. Tóm tắtNhìn lại quy trình
Mở đầu

Thẻ nhiệm vụ

Bài thực hành · Đối soát chuyển khoảnAgent đọc ảnh và ghép với đơn hàng

Tình huống thực tế

Khách chuyển khoản rồi gửi ảnh qua Zalo. Cuối ngày, kế toán phải mở từng ảnh và dò với danh sách đơn để biết đơn nào đã đủ tiền, đơn nào thiếu, đơn nào chưa có ảnh phù hợp và ảnh nào trùng hoặc cần kiểm tra.

Agent đọc ảnh, chuẩn hóa dữ liệu, ghép ảnh với đơn, chặn giao dịch trùng và tính số tiền còn thiếu hoặc nhận dư. Kết quả chỉ dựa trên ảnh, không thay thế sao kê ngân hàng.

Mô hình PEAS

Kết quả cần có

Đo thế nào là làm đúng?

  • 100% đơn và ảnh xuất hiện trong báo cáo.
  • Không cộng trùng; không báo “Đã trả đủ” khi thiếu căn cứ.
  • Excel và dashboard khớp số liệu; mỗi ngoại lệ có lý do và việc cần làm.

Môi trường làm việc

Một thư mục làm việc trên máy tính.

Hành động

Agent được và không được làm gì?

Được đọc ảnh, chuẩn hóa, phát hiện trùng, ghép khi đủ căn cứ, tính tiền, phân loại và xuất Excel + dashboard.

Không được: nhắn khách, xác nhận tiền đã vào, giao hàng, hoàn tiền hoặc sửa file nguồn.

Đầu vào

Agent dựa vào dữ liệu nào?

  • Ảnh: số tiền, nội dung, người chuyển, mã giao dịch, thời gian.
  • Excel: mã đơn, khách hàng, số điện thoại, số phải thu.
  • Người dùng: đường dẫn, tên sheet và ánh xạ cột.
Lưu ý: Ảnh chuyển khoản chỉ là bằng chứng khách cung cấp. Không thể dùng ảnh để xác nhận tiền đã thực sự ghi có trên tài khoản nếu chưa đối chiếu với sao kê.
Bước 1

Cài Skill đối soát có sẵn

Mở CodexClaude Code trong một thư mục làm việc trên máy tính. Skill đã được chuẩn bị sẵn trên GitHub; bạn chỉ cần tải về, đọc hướng dẫn và kiểm tra bộ dữ liệu mẫu.

  1. Tạo hoặc chọn một thư mục làm việc trên máy tính.
  2. Mở thư mục đó bằng CodexClaude Code.
  3. Bấm Sao chép, dán câu lệnh để công cụ tải và kiểm tra Skill. Chưa chạy đối soát ở bước này.
Câu lệnh tải và kiểm tra Skill 
Tải Skill đối soát chuyển khoản tại đường dẫn sau về thư mục làm việc hiện tại:
https://github.com/slimsoftvietnam/slimai-agent-doi-soat

Đọc hướng dẫn sử dụng Skill và liệt kê các tệp dữ liệu mẫu đi kèm. Cho tôi biết cần đặt file Excel và ảnh đầu vào ở đâu, kết quả sẽ được lưu ở đâu.

Chưa chạy đối soát, chưa sửa hoặc xóa dữ liệu mẫu. Báo lại khi đã sẵn sàng.

Kết quả bước 1: Agent đã tải Skill, đọc hướng dẫn, liệt kê dữ liệu mẫu, chỉ rõ thư mục đầu vào và đầu ra rồi báo sẵn sàng. Skill chưa được chạy ở bước này.

GitHub là nơi lưu bộ Skill đã hoàn thiện. Mỗi bộ mã được gọi là một repository (repo). Bài thực hành này dùng lại repo có sẵn, không yêu cầu tạo Agent từ đầu.
Bước 2

Kiểm tra bộ dữ liệu mẫu

Dùng file Excel danh sách đơn hàng và thư mục ảnh chuyển khoản đi kèm Skill. Khi dùng dữ liệu thật, hãy tải ảnh từ Zalo về máy rồi đặt vào đúng thư mục đầu vào.

doi-soat-chuyen-khoan/ ├── SKILL.md ├── data/ │ ├── don_hang.xlsx │ └── anh_chuyen_khoan/ │ ├── anh_001.jpg │ ├── anh_002.png │ └── ... └── output/

Tệp Excel nên có mã đơn, tên khách, số điện thoại và số phải thu. Nếu cột có tên khác, Agent sẽ hỏi để ánh xạ đúng trước khi xử lý.

  1. Chép danh sách đơn vào thư mục data, đặt tên don_hang.xlsx.
  2. Chép tất cả ảnh cần đối soát vào data/anh_chuyen_khoan. Không xóa ảnh gửi trùng ở bước này.
  3. Gửi câu lệnh bên dưới để Agent kiểm tra dữ liệu trước khi chạy.
Câu lệnh kiểm tra dữ liệu đầu vào 
Hãy kiểm tra các dữ liệu tôi đã đặt trong thư mục dự án:
- data/don_hang.xlsx: danh sách đơn hàng
- data/anh_chuyen_khoan/: ảnh khách gửi qua Zalo

Trước tiên, hãy liệt kê tên sheet và tên các cột Excel, đối chiếu với mã đơn, khách hàng, số điện thoại, số phải thu. Nếu tên cột khác, hãy đề xuất ánh xạ và hỏi tôi xác nhận trước khi chạy.
Kiểm tra số lượng ảnh, định dạng được hỗ trợ, ảnh lỗi không đọc được và tên tệp bị trùng. Không xóa, đổi tên hay sửa file gốc.
Chỉ báo cáo kết quả kiểm tra đầu vào ở bước này.
Kiểm tra trước khi tiếp tục: Agent phải cho biết số đơn, số ảnh, tên cột Excel và ảnh nào không đọc được. Nếu ánh xạ cột chưa rõ, cần xác nhận thủ công.
Bước 3

Chạy Skill và xem kết quả

Khi đã xác định đúng file Excel và thư mục ảnh mẫu, gửi câu lệnh sau để Agent đối soát và tạo hai đầu ra: Excel chi tiết và dashboard HTML.

Câu lệnh chạy đối soát 
Hãy dùng Skill đối soát chuyển khoản đã cài để xử lý bộ dữ liệu mẫu trong thư mục làm việc.

Yêu cầu:
1. Đọc trên từng ảnh các trường có thể xác định: số tiền, người chuyển, ngân hàng, nội dung, thời gian và mã giao dịch. Trường nào không rõ phải đánh dấu, không đoán.
2. Phát hiện ảnh hoặc giao dịch trùng và không cộng hai lần.
3. Chỉ ghép ảnh với đơn hàng khi có đủ bằng chứng. Với từng đơn, tính số phải thu, số tiền đã ghép theo ảnh, số còn thiếu hoặc nhận dư.
4. Phân loại đúng một trong bốn trạng thái: Đã thanh toán đủ theo dữ liệu ảnh; Còn thiếu; Chưa tìm thấy giao dịch phù hợp; Cần kiểm tra.
5. Tách riêng ảnh mờ, ảnh không phải giao dịch, sai mã đơn hoặc không tìm được đơn phù hợp. Ghi rõ lý do và việc cần làm.
6. Tạo file Excel chi tiết và dashboard HTML. Trên dashboard, khi chọn chỉ số hoặc trạng thái phải xem được các đơn liên quan và lý do phân loại.
7. Kiểm tra số lượng và số tiền giữa Excel và dashboard phải khớp nhau.
8. Lưu kết quả vào thư mục đầu ra, không sửa hoặc xóa dữ liệu nguồn.

Kết quả chỉ là đối soát sơ bộ theo ảnh khách cung cấp, không phải xác nhận tiền đã vào tài khoản. Sau khi hoàn tất, mở dashboard để tôi xem và cho biết đường dẫn file Excel.

Kết quả bạn cần nhìn thấy

Dashboard đối soát Dashboard mẫu, không phải kết quả vừa chạy
20Tổng đơn
12Đã trả đủ
5Trả thiếu
3Cần xử lý khác
Mã đơn Phải thu Theo ảnh Phân loại
DH001 1.000.000 1.000.000 Đã trả đủ
DH002 2.000.000 1.500.000 Trả thiếu
DH003 850.000 0 Chưa có ảnh khớp

Kết quả bước 3: Có doi_soat.xlsx và dashboard.html trong thư mục đầu ra. Dashboard cho phép lọc trường hợp cần xử lý và in thành PDF từ trình duyệt.

Bước 4

Kiểm tra kết quả đối soát

Kiểm tra bốn tình huống quan trọng trong dữ liệu mẫu trước khi tin vào số tổng hợp. Excel và dashboard cũng phải cho cùng một kết quả.

Câu lệnh kiểm thử và rà soát 
Hãy kiểm tra lại kết quả đối soát ở bốn tình huống sau:
1. Hai ảnh trùng phải chỉ được tính một lần.
2. Đơn trả thiếu phải hiển thị đúng số tiền còn thiếu.
3. Ảnh có sai mã đơn phải ở trạng thái Cần kiểm tra, không tự động ghép.
4. Ảnh chỉ là tin nhắn, không phải giao dịch, phải bị loại khỏi số tiền đã đối soát.

Với mỗi tình huống, trả kết quả Đạt/Chưa đạt và dẫn chứng từ file nguồn, Excel và dashboard. Nếu có lỗi, nêu rõ nguyên nhân, chỉ sửa kết quả khi có bằng chứng rồi kiểm tra lại tính nhất quán giữa Excel và dashboard. Không sửa hoặc xóa dữ liệu nguồn.
Đầu ra đạt yêu cầu: Người phụ trách biết đơn nào cần nhắc thanh toán, ảnh nào cần xem lại và có thể lần về dữ liệu nguồn. Không dùng kết quả từ ảnh để tự động xác nhận đã nhận tiền thực tế.
Tóm tắt

Nhìn lại toàn bộ quy trình

  1. 1Cài Skill
  2. 2Nạp dữ liệu
  3. 3Đọc và ghép
  4. 4Xuất báo cáo
  5. 5Kiểm tra
Skill có sẵnExcel đối soátDashboard HTML
1
Cài Skill có sẵnTải repo, đọc hướng dẫn và xác định đúng thư mục.
2
Dùng nhiều lầnThay bộ Excel và ảnh cho ngày đối soát mới.
3
Kiểm soát ngoại lệGiao dịch trùng hoặc mơ hồ phải có người xem lại.
4
Đầu ra rõ ràngExcel để kiểm tra chi tiết, dashboard để theo dõi nhanh.

Sau khi thực hành, bạn có thể tái sử dụng Skill cho các lần đối soát tiếp theo. Chỉ cần cung cấp bộ ảnh và danh sách đơn mới, kiểm tra ánh xạ cột rồi chạy lại.