Harness cho agent
Perch chạy một harness đầy đủ cho agent trên ứng dụng máy tính và CLI: shell, tìm kiếm, sửa tệp, tác vụ nền, sandbox khép kín, chế độ lập kế hoạch và quyền theo cấp độ rủi ro. Đây là toàn bộ bộ công cụ và các cơ chế kiểm soát chúng.
Bên dưới công việc tài liệu và kiểm toán, Perch là một harness đa năng cho agent. Nó chạy lệnh, tìm kiếm và sửa tệp, tạo agent hỗ trợ và thực thi mã trong sandbox. Cùng cơ chế đối soát sổ kế toán cũng có thể tái cấu trúc mô-đun, vì đó là cùng một cơ chế.
Trang này là tài liệu tham khảo về những gì Perch thực sự có thể làm trên máy tính của bạn và các cơ chế kiểm soát quyết định bao nhiêu việc được thực hiện mà không hỏi bạn trước.
Chỉ trên ứng dụng máy tính và CLI
Shell và tìm kiếm
| Công cụ | Chức năng |
|---|---|
bash | Chạy lệnh shell trong không gian làm việc. |
grep | Tìm kiếm nội dung tệp trong cả thư mục. |
glob | Tìm tệp theo mẫu. |
Tìm kiếm chạy bằng grep và glob thực tế thay vì phỏng đoán ngữ nghĩa, nên tìm mọi vị trí gọi nghĩa là tìm mọi vị trí gọi.
Đọc và ghi tệp
| Công cụ | Chức năng |
|---|---|
readLocalFile | Đọc tệp vào ngữ cảnh. |
writeLocalFile | Ghi tệp. |
editLocalFile | Sửa một phần tệp tại chỗ. |
moveLocalFile, copyLocalFile | Di chuyển hoặc sao chép. |
createDirectory, deleteLocalFile | Tạo thư mục, xóa tệp. |
statPath | Xem xét đường dẫn mà không đọc nội dung. |
Mọi lệnh gọi đều được kiểm tra theo các thư mục gốc đã phê duyệt cho không gian làm việc của bạn, nên Perch không thể truy cập ra ngoài thư mục bạn đã mở.
Tác vụ nền
Công việc dài không nhất thiết phải chặn cuộc hội thoại. Perch có thể khởi chạy lệnh ở nền rồi tiếp tục.
| Công cụ | Chức năng |
|---|---|
run_in_background | Khởi chạy lệnh như một tác vụ tách rời. |
check_background_task | Kiểm tra tác vụ. |
list_background_tasks | Liệt kê những gì đang chạy. |
wait_for_background_task | Chặn cho đến khi tác vụ hoàn tất. |
kill_background_task | Dừng tác vụ. |
Nhờ đó, Perch có thể giám sát bộ kiểm thử, quá trình build hay cài đặt dài thay vì phải chờ trong đó.
Sandbox
Với công việc cần tính toán thực tế thay vì suy luận về số liệu, Perch viết mã và chạy trong sandbox khép kín bằng run_sandbox_code. Nhờ vậy, tổng được tính thay vì đoán.
Sandbox được chủ động gia cố bảo mật:
- Tắt mạng. Sandbox không có quyền truy cập ra ngoài.
- macOS seatbelt. Mã được thực thi dưới hồ sơ
sandbox-exec, cô lập với phần còn lại của máy tính. - Ghi lại nguồn gốc. Các lần thực thi sandbox được ghi nhật ký, để số liệu tính được có thể truy về mã đã tạo ra nó.
Lập kế hoạch và theo dõi tác vụ
Perch có chức năng lập kế hoạch chính thức thay vì chỉ dẫn “suy nghĩ từng bước”:
- Chế độ Plan cho phép Perch xem xét không gian làm việc và soạn kế hoạch, với các công cụ thay đổi dữ liệu bị chặn đến khi bạn phê duyệt. Bạn nhận được thẻ kế hoạch, và không có gì được ghi khi bạn đang đọc.
- Danh sách việc cần làm cho phép Perch duy trì danh sách tác vụ hiển thị trong lượt chạy dài, để bạn theo dõi tiến độ thay vì đoán.
- Câu hỏi. Khi Perch thực sự bị chặn bởi quyết định thuộc về bạn, nó hỏi thay vì chọn thay bạn.
Chế độ chat
Ô soạn tin có ba chế độ, thay đổi những gì một lượt được phép làm:
| Chế độ | Hành vi |
|---|---|
| Ask | Hội thoại. Hỏi về thư mục, các tệp tải lên hoặc việc cần làm tiếp theo. |
| Plan | Perch xem xét, soạn kế hoạch và chờ phê duyệt trước khi hành động. |
| Agents | Perch lập kế hoạch và thực hiện tác vụ. |
Chế độ quyền
Tách biệt với chế độ chat, cài đặt quyền quy định bao nhiêu việc chạy mà không cần phê duyệt. Nó phân theo cấp độ rủi ro thay vì chỉ có công tắc bật tắt:
| Chế độ | Những gì chạy mà không hỏi |
|---|---|
| Default | Không có việc rủi ro. Ghi, chạy lệnh, gửi, xóa và các hành động không thể hoàn tác khác đều cần phê duyệt. |
| Auto Review | Công việc có thể hoàn tác với rủi ro thấp và trung bình tự chạy. Mỗi hành động có hệ quả vượt mức đó được một bộ phận đánh giá riêng kiểm tra, chỉ hỏi bạn khi không chắc chắn. |
| Take the Wheel | Tự chủ hoàn toàn. Perch có thể ghi, xóa, gửi và thực hiện các hành động thực tế không thể hoàn tác mà không hỏi. |
| Plan | Chỉ đọc. Công cụ thay đổi dữ liệu vẫn bị chặn đến khi kế hoạch được phê duyệt. |
Auto Review tự vận hành mà vẫn kiểm soát: các chỉnh sửa có thể hoàn tác và lệnh của chính dự án được thực hiện, hành động có hệ quả được đánh giá trước khi chạy, còn những hành động rủi ro cao nhất (force push, xóa hàng loạt) luôn dừng để hỏi bạn. Ranh giới nó đặt ra là giữa có thể và không thể hoàn tác, không phải giữa dễ và khó, nên sửa tệp bạn có thể hoàn tác được xử lý khác với gửi email. Xem chế độ quyền để biết cách bộ phận đánh giá quyết định.
Mức suy luận
Điều khiển mức suy luận đặt mức độ mô hình đầu tư cho một lượt. Đó là một thanh gồm năm đoạn: bốn mức suy luận, rồi một nấc riêng cho Flock.
| Cài đặt | Ý nghĩa |
|---|---|
| Off | Không suy nghĩ. Nhanh nhất và tiêu tốn mức sử dụng ít nhất. |
| Low | Suy luận nông. Tác vụ ngắn có phạm vi hẹp, cần tốc độ. |
| Medium | Cân bằng. Ít lần gọi công cụ hơn, được gộp nhiều hơn. |
| High | Mặc định. Suy luận phức tạp và công việc của agent. |
| Flock | Không phải mức suy luận. Lập kế hoạch một nhóm agent thực thi và chạy song song. Phù hợp nhất cho công việc lớn, có thể chia nhỏ. |
Điều thú vị nằm bên dưới. Các nhà cung cấp biểu đạt suy luận theo những cách hoàn toàn khác nhau: một số mô hình bỏ qua hoàn toàn tham số suy luận, một số chỉ nhận công tắc bật tắt, còn những mô hình khác cung cấp các thang mức có tên riêng. Mỗi mô hình trong danh mục mô hình khai báo mình thuộc loại nào, và mức suy luận bạn chọn được chuyển đổi cho phù hợp với mô hình thực sự được xác định cho lượt đó.
Điều này có nghĩa là một điều khiển hoạt động nhất quán bất kể Roost định tuyến bạn đến mô hình nào hay bạn tự ghim mô hình nào. Thanh này không bao giờ hứa mô hình sẽ làm điều nó không thể làm.
Claude Opus 5.5 trên Pro là mô hình có thang mức riêng: mức suy luận gồm low, medium, high, xhigh và max, và suy nghĩ luôn bật, nên không có Off.
Gemini 4 Argon trên Pro nhận các mức Low, Medium và High. Mô hình này luôn suy nghĩ, nên Off chạy như Low.
Sub-agent
Perch có thể tạo agent hỗ trợ trong một lượt, và bạn chọn mô hình cho chúng. Mặc định là Inherit, theo mô hình đang làm công việc chính. Chọn mô hình khác theo tên là cách để một mô hình kiểm tra công việc của mô hình khác thay vì tự chấm mình.
Cài đặt này cũng áp dụng cho agent được giao việc chạy nền. Mô hình được chọn theo tên tốn kém hơn so với việc để định tuyến tự động.
Xem Sub-agent để biết đầy đủ, và Operator và các agent để biết khác biệt giữa bốn chế độ đa agent.
Skill
Perch có bộ skill operator chỉ tải khi phù hợp: điều hướng không gian làm việc, GitHub và git, tài liệu, bảng tính, bài thuyết trình, PDF, sơ đồ, nghiên cứu, chất lượng dữ liệu và thao tác trình duyệt. Mỗi skill là tập chỉ dẫn cùng các công cụ ưu tiên cho một loại công việc, và việc rà siêu dữ liệu vẫn ít tốn kém trong khi chỉ dẫn đầy đủ chỉ tải khi phù hợp.
Mỗi skill cũng có tiêu chuẩn kiểm chứng, là những gì nó phải xác nhận trước khi bàn giao kết quả cho bạn. Xem Skill để biết bộ skill đầy đủ và cách chọn skill.
Quy tắc dự án
Perch đọc chỉ dẫn thường trực từ thư mục của bạn trong mọi lượt, từ .perch/PERCH.md và .perch/rules/, cùng sổ tay toàn cục tại ~/Documents/Perch/PERCH.md. Quy tắc bạn đặt ở đó ghi đè mặc định của Perch.
Xem Bộ nhớ để biết cách tệp dự án, bộ nhớ lâu dài và việc học từ những lần sửa sai kết hợp với nhau.
Cách Perch hoạt động
Perch đọc tài liệu của bạn trước, dựa trên những gì tìm được để trả lời và cho biết nguồn đằng sau mỗi nhận định.
Skill
Perch có bộ skill operator chỉ tải khi phù hợp. Mỗi skill là tập quy tắc làm việc, công cụ ưu tiên và tiêu chuẩn kiểm chứng cho một loại công việc. Đây là những skill đi kèm và cách chúng được chọn.