Tự dựng trợ lý AI (4/5): trợ lý thư ký nối Gmail, chỉ soạn nháp

Trợ lý nghiên cứu ở bài 3 đã tìm được thông tin. Bài 4 thêm người soạn thư: trợ lý thư ký, đọc được Gmail thật của bạn nhưng chỉ được soạn bản nháp. Gửi đi hay không là việc của bạn.

Đọc xong, bạn biết cách kết nối Gmail cho Claude, cách cấp đúng quyền cho trợ lý con, và cách chặn chắc chắn mọi lệnh gửi thư bằng hook.

Kết nối khác với quyền

Claude nói chuyện với Gmail qua một connector (cổng kết nối). Connector dùng chuẩn MCP, một chuẩn chung để AI trao đổi với dịch vụ bên ngoài. Nhưng có cổng chưa có nghĩa là được vào: bạn vẫn phải đăng nhập và đồng ý cấp quyền qua bước OAuth, tức bước Google hỏi bạn có cho phép Claude truy cập hay không. Bài Skill, RAG, MCP là gì giải thích kỹ hơn về MCP.

Sau khi kết nối, trợ lý chính có cả bộ công cụ Gmail, kể cả gửi thư. Bài này thu hẹp lại thành hai lớp:

Bước 1: tạo trợ lý thư ký

Prompt 1 trong kit tạo .claude/agents/thu-ky.md theo khuôn chung của bài 3: chạy Sonnet, soạn email tiếng Việt ngắn gọn, đúng xưng hô, mỗi việc ghi một dòng nhật ký. Quy tắc số một: chỉ tạo bản nháp, không bao giờ tự gửi. Phòng thư ký gắn với Trái Đất, màu xanh ngọc.

Bước 2: kết nối Gmail (bạn tự bấm)

Bước này cấp quyền đọc hộp thư của bạn, nên bạn tự làm. Trong app Claude: thanh bên → Tùy chỉnh → Trình kết nối → Gmail → Kết nối, rồi đồng ý ở trang của Google. Tên các mục có thể đổi theo phiên bản app.

Kiểm tra quyền đọc bằng prompt 2: liệt kê tiêu đề và ngày của 3 thư mới nhất, không mở nội dung.

Bước 3: phân quyền và hàng rào

Phân quyền cho trợ lý thư ký và kiểm lại hàng rào:
 
1. Xem tên chính xác các công cụ Gmail em đang có. Cập nhật phần tools của .claude/agents/thu-ky.md: chỉ cấp công cụ tìm / đọc email và tạo, sửa bản nháp. KHÔNG cấp công cụ gửi, trả lời, chuyển tiếp, xóa, bỏ vào thùng rác.
2. Kiểm .claude/hooks/guardrail.mjs, rào 3 (ra ngoài phải duyệt): phải chặn mọi công cụ Gmail gửi thư ra ngoài (send, reply, forward) đúng với tên công cụ thật em vừa xem, trừ khi có file duyệt .claude/duyet/<mã>.json. Thiếu thì bổ sung.
3. Thêm các trường hợp đó vào .claude/hooks/thu-guardrail.mjs và chạy thử: gửi / trả lời / chuyển tiếp bị chặn, tạo bản nháp được cho qua.
Commit với mô tả ngắn.

Câu "xem tên chính xác các công cụ" quan trọng. Tên công cụ Gmail trong app có dạng mcp__<mã>__create_draft, và mã này khác nhau giữa các máy. Đoán tên thì hàng rào có thể để lọt.

Bước 4: soạn thư thật, và thử bảo nó gửi

Soạn email cảm ơn chị Lan (lan@example.com) vì buổi gặp hôm qua, và hẹn chị uống cà phê thứ Sáu tuần sau lúc 15:00.

Trợ lý chính tự tính ngày thứ Sáu tuần sau, giao thư ký soạn, rồi kiểm lại bản nháp trong Gmail. Địa chỉ example.com là tên miền dành riêng cho ví dụ, thư gửi tới đó không đến được ai.

Rồi thử bảo nó gửi luôn. Hook chặn lại: thư vẫn nằm trong mục Thư nháp. Trợ lý giải thích rằng cần một file duyệt, và theo luật nó không được tự tạo file đó.

Bước 5: hai trợ lý phối hợp

Nghiên cứu giá vàng trong nước tuần này, rồi soạn email tóm tắt gửi anh Minh (minh@example.com).

Trong video, trợ lý chính không gọi trợ lý nghiên cứu lần nữa. Nó thấy báo cáo giá vàng làm cùng ngày vẫn còn mới, nên dùng lại báo cáo đó rồi giao thư ký soạn thư. Đây là trợ lý tự quyết, có giải thích lý do. Muốn bắt nghiên cứu lại, bạn thêm "tìm lại, không dùng báo cáo cũ" vào câu lệnh.

Tự kiểm

Script kiểm tra bài 4 xem file trợ lý thư ký, registry, quyền công cụ (có soạn nháp, không có gửi), và giả lập lệnh gửi để chắc hook chặn. Bản trong video đạt 14/14 mục.

Tải kit bài 4 (.zip)

Bài cuối: nối trung tâm chỉ huy, gõ lệnh trên hệ mặt trời và bấm duyệt để thư được gửi đi.