Làm việc trong Plan Studio

Bài hướng dẫn này chỉ cho bạn cách làm việc với kế hoạch trong Plan Studio. Để hiểu điều phối và tài liệu kế hoạch là gì, xem Điều phối và Dùng chế độ kế hoạch.

Mở một kế hoạch

Một kế hoạch thuộc về cuộc hội thoại đã tạo ra nó, nên đó là nơi bạn thường truy cập: hàng của kế hoạch trong cuộc hội thoại có hành động Mở và Plan Studio mở ra dưới dạng một tab trình soạn thảo bên cạnh cuộc hội thoại.

Trung tâm liệt kê ba mục:

Kế hoạch đang hoạt động — các điều phối, những cái đang đề xuất xếp trước, kèm trạng thái, số bước và số bản sửa đổi.
Tài liệu kế hoạch — những kế hoạch do một agent đơn lẻ gửi bằng submit_plan trong chế độ kế hoạch, trong lúc chúng đang ở trạng thái đề xuất hoặc đã được phê duyệt.
Playbook — các mẫu kế hoạch có tham số đã lưu.

Nhấp vào một thẻ để mở nó trong Plan Studio. Tuyến là /workspaces/<workspace-id>/plans/<kind>/<plan-id>, trong đó kind là orchestration hoặc document, nên bạn cũng có thể tạo liên kết sâu tới một kế hoạch đơn lẻ.

Nếu bạn mở một điều phối, bạn có canvas có thể chỉnh sửa, dòng thời gian phiên bản và thanh phê duyệt. Nếu bạn mở một tài liệu kế hoạch, cùng một đồ thị đó sẽ hiển thị ở chế độ chỉ đọc — tài liệu kế hoạch do agent tạo ra; bạn xem xét, ước tính và phê duyệt hoặc từ chối chúng, và một tài liệu đã được phê duyệt sẽ hiển thị trạng thái chạy trực tiếp theo từng nút từ điều phối mà nó được biên dịch thành.

Chỉnh sửa DAG

Có thể chỉnh sửa một điều phối khi nó đang ở trạng thái proposed. Mọi thao tác chỉnh sửa trên canvas đều dùng bàn phím:

Nhấp vào canvas, rồi di chuyển lựa chọn bằng các phím mũi tên.
Nhấn n để thêm một bước. Bước đó xuất hiện ở trạng thái được chọn với tên “Bước mới”; hãy đổi tên nó trong trình kiểm tra ở bên phải.
Nhấn e trên bước phải chạy trước, rồi nhấp vào bước phụ thuộc (hoặc chọn nó và nhấn Enter) để nối một phụ thuộc. Nhấn Esc để bỏ một kết nối đang chờ.
Nhấn x để cắt phụ thuộc mới nhất của bước đang chọn, hoặc bật/tắt các phụ thuộc chính xác trong trình chỉnh sửa phụ thuộc của trình kiểm tra.
Nhấn Delete để xóa bước đang chọn; các tham chiếu tới nó sẽ bị gỡ khỏi phần phụ thuộc của những bước còn lại.

Trong trình kiểm tra, bạn cũng có thể chỉnh sửa mô tả, vai trò và lược đồ đầu ra của bước. Các chỉnh sửa được tự động lưu thành một bản sửa đổi mới sau một khoảng dừng ngắn; một lỗi xác thực (hiển thị trên thanh phê duyệt) sẽ chặn việc lưu cho tới khi bạn sửa xong.

Chỉ các bước công việc mới chỉnh sửa được. Các nút cấu trúc — nghiên cứu, thảo luận và tổng hợp — là chỉ đọc, và bất kỳ bước nào có công việc đã chạy cũng vậy (nó được đánh dấu “đã chạy”, vì chỉnh sửa nó sẽ rẽ nhánh kế hoạch).

Việc lưu mang tính đồng thời lạc quan trên bản sửa đổi mà bạn bắt đầu. Nếu bộ điều phối lập lại kế hoạch ngay bên dưới bạn, thao tác lưu của bạn bị từ chối với thông báo “kế hoạch đã thay đổi” thay vì được hợp nhất hay âm thầm ghi đè; hãy đọc lại bản sửa đổi hiện tại và làm lại chỉnh sửa. Những lần lập lại kế hoạch do agent khởi xướng cũng bị giới hạn tần suất ở mức một lần mỗi hai phút, nên trường hợp này hiếm khi xảy ra.

Đọc các ước tính về chi phí, thời gian và rủi ro

Nhấn Ước tính trên thanh phê duyệt.

Mỗi bước trên canvas nhận một huy hiệu với khoảng chi phí và kích thước mẫu đằng sau nó, hoặc “Chưa có lịch sử” khi vai trò của bước chưa từng chạy. Chọn một bước để xem đầy đủ chi tiết trong trình kiểm tra: khoảng chi phí kèm kích thước mẫu, một khoảng thời lượng và phạm vi ảnh hưởng (các tệp và ký hiệu) suy ra từ xuất xứ của bước — hoặc “chưa rõ” khi bước không mang xuất xứ nào.
Thanh phê duyệt hiển thị tổng của kế hoạch: một khoảng chi phí tổng thể, một khoảng thời lượng cho đường găng (các nhánh song song chồng lấn, nên đây không phải là tổng) và trần ngân sách khi kế hoạch có đặt một mức.
Nếu chỉ một số bước có lịch sử, tổng số được đánh dấu là một phần và chỉ bao gồm những bước ước tính được. Nếu mức cao nhất của ước tính vượt trần ngân sách, tổng số chuyển sang màu đỏ kèm cảnh báo vượt ngân sách.

Các ước tính hoặc trung thực, hoặc không có: một bước mà vai trò chưa có lịch sử lần chạy hoàn tất sẽ báo kích thước mẫu bằng không và không có bất kỳ khoảng nào, đồng thời được hiển thị là chưa rõ thay vì đoán bừa. Hãy coi “Chưa có lịch sử” là “không ai biết”, chứ không phải “rẻ”.

Trần ngân sách là một phép so sánh hiển thị với ước tính này. Không có gì cưỡng chế nó khi kế hoạch đang chạy — xem Quản lý chi phí để biết những cơ chế thực sự chặn chi tiêu.

So sánh một bản sửa đổi với đề xuất trước đó

Mọi chỉnh sửa và mọi lần lập lại kế hoạch của bộ điều phối đều được ghi thêm vào một dòng thời gian bản sửa đổi chỉ ghi thêm, hiển thị trong bảng Phiên bản ở bên trái của một kế hoạch điều phối.

Nhấp vào một bản sửa đổi để so sánh nó với đề xuất hiện tại. Khi không chọn gì, bảng sẽ so sánh bản sửa đổi trước đó với bản hiện tại.
Đọc phần khác biệt ở nửa dưới của bảng: những bước được thêm, gỡ bỏ hoặc thay đổi giữa hai bản sửa đổi.
Nếu kế hoạch vẫn đang ở trạng thái proposed, nhấp vào biểu tượng tua lại trên một bản sửa đổi để quay về bản đó. Việc tua lại lưu đề xuất đó thành một bản sửa đổi mới — không mất gì cả.

Cả propose_orchestration lẫn trình soạn thảo đều từ chối thay đổi khi kế hoạch không còn ở trạng thái proposed, nên một lần chạy đang diễn ra sẽ không tiếp nhận việc lập lại kế hoạch giữa chừng.

Phê duyệt, từ chối hoặc mở rộng một kế hoạch

Trong ứng dụng, một kế hoạch đang đề xuất là một quyết định duy nhất, được đưa ra trọn vẹn: Phê duyệt kế hoạch hoặc Từ chối trên thanh phê duyệt. Phê duyệt kế hoạch luôn phê duyệt mọi bước — không có cách nào chọn một tập con trước. Việc phê duyệt bị chặn khi đề xuất có lỗi xác thực, và những lỗi này được hiển thị bên cạnh các nút.

Việc phê duyệt chỉ dành cho người vận hành. Không có công cụ MCP nào cho việc này, nên một agent có thể đề xuất và sửa đổi một kế hoạch nhưng không bao giờ phê duyệt được nó.

Khi một điều phối đang thực thi, thanh này thay đổi:

Nếu một bước dừng lại để hỏi giữa chừng, hãy chọn nó và nhấn Tiếp tục nút để tiếp tục.
Nhấn Phê duyệt mục đã chọn để mở rộng một phê duyệt một phần sang bước đang chọn cùng mọi thứ mà nó phụ thuộc một cách bắc cầu (một bước không bao giờ được phê duyệt mà thiếu các phụ thuộc của nó). Điều khiển này nằm trên thanh thực thi của mọi điều phối; nó không làm gì khi kế hoạch đã được phê duyệt trọn vẹn.
Nhấn Hủy lần chạy để dừng toàn bộ điều phối.

Những bước nằm ngoài một tập đã phê duyệt một phần sẽ hiển thị ở dạng bị hoãn và không chạy cho tới khi bạn mở rộng tập đó.

Chạy một playbook với tham số

Một playbook là một mẫu kế hoạch đã lưu với các chỗ giữ {{param}} có kiểu trong mục tiêu, tiêu đề bước, mô tả và prompt của nó. Việc thay thế là theo nghĩa đen — không có ngôn ngữ biểu thức; nếu cần logic, hãy dùng quy trình thay thế.

Trong mục Playbook của trung tâm, nhấn Chạy trên playbook (hoặc mở bảng lệnh ⌘K và chọn playbook ở đó).
Điền các tham số. Tham số kiểu liệt kê hiển thị dưới dạng menu thả xuống; tham số repo và agent nhận một tham chiếu repo hoặc agent; tham số tùy chọn sẽ dùng giá trị mặc định của chúng.
Chọn phiếu neo mà kế hoạch được đề xuất dựa trên đó, rồi xác nhận.

Chạy một playbook chỉ đề xuất một kế hoạch — điều phối được tạo ra sẽ mở trong Plan Studio ở trạng thái proposed và không có gì thực thi cho tới khi bạn phê duyệt nó ở đó. Để gỡ một playbook, nhấn biểu tượng thùng rác trên thẻ của nó.

Agent tạo và chạy playbook bằng các công cụ MCP create_playbook và run_playbook; xem tham chiếu công cụ MCP.

Hướng dẫn liên quan

Dùng chế độ kế hoạch: cách một agent tạo ra một tài liệu kế hoạch bằng submit_plan
Chạy một điều phối: vòng đời phê duyệt một lần nhìn từ phía cuộc hội thoại
Tạo mẫu quy trình: khi bạn cần logic mà một playbook không thể diễn đạt
Theo dõi lần chạy quy trình: góc nhìn của engine về một kế hoạch đã được phê duyệt

Khái niệm liên quan

Điều phối