Hướng dẫn sử dụng QuickAgent
QuickAgent là không gian làm việc tác nhân AI ưu tiên xử lý cục bộ. Ứng dụng biến mục tiêu thành một Run bền vững, giới hạn Run đó bằng Workspace Profile, yêu cầu xét duyệt trước các thao tác nhạy cảm và lưu kết quả đã xác minh trong Artifacts.
Bắt đầu
- Mở Cài đặt > AI, thêm một nhà cung cấp và chạy kiểm tra kết nối của nhà cung cấp đó.
- Mở Cài đặt > Workspace Profiles. Chọn nhà cung cấp, công cụ, kết nối, thư mục gốc, nguồn Knowledge và phạm vi Memory được phép sử dụng.
- Chọn Cuộc trò chuyện mới, chọn hồ sơ và xác nhận đích đến của nhà cung cấp hiển thị phía trên cuộc trò chuyện.
- Mô tả kết quả mong muốn. Chỉ thêm các tệp, thư mục, phương tiện, Knowledge hoặc Memory cần thiết cho Run này.
- Xem lại kế hoạch, phê duyệt, xác nhận Critical và Data Send Preview khi chúng xuất hiện.
- Theo dõi công việc trong Timeline. Mở kết quả đã hoàn thành từ Artifacts và kiểm tra dấu vết kiểm toán trong Lịch sử.
Tổng quan giao diện
| Mục | Mục đích sử dụng |
|---|---|
| Chats | Cuộc trò chuyện, đích đến của nhà cung cấp, Context Tray, kế hoạch, phê duyệt và Run Timeline đang hoạt động. |
| Runs | Mọi tác vụ đã được lập kế hoạch, đang chạy, tạm dừng, đã lên lịch, thất bại hoặc hoàn tất. |
| Hộp thư phê duyệt | Các yêu cầu xem xét về hành động đang chờ, mức Critical và Data Send cần bạn quyết định. |
| Artifacts | Các tệp, báo cáo, nhật ký, nội dung đa phương tiện, bảng và bản kê thao tác đã được xác minh do các Run tạo ra. |
| Tự động hóa | Lịch trình, trình giám sát, webhook, sự kiện ứng dụng và trình kích hoạt Shortcut/App Intent. |
| Kỹ năng | Hướng dẫn có thể tái sử dụng với dữ liệu đầu vào có kiểu, công cụ được phép, kết nối bắt buộc, mức rủi ro và đầu ra. |
| Kết nối | Nhà cung cấp, hồ sơ trình duyệt, thư mục gốc tệp/VFS, SSH, MCP, HTTP/SaaS, cầu nối nhà thông minh và kênh thông báo. |
| Kiến thức | Các thư mục đã lập chỉ mục, nội dung QuickNote, đoạn trích web, PDFs và nguồn Office. |
| Lịch sử | Các quyết định an toàn, thao tác công cụ, đích đến và dấu thời gian chỉ cho phép bổ sung. |
| Cài đặt | Giao diện, ngôn ngữ, AI, công cụ, an toàn, Workspace Profiles, phím tắt, quyền, Trợ giúp và Pro. |
Nhà cung cấp và Workspace Profiles
QuickAgent có thể sử dụng System AI khi hệ điều hành cung cấp khả năng tương thích, các nhà cung cấp cục bộ như Ollama, LM Studio hoặc DeskLLM, các điểm cuối LAN hoặc tùy chỉnh tương thích với OpenAI, cùng các nhà cung cấp đám mây đã cấu hình như Anthropic hoặc Gemini. Khả năng sử dụng được xác định bằng kiểm tra trực tiếp; chỉ có tên nhà cung cấp không có nghĩa là nhà cung cấp đó đã sẵn sàng.
Workspace Profile là phạm vi quyền của Run. Hồ sơ này ghi lại nhà cung cấp/mô hình đã chọn, công cụ được phép, kết nối, thư mục gốc tệp, nguồn Knowledge, phạm vi Memory, các ghi đè an toàn và ngân sách. Thay đổi cấu hình sau đó sẽ khiến bản ghi này không còn mới và cần được xem xét.
Run, phê duyệt và khôi phục
Điều khiển Run
- Tạm dừng yêu cầu dừng có phối hợp tại một điểm kiểm tra bền vững.
- Tiếp tục tiếp tục chính Run đó và phần công việc đã hoàn thành.
- Dừng hủy công việc của nhà cung cấp và công cụ. Một tác động bên ngoài đã dừng hoặc chưa chắc chắn sẽ không được báo cáo là thành công.
- Thử lại chỉ khả dụng khi QuickAgent có thể xác định ranh giới thử lại an toàn.
Các mức an toàn
| Mức | Ý nghĩa |
|---|---|
| An toàn | Đọc, kiểm tra hoặc chuyển đổi trong hồ sơ đang hoạt động. |
| Phê duyệt | Xem xét một thao tác ghi thông thường hoặc hành động bên ngoài. |
| Xác nhận | Xem xét một thay đổi có tác động lớn hơn hoặc khó đảo ngược hơn. |
| Critical | Luôn yêu cầu xác nhận mạnh; các quy tắc không bao giờ tự động phê duyệt mức này. |
Phần phê duyệt hiển thị chính xác mục tiêu, đích đến, đối số đề xuất, rủi ro và trạng thái Undo. Nếu bạn sửa một đối số, QuickAgent sẽ xác thực và kiểm tra lại rủi ro của hành động đã chỉnh sửa.
Run đa tác tử
Các mục tiêu phức tạp có thể sử dụng một bộ lập kế hoạch, các tác tử chuyên môn có kiểu, một tác tử đánh giá và một tác tử đánh giá bảo mật. Timeline hiển thị từng lần bàn giao, đánh giá, thử lại, chuyển sang phương án dự phòng và ranh giới phản hồi cuối cùng. Tác tử chỉ nhận được phần giao của bốn nhóm: công cụ của Skill, công cụ của Workspace Profile, công cụ theo vai trò và công cụ hiện đang hoạt động.
Ngân sách toàn cục và theo vai trò giới hạn số lần gọi, thời gian, chi phí, byte mạng và token. Khi đạt giới hạn ngân sách, QuickAgent sẽ tạm dừng. Ứng dụng hiển thị giới hạn hiện tại và giới hạn đề xuất, đồng thời chỉ tăng chúng sau khi được xem xét rõ ràng. Ngân sách đã phê duyệt và lịch sử vai trò đã hoàn tất vẫn được giữ lại sau khi khởi động lại.
Ngữ cảnh, Knowledge và AI Memory
Khay ngữ cảnh
Thêm tệp, thư mục, hình ảnh, khung hình video, âm thanh, ghi chú giọng nói, nội dung QuickNote, Knowledge hoặc Workspace Memory. QuickAgent trích xuất hoặc tóm tắt nội dung được hỗ trợ và cho biết tệp đính kèm có được gửi trực tiếp tới nhà cung cấp hay không.
Kiến thức
Các nguồn Knowledge được lập chỉ mục riêng với cuộc trò chuyện. Run chỉ có thể tìm kiếm các nguồn mà Workspace Profile cho phép và trích dẫn vẫn giữ nguyên danh tính nguồn.
Memory
Memory được sử dụng có chủ đích, không phải là lịch sử trò chuyện tự động. Phạm vi Người dùng, Workspace, Project và Công cụ/Kết nối được tách riêng. Mọi yêu cầu tạo, sửa hoặc xóa đều cần một lần phê duyệt mới, và bản xem trước phê duyệt hiển thị phạm vi cùng giá trị đề xuất chính xác.
Công cụ và kết nối
Danh mục trực tiếp bao gồm thao tác tệp/VFS; Office, PDF và dữ liệu có cấu trúc; đa phương tiện và OCR; sử dụng trình duyệt và máy tính; lệnh phát triển; SSH; MCP; HTTP và SaaS; cầu nối nhà thông minh; thông báo; lịch trình; trình giám sát; và điều khiển tự động hóa. Các máy chủ MCP đã kết nối có thể thêm công cụ động sau khi xác thực schema và QuickAgent đánh giá lại rủi ro.
Cài đặt > Công cụ hiển thị lý do một công cụ đã sẵn sàng hoặc bị vô hiệu hóa. Các lý do thường gặp gồm thiếu kết nối, quyền hệ điều hành, nền tảng không được hỗ trợ, hạn chế của Workspace Profile, điểm cuối chưa được kiểm tra hoặc khả năng của nhà cung cấp không khả dụng.
Tự động hóa
Tự động hóa có thể bắt đầu từ thời gian, tệp/thư mục, web, webhook, email, lịch, mạng, máy chủ, thiết bị, cảm biến, vị trí, sự kiện ứng dụng, Shortcut/App Intent, lệnh hoặc kích hoạt thủ công khi nền tảng hỗ trợ. Một trình kích hoạt tạo ra Run thông thường; nó không bỏ qua các bước kiểm tra Workspace Profile, phê duyệt, Critical hoặc Data Send.
- Hoạt động giám sát trên máy tính chỉ tiếp tục khi tiến trình ứng dụng đang chạy.
- Nền tảng di động khôi phục công việc quá hạn khi ứng dụng trở lại màn hình trước.
- Hãy sử dụng Shortcut/App Intent hoặc bộ chuyển tiếp sự kiện đáng tin cậy khi cần hệ điều hành bảo đảm việc phân phối.
- Các sự kiện trong hàng đợi, thao tác tạm dừng, hủy và xóa luôn được thể hiện rõ để sự kiện không bị âm thầm loại bỏ.
Skills và Skill Packs
Skill lưu trữ câu lệnh tập trung vào kết quả, các biến có kiểu, đề xuất nhà cung cấp, công cụ được phép, kết nối và khả năng bắt buộc, mức rủi ro tối đa cùng Artifacts dự kiến. Trước khi sử dụng, QuickAgent hiển thị dữ liệu đầu vào và quyền có hiệu lực; bản xem trước không tự cấp quyền.
Bảy Pack tích hợp sẵn cung cấp các Skill thực tế cho Office, Lập trình, Nhà thông minh, Nghiên cứu, Tự động hóa trình duyệt, Quản trị cá nhân và Ứng phó sự cố. Bạn có thể cài đặt, cập nhật, gỡ cài đặt, tùy chỉnh, sao chép, nhập và xuất Skill. JSON đã nhập sẽ có bản xem trước về độ tin cậy, nhà phát hành, chữ ký, quyền, rủi ro, nền tảng và xung đột. “Giữ cả hai” tạo một bản phái sinh cục bộ không có chữ ký thay vì kế thừa độ tin cậy của nhà phát hành khác.
Artifacts, lịch sử và Undo
Artifacts lưu giữ byte đầu ra, siêu dữ liệu, phiên bản, nguồn gốc, Run nguồn và bản kê thao tác. Tùy theo khả năng của nền tảng, bạn có thể mở, chia sẻ, xuất hoặc hiển thị chúng trong thư mục. Các thao tác đủ điều kiện cung cấp chức năng Undo đã qua xem xét; công việc phá hủy hoặc chưa chắc chắn không bao giờ được tự động thực hiện lại.
Lịch sử chỉ cho phép bổ sung. Lọc theo An toàn, Phê duyệt, Xác nhận hoặc Critical, và xuất bản kiểm tra khi bạn cần hồ sơ bên ngoài.
Cài đặt
- Chung: giao diện, ngôn ngữ, Workspace Profiles, phím tắt, Trợ giúp và quyền.
- AI: nhà cung cấp, điểm cuối, mô hình, thông tin xác thực và kiểm tra trực tiếp.
- Công cụ: trạng thái sẵn sàng của danh mục, hỗ trợ nền tảng và lý do thiết lập.
- An toàn: quy tắc phê duyệt, hành vi Data Send, xác thực thiết bị và chính sách Memory theo phạm vi.
- Nâng cao: khôi phục và chẩn đoán dành cho việc khắc phục sự cố.
Phím tắt
Trên macOS, ứng dụng ánh xạ các phím tắt Ctrl được hiển thị sang phím Command của nền tảng khi phù hợp. Trang Phím tắt trong ứng dụng là nguồn thông tin chính thức và hỗ trợ tùy chỉnh.
| Phím tắt | Thao tác |
|---|---|
| Ctrl + N | Cuộc trò chuyện mới |
| Ctrl + L | Đưa con trỏ vào ô soạn thảo |
| Ctrl + Shift + Space | Tạm dừng hoặc tiếp tục Run đang hoạt động |
| Ctrl + . | Dừng Run đang hoạt động |
| Ctrl + 1 … 9 | Mở Trò chuyện qua Lịch sử |
| Ctrl + , | Mở Cài đặt |
| F1 | Mở Trợ giúp & Quyền riêng tư |
| Esc | Đóng hộp thoại hoặc hủy tương tác không phá hủy hiện tại |
Ghi chú về nền tảng
| Nền tảng | Các giới hạn quan trọng |
|---|---|
| macOS | Được chạy trong sandbox ở cả Debug và Release. Quyền truy cập tệp sử dụng các thư mục gốc đã chọn/dấu trang có phạm vi bảo mật. Ghi màn hình và Trợ năng là các quyền hệ thống riêng biệt. Khả năng tích hợp tiến trình cục bộ và Shortcut tiếp tục được kiểm tra. |
| Windows | Các tính năng về tệp, Office/PDF/dữ liệu, trình duyệt, phát triển, điều khiển từ xa và máy tính để bàn phụ thuộc vào runtime đã cài đặt và quyền. Các tích hợp chỉ dành cho Apple sẽ không khả dụng và có lý do hiển thị rõ ràng. |
| iPhone / iPad | Tệp sử dụng trình chọn của hệ thống. Quyền truy cập máy ảnh, micrô, giọng nói, ảnh, mạng cục bộ và thông báo được yêu cầu theo ngữ cảnh. Không bảo đảm giám sát nền; hãy dùng Shortcuts/App Intents hoặc cơ chế cập nhật khi trở lại màn hình trước. |
| Android | Tệp và thư mục sử dụng Storage Access Framework. Công việc nền tuân theo các hạn chế của Android. Điều khiển nhập liệu dựa trên trợ năng không bao giờ được coi là đã cấp quyền chỉ vì một dịch vụ được khai báo. |
| Web | Sử dụng bộ nhớ chỉ trong phiên cho các tính năng cần khả năng lưu trữ gốc và vô hiệu hóa rõ ràng các khả năng không được hỗ trợ về thiết bị, thư mục gốc tệp, tiến trình cục bộ và chạy nền. |
Mẹo & Thủ thuật
Khắc phục sự cố
| Vấn đề | Nội dung cần kiểm tra |
|---|---|
| Nhà cung cấp không thể chạy | Mở Cài đặt > AI. Kiểm tra cấu hình, xác thực, khả năng của mô hình, khả năng truy cập điểm cuối, thời gian chờ và chi tiết giới hạn tốc độ, sau đó chạy kiểm tra kết nối. |
| Một công cụ bị vô hiệu hóa | Mở Cài đặt > Công cụ và đọc lý do trực tiếp. Xem lại nền tảng hiện tại, quyền, kiểm tra kết nối, Workspace Profile và thư mục gốc đã chọn. |
| Một Run có vẻ bị kẹt | Mở Run và Timeline. Run có thể đang tạm dừng, chờ dữ liệu đầu vào, phê duyệt, xác nhận Critical, xem xét Data Send hoặc xem xét ngân sách. Nút Dừng vẫn luôn khả dụng. |
| Một quyền đã thay đổi | Mở Trợ giúp > Tổng quan hoặc Cài đặt, sau đó mở phần cài đặt hệ thống. Kiểm tra lại kết nối hoặc công cụ bị ảnh hưởng sau khi quay lại. |
| Một hành động bên ngoài chưa chắc chắn | Kiểm tra hệ thống đích. Giữ Run ở trạng thái tạm dừng hoặc Dừng Run trừ khi bạn đã xác minh rằng việc thử lại là phù hợp. |
| Một Tự động hóa không kích hoạt trong nền | Hệ điều hành di động không bảo đảm việc thăm dò tùy ý. Hãy trở lại màn hình trước để cập nhật hoặc cấu hình Shortcut/App Intent hay nguồn sự kiện đáng tin cậy. |
| Không thể mở hoặc xuất một Artifact | Kiểm tra xem các byte của Artifact còn khả dụng không, nền tảng có hỗ trợ hành động này không và quyền đối với đích đã chọn còn hợp lệ không. |
Quyền riêng tư, quyền và giấy phép
QuickAgent lưu trữ cục bộ các cuộc trò chuyện, Run, phê duyệt, siêu dữ liệu Knowledge, Skill và cài đặt. Thông tin xác thực sử dụng bộ nhớ được nền tảng bảo vệ. Nội dung chỉ rời khỏi thiết bị thông qua nhà cung cấp hoặc dịch vụ được kết nối mà bạn cấu hình, và các lần gửi ra ngoài đều nhận được bản xem trước nhận biết đích đến.
Các quyền được yêu cầu theo ngữ cảnh: tệp/thư mục, ảnh, máy ảnh, micrô, nhận dạng giọng nói, mạng cục bộ, thông báo, ghi màn hình và trợ năng/điều khiển nhập liệu là độc lập. Việc thu hồi quyền khiến khả năng bị ảnh hưởng không còn khả dụng thay vì tạo ra kết quả thành công giả.
Mở Cài đặt > Trợ giúp & Quyền riêng tư để xem bảng khả năng của nền tảng hiện tại và Giấy phép mã nguồn mở để xem thông báo về các gói và thành phần gốc đi kèm.