PerchAI
Sử dụng Perch

Tác vụ tự động

Lưu một tác vụ một lần và Perch chạy nó trên đám mây theo lịch, hoặc khi mã của chính bạn gọi đến, kể cả khi máy tính của bạn đang tắt. Mỗi lần chạy mở ra dưới dạng một cuộc trò chuyện bạn có thể đọc và tiếp tục. Đang ở giai đoạn beta cho Pro.

Beta

Tác vụ tự động được bật cho mọi tài khoản Pro. Nếu bạn thấy Routines (Tác vụ tự động) trong thanh bên của Perch Terminal, bên dưới Artifacts, tính năng đã được bật cho bạn.

Tác vụ tự động là một tác vụ đám mây đã lưu: tên, hướng dẫn, mô hình và điều gì sẽ khởi động nó. Khi đến giờ, Perch khởi động một agent trên đám mây với hướng dẫn của bạn làm tin nhắn đầu tiên. Tác vụ chạy trong không gian làm việc đám mây riêng, nên máy tính của bạn có thể tắt. Sau đó, bạn mở cuộc trò chuyện của lần chạy, đọc những gì nó đã làm và tiếp tục trò chuyện nếu muốn thêm.

Tác vụ tự động phù hợp với những việc bạn vẫn phải yêu cầu đi yêu cầu lại: rà soát lỗi buổi sáng trên một kho mã, lượt xử lý hộp thư hỗ trợ vào mỗi ngày làm việc, bản tóm tắt số liệu hằng tuần, hoặc một bước kiểm tra do công cụ của chính bạn khởi động sau mỗi lần triển khai.

Tạo tác vụ tự động

Mở Routines

Trong Perch Terminal trên web hoặc trong Perch Desktop, chọn Routines (Tác vụ tự động) trong thanh bên, rồi chọn New routine.

Đặt tên và viết hướng dẫn

Viết hướng dẫn như khi giao việc cho đồng nghiệp: cần xem gì, cần làm gì và bạn muốn nhận lại gì. Ví dụ: "Đọc email mới trong hộp thư hỗ trợ. Soạn thư trả lời cho từng câu hỏi đơn giản và lưu thành bản nháp Gmail. Gắn nhãn cho phần còn lại. Không bao giờ gửi bất cứ thứ gì."

Menu mô hình nằm ở góc dưới bên phải của ô hướng dẫn và có cùng các lựa chọn như ô soạn tin.

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

Với công việc lập trình, chọn một kho mã GitHub và một nhánh. Mỗi lần chạy sẽ clone kho mã đó và đẩy công việc lên một 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. Giữ No repository cho mọi việc không đụng đến kho mã.

Chọn cách kích hoạt

Schedule chạy tác vụ vào những thời điểm đã định, hoặc một lần vào một thời điểm trong tương lai. API bắt đầu tác vụ từ mã của chính bạn. Cả hai được mô tả bên dưới.

Thiết lập kết nối, cách hoạt động và thông báo

Ba tab bên dưới phần kích hoạt quyết định tác vụ tự động được dùng những ứng dụng nào, có dừng lại hỏi trước các hành động rủi ro hay không, và cách nó báo cho bạn về một lần chạy. Xem Cài đặt.

Chọn Create routine

Tác vụ tự động được bật ngay từ lúc bạn lưu. Biểu mẫu cho biết lần chạy đầu tiên sẽ diễn ra khi nào.

Hoặc nhờ Perch

Trong bất kỳ cuộc trò chuyện Perch Terminal nào, trên web, trong Perch Desktop hoặc trong CLI, hãy mô tả tác vụ tự động bạn muốn, hoặc gõ /schedule (/routines cũng được). Perch hỏi những gì còn thiếu, rồi hiển thị một thẻ với mọi thứ sẽ được lưu: tên, toàn bộ hướng dẫn, lịch theo múi giờ của bạn kèm lần chạy tiếp theo, mô hình, các kết nối, kho mã và cài đặt.

Không có gì được lưu cho đến khi bạn phê duyệt thẻ. Thẻ xuất hiện trong mọi chế độ quyền, kể cả Take the Wheel, và Auto Review không bao giờ phê duyệt thay bạn. Trừ khi bạn chỉ định khác, tác vụ tự động dùng mô hình mà cuộc trò chuyện đang dùng và múi giờ của thiết bị của bạn.

Chính các lần chạy của một tác vụ tự động không thể tạo hoặc thay đổi tác vụ tự động.

Cách kích hoạt

Theo lịch

Lặp lạiThời điểm chạy
Every hourVào phút bạn chọn trong mỗi giờ.
Every dayVào một giờ trong ngày.
WeekdaysTừ thứ Hai đến thứ Sáu, vào một giờ trong ngày.
Every weekVào một ngày trong tuần, tại một giờ trong ngày.
CustomTheo lịch cron gồm năm trường: phút, giờ, ngày trong tháng, tháng, ngày trong tuần.
OnceVào một ngày và giờ cụ thể. Sau đó tác vụ tự động hiển thị Done: it ran once.

Mọi lịch đều chạy theo múi giờ bạn chọn, nên việc chuyển đổi giờ mùa hè không làm lịch bị lệch. Một tác vụ tự động chạy tối đa mỗi giờ một lần, và lịch tùy chỉnh chạy thường xuyên hơn sẽ bị từ chối.

API

Dùng cách kích hoạt API để bắt đầu một tác vụ tự động từ script triển khai, cảnh báo giám sát hoặc ứng dụng khác. Khi bạn lưu, Perch hiển thị một token bí mật một lần duy nhất. Hãy sao chép ngay lúc đó.

Trên trang của tác vụ tự động, Trigger from another app hiển thị địa chỉ và một yêu cầu mẫu:

curl -X POST https://chat.perchai.app/api/routines/fire \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"text": "..."}'
  • text là tùy chọn, tối đa 2,000 ký tự. Nội dung này đến lần chạy dưới dạng dữ liệu, không bao giờ là mệnh lệnh, nên Perch chỉ dùng nó theo cách hướng dẫn của bạn quy định. Ví dụ: "Nội dung cảnh báo được đính kèm. Tìm nguyên nhân của nó trong kho mã."
  • Perch phản hồi bằng 202 cùng runId và chatUrl của lần chạy mới.
  • Mỗi tác vụ tự động có thể được bắt đầu theo cách này tối đa 30 lần mỗi giờ.
  • Make a new token thay thế token, và token cũ ngừng hoạt động. Delete token tắt cách kích hoạt API.

Chạy ngay

Mọi tác vụ tự động đều có Run now trên trang của nó, dù được kích hoạt theo cách nào. Chọn Add a note trước để gửi thêm văn bản kèm riêng lần chạy đó.

Cài đặt

Kết nối

Tác vụ tự động chỉ dùng được các kết nối bạn thêm trong tab này. Không có kết nối nào được chọn sẵn cho bạn. Bạn có thể thêm bất kỳ ứng dụng nào đã kết nối trong Settings › Connections, tối đa 10 ứng dụng cho mỗi tác vụ tự động.

Tác vụ tự động chạy trên đám mây, nên máy chủ MCP cục bộ được cấu hình trên máy tính của bạn không khả dụng với chúng, giống như với mọi agent trên đám mây.

Cách hoạt động

  • Ask before risky actions là mặc định. Lần chạy sẽ chờ bạn phê duyệt trước khi làm bất cứ việc gì rủi ro, và trạng thái của nó là Waiting for you. Trang tác vụ tự động hiển thị A run is waiting for your approval cùng nút Review để mở cuộc trò chuyện. Yêu cầu phê duyệt không được trả lời trong 24 giờ sẽ hết hạn.
  • Run without asking cho phép Perch làm theo hướng dẫn mà không dừng lại, kể cả thực hiện thay đổi qua các kết nối của nó. Hãy dùng cho những tác vụ bạn đã từng theo dõi chạy trước đó.
  • New chat each run là mặc định. Keep one chat khiến mỗi lần chạy tiếp nối lần trước, nên nó có thể cho bạn biết điều gì đã thay đổi kể từ đó.

Thông báo

Tell me quyết định khi nào bạn nhận được tin về một lần chạy:

  • After every run (mặc định)
  • Only when there's something to report. Mỗi lần chạy cho biết có tìm thấy gì không. Lần chạy không tìm thấy gì sẽ hiển thị Nothing to report và không thông báo cho bạn.
  • Only when a run fails
  • Never

Bên dưới, chọn Phone notification, Email hoặc cả hai. Thông báo trên điện thoại cần Perch trên Màn hình chính. Email nêu tên tác vụ tự động và kết quả, mở đầu bằng phần đầu của câu trả lời và có liên kết đến cuộc trò chuyện.

Trừ khi Tell me được đặt thành Never, Perch luôn gửi email cho bạn khi một lần chạy không thành công, đang chờ bạn phê duyệt hoặc không thể bắt đầu, kể cả khi Email không được đánh dấu.

Theo dõi tác vụ tự động

Danh sách tác vụ tự động hiển thị lịch của từng tác vụ, lần chạy tiếp theo, kết quả lần chạy gần nhất và công tắc bật/tắt. Một con số đánh dấu các kết quả bạn chưa mở.

Mở một tác vụ tự động để xem các lần chạy của nó: mỗi lần bắt đầu khi nào, được khởi động bởi gì (Schedule, API hoặc Run now), diễn ra thế nào và mất bao lâu. Open chat mở cuộc trò chuyện của một lần chạy. Các cuộc trò chuyện của tác vụ tự động không xuất hiện trong danh sách trò chuyện, nên một tác vụ chạy mỗi giờ không làm công việc khác của bạn bị chìm xuống. Mỗi cuộc trò chuyện là một cuộc trò chuyện đám mây bình thường: hỏi tiếp, trả lời yêu cầu phê duyệt, hoặc xem xét một nhánh trong bảng Changes.

Trạng tháiÝ nghĩa
RunningLần chạy vẫn đang diễn ra.
Waiting for youLần chạy cần bạn phê duyệt để tiếp tục.
AnsweredLần chạy đã hoàn tất.
Nothing to reportLần chạy đã hoàn tất và không tìm thấy gì đáng báo cho bạn.
FailedLần chạy dừng do lỗi. Lý do được hiển thị kèm theo.
ExpiredLần chạy đã chờ phê duyệt quá 24 giờ.
StoppedBạn đã dừng lần chạy.
SkippedLần chạy không bắt đầu. Lý do được hiển thị kèm theo.

Một lần chạy theo lịch sẽ bị bỏ qua, và lần tiếp theo vẫn diễn ra như kế hoạch, khi:

  • Lần chạy trước của tác vụ tự động vẫn đang diễn ra. Hai lần chạy của cùng một tác vụ tự động không bao giờ bắt đầu cùng lúc.
  • Lần chạy trước đang chờ bạn phê duyệt và tác vụ tự động giữ một cuộc trò chuyện.
  • Perch không thể bắt đầu nó trong vòng 30 phút sau giờ đã hẹn.
  • Bạn đã có ba lần chạy trên đám mây đang diễn ra suốt 30 phút sau giờ đã hẹn.
  • Bạn đã chạm giới hạn lần chạy trên đám mây trong ngày, hoặc đã dùng hết số giờ không gian làm việc đám mây của kỳ này.

Để thay đổi một tác vụ tự động, hãy mở nó và chọn Edit từ menu More actions. Công tắc dùng để tắt và bật nó. Delete xóa tác vụ tự động nhưng vẫn giữ các cuộc trò chuyện của nó.

Nếu mô hình của một tác vụ tự động không còn được cung cấp, Perch sẽ tắt tác vụ đó và báo cho bạn thay vì tự đổi mô hình. Hãy chọn mô hình khác rồi bật lại.

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

  • Tối đa 20 tác vụ tự động có thể bật cùng lúc.
  • Mỗi giờ một lần là tối đa cho mỗi tác vụ tự động.
  • Mỗi lần chạy là một lần chạy agent trên đám mây. 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, và thời gian không gian làm việc được tính vào 30 giờ thời gian không gian làm việc đám mây mỗi kỳ thanh toán. Các lần chạy của tác vụ tự động dùng chung giới hạn ba lần chạy trên đám mây cùng lúc với các cuộc trò chuyện đám mây khác của bạn.

Khắc phục sự cố

Tôi không thấy Routines. Tác vụ tự động đi kèm Pro. Kiểm tra rằng bạn đã đăng nhập tài khoản Pro.

Lịch của tôi bị từ chối. Một tác vụ tự động chỉ có thể chạy tối đa mỗi giờ một lần, và thời điểm Once phải ở trong tương lai.

Một lần chạy báo Skipped. Lý do được hiển thị bên cạnh. Danh sách ở trên giải thích từng lý do.

Tôi không nhận được email. Kiểm tra rằng Tell me không được đặt thành Never, và xem thư mục thư rác. Nếu hiện tại Perch không gửi được email, trang của tác vụ tự động sẽ cho biết.