PerchAI
Sử dụng Perch

Agent trên đám mây

Chạy tác vụ Perch trong không gian làm việc đám mây riêng vẫn tiếp tục sau khi bạn đóng tab. Bắt đầu từ web, điện thoại hoặc Slack, trỏ đến kho mã GitHub và xem xét nhánh được đẩy lên. Đang ở giai đoạn beta cho Pro.

Beta

Agent trên đám mây được bật cho mọi tài khoản Pro. Nếu bạn thấy Cloud trong menu chọn nơi chạy tin nhắn, tính năng đã được bật cho bạn.

Agent trên đám mây là cùng agent Perch bạn dùng trên Desktop, chạy trong không gian làm việc đám mây riêng thay vì trên máy tính của bạn. Không gian làm việc có tệp và terminal riêng. Nó tiếp tục làm việc khi bạn đóng tab, thoát ứng dụng hoặc cất điện thoại, và luồng hội thoại cùng kết quả đang chờ khi bạn quay lại.

Bắt đầu phiên đám mây

Mở Perch Terminal trên web

Truy cập chat.perchai.app và chuyển từ Perch AI sang Perch Terminal, hoặc mở trực tiếp chat.perchai.app/agents/desktop. Tính năng hoạt động trong mọi trình duyệt, kể cả trên điện thoại.

Chọn Cloud

Nút hình viên thuốc đầu tiên trong ô soạn tin cho biết tin nhắn tiếp theo sẽ chạy ở đâu. Mở nút đó và chọn Cloud. Trong Perch Desktop, cùng menu này cung cấp lựa chọn máy tính của bạn và Cloud.

Chọn kho mã nếu tác vụ cần

Với công việc lập trình, chọn kho mã GitHub và nhánh từ các nút hình viên thuốc bên cạnh. Giữ No repository cho nghiên cứu, viết hoặc bất kỳ công việc nào khác không đụng đến kho mã.

Mô tả tác vụ và gửi

Viết như khi giao việc cho đồng nghiệp: cần thay đổi gì, kiểm tra thế nào và muốn nhận lại gì. "Sau đó chạy kiểm thử và đẩy lên nhánh mới" là cách kết thúc phù hợp cho công việc lập trình.

Điều gì xảy ra sau khi gửi

Tin nhắn đầu tiên khởi động sandbox riêng cho phiên. Dòng Session trong luồng hội thoại hiển thị quá trình chuẩn bị, mất vài giây. Nếu gửi tin nhắn tiếp nối ngay sau khi một lượt kết thúc, Perch dùng lại không gian làm việc khi nó vẫn đang sẵn sàng, nên lượt tiếp theo bắt đầu nhanh hơn.

Từ đó, quá trình chạy được truyền trực tiếp vào luồng hội thoại: Perch đang suy nghĩ gì, từng lệnh chạy và từng tệp thay đổi. Luồng hội thoại cập nhật trực tiếp ở mọi nơi đang mở, nên bạn có thể bắt đầu công việc trên điện thoại và xem nó hoàn tất trên Desktop.

Bạn có thể đóng mọi thứ. Quá trình chạy không phụ thuộc vào việc thiết bị nào của bạn vẫn đang mở.

Trên điện thoại, thêm Perch vào Màn hình chính. Với Pro, Perch có thể thông báo khi quá trình chạy cần bạn đồng ý hoặc đã hoàn tất.

Làm việc với kho mã GitHub

Lần đầu chọn kho mã, Perch yêu cầu bạn kết nối GitHub:

  1. Chọn Connect GitHub trong ô soạn tin.
  2. Perch hiển thị mã ngắn. Chọn Open GitHub, nhập mã và phê duyệt quyền truy cập kho mã.
  3. Sau khi được phê duyệt, Perch có thể clone, commit và đẩy nhánh lên các kho mã mà bạn có quyền đẩy lên.

Trong quá trình chạy, Perch làm việc trong bản clone của nhánh bạn chọn và đẩy công việc lên nhánh mới có tên perch/ kèm mã định danh ngắn. Không có gì được tự động hợp nhất cho bạn.

Để xem xét công việc, mở bảng Changes của luồng hội thoại. Bảng liệt kê mọi tệp đã thay đổi kèm diff. Từ đó bạn có thể Create PR hoặc Create draft PR, và khi đã có pull request, View PR đưa bạn đến đó trên GitHub.

Công cụ đã kết nối

Máy chủ MCP từ xa bạn kết nối trong Settings › Connections khả dụng với các phiên đám mây, nên quá trình chạy có thể đọc từ những hệ thống bạn đang dùng.

Máy chủ MCP cục bộ, tức những máy chủ được cấu hình trên máy tính trong ~/.perch/mcp.json, không khả dụng. Không gian làm việc đám mây không thể truy cập máy của bạn. Tác vụ cần tệp cục bộ, ứng dụng cục bộ hoặc máy chủ cục bộ nên chạy trên máy tính của bạn.

Khi một bước cần bạn đồng ý, luồng hội thoại hỏi và chờ, giống như trên Desktop. Trả lời từ bất kỳ màn hình nào bạn đang mở.

Slack

Bạn có thể giao tác vụ cho Perch mà không cần mở Perch.

  1. Trong Perch Terminal trên web, vào Settings › Connections và chọn Add to Slack.
  2. Liên kết tài khoản Slack với tài khoản Perch khi Perch yêu cầu.
  3. Gửi tin nhắn trực tiếp cho Perch hoặc nhắc đến Perch trong kênh.

Mỗi tin nhắn chạy như một phiên đám mây và câu trả lời trở lại trong cùng luồng Slack. Một luồng Slack tương ứng với một luồng Perch, cũng xuất hiện trong danh sách luồng hội thoại, nên bạn có thể tiếp tục trong Perch Terminal sau này.

Nếu một bước cần bạn phê duyệt, Slack yêu cầu bạn mở Perch để trả lời. Chưa hỗ trợ phê duyệt ngay trong Slack.

Mức sử dụng và giới hạn

  • Mức sử dụng mô hình được tính vào giới hạn thông thường của gói, giống mọi cuộc trò chuyện khác.
  • Thời gian không gian làm việc đám mây được giới hạn ở 30 giờ mỗi kỳ thanh toán. Settings › Usage › Cloud agents hiển thị lượng thời gian đã dùng. Khi chạm giới hạn, các lần chạy đám mây mới bị từ chối cho đến khi kỳ tiếp theo bắt đầu.
  • Tin nhắn chạy trên máy tính của bạn không bao giờ được tính vào thời gian không gian làm việc.

Bảo mật

Mỗi phiên chạy trong sandbox cô lập riêng, tách biệt với mọi người dùng khác. Chỉ token truy cập ngắn hạn cho các kết nối của bạn được đưa vào không gian làm việc; token dài hạn vẫn nằm trên máy chủ Perch.

Khắc phục sự cố

Tôi không thấy Cloud trong menu. Agent trên đám mây đi kèm Pro. Kiểm tra rằng bạn đã đăng nhập tài khoản Pro.

Kho mã của tôi không có trong danh sách. Perch liệt kê các kho mã mà tài khoản GitHub của bạn có thể đẩy lên. Với kho mã của tổ chức, tổ chức có thể cần cho phép quyền truy cập GitHub của Perch trước. Chọn Reconnect GitHub để đăng nhập lại.

Perch không bắt đầu lần chạy đám mây và báo tôi đã hết thời gian không gian làm việc. Bạn đã dùng hết 30 giờ của kỳ này. Tin nhắn chạy trên máy tính của bạn vẫn hoạt động, và mức sử dụng đi kèm được đặt lại theo kỳ thanh toán.