Chạy agent song song

Hướng dẫn này chỉ cho bạn cách chạy nhiều agent cùng lúc mà chúng không ghi đè lên nhau.

Đơn vị cô lập là space, không phải agent

Khi công việc bắt đầu trong một space, Control Center cấp phát một bản checkout copy-on-write cho mỗi kho mã đã đăng ký, nằm dưới thư mục gốc riêng của space đó, trên một nhánh dẫn xuất từ mẫu nhánh của không gian làm việc. Sau đó mỗi agent trong space nhận một thư mục làm việc overlay riêng — nhưng các overlay chia sẻ thư mục repos/ của space đó.

Vì vậy:

Hai agent trong các space khác nhau làm việc trong các bản checkout khác nhau, trên các nhánh khác nhau. Đó là cô lập thực sự.
Hai agent trong cùng một space làm việc trên cùng một bản checkout, cùng một nhánh. Đường dẫn overlay của chúng khác nhau, nên khóa đường dẫn điều phối (vốn chỉ tuần tự hóa các lượt chạy khi chúng yêu cầu đúng cùng một thư mục làm việc) cũng không tuần tự hóa chúng. Chúng có thể ghi vào cùng những tệp tại cùng một thời điểm.

Quy tắc rút ra: mỗi tác vụ song song dùng một space.

Chạy tác vụ song song — các space riêng biệt

Mở một space với agent A và gửi cho nó một tác vụ.
Mở space thứ hai với agent B và gửi cho nó một tác vụ khác.
Cả hai được điều phối ngay lập tức, mỗi agent trong bản checkout của space riêng trên nhánh riêng.

Đây là công thức để dùng mỗi khi các agent sẽ chỉnh sửa tệp.

Phối hợp trong một space — nhiều lượt mention

Trong một space, hãy @-mention nhiều hơn một agent:

@alice refactor the auth module. @bob review what alice lands.

Cả hai agent được điều phối song song và truyền vào cùng một space, có gắn thẻ người gửi. Vì chúng chia sẻ bản checkout của space, hãy dùng cách này để phối hợp — một agent viết, một agent đọc, hoặc hai agent cùng suy luận về một cây làm việc — chứ không phải cho hai chỉnh sửa độc lập.

Tỏa nhánh từ một quy trình

Mẫu pr_review tích hợp sẵn là ví dụ được phát hành của kiểu tỏa nhánh: nhiều node đánh giá chạy đồng thời từ một trình kích hoạt và một node Consolidate (join) gộp các phát hiện của chúng thành một báo cáo. Chạy nó từ màn hình quy trình và mọi người đánh giá đều được điều phối song song.

Trình biên tập quy trình ẩn sentinel kết thúc và nối lại nó để chờ mọi nút đích đang hoạt động khi bạn thêm hoặc nối một bước, nhờ đó các nhánh bạn tự vẽ vẫn chạy.

Theo dõi chúng chạy

Quan sát → Trực tiếp (chân thanh bên → Quan sát, rồi đến thẻ Trực tiếp) hiển thị danh sách agent của không gian làm việc này, cập nhật lại mỗi giây: trạng thái (đang chạy / nhàn rỗi / đỗ / đã hủy), mỗi agent đang làm gì, token và chi phí cho lượt chạy gần nhất, cùng nút dừng cho một tiến trình đang chạy. Chọn một dòng sẽ neo mở một ngăn kéo bản ghi trực tiếp.

Cài đặt → Không gian làm việc → Agent hiển thị cùng danh sách đó với một bộ từ vựng trạng thái khác, ưu tiên mức độ cần chú ý, được suy ra từ lịch sử chạy của từng agent — đang chạy, bị chặn, thất bại, nhàn rỗi, chưa từng chạy — sắp xếp sao cho bất cứ thứ gì cần chú ý đều nổi lên đầu. Thẻ Nhật ký của mỗi agent lưu lịch sử chạy riêng của nó.

Cả hai bề mặt đều giới hạn trong không gian làm việc đang hoạt động.

Xử lý xung đột

Giữa các space, mỗi space nằm trên nhánh riêng, nên va chạm xuất hiện dưới dạng một xung đột merge Git thông thường khi bạn merge pull request thứ hai. Hãy xử lý như với bất kỳ xung đột merge nào.

Bên trong một space không có ranh giới nhánh và cũng không có khóa: các agent đang ghi trực tiếp vào cùng những tệp và bên thua đơn giản là bị ghi đè. Nếu bạn thấy mình muốn hai agent cùng chỉnh sửa trong một space, hãy tách công việc thành hai space.

Để giảm va chạm theo cả hai cách:

Cho mỗi agent một phạm vi riêng — tệp khác nhau, mô-đun khác nhau.
Dùng đồ thị mã để kiểm tra một thay đổi chạm tới những gì trước khi điều phối. Xem Tìm mã bằng đồ thị mã.
Xem xét và merge pull request của từng agent một cách kịp thời.

Cân nhắc về tài nguyên

Mỗi agent đang chạy tiêu tốn:

Một bản checkout của space — không đáng kể trên đĩa khi có copy-on-write; trên Windows là một git worktree. Hệ thống tệp không thể reflink sẽ làm việc cấp phát thất bại thay vì sao chép.
Một tiến trình trên máy chủ
Token mô hình, tích lũy theo từng agent

Chi phí được ghi vào Quan sát → Phân tích. Lưu ý rằng một lượt tương tác thông thường không có giới hạn chi tiêu; xem Quản lý chi phí để biết hai lệnh có giới hạn chi tiêu.