Cài 3DAgent mất khoảng 10 phút. Sau khi cài, bạn trò chuyện với AI trong app 3DAgent và AI dựng mô hình ngay trong SOLIDWORKS của bạn. Bộ cài hiện chưa có chữ ký số, nên Windows và trình duyệt sẽ hiện cảnh báo "không xác định nhà phát hành". Đây là điều bình thường với phiên bản này: làm theo đúng các bước dưới đây để cài tiếp.
| Cần có | Chi tiết |
|---|---|
| Máy tính | Windows 10 hoặc 11, bản 64-bit, có Internet |
| SOLIDWORKS | Bản quyền, đã kích hoạt và mở được bình thường. Đã thử với SOLIDWORKS 2020 và 2025 |
| Tài khoản 3DAgent | Email và mật khẩu do SSPACE cấp. Mỗi tài khoản dùng trên 1 máy |
| Tài khoản AI (một trong hai) | Claude Pro / Max, hoặc ChatGPT Plus / Pro / Business |
| Dung lượng trống | Khoảng 600 MB (3DAgent khoảng 170 MB; Claude Code khoảng 250 MB; Codex khoảng 160 MB) |
Không cần quyền quản trị (admin): 3DAgent cài riêng cho tài khoản Windows đang dùng.
Nếu SSPACE chép bộ cài qua USB hoặc thư mục mạng nội bộ, bỏ qua bước này. Thường sẽ không gặp cảnh báo ở Bước 2.
Minh hoạ: bấm vào hai chỗ có viền vàng, theo thứ tự Thông tin thêm rồi Vẫn chạy.
Cảnh báo này xuất hiện vì bộ cài chưa được ký số, không phải vì phát hiện virus. Bản có chữ ký số SSPACE sẽ phát hành sau.
Không thấy nút Vẫn chạy, hoặc Windows báo đã chặn hẳn ứng dụng: xem mục Khi gặp sự cố (Smart App Control).
Mất mạng khi đang tải Claude Code / Codex vẫn cài được 3DAgent. Cài lại phần AI sau trong app: Cài đặt › Bộ não AI › Cài đặt (xem Bước 5).
App 3DAgent mở thành một cửa sổ hẹp ở cạnh phải màn hình, để bạn vừa xem SOLIDWORKS vừa trò chuyện. Lần sau, mở app bằng biểu tượng 3DAgent trên Desktop hoặc Start › 3DAgent › 3DAgent.
"Bộ não" là tài khoản AI của bạn (Claude hoặc ChatGPT) làm phần suy nghĩ; 3DAgent làm phần điều khiển SOLIDWORKS. Dùng tài khoản AI của chính bạn thì 3DAgent không tính thêm phí: mức dùng được tính vào gói Claude / ChatGPT của bạn.
Trang OpenAI báo cần "bật tính năng đăng nhập bằng mã thiết bị": bấm Hủy, không cần bật. Bấm lại Đăng nhập trong app và đăng nhập trên trang vừa mở.
Có khoá API của Anthropic / OpenAI thay cho tài khoản: bấm Dùng khoá API trong cùng mục. Khoá được mã hoá và chỉ lưu trên máy này.
| Nút | Tác dụng |
|---|---|
| Hỏi / Làm / Giảng giải | Hỏi: chỉ giải thích, không sửa mô hình. Làm: AI dựng trong SOLIDWORKS. Giảng giải: dựng từng bước kèm giải thích, dành cho học |
| Nhanh / Tiêu chuẩn / Chuyên gia | Mức AI. Bài khó (mặt nghiêng, nhiều chi tiết) nên dùng Chuyên gia |
| ＋ (cạnh ô soạn tin) | Đính kèm ảnh hoặc PDF bản vẽ; cũng có thể kéo thả file hoặc dán ảnh bằng Ctrl+V |
| Làm cùng / Giao việc | Làm cùng: AI làm trực tiếp trên SOLIDWORKS bạn đang mở. Giao việc: AI làm trong một SOLIDWORKS chạy ngầm, bạn làm việc khác trong lúc chờ |
| ☰ (góc trên bên trái) | Cuộc trò chuyện mới, lịch sử trò chuyện, Kho kỹ năng, Cài đặt |
Khi có bản mới, app hiện một thanh ngay dưới thanh trên cùng:
Kiểm tra bản mới thủ công: Start › 3DAgent › 3DAgent - Cập nhật.
Gỡ 3DAgent không gỡ Claude Code / Codex và không đụng tới file SOLIDWORKS của bạn. Muốn dùng tài khoản trên máy khác, nhớ Đăng xuất trong app trước khi gỡ.
| Hiện tượng | Cách xử lý |
|---|---|
| Windows chặn hẳn bộ cài, không có nút Vẫn chạy | Máy đang bật Smart App Control, tính năng này chặn mọi phần mềm chưa ký số. Liên hệ SSPACE trước khi tắt nó (Windows Security › App & browser control › Smart App Control), hoặc chờ bản có chữ ký số |
| Phần mềm diệt virus xóa hoặc cách ly file 3DAgent | Khôi phục file từ khu cách ly và thêm ngoại lệ cho thư mục 3DAgent, hoặc báo SSPACE kèm tên phần mềm diệt virus |
| "Không tìm thấy SOLIDWORKS trên máy này" | Cài và kích hoạt SOLIDWORKS trước, rồi chạy lại bộ cài |
| Đăng nhập 3DAgent báo "Sai email hoặc mật khẩu" | Kiểm tra bộ gõ (Unikey, Caps Lock). Sai 5 lần thì tài khoản khóa đăng nhập 15 phút. Quên mật khẩu: liên hệ SSPACE để đặt lại |
| "Không kết nối được máy chủ 3DAgent" | Kiểm tra Internet. Mạng công ty có tường lửa thì nhờ bộ phận IT mở swai-api.tuyennn.workers.dev |
| Đăng nhập trên máy mới bị từ chối | Mỗi tài khoản dùng trên 1 máy, chuyển máy tối đa 2 lần trong 30 ngày. Đăng xuất trong app trên máy cũ trước khi chuyển, hoặc nhờ SSPACE gỡ máy cũ |
| Chấm SW trên app không xanh | Mở SOLIDWORKS, chờ mở xong hẳn, rồi bấm vào chữ SW › Kết nối lại |
| Trình duyệt không tự mở khi đăng nhập Claude / ChatGPT | Chép đường link dài trong cửa sổ đen vừa hiện, dán vào trình duyệt. Giữ cửa sổ đen mở đến khi xong |
| Cài Claude Code / Codex báo lỗi | Kiểm tra Internet rồi vào Cài đặt › Bộ não AI, bấm Cài đặt lại |
| Bấm Cập nhật báo lỗi | Kiểm tra Internet rồi bấm Thử lại. Vẫn lỗi: báo SSPACE, app vẫn dùng bình thường bản đang có |
| Bấm đúp biểu tượng 3DAgent mà không thấy cửa sổ | App chỉ mở một cửa sổ: tìm biểu tượng 3DAgent trên thanh tác vụ (taskbar) |
Vẫn không cài được: chụp màn hình lỗi và gửi SSPACE, kèm phiên bản Windows và SOLIDWORKS đang dùng.
Bộ cài cũng kết nối 3DAgent vào các app AI có sẵn trên máy (Claude Desktop, Codex…). Muốn dùng 3DAgent từ đó: thoát hẳn app AI (chuột phải biểu tượng gần đồng hồ › Quit / Thoát), mở lại và gõ Kiểm tra trạng thái 3DAgent. Cài app AI mới sau khi cài 3DAgent: chạy Start › 3DAgent › 3DAgent - Kết nối lại với app AI.