Tóm tắt nhanh:
- Agentic Inbox là một email client mã nguồn mở (Apache 2.0) chạy hoàn toàn trên Cloudflare Workers, không cần VPS hay máy chủ ảo truyền thống.
- Kiến trúc serverless tận dụng Durable Objects (SQLite) để cách ly từng mailbox, R2 lưu trữ tệp đính kèm và Email Routing xử lý email đến/đi.
- Tích hợp sẵn AI agent xây dựng trên Cloudflare Agents SDK và Workers AI (mô hình
@cf/moonshotai/kimi-k2.5), có khả năng đọc, tìm kiếm, tóm tắt và tự động soạn nháp phản hồi.- Tính năng nổi bật: auto-draft khi có email mới, 9 công cụ email tích hợp, hỗ trợ MCP server cho phép kết nối với Claude Code, Cursor.
- Bảo mật bằng Cloudflare Access JWT, chi phí vận hành cực thấp nhờ mô hình pay-as-you-go của Cloudflare.
Giới thiệu tổng quan về Agentic Inbox
Trong kỷ nguyên mà email vẫn là kênh giao tiếp chuyên nghiệp chủ đạo, việc quản lý hàng trăm email mỗi ngày đã trở thành gánh nặng thực sự. Các giải pháp như Gmail hay Outlook tuy mạnh mẽ nhưng đi kèm sự phụ thuộc vào nhà cung cấp, lo ngại về quyền riêng tư và chi phí leo thang khi mở rộng. Đây chính là lúc Agentic Inbox xuất hiện như một câu trả lời đột phá.
Agentic Inbox là một dự án mã nguồn mở chính thức từ Cloudflare, cho phép bạn tự host một email client hiện đại với AI agent tích hợp, vận hành hoàn toàn trên hạ tầng Cloudflare Workers. Khác với những giải pháp self-hosted truyền thống đòi hỏi bạn phải duy trì một máy chủ Linux, cấu hình Postfix, Dovecot, SpamAssassin, rồi lo lắng về uptime và bảo mật, Agentic Inbox tận dụng triệt để mô hình serverless edge computing.
┌──────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ Browser │────>│ Hono Worker │────>│ MailboxDO │
│ React SPA │ │ (API + SSR) │ │ (SQLite + R2) │
│ Agent Panel │ │ │ └─────────────────┘
└──────┬───────┘ │ /agents/* ──────┼────>┌─────────────────┐
│ │ │ │ EmailAgent DO │
│ WebSocket │ │ │ (AIChatAgent) │
└─────────────┤ │ │ 9 email tools │
│ │────>│ Workers AI │
└──────────────────┘ └─────────────────┘Bài toán mà Agentic Inbox giải quyết
Công cụ này nhắm đến ba nhóm vấn đề cốt lõi:
- Loại bỏ chi phí hạ tầng cố định: bạn chỉ trả tiền cho những gì sử dụng (request, storage, AI inference) – không có máy chủ rảnh rỗi 24/7.
- Tự chủ dữ liệu: toàn bộ email, tệp đính kèm, lịch sử chat với AI đều nằm trong tài khoản Cloudflare của chính bạn.
- Tự động hóa thông minh: AI agent đọc email mới, hiểu ngữ cảnh, tự nháp phản hồi – giảm 70-80% thời gian xử lý hộp thư thủ công.
Lợi thế của triển khai serverless trên Cloudflare
Kiến trúc của Agentic Inbox khai thác bốn dịch vụ Cloudflare trọng yếu:
- Cloudflare Workers: chạy mã JavaScript/TypeScript ở rìa mạng (edge), độ trễ cực thấp toàn cầu.
- Durable Objects với SQLite: mỗi mailbox được cách ly trong một Durable Object riêng, có cơ sở dữ liệu SQLite nhúng – đảm bảo tính nhất quán và bảo mật.
- R2 Storage: lưu trữ tệp đính kèm với chi phí thấp, không phí egress.
- Workers AI: chạy LLM (mô hình
@cf/moonshotai/kimi-k2.5) ngay trên hạ tầng Cloudflare.
AI agent giúp ích như thế nào
AI Agent không chỉ là một chatbot trang trí. Nó được trang bị 9 công cụ email chuyên biệt cho phép:
- Đọc và tóm tắt nội dung email theo yêu cầu.
- Tìm kiếm ngữ nghĩa trong toàn bộ thư mục.
- Tự động soạn nháp phản hồi (auto-draft) khi có email đến.
- Soạn email mới, trả lời, chuyển tiếp – nhưng luôn yêu cầu xác nhận rõ ràng trước khi gửi.
- Custom system prompt cho từng mailbox riêng biệt, lịch sử chat persistent.
Hướng dẫn chi tiết các bước cài đặt và deploy
Trước khi bắt đầu, hãy đảm bảo bạn đã chuẩn bị đầy đủ các điều kiện tiên quyết. Mã nguồn và tài liệu chính thức có tại kho lưu trữ Cloudflare Agentic Inbox trên GitHub.
Yêu cầu tiên quyết
- Tài khoản Cloudflare đã được kích hoạt và một tên miền đã được kết nối.
- Email Routing được bật để nhận email.
- Email Service được bật để gửi email đi (binding
send_email). - Workers AI được kích hoạt để chạy AI agent.
- Cloudflare Access đã cấu hình – bắt buộc trong môi trường production.
Bước 1: Deploy nhanh tới Cloudflare
Cách dễ nhất là sử dụng nút “Deploy to Cloudflare” có sẵn trên trang README của repository. Quy trình deploy sẽ tự động provision R2 bucket, Durable Objects và Workers AI.
Trong quá trình này, hệ thống sẽ hỏi bạn biến môi trường DOMAINS – đây là tên miền bạn muốn nhận email (ví dụ yourdomain.com, sẽ tạo ra các địa chỉ kiểu [email protected]).
Bước 2: Cấu hình Cloudflare Access
Đây là bước bắt buộc và cực kỳ quan trọng vì Agentic Inbox được thiết kế để bảo vệ hộp thư của bạn khỏi truy cập trái phép từ Internet.
- Vào Worker vừa deploy, mở Settings > Domains & Routes.
- Bật tính năng one-click Cloudflare Access.
- Modal hiện ra sẽ cung cấp hai giá trị:
POLICY_AUDvàTEAM_DOMAIN. - Thiết lập hai giá trị này thành secrets cho Worker:
wrangler secret put POLICY_AUD
wrangler secret put TEAM_DOMAINLưu ý: TEAM_DOMAIN có thể là URL team Access của bạn hoặc URL đầy đủ dạng .../cdn-cgi/access/certs.
Bước 3: Thiết lập Email Routing
Trong Cloudflare Dashboard, điều hướng đến domain của bạn > Email Routing, tạo một catch-all rule trỏ tất cả email đến Worker đã deploy. Catch-all rule giúp mọi địa chỉ thuộc miền của bạn đều được route đến Agentic Inbox.
Bước 4: Bật Email Service để gửi đi
Worker cần binding send_email để có khả năng gửi email outbound. Cấu hình này được khai báo trong file wrangler.jsonc của dự án.
Bước 5: Phát triển local (tùy chọn)
Nếu muốn customize trước khi deploy chính thức:
git clone https://github.com/cloudflare/agentic-inbox.git
cd agentic-inbox
npm install
npm run devĐặt domain của bạn trong wrangler.jsonc, sau đó tạo R2 bucket:
wrangler r2 bucket create agentic-inboxCuối cùng deploy bằng lệnh:
npm run deployBước 6: Tạo mailbox đầu tiên
Truy cập URL ứng dụng đã deploy (ví dụ https://your-app.workers.dev), đăng nhập qua Cloudflare Access, sau đó tạo một mailbox cho bất kỳ địa chỉ nào trên miền của bạn (ví dụ [email protected]). Mỗi mailbox sẽ được khởi tạo trong một Durable Object riêng với database SQLite độc lập.
Hướng dẫn sử dụng thực tế
Truy cập giao diện và gửi/nhận email
Sau khi đăng nhập thành công, bạn sẽ thấy giao diện email hiện đại được xây dựng bằng React 19, React Router v7, Tailwind CSS và TipTap (rich text editor). Các tính năng cơ bản bao gồm:
- Soạn email với rich text composer hỗ trợ định dạng đa dạng.
- Reply/Forward threading – hiển thị chuỗi hội thoại trực quan.
- Folder organization – tổ chức theo thư mục.
- Search – tìm kiếm nhanh trong toàn bộ mailbox.
- Attachments – đính kèm tệp lưu trữ trên R2.
AI agent hoạt động như thế nào
Panel AI agent nằm bên phải giao diện chính, hoạt động qua kết nối WebSocket tới EmailAgent Durable Object. Một số kịch bản sử dụng phổ biến:
- Phân loại và tóm tắt: hỏi agent “Tóm tắt 5 email mới nhất từ khách hàng X” – nó sẽ dùng tool tìm kiếm, đọc nội dung và trả về tóm tắt streaming markdown.
- Auto-draft tự động: ngay khi có email mới đến, agent sẽ đọc, hiểu ngữ cảnh và tạo sẵn một bản nháp phản hồi. Bạn chỉ cần xem lại, chỉnh sửa nếu cần và xác nhận gửi – không bao giờ gửi tự động không có sự đồng ý của bạn.
- Tìm kiếm ngữ nghĩa: thay vì gõ từ khóa, bạn có thể hỏi “Tìm email nào liên quan đến hợp đồng quý 4 năm ngoái” và agent sẽ thực hiện đa bước tìm kiếm.
- Custom system prompt: mỗi mailbox có thể có một system prompt riêng, ví dụ mailbox công việc dùng giọng văn formal, mailbox cá nhân thân thiện hơn.
Mở rộng qua MCP server
Một tính năng nâng cao của Agentic Inbox là MCP server tại endpoint /mcp. Điều này cho phép bạn kết nối các công cụ AI bên ngoài như Claude Code, Cursor trực tiếp vào hộp thư của mình bằng cách truyền tham số mailboxId. Lưu ý quan trọng: bất kỳ user nào vượt qua chính sách Cloudflare Access đều có thể thao tác trên mọi mailbox – đây là biên giới tin cậy duy nhất theo thiết kế.
Agentic Inbox đại diện cho thế hệ ứng dụng email tiếp theo: serverless, AI-native, self-hosted và tối ưu chi phí. Với kiến trúc hoàn toàn dựa trên Cloudflare Workers, bạn có được một hệ thống email thông minh mà không phải lo lắng về máy chủ, scaling hay bảo mật hạ tầng.
Để bắt đầu, hãy fork repository tại github.com/cloudflare/agentic-inbox, thử nghiệm trên một subdomain trước khi áp dụng cho miền chính. Một số hướng mở rộng đáng cân nhắc: tinh chỉnh system prompt cho từng workflow nghiệp vụ, tích hợp các tool email tùy chỉnh, hoặc kết hợp với calendar/CRM thông qua MCP. Trong tương lai gần, khi Workers AI bổ sung thêm các mô hình mạnh hơn, hiệu năng của AI agent trong Agentic Inbox còn có thể tiến xa hơn nữa.
