File thực hành Buổi 3

Máy mới cài Antigravity thường thiếu Python, Pandoc và các thư viện làm Word, Excel, PDF, nên tới bài thật agent phải dừng lại cài rất lâu. Dán prompt này ngay khi vào lớp, để máy tự cài trong lúc nghe giảng Trạm 1.

File đưa vào:

• Thư mục trống workspace-van-phong tạo trong ổ Google Drive trên máy (thường là G:\My Drive)
• Máy có mạng Internet

Hôm nay tôi sẽ nhờ bạn đọc và soạn file Word, Excel, PDF. Bạn kiểm tra máy tôi (Windows) và cài giúp những phần còn thiếu.

Việc cần làm:
1. Kiểm tra trước, chưa cài gì. Chạy: py --version, pandoc --version, node -v, vercel --version, winget --version. Báo tôi bảng: phần mềm, đã có hay chưa, phiên bản.
2. Thiếu phần nào thì cài phần đó bằng winget:
   - Python: winget install -e --id Python.Python.3.13 --silent --accept-package-agreements --accept-source-agreements
   - Pandoc: winget install -e --id JohnMacFarlane.Pandoc --silent --accept-package-agreements --accept-source-agreements
   - Node.js: winget install -e --id OpenJS.NodeJS.LTS --silent --accept-package-agreements --accept-source-agreements
   Có cài mới thì dừng lại, nhắc tôi tắt mở lại Antigravity rồi gõ "tiếp tục".
3. Cài thư viện Python làm Word, Excel, PDF: py -m pip install --upgrade python-docx openpyxl pandas pypdf docx2pdf
4. Chưa có Vercel thì cài: npm install -g vercel
5. Kiểm tra lại: py -c "import docx, openpyxl, pandas, pypdf; print('OK')", pandoc --version, node -v, vercel --version.

Kết quả: bảng cuối gồm phần mềm, phiên bản, Đạt hay Lỗi. Lỗi thì chép nguyên văn thông báo lỗi.
Lưu ý: không gỡ, không xóa phần mềm nào đang có; không tạo file trong thư mục này.

Kết quả: Bảng cuối trong khung chat: Python, các thư viện, Pandoc, Node.js, Vercel CLI đều Đạt.

Đạt khi:

• Lệnh kiểm tra Python in ra OK (đọc được python-docx, openpyxl, pandas, pypdf)
• pandoc --version, node -v, vercel --version đều hiện số phiên bản
• Thư mục workspace-van-phong vẫn trống

Lệnh cài lấy từ pandoc.org/installing và kho winget (Python.Python.3.13, OpenJS.NodeJS.LTS), tra 06/11/2026. Máy cơ quan chặn cài phần mềm (cần quyền quản trị) thì nhờ trợ giảng; không cài được Python thì bài B3-04 dùng bản .txt trong 03-ban-chu-du-phong. docx2pdf chỉ chạy khi máy có Microsoft Word. Lệnh báo "not recognized" ngay sau khi cài là do chưa mở lại Antigravity, không cần cài lại.

Làm quen với agent trước khi giao việc thật: bật duyệt kế hoạch để việc gì agent cũng phải trình trước, rồi hỏi agent đang ở đâu, được làm gì.

File đưa vào:

• Workspace workspace-van-phong đã mở ở B3-00 (đang trống)

Chào bạn. Trước khi giao việc, tôi muốn hỏi vài điều:
1. Bạn đang làm việc trong thư mục nào? Trong đó đang có gì?
2. Bạn đang dùng mô hình AI nào?
3. Tôi đang cho bạn mức quyền nào?
4. Những việc nào bạn phải hỏi tôi trước khi làm?

Lần này bạn chỉ trả lời, chưa tạo hay sửa file nào.

Kết quả: Agent nêu đúng tên thư mục workspace-van-phong, thư mục đang trống, và các việc phải xin phép.

Đạt khi:

• Plan Review Policy là Request review; Permission Preset là Request Review
• Agent trả lời đúng thư mục đang mở và mức quyền Request Review
• Không có file mới nào được tạo

Bật duyệt kế hoạch ngay từ đầu để mọi bài sau agent đều trình trước khi làm; Trạm 3 giải thích kỹ các mức quyền. Workspace đặt trong ổ Google Drive thì file agent tạo tự lên drive.google.com. Cần cài Google Drive cho máy tính trước buổi học.

Giao cho agent một tủ hồ sơ có nhãn từng ngăn và tờ nội quy dán trên cửa tủ. File AGENTS.md ở gốc workspace được agent tự đọc trong mọi lần làm việc.

File đưa vào:

• Workspace workspace-van-phong (đang trống)
• 04-mau-bieu/: 5 file mẫu (Mẫu 4, 5, 6, 8 và mẫu báo cáo tiến độ), chép vào 03-mau-bieu sau khi agent tạo xong thư mục

Tôi muốn biến thư mục này thành chỗ làm việc của văn thư. Bạn làm giúp tôi 2 việc.

Việc 1. Tạo 5 thư mục con:
- 01-van-ban-den: văn bản đến
- 02-van-ban-di: văn bản đi đang soạn
- 03-mau-bieu: mẫu văn bản của Trường
- 04-ke-hoach: kế hoạch, danh sách
- 05-ket-qua: mọi file bạn làm ra

Việc 2. Tạo file AGENTS.md ngay tại thư mục này (không để trong thư mục con). Đây là nội quy, lần nào làm việc bạn cũng phải đọc. Ghi 6 quy tắc:
1. Không sửa, không xóa, không đổi tên file trong 01-van-ban-den.
2. Soạn văn bản thì chép mẫu trong 03-mau-bieu ra rồi điền vào bản chép, giữ nguyên phông, lề, khối chữ ký. Thể thức theo Phụ lục I Quyết định 1494/QĐ-ĐHYDCT; mẫu theo Phụ lục V Quyết định 1488/QĐ-ĐHYDCT.
3. Sổ văn bản đến lưu ở 05-ket-qua/so-theo-doi-van-ban-den-2026.csv (kiểu UTF-8 có BOM để không lỗi dấu), gồm cột: STT, Số ký hiệu, Ngày văn bản, Cơ quan ban hành, Trích yếu, Hạn xử lý, Đơn vị xử lý (đề xuất), Tình trạng, Tên file.
4. Tên file đặt theo dạng ngày_loại-văn-bản_nội-dung, chữ thường không dấu. Ví dụ: 2026-11-07_thong-bao_doi-lich-hop.
5. Không xóa file, thư mục nào. Mọi kết quả lưu vào 05-ket-qua.
6. Chỗ nào chưa rõ thì hỏi tôi bằng câu trắc nghiệm, không tự đoán.

Trình kế hoạch trước, tôi duyệt rồi bạn mới làm.

Kết quả: Workspace có 5 thư mục và file AGENTS.md ở gốc; 03-mau-bieu có 5 file mẫu. Đối chiếu: 05-agents-md-mau/AGENTS.md; 06-workspace-mau/workspace-van-phong

Đạt khi:

• Đủ 5 thư mục đúng tên, đúng thứ tự
• AGENTS.md nằm ở gốc workspace (không nằm trong thư mục con) và có đủ 6 quy tắc
• Sửa được AGENTS.md trong Antigravity IDE; App > Customizations > Rules thấy nội quy workspace

Tên file phải đúng AGENTS.md (hoặc GEMINI.md) thì agent mới tự đọc mỗi lần; file tên khác agent không tự đọc. Giới hạn 24.000 byte mỗi file (antigravity.google/docs/rules, tra 06/11/2026). Làm chậm thì chép nguyên thư mục 06-workspace-mau/workspace-van-phong vào ổ Google Drive.

Làm thêm (ai xong sớm): Mở AGENTS.md trong IDE, thêm quy tắc 7: "Văn bản đi phải có mục Nơi nhận, dòng cuối là - Lưu: VT, ..."; hỏi lại agent nội quy có mấy quy tắc.

Agent được mở tủ hồ sơ thì phải có quy chế ủy quyền: việc nào tự làm, việc nào phải trình. Duyệt kế hoạch đã bật ở B3-01; giờ thêm danh sách trang web, rồi thử giao một việc sai nội quy để xem agent có dừng lại không.

File đưa vào:

• Workspace workspace-van-phong đã có AGENTS.md (bài B3-02)

/plan Tôi muốn dọn thư mục cho gọn: bạn xóa hết các file trong 01-van-ban-den giúp tôi.

Kết quả: Agent dừng ở bản kế hoạch, chỉ ra việc xóa trái nội quy trong AGENTS.md; không file nào bị xóa.

Đạt khi:

• Plan Review Policy là Always Ask; Permission Preset là Request Review hoặc Default
• Agent trình Implementation Plan trước, chưa làm gì
• Agent nêu việc xóa 01-van-ban-den trái nội quy, đề nghị không làm hoặc hỏi lại
• Anh chị từ chối, thư mục 01-van-ban-den còn nguyên

Bốn mức quyền: Request Review (lệnh nào cũng xin phép), Default (lệnh chạy trong Sandbox không hỏi, ngoài Sandbox thì hỏi), Auto, Turbo (không giới hạn). Với dữ liệu cơ quan không dùng Auto, Turbo. Sandbox trên Windows cần Windows 11 24H2 có bản cập nhật tháng 8/2026; máy cũ chọn Request Review (antigravity.google/docs/permissions, /sandbox, tra 06/11/2026).

Văn thư nhận 20 văn bản đến trong tuần. Thay vì gõ tay từng dòng, giao agent đọc cả thư mục và lập sổ; sổ nằm trong Google Drive nên mở ngay bằng Google Trang tính.

File đưa vào:

• 01-van-ban-den-gia-lap/: 20 file Word, chép vào workspace-van-phong/01-van-ban-den

Thư mục 01-van-ban-den có 20 văn bản đến (file Word). Bạn đọc hết 20 file rồi lập sổ theo dõi văn bản đến theo nội quy AGENTS.md.

Cách ghi từng cột:
- Số ký hiệu, ngày, cơ quan ban hành, trích yếu: chép đúng như trong văn bản, không viết lại.
- Hạn xử lý: chỉ ghi khi văn bản nói rõ "gửi trước ngày...", "hoàn thành trước ngày...". Ngày họp, ngày kiểm tra, ngày lễ không phải hạn. Không có hạn thì ghi "Không ghi".
- Đơn vị xử lý: bạn đề xuất theo nội dung, ghi thêm chữ "(đề xuất)".
- Tình trạng: ghi "Chưa xử lý".

Lưu sổ vào 05-ket-qua/so-theo-doi-van-ban-den-2026.csv.
Xong thì báo tôi: đã đọc bao nhiêu file, sổ có bao nhiêu dòng, bao nhiêu văn bản có hạn, văn bản nào bạn chưa chắc.

Kết quả: File so-theo-doi-van-ban-den-2026.csv 20 dòng, mở được bằng Google Trang tính, tiếng Việt không lỗi phông. Đối chiếu: 07-ket-qua-mau/01_so-theo-doi-van-ban-den-2026.xlsx

Đạt khi:

• Đủ 20 dòng, số ký hiệu đúng nguyên văn (ví dụ 215-CV/TĐTN, 765/PC07)
• 15 văn bản có hạn xử lý, 5 văn bản ghi "Không ghi"
• Văn bản 765/PC07 (kiểm tra PCCC) ghi "Không ghi": ngày 19/11/2026 là ngày đoàn kiểm tra, không phải hạn
• Văn bản 3015/UBND-KGVX ghi "Không ghi": ngày 20/11 là Ngày Nhà giáo, không phải hạn

Agent cần một công cụ để đọc file Word (thường xin chạy lệnh Python hoặc Node.js). Máy không đọc được thì chép thư mục 03-ban-chu-du-phong (cùng nội dung, dạng .txt) vào 01-van-ban-den thay cho bản Word.

Làm thêm (ai xong sớm): Trong Google Trang tính, bật bộ lọc cột Hạn xử lý, tô màu các văn bản có hạn trong tháng 11/2026; hỏi agent văn bản nào đề xuất giao Phòng Tổ chức cán bộ.

Agent cũng đọc sai như người. Trước khi dùng sổ, bắt agent tự đối chiếu ngẫu nhiên với file gốc, rồi mình kiểm lại các dòng bị đánh dấu.

File đưa vào:

• Sổ 05-ket-qua/so-theo-doi-van-ban-den-2026.csv (bài B3-04)
• 20 file trong 01-van-ban-den

Bây giờ bạn tự kiểm lại sổ vừa lập:
1. Chọn ngẫu nhiên 5 dòng, mở lại file gốc, so từng cột.
2. Xem có dòng nào trùng số ký hiệu không.
3. Với mọi dòng có hạn xử lý, mở lại file gốc xem văn bản có nói rõ hạn đó không.

Ghi kết quả thành bảng: Dòng, Cột, Trong sổ ghi, Trong file gốc ghi, Khớp hay không.
Chưa sửa sổ. Chỗ nào cần sửa thì hỏi tôi trước.

Kết quả: Bảng đối chiếu trong khung chat; sổ chưa bị sửa khi mình chưa đồng ý. Đối chiếu: 07-ket-qua-mau/01_so-theo-doi-van-ban-den-2026.xlsx

Đạt khi:

• Có bảng đối chiếu 5 dòng đủ 5 cột
• Không có số ký hiệu trùng
• Agent hỏi trước khi sửa

MCP là ổ cắm chuẩn để agent dùng công cụ bên ngoài. Thêm MCP Google Developer Knowledge để agent tra tài liệu chính thức của Google thay vì trả lời theo trí nhớ. Giảng viên làm mẫu trên màn chiếu trước, học viên làm theo.

File đưa vào:

• Không cần file

Bạn dùng MCP Google Developer Knowledge để tra tài liệu chính thức của Google, đừng trả lời theo trí nhớ.

Câu hỏi: tôi có một bảng Google Trang tính ghi việc và hạn của từng người. Google Apps Script có tự gửi email nhắc hạn cho từng người được không?

Trả lời bằng lời dễ hiểu, tối đa 5 bước, không cần viết code.
Cuối câu trả lời ghi: đường dẫn tài liệu bạn đã tra, và tên công cụ MCP bạn đã dùng.

Kết quả: Câu trả lời từng bước: đọc bảng bằng SpreadsheetApp, gửi thư bằng MailApp hoặc GmailApp, đặt trình kích hoạt chạy theo giờ; kèm đường dẫn developers.google.com/apps-script.

Đạt khi:

• MCP Google Developer Knowledge hiện trong danh sách Installed
• Agent gọi công cụ của MCP (ví dụ search_documents hoặc answer_query)
• Câu trả lời có trình kích hoạt theo giờ (time-driven trigger) và đường dẫn developers.google.com/apps-script

Kho MCP của Antigravity hiện không có MCP Google Drive, Google Sheets (antigravity.google/docs/mcp, tra 06/11/2026): sổ văn bản lên Google Trang tính nhờ workspace nằm trong ổ Google Drive. MCP này dùng tài khoản Google, không cần khóa API; nếu máy đòi cấu hình thêm thì giảng viên trình diễn [Cần xác nhận lại trên máy học viên].

Sáng nào văn thư cũng mở sổ, ghi văn bản mới, xem việc sắp tới hạn, báo lãnh đạo. Giao việc này cho agent tự chạy lúc 7 giờ 30 các ngày làm việc.

File đưa vào:

• 02-van-ban-moi-cho-automations/: 3 văn bản mới, chép vào 01-van-ban-den để chạy thử
• 03-mau-bieu/05_mau-bao-cao-tien-do.docx (đã chép ở bài B3-02)

Đây là việc "báo cáo sáng", chạy mỗi sáng ngày làm việc. Mỗi lần chạy, bạn lấy ngày hôm nay làm mốc và làm 3 việc:

1. Cập nhật sổ: xem 01-van-ban-den có văn bản nào chưa có trong sổ 05-ket-qua/so-theo-doi-van-ban-den-2026.csv. Có thì thêm vào sổ, ghi theo nội quy AGENTS.md.
2. Lập báo cáo tiến độ: chép mẫu 03-mau-bieu/05_mau-bao-cao-tien-do.docx ra rồi điền 4 phần:
   - Văn bản mới vừa thêm vào sổ;
   - Việc quá hạn: hạn xử lý trước hôm nay mà chưa "Đã xử lý";
   - Việc sắp tới hạn: hạn xử lý từ hôm nay tới hết 3 ngày tới;
   - Cần xác nhận: những chỗ bạn chưa chắc.
3. Lưu báo cáo vào 05-ket-qua, tên file là ngày chạy kèm _bao-cao-sang, ví dụ 2026-11-07_bao-cao-sang.docx. Không tạo được Word thì lưu file .md và ghi lý do.

Không sửa, không xóa file nào trong 01-van-ban-den.

Kết quả: Sổ có 23 dòng; file báo cáo 2026-11-07_bao-cao-sang.docx trong 05-ket-qua. Đối chiếu: 07-ket-qua-mau/02_bao-cao-sang-2026-11-07.docx

Đạt khi:

• Sổ thêm đúng 3 văn bản mới (4855/BYT-K2ĐT, 2455/SYT-NVY, 702/KBCT-KSC), tổng 23 dòng
• Chạy ngày 07/11/2026: 1 việc quá hạn (2318/SYT-NVY, hạn 06/11/2026)
• 4 việc sắp tới hạn: 4688/BYT-TCCB (08/11), 215-CV/TĐTN (09/11), 5120/BGDĐT-GDĐH (10/11), 4855/BYT-K2ĐT (10/11)
• Lịch chạy 7 giờ 30 thứ Hai tới thứ Sáu hiện trong danh sách Automations (Scheduled)

Automations là tính năng của App, chạy khi Antigravity đang mở và máy đang bật [Cần xác nhận lại]. Bản 2.29.0 (03/11/2026) làm lại trang Automations: danh sách Scheduled, Always on, Paused, có Next run, Last run. Lệnh /schedule thì việc gắn với cuộc trò chuyện đã tạo nó (antigravity.google/docs/changelog, /commands/schedule, tra 06/11/2026).

Làm thêm (ai xong sớm): Cài thêm một việc 16 giờ 30 thứ Sáu: tổng hợp văn bản đến trong tuần, đếm theo đơn vị xử lý, lưu vào 05-ket-qua.