Chạy một điều phối

Hướng dẫn này chỉ cho bạn cách biến một mục tiêu lớn thành một kế hoạch cho cả nhóm tự vận hành. Xem Điều phối để hiểu cách nó hoạt động.

Khi nào nên dùng điều phối

Hãy dùng điều phối khi yêu cầu lớn hơn một agent và bạn chưa biết chính xác các bước. Với một tác vụ đơn lẻ, hãy nhắn cho một agent trong một space; với một quy trình bạn có thể tự viết ra bằng tay, hãy dựng một mẫu quy trình.

Bước 1: Yêu cầu kế hoạch

Mở (hoặc tạo) một space và một phiếu neo. Mọi đề xuất đều cần một phiếu như vậy (propose_orchestration nhận ticket_id); space dùng chung được lấy từ phiếu đó.
Tùy chọn, chuyển hộp chọn chế độ của trình soạn sang Điều phối. Chế độ đó thu hẹp agent vào việc đọc và đề xuất — bộ nhớ, đồ thị mã, việc đọc repo và phiếu, propose_orchestration cùng các công cụ playbook — nên nó không thể bắt đầu viết mã thay vì lập kế hoạch.
@-mention agent điều phối của bạn (thường là agent CEO) và nêu mục tiêu bằng ngôn ngữ thường ngày:

@ceo Nghiên cứu bối cảnh cạnh tranh cho một ứng dụng ghi cuộc họp ưu tiên ngoại tuyến và viết một tài liệu định vị dài một trang.

Agent điều phối trả lời bằng một thẻ đề xuất có cấu trúc trong space: các vai trò cần thiết, công việc được chia thành các phiếu con, một giai đoạn nghiên cứu và thảo luận tùy chọn, một bước tổng hợp tạo ra kết quả bàn giao và một ngân sách.

Vì đề xuất là một đối tượng có kiểu, ứng dụng kiểm tra tính hợp lệ của nó (các vai trò đúng dạng, lược đồ đầu ra được khai báo, một DAG không có chu trình) trước khi bất cứ thứ gì chạy. Một đề xuất không vượt qua kiểm tra hợp lệ thì không thể được phê duyệt.

Bước 2: Xem xét và chỉnh sửa đề xuất

Thẻ trong cuộc hội thoại đưa ra ba hành động: Duyệt kế hoạch, Từ chối và Mở — nút Mở sẽ mở kế hoạch trong Plan Studio dưới dạng một tab trình chỉnh sửa. Bản thân thẻ thì không thể chỉnh sửa.

Để thay đổi bất cứ điều gì, hãy nhấn Mở và làm việc trong trình kiểm tra bên phải:

Tiêu đề, mô tả, vai trò, phụ thuộc và lược đồ đầu ra của bất kỳ bước công việc nào. Vai trò ở đây nghĩa là bước đó thuộc về khóa vai trò nào trong số các khóa vai trò đã có của kế hoạch — bạn không thể ghim một vai trò vào một agent có tên hay sửa danh sách tuyển dụng từ trình kiểm tra, và bạn cũng không thể sửa ngân sách.

Hai thứ ở dạng chỉ đọc: các nút cấu trúc (nghiên cứu, thảo luận, tổng hợp) và bất kỳ nút nào có công việc đã chạy. Chỉ có thể chỉnh sửa khi điều phối vẫn đang ở trạng thái proposed.

Nhấn Ước tính trên thanh phê duyệt để xem khoảng chi phí, thời lượng và phạm vi ảnh hưởng trước khi bạn chốt. Xem Làm việc trong Plan Studio để biết đầy đủ về trình chỉnh sửa.

Bước 3: Phê duyệt

Hãy phê duyệt kế hoạch, từ thẻ trong cuộc hội thoại hoặc từ thanh phê duyệt của Plan Studio. Đây là quyết định duy nhất bạn đưa ra. 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ên một agent có thể đề xuất và sửa đổi nhưng không bao giờ tự phê duyệt kế hoạch của mình.

Từ đây, một bộ hiện thực hóa tất định (một hàm thuần túy, không dùng LLM) biến đề xuất thành một quy trình thật và tạo bộ khung:

tuyển bất kỳ vai trò mới nào (và ghi lại id của các agent được tuyển để một sự cố giữa chừng lúc phê duyệt có thể chạy tiếp mà không tuyển trùng)
gom các vai trò vào một nhóm
tạo một dự án và xếp phiếu cha vào dự án đó
khởi chạy lần chạy quy trình điều khiển tất cả

Trạng thái chuyển sang approved, rồi executing.

Bước 4: Theo dõi khi nó chạy

Các phiếu con thực thi dưới dạng các bước quy trình; nếu bạn đã bật một vòng thảo luận, mỗi vai trò đăng quan điểm của mình trước. Tiến độ hiện ra ở những nơi bạn vẫn thường xem:

phiếu cha mà điều phối được neo vào
space dùng chung nơi nhóm trao đổi, với hàng của kế hoạch theo dõi trạng thái của từng nút
chi tiết lần chạy quy trình, với biểu đồ thác nước quen thuộc và chi phí theo từng bước — xem Theo dõi lần chạy quy trình
dự án mà phiếu cha được xếp vào

Khi các phiếu con hoàn tất, trạng thái chuyển sang synthesizing và bước tổng hợp tạo ra kết quả bàn giao. Văn bản đó được đăng trong space dùng chung và phiếu cha được đánh dấu hoàn tất, rồi trạng thái chuyển sang completed.

Dừng sớm

Nhấn Hủy điều phối trên thẻ trong cuộc hội thoại, hoặc Hủy lần chạy trên thanh phê duyệt của Plan Studio. Việc hủy sẽ dỡ bỏ công việc đang chạy.

Một điều phối thất bại khi bước hiện thực hóa thất bại, hoặc khi lần chạy quy trình đã sinh của nó thất bại (nghiên cứu, thảo luận, tổng hợp hoặc persist — những bước này không tiếp tục khi thất bại). Các bước công việc đã sinh thì luôn tiếp tục khi thất bại, nên một phiếu con thất bại không làm cả lần chạy thất bại. Không có nhánh thất bại do vượt ngân sách và không có ngưỡng “mọi phiếu con đều thất bại”.

Hướng dẫn liên quan

Làm việc trong Plan Studio: chỉnh sửa, ước tính, xem diff và phê duyệt kế hoạch
Tạo và quản lý phiếu: phiếu cha mà một điều phối được neo vào
Tổ chức công việc bằng dự án: nơi phiếu cha được xếp vào
Theo dõi lần chạy quy trình: một điều phối đã được hiện thực hóa trông thế nào trong bộ máy
Xây dựng một nhóm agent: các vai trò mà một điều phối lấp đầy hoặc tuyển mới