Hướng dẫn làm chủ AgentSea Space
Tài liệu minh bạch về cài đặt máy tính/VPS, kết nối mô hình ngôn ngữ BYOK, tích hợp đa kênh và cơ chế bản quyền cục bộ.
Mục lục tài liệu nhanh (TOC)
1. Hướng dẫn thiết lập mục tiêu (Target Flow Preview)
Minh họa quy trình trải nghiệm mục tiêu dự kiến khi bộ cài chính thức và hạ tầng bản quyền hoàn tất phát hành.
Bước 1: Tải bộ cài tương ứng (Thiết kế mục tiêu)
Khi bộ cài hoàn thiện chữ ký số, người dùng sẽ tải gói cài đặt chính thức cho macOS (.dmg), Windows (.exe) hoặc kịch bản headless cho Linux VPS từ trang /space/download.
Bước 2: Kích hoạt thiết bị (Thiết kế mục tiêu)
Theo thiết kế hệ thống, người dùng đăng nhập tài khoản Cloud Hub để cấp quyền thiết bị (tối đa 01 PC và 01 VPS) và nhận vé ký số (Signed Lease).
Bước 3: Nhập API Key (BYOK) & Kênh liên lạc (Thiết kế mục tiêu)
Theo thiết kế hệ thống, người dùng sẽ cung cấp API Key từ Google AI Studio, Anthropic hoặc OpenAI, quét mã QR Zalo hoặc nhập Token Telegram để kích hoạt nhân viên trực.
2. Độ sẵn sàng cài đặt (macOS, Windows, VPS)
Công bố minh bạch về trạng thái phát hành bộ cài — Không tạo dòng lệnh hay liên kết giả định.
Hệ điều hành macOS
Yêu cầu: macOS 12.0 (Monterey) trở lên. Tối ưu cho Apple Silicon (M1/M2/M3/M4) và hỗ trợ Intel x86_64.
Trạng thái: Chưa xác minh · Chưa khả dụng (chưa phát hành gói .dmg chính thức).
Hệ điều hành Windows
Yêu cầu: Windows 10 / 11 (64-bit). Khuyến nghị RAM tối thiểu 8GB (hoặc 16GB nếu muốn chạy mô hình cục bộ Ollama).
Trạng thái: Chưa xác minh · Chưa khả dụng (chưa phát hành bộ cài .exe chính thức).
Máy chủ ảo riêng (Linux VPS)
Yêu cầu: Ubuntu 22.04 LTS hoặc 24.04 LTS. Cấu hình tối thiểu: 2 vCPU, 2GB RAM, 20GB SSD (đủ chạy headless runtime và các gateway).
Trạng thái: Chưa xác minh · Chưa khả dụng (kịch bản thiết lập headless chưa phát hành chính thức).
3. Cấu hình mô hình AI (BYOK & Local LLM)
Mô hình Bring Your Own Key: Bạn toàn quyền chọn bộ não AI và trả chi phí trực tiếp cho nhà cung cấp.
Google Gemini (Khuyên dùng cho chi phí tối ưu)
Sử dụng Gemini 3.8 Flash (dòng mô hình Gemini thế hệ mới nhất). Lấy API key miễn phí hoặc trả sau tại Google AI Studio (aistudio.google.com). Chi phí cực kỳ tiết kiệm với ngữ cảnh lớn.
Anthropic Claude (Khuyên dùng cho khả năng viết & lập luận)
Sử dụng Claude Sonnet 5 hoặc Claude Opus 5.5. Lấy API key tại console.anthropic.com. Xuất sắc trong việc hiểu tiếng Việt và xử lý bảng việc phức tạp.
OpenAI (Dòng GPT thế hệ mới nhất)
Lấy API key tại platform.openai.com. Hoạt động ổn định, độ trễ thấp và hệ sinh thái công cụ hỗ trợ phong phú.
Local LLM (Ollama / vLLM / LM Studio)
Dành cho người dùng yêu cầu bảo mật 100% không gửi dữ liệu ra bên ngoài. Chạy Ollama trên máy với các mô hình như Qwen 2.5, Llama 3.3. Kết nối qua endpoint nội bộ (ví dụ: http://127.0.0.1:11434/v1).
4. Tích hợp kênh liên lạc (Zalo, Telegram, Discord...)
Thiết kế mục tiêu (Target Design — chưa xác minh runtime): Quản lý tập trung mọi tin nhắn khách hàng trong một bảng điều khiển thống nhất.
Zalo cá nhân (Đăng nhập qua QR Code)
Theo thiết kế mục tiêu: đăng nhập trực tiếp tài khoản Zalo của bạn bằng cách quét mã QR trên màn hình Cockpit; phiên đăng nhập dự kiến được duy trì cục bộ trên máy của bạn.
Telegram Bot
Theo thiết kế mục tiêu: tạo bot miễn phí qua @BotFather trên Telegram, lấy Bot Token và dán vào Cockpit để nhận phản hồi tức thì, hỗ trợ nhóm và kênh thông báo.
Discord Bot
Theo thiết kế mục tiêu: khởi tạo Application trên Discord Developer Portal, cấu hình quyền Bot và đưa vào server nội bộ để quản lý công việc và hỗ trợ cộng đồng.
Slack Workspace
Theo thiết kế mục tiêu: cấu hình Slack App với quyền Bot User OAuth Token để nhận và phân công tác vụ trực tiếp từ các kênh thảo luận của công ty.
Web Chat Widget & REST API
Thiết kế mục tiêu: nhúng khung chat trực tiếp vào website của bạn. Lưu ý kiến trúc: Endpoint nhận tin nhắn công khai dự kiến được thiết lập trên VPS riêng của bạn, không định tuyến qua Cloud Hub của AgentSea.
5. Chính sách bản quyền (1 PC + 1 VPS)
Quy định rõ ràng về phạm vi kích hoạt thiết bị nhằm tối ưu hóa chi phí vận hành cá nhân.
- Mỗi mã bản quyền thuộc quyền sở hữu của một cá nhân (tài khoản đăng ký tại agentsea.vn).
- Được phép kích hoạt tối đa hai (02) thiết bị hoạt động đồng thời: một (01) máy tính cá nhân (Mac hoặc Windows) và một (01) máy chủ ảo riêng (Linux VPS).
- Đổi thiết bị mới: Khi thay đổi máy tính hoặc chuyển sang VPS mới, bạn cần truy cập mục Quản lý thiết bị (/space/devices) trên Cloud Hub để nhấn 'Hủy kích hoạt' thiết bị cũ trước khi kích hoạt thiết bị mới.
- Xử lý sự cố mất thiết bị: Trong trường hợp hỏng ổ cứng hoặc mất máy đột xuất không thể tự gỡ, bạn có thể gửi yêu cầu hỗ trợ qua kênh chăm sóc khách hàng để quản trị viên thu hồi thiết bị sau khi xác minh nhật ký.
6. Cơ chế bản quyền ngoại tuyến (Tối đa 7 ngày)
Thiết kế mục tiêu (Target Design): Cơ chế bản quyền ngoại tuyến tối đa 7 ngày nhưng không vượt quá hạn gói bản quyền (entitlement expiry). Lưu ý: Các mô hình AI đám mây và cổng liên lạc trực tuyến vẫn cần kết nối Internet.
Vận hành bình thường trên mạng nội bộ
Định hướng mục tiêu trong thời gian ngoại tuyến: Agent có thể xử lý các tác vụ cục bộ nội bộ (nếu dùng Local LLM). Lưu ý quan trọng: Không có cam kết ngoại tuyến cho các mô hình AI đám mây (Gemini, Claude, OpenAI) hoặc các cổng nhắn tin trực tuyến (Zalo, Telegram) vì các dịch vụ này luôn yêu cầu Internet.
Chuyển sang chế độ Chỉ Đọc (Read-Only)
Thiết kế chế độ Chỉ Đọc mục tiêu: Giữ nguyên khả năng xem và trích xuất dữ liệu lịch sử tại máy; tạm dừng thực thi tiến trình tự động nền cho đến khi kết nối mạng xác thực lại.
7. Câu hỏi thường gặp & Xử lý sự cố
Giải đáp các thắc mắc kỹ thuật phổ biến nhất từ người dùng vận hành thực tế.
Q: Nếu tôi tắt máy tính hoặc laptop gập lại, AI có tiếp tục trả lời khách không?
Trả lời: Không. AgentSea Space là phần mềm chạy trực tiếp trên thiết bị của bạn (Local-First). Khi máy tính bị tắt nguồn hoặc mất mạng, nhân viên AI cũng sẽ tạm dừng. Nếu muốn AI trực 24/7 liên tục, bạn hãy kích hoạt thiết bị thứ hai trên một máy chủ ảo riêng (VPS Ubuntu) - nằm trong phạm vi 1 PC + 1 VPS của bản quyền.
Q: AgentSea có đọc được tin nhắn khách hàng hoặc danh bạ của tôi không?
Trả lời: Theo mục tiêu kiến trúc Zero-Knowledge (Target Design): Cloud Hub theo thiết kế chỉ quản lý xác thực và cấp vé bản quyền. Định hướng là mọi tin nhắn, danh bạ, prompt và tệp tin đều lưu cục bộ tại máy hoặc VPS riêng của bạn (runtime hiện đang phát triển và chưa qua kiểm toán bên thứ 3).
Q: Sử dụng Zalo cá nhân với AI có nguy cơ bị khóa nick không?
Trả lời: Có rủi ro nếu người dùng lạm dụng. Zalo có thuật toán kiểm soát rất nghiêm ngặt đối với tài khoản cá nhân. Nếu tài khoản gửi tin nhắn quá nhanh hoặc gửi tin tự động cho hàng loạt người lạ cùng lúc, Zalo có thể tạm khóa tài khoản. Theo thiết kế luồng xử lý mục tiêu, hệ thống khuyến nghị luôn dùng chế độ kiểm duyệt thủ công (Human-in-the-loop) để giảm thiểu rủi ro.
Q: Khi tôi đổi sang máy tính mới thì phải làm thế nào?
Trả lời: Rất đơn giản: Bạn chỉ cần đăng nhập tài khoản tại agentsea.vn, vào mục 'Quản lý thiết bị' (/space/devices), chọn thiết bị cũ và bấm 'Hủy kích hoạt'. Sau đó, bạn đăng nhập trên máy tính mới để kích hoạt bản quyền bình thường.
Q: Sau 7 ngày mất mạng (offline), phần mềm sẽ hoạt động như thế nào?
Trả lời: Mục tiêu thiết kế: Vé bản quyền ngoại tuyến có hiệu lực tối đa 7 ngày nhưng không vượt quá hạn gói bản quyền (entitlement expiry). Trong thời gian ngoại tuyến, chỉ tác vụ cục bộ (Local LLM) có thể chạy; các mô hình AI đám mây và cổng tin nhắn trực tuyến (Zalo, Telegram) không hoạt động nếu mất mạng. Khi hết hạn vé hoặc hết hạn gói bản quyền mà chưa xác thực lại, phần mềm dự kiến chuyển sang chế độ CHỈ ĐỌC (Read-Only): cho phép xem và xuất dữ liệu lịch sử tại máy, tạm dừng các tác vụ tự động mới.