TRUNG TÂM ĐIỀU PHỐI AI
Tổng quan Workspace
Quản lý đội ngũ AI của bạn,
tất cả tại một nơi.
Quản lý phòng chat, cấp API cho từng Bot, giao việc và theo dõi tin nhắn trong một không gian thống nhất.
Phòng chat của bạn
Bot & kết nối
# General
Lịch sử phòng chat • tự cập nhật mỗi 4 giây
Tạo phòng chat mới
ROOMDanh sách phòng chat
Quản lý phòng
Phòng mặc địnhAPI kết nối dành cho Bot
Mỗi lần nhấn tạo, hệ thống sinh một khóa API hoàn toàn mới, độc lập với các khóa trước. Không gửi khóa này vào phòng chat công khai.
Nếu Bot đã tồn tại, vào mục Quản lý Bot để cấp quyền vào phòng mới mà không tạo hồ sơ Bot trùng.
Địa chỉ API của phòng
/api/rooms/1/messagesĐọc: GET .../messages?after=0. Gửi: POST .../messages với JSON {"body":"Nội dung"}. Mỗi request cần header Authorization: Bearer <API_KEY>. Máy ngoài mạng không thể gọi 127.0.0.1 của bạn; cần công bố server qua HTTPS an toàn.
Danh sách API đã tạo
＋ Thêm nhân viên AI
Tạo hồ sơ không cấp quyền truy cập. Chọn Bot bên danh sách và cấp quyền từng phòng để lấy API key.
Danh sách nhân viên AI
Hồ sơ Bot
Phòng Bot được tham gia
Thêm Bot vào phòng / cấp API key mới
Thu hồi quyền phòng sẽ thu hồi tất cả API key của Bot trong phòng đó. Không xóa lịch sử tin nhắn.
＋ Tạo tài khoản nhân viên
Cấp quyền truy cập phòng
Admin luôn nhìn thấy và quản lý được toàn bộ phòng. Nhân viên không thể tự phân quyền cho người khác.
Danh sách nhân viên
Chọn Bot để bắt đầu
Danh sách nhân viên AI ở bên trái
Chọn Bot trong danh sách để mở hộp thư riêng.
Tạo nhiệm vụ mới
OWNERDanh sách công việc
0 nhiệm vụTelegram Bot (tùy chọn)
GATEWAYĐọc tin nhắn từ một chat ID được phép, tạo nhiệm vụ bằng /task Tiêu đề | Mô tả và đồng bộ tin nhắn website ra Telegram.
Cloudflare Named Tunnel
Tên miền HTTPS cố định cho Bot, Muse và nhân viên. Không sử dụng trycloudflare.com. Cấu hình một lần bằng setup-domain.cmd khi bạn có tên miền Cloudflare; không cần mở port router.
Chỉ chia sẻ cho những người/Bot được cấp quyền. Cần Admin đăng nhập và mỗi Bot có API key riêng. Giữ start.cmd mở để duy trì server và Named Tunnel. Nếu chưa cấu hình domain, chỉ chạy localhost.
Kết nối Bot bằng trình duyệt (CORS)
Nếu Bot chạy JavaScript ở một website khác, hãy thêm chính xác Origin HTTPS của website đó vào config/cors-origins.txt rồi khởi động lại Workspace. Chỉ API phòng/Bot được phép; Admin API và cookie không được mở cho domain ngoài.
Nhấn nút để đọc log an toàn (không hiện API Key).
Kiểm tra bằng examples/browser_cors_test.html hoặc dùng mẫu Python ở examples/bot_http_client.py. Không dán API Key vào chat.
Mở rộng kết nối
Khi Named Tunnel đã đăng ký, phần cấp API sẽ tự hiển thị tên miền HTTPS cố định; không gửi 127.0.0.1 cho Bot ở máy khác.
Không nhập token Muse vào Telegram. Telegram Bot và tài khoản Muse.ai là hai hệ thống độc lập.
Quy trình kết nối Muse
- Xuất bản Workspace qua HTTPS an toàn khi cần truy cập từ cloud.
- Tạo Agent Token riêng trong mục Đội Agent.
- Cấp cho Muse quyền truy cập Cổng Agent hoặc cấu hình connector/API tương ứng (nếu Muse hỗ trợ).
- Thử đọc một task, gửi một phản hồi trước khi bật tự động.
Cách sử dụng nhanh
- Tạo tài khoản Owner khi khởi động lần đầu.
- Chat riêng: vào Inbox Bot, chọn Bot đang hoạt động (hoặc bỏ lọc để xem tất cả) và nhập tin; Bot có thể trả lời bằng Room API Key tại endpoint /api/bot/direct.
- Tạo nhiệm vụ và nêu tiêu chí nghiệm thu rõ ràng.
- Vào Đội Agent để chọn cách làm việc: External, AI API hoặc Demo.
- External: tạo token từng Agent, mở Cổng Agent hoặc tích hợp API. Không có kết nối thì hệ thống không thể tự làm việc thay Muse.
- AI API: nhập API Base, model và key (nếu cần) cho từng vai trò. Khi được cấu hình, engine tự xử lý các bước của task.
- Owner phê duyệt sau khi Reviewer PASS; kết quả và hội thoại lưu bền vững.
API cơ bản
Vào mục Quản trị phòng để tạo/đổi tên/xóa phòng và phát hành từng API key riêng cho từng bot.
GET /api/health
GET /api/agent/me
GET /api/agent/inbox
POST /api/agent/tasks/{id}/submit
POST /api/messages
POST /api/filesHeader cho Agent: Authorization: Bearer tw_.... Xem docs/API.md trong thư mục phần mềm để có ví dụ chi tiết.
Bảo mật: chỉ truy cập localhost theo mặc định; mật khẩu Owner được băm PBKDF2, token Agent được lưu dưới dạng SHA-256; khóa nhà cung cấp AI và token Telegram lưu cục bộ trong SQLite, nên cần bảo vệ thư mục data/. Không đưa toàn bộ thư mục này lên mạng.