Chuyển đến nội dung chính
Hướng dẫn AI

Hướng dẫn Capri: Thiết lập tác nhân AI Cyberpunk cho máy tính Windows

Tìm hiểu cách tải xuống và cấu hình Capri trên Windows, kết nối Claude Code, Codex, Antigravity hoặc trợ lý khác, thực hiện tác vụ trên máy tính và lập trình, quản lý phê duyệt, đồng thời giới hạn an toàn quyền truy cập vào tệp và dự án.

Hướng dẫn Capri: Thiết lập tác nhân AI Cyberpunk cho máy tính Windows

Capri là gì?

Capri là một tác nhân AI mang phong cách cyberpunk dành cho Windows. Ứng dụng cung cấp giao diện máy tính để bàn gốc và một lớp tác nhân cho các trợ lý AI như Claude Code, Codex và Antigravity. Thay vì chỉ làm việc từ terminal, bạn mô tả mục tiêu bằng ngôn ngữ tự nhiên, còn Capri sẽ chuyển yêu cầu đến trợ lý bạn chọn, điều phối các công cụ và báo cáo kết quả.

Capri có thể làm việc với tệp, thư mục dự án, mã nguồn, lệnh shell, ứng dụng và các tác vụ liên quan đến web. Ứng dụng được thiết kế cho cả nhà phát triển lẫn những người muốn có một trợ lý đa năng trên máy tính.

Hiện ứng dụng có sẵn cho Windows 10 trở lên. Hỗ trợ macOS và Linux đã được lên kế hoạch nhưng chưa khả dụng.

Tính năng chính

  • Nhiều công cụ AI: Sử dụng Claude Code, Codex, Antigravity hoặc trợ lý khác thông qua bộ điều hợp tùy chỉnh.
  • Giao diện gốc cho máy tính để bàn: Làm việc từ ứng dụng đồ họa thay vì quy trình chỉ dùng terminal.
  • Thao tác với tệp và dự án: Yêu cầu Capri tìm, đọc, sắp xếp, chỉnh sửa hoặc phân tích tệp và thư mục.
  • Quy trình tác vụ: Capri có thể lập kế hoạch, sử dụng công cụ, kiểm tra kết quả và giải thích những gì đã diễn ra.
  • Hỗ trợ lập trình: Sử dụng công cụ bạn предпоч thích để viết, tái cấu trúc, gỡ lỗi và chạy mã.
  • Tự động hóa: Biến các công việc lặp lại thành yêu cầu bằng ngôn ngữ tự nhiên.
  • Kiểm soát phê duyệt: Xem xét các thao tác nhạy cảm và phê duyệt hoặc từ chối trước khi chúng được thực hiện.
  • Giao diện cyberpunk: Sử dụng trải nghiệm máy tính để bàn tối màu lấy cảm hứng từ neon.

Cài đặt Capri trên Windows

1. Tải bản phát hành

Mở bản phát hành Capri mới nhất và chọn một trong các gói Windows có sẵn:

  • Capri-Setup.exe: Sử dụng trình cài đặt để cài đặt thông thường và tạo lối tắt trong menu Start.
  • Capri-Portable.zip: Sử dụng bản portable khi bạn muốn chạy Capri từ một thư mục mà không cần cài đặt.

2. Khởi chạy ứng dụng

Với phiên bản trình cài đặt, chạy Capri-Setup.exe, hoàn tất trình hướng dẫn thiết lập và mở Capri từ menu Start. Với phiên bản portable, giải nén Capri-Portable.zip vào một thư mục rồi chạy ứng dụng từ đó.

Windows SmartScreen có thể hiển thị cảnh báo vì Capri là một ứng dụng mới. Nếu bạn đã tải tệp từ trang Releases chính thức của kho lưu trữ, hãy chọn More info, sau đó chọn Run anyway.

3. Kết nối trợ lý AI

Trong lần khởi chạy đầu tiên, Capri sẽ hỏi bạn muốn sử dụng trợ lý nào. Chọn một công cụ có sẵn, sau đó đăng nhập vào tài khoản hoặc cung cấp API key cần thiết. Capri hỗ trợ Claude Code, Codex và Antigravity ngay khi cài đặt. Bạn có thể kết nối các trợ lý khác thông qua bộ điều hợp tùy chỉnh.

Lựa chọn công cụ quyết định hệ thống AI nào sẽ xử lý yêu cầu của bạn, còn Capri cung cấp giao diện máy tính để bàn, khả năng định tuyến, công cụ và quy trình phê duyệt.

Chạy tác vụ đầu tiên

Mô tả mục tiêu bằng ngôn ngữ tự nhiên

Bắt đầu bằng một yêu cầu cụ thể, giải thích điều bạn muốn Capri thực hiện. Ví dụ:

Dọn dẹp thư mục Downloads của tôi và nhóm mọi thứ theo loại.

Capri có thể quét thư mục, đề xuất kế hoạch và di chuyển tệp sau khi bạn phê duyệt thao tác. Trong lần thử đầu tiên, hãy sử dụng một thư mục không chứa dữ liệu không thể thay thế.

Thử một tác vụ lập trình

Capri có thể sử dụng công cụ đã kết nối để kiểm tra dự án, tìm vấn đề, sửa mã và chạy các bước kiểm tra. Một yêu cầu phù hợp có thể là:

Tìm lỗi trong dự án này, giải thích nguyên nhân, sửa lỗi và chạy các bước kiểm tra hiện có.

Khi tác vụ liên quan đến việc thay đổi tệp hoặc thực thi lệnh, hãy xem xét các thao tác được đề xuất trước khi phê duyệt.

Làm việc với tài liệu

Bạn cũng có thể yêu cầu Capri xử lý nhiều tệp và tạo ra một kết quả tổng hợp:

Tóm tắt mọi tệp PDF trong thư mục này thành một tài liệu.

Trợ lý có thể đọc các tệp và viết bản tóm tắt tổng hợp, tùy thuộc vào quyền và khả năng truy cập được cấp cho Capri.

Cách Capri xử lý một yêu cầu

  1. Mô tả mục tiêu: Bạn cung cấp yêu cầu bằng ngôn ngữ tự nhiên.
  2. Định tuyến yêu cầu: Capri gửi yêu cầu đến công cụ AI bạn đã chọn.
  3. Lập kế hoạch công việc: Công cụ xác định các bước và công cụ cần thiết.
  4. Yêu cầu phê duyệt: Capri cho bạn cơ hội phê duyệt các thao tác nhạy cảm.
  5. Thực hiện và báo cáo: Capri sử dụng các công cụ liên quan và báo cáo kết quả.

Lớp công cụ có thể làm việc với tệp và dự án, shell và ứng dụng, cũng như các tác vụ liên quan đến web. Cổng phê duyệt nhằm giúp bạn tham gia khi một thao tác có thể thay đổi hệ thống hoặc dữ liệu của bạn.

Chọn và chuyển đổi công cụ

Capri hỗ trợ trực tiếp Claude Code, Codex và Antigravity. README cũng mô tả khả năng hỗ trợ các trợ lý khác thông qua bộ điều hợp tùy chỉnh. Hãy sử dụng công cụ phù hợp nhất với tác vụ, sau đó chuyển đổi khi một trợ lý khác thích hợp hơn.

Ví dụ, bạn có thể sử dụng một công cụ cho quy trình lập trình và một công cụ khác cho tác vụ máy tính để bàn thông thường. Quy trình đăng nhập hoặc cung cấp API key cụ thể phụ thuộc vào nhà cung cấp trợ lý mà bạn kết nối.

Cấu hình quyền và giao diện

README cung cấp ví dụ cấu hình sau:

engine: claude-code        # claude-code | codex | antigravity | custom

permissions:
  mode: ask                # hỏi trước khi thực hiện | tự động | chỉ đọc
  allowed_folders:
    - ~/Documents
    - ~/Projects

interface:
  theme: cyberpunk

Cài đặt engine chọn trợ lý được kết nối. Chế độ quyền có thể được cấu hình để hỏi trước khi thực hiện, chạy tự động hoặc chỉ sử dụng quyền truy cập chỉ đọc. Danh sách allowed_folders giới hạn những vị trí Capri có thể truy cập, còn cấu hình giao diện chọn giao diện cyberpunk.

Hãy sử dụng các cài đặt hạn chế khi làm quen với ứng dụng. Bắt đầu với mode: ask và chỉ cho phép những thư mục cần thiết cho tác vụ.

Mẹo sử dụng nâng cao và tự động hóa

Xác định ranh giới tác vụ chính xác

Yêu cầu tốt cần nêu rõ vị trí, kết quả mong muốn và các giới hạn. Thay vì yêu cầu Capri sắp xếp mọi thứ, hãy chỉ định một thư mục và giải thích cách nhóm các mục. Điều này giúp bạn dễ xem xét kế hoạch được đề xuất hơn.

Thận trọng khi tự động hóa các công việc lặp lại

Capri được thiết kế để biến những công việc lặp lại thành một câu lệnh duy nhất. Các ví dụ trong dự án bao gồm thiết lập một ứng dụng web mới và khởi chạy ứng dụng đó, hoặc yêu cầu sao lưu định kỳ thư mục Documents. Hãy xem xét các hành động được tạo và xác minh đích đến cùng các tệp là chính xác trước khi bật quy trình liên tục.

Lộ trình dự án liệt kê riêng bộ lập lịch tác vụ là tính năng dự kiến, vì vậy đừng cho rằng mọi tính năng lập lịch hiện đã có trong ứng dụng được phát hành.

Sử dụng bộ điều hợp tùy chỉnh khi cần

Nếu trợ lý bạn muốn dùng không nằm trong số các engine tích hợp sẵn, dự án mô tả bộ điều hợp tùy chỉnh là cách để kết nối các trợ lý khác. Hãy kiểm tra tài liệu của bản phát hành hiện tại và các issue trong repository để biết chi tiết triển khai trước khi lên kế hoạch tích hợp tùy chỉnh.

Khuyến nghị về an toàn

  • Xem xét các hành động trước khi phê duyệt: Đặc biệt chú ý đến việc xóa, di chuyển, ghi đè tệp và các lệnh shell.
  • Giới hạn quyền truy cập thư mục: Chỉ cấp cho Capri quyền truy cập vào những thư mục cần thiết cho tác vụ hiện tại.
  • Duy trì bản sao lưu: Sao lưu dữ liệu quan trọng trước khi chạy các thao tác quy mô lớn hoặc tự động.
  • Bảo vệ thông tin xác thực: Không bao giờ chia sẻ API key, token tài khoản hoặc thông tin xác thực khác.
  • Kiểm tra chính sách của nhà cung cấp: Các yêu cầu được xử lý bởi trợ lý AI mà bạn kết nối, theo các điều khoản và chính sách quyền riêng tư của nhà cung cấp đó.

Capri được thiết kế để cho phép bạn xem xét các hành động, nhưng không công cụ tự động hóa máy tính để bàn nào hoàn toàn không có rủi ro. Hãy coi lời nhắc phê duyệt là một ranh giới bảo mật, không phải điều bất tiện.

Khắc phục sự cố và hỗ trợ

Nếu Windows chặn ứng dụng, hãy xác nhận rằng bạn đã tải ứng dụng từ trang Releases chính thức của dự án trước khi sử dụng tùy chọn bỏ qua SmartScreen. Nếu không thể kết nối với trợ lý, hãy xác minh engine đã chọn, trạng thái đăng nhập và API key hoặc thông tin xác thực tài khoản.

Để yêu cầu tính năng hoặc báo cáo vấn đề, hãy sử dụng trình theo dõi issue của repository. Lộ trình dự án bao gồm các phiên bản macOS và Linux, hệ thống plugin, ứng dụng đồng hành trên thiết bị di động và thư viện giao diện cyberpunk do cộng đồng xây dựng.

Kết luận

Capri kết hợp giao diện máy tính để bàn Windows với các trợ lý AI mà bạn đang sử dụng. Sau khi tải xuống bộ cài đặt hoặc bản portable, hãy kết nối một engine, mô tả tác vụ và xem xét các hành động được đề xuất trước khi cho phép Capri làm việc với tệp, dự án và ứng dụng của bạn. Bắt đầu với quyền hạn chế và các yêu cầu đơn giản, sau đó mở rộng sang quy trình lập trình cùng các hoạt động tự động hóa được xem xét cẩn thận.