Tự dựng trợ lý AI (5/5): nối trung tâm chỉ huy với trợ lý thật
Bài cuối loạt Tự dựng trợ lý AI: máy chủ cầu nối chạy Claude Code ngầm, hook ghi sổ trạng thái, hành tinh sáng theo việc thật, bấm duyệt hai lần thư mới được gửi.
Hướng dẫn5 phút đọc
Bốn bài trước dựng từng phần riêng: trung tâm chỉ huy 3D, trợ lý chính, trợ lý nghiên cứu và trợ lý thư ký. Bài 5 nối chúng lại. Bạn gõ lệnh ngay trên hệ mặt trời, hành tinh sáng lên theo việc trợ lý đang làm thật, và thư chỉ được gửi khi bạn bấm duyệt.
Đọc xong, bạn hiểu kiến trúc của cả hệ thống, có 4 prompt để nối, và biết vì sao nút duyệt dùng một mã chỉ dùng được một lần.
Kiến trúc: bốn mảnh, tất cả trong máy bạn
- Trung tâm chỉ huyGõ lệnh, bấm duyệt
- Máy chủ cầu nốiNhận lệnh, gọi Claude Code
- Claude CodeChạy ngầm, giao trợ lý con
- HookGhi file trạng thái để vẽ
- Bridge server (máy chủ cầu nối): một máy chủ nhỏ viết bằng Node.js, chỉ nghe ở
127.0.0.1:47870. Nó nhận lệnh từ trang web, rồi chạy Claude Code ở chế độ không giao diện bằng lệnhclaude -p(tài liệu chạy Claude Code bằng lệnh, kiểm tra ngày 01/11/2026). - Hook ghi sổ: mỗi khi trợ lý nhận lệnh, giao việc, làm xong, tạo bản nháp, hook ghi vào
trang-thai/trang-thai.json. - Trung tâm chỉ huy đọc file đó mỗi giây. Đây đúng là "hợp đồng" dữ liệu đã làm ở bài 1, nên giao diện gần như không phải viết lại.
Bốn prompt
| Prompt | Làm gì |
|---|---|
| 1 | Viết máy chủ cầu nối: chỉ nghe trong máy, mỗi lúc một việc, chỉ cho các công cụ cần thiết, không có công cụ gửi thư |
| 2 | Viết hook ghi sổ trạng thái đúng hình dạng giao diện đọc |
| 3 | Cho giao diện đọc dữ liệu thật khi mở từ máy chủ; mở file trực tiếp thì vẫn chạy trình diễn |
| 4 | Nối nút Duyệt gửi với mã duyệt dùng một lần |
Một chi tiết ở prompt 1: khi Claude Code chạy ngầm, công cụ Gmail mang tên khác trong app. Prompt bảo Claude chạy thử một lần để xem tên thật rồi mới thêm vào quyền của trợ lý thư ký. Lại là bài học của bài 4: đừng đoán tên công cụ.
Chạy xong prompt 3, mở http://127.0.0.1:47870 bằng Chrome. Góc trái hiện Đã kết nối. Sao Thổ và Trái Đất sáng màu hai phòng thật, sáu hành tinh còn lại vẫn chờ.
Chạy thật
Câu lệnh gõ trên trung tâm chỉ huy trong video:
Nghiên cứu mới giá vàng trong nước hôm nay (tìm lại, không dùng báo cáo cũ), rồi soạn email tóm tắt gửi anh Minh (minh@example.com).Mặt Trời chớp, tia sáng bay sang Sao Thổ. Sao Thổ nhấp nháy suốt lúc trợ lý nghiên cứu làm việc, khoảng một phút rưỡi trong video. Xong, tia sáng sang Trái Đất, thư ký soạn thư.
Khi bản nháp tạo xong, camera bay tới Trái Đất. Bảng bên phải hiện thư nháp chờ duyệt: người nhận, tiêu đề, nội dung. Bạn đọc thư ngay trên trung tâm chỉ huy.
Vì sao duyệt phải bấm hai lần, và mã chỉ dùng một lần
Ở bài 2, hàng rào số 3 chặn mọi lệnh gửi thư, trừ khi có một file duyệt cho đúng việc đó. Bài 5 dùng chính cơ chế này:
- Bạn bấm Duyệt gửi, nút đổi thành "Bấm lần nữa để gửi". Bấm lần hai mới tính.
- Máy chủ cầu nối tạo file duyệt cho đúng một bản nháp, hết hạn sau 10 phút. Claude không được tự tạo file này: hook chặn.
- Máy chủ chạy Claude Code với đúng một công cụ: gửi bản nháp đó.
- Hook thấy file duyệt khớp thì cho gửi, rồi cất file vào
_cho-xoa/. Mã không dùng lại được.
Hai lớp này giữ thư không bị gửi nhầm: bấm hai lần thì khó trượt tay, mã dùng một lần thì không ai dùng lại được lần duyệt cũ để gửi thư khác.
Một bài học từ lúc làm video: nếu bạn chạy thử trên một bản sao, nhớ tắt máy chủ của bản sao trước khi chạy bản chính. Hai máy chủ không thể cùng nghe cổng 47870, nên bản chạy trước chiếm cổng và trang trung tâm chỉ huy nói chuyện với nhầm bản.
Tự kiểm và bản hoàn chỉnh
Script kiểm tra bài 5 xem máy chủ (chỉ nghe trong máy, có các đường dẫn API), hook ghi sổ, giao diện đọc dữ liệu thật, quyền Gmail khi chạy ngầm, hàng rào gửi thư, và có ít nhất một thư đã gửi bằng nút duyệt. Máy chủ phải đang chạy khi kiểm. Bản trong video đạt 13/13 mục.
Kit bài 5 có thêm bản hoàn chỉnh của cả hệ thống sau 5 bài, đã làm sạch dữ liệu của lần quay. Bạn dùng nó để đối chiếu khi kẹt, hoặc chạy thử ngay. Nên tự làm 5 bài trước: tự dựng mới hiểu từng lớp để sau này sửa và gắn thêm trợ lý con.
Tải kit bài 5 kèm bản hoàn chỉnh (.zip)
Sáu quỹ đạo còn trống
Hệ thống của bạn giờ có một trợ lý chính, hai trợ lý con và một trung tâm chỉ huy. Mỗi trợ lý con mới chỉ cần tạo theo khuôn ở bài 3 rồi khai báo vào danh sách phòng là có hành tinh riêng. Bạn bắt đầu với nghề nào, tùy công việc của bạn.