Điều phối agent đầu tiên của bạn

Bạn sẽ xây dựng gì

Đến cuối hướng dẫn này, bạn sẽ có:

• Một agent do chính bạn tạo và cấu hình
• Một space nơi bạn và agent đó trò chuyện
• Một lượt chạy đã hoàn tất, với công việc đã được commit trong một worktree cách ly và một hàng trong nhật ký lượt chạy của agent

Điều kiện tiên quyết: đã hoàn thành Không gian làm việc đầu tiên của bạn, nghĩa là không gian làm việc này đã có một kho mã được đăng ký và ít nhất một nhà cung cấp mô hình được kết nối.

Bước 1: Tạo một agent

1. Mở Cài đặt → Không gian làm việc → Agent
2. Nhấp Agent mới. Một agent tên “Agent chưa đặt tên” được tạo ngay lập tức và được chọn sẵn trong danh sách — không có hộp thoại tạo và không có gì để xác nhận. Bạn cấu hình nó ngay tại chỗ.
3. Trên tab Cài đặt, điền:
   • Tên: một cái gì đó ngắn gọn, dễ nhớ, ví dụ alice. Đây là thứ bạn gõ sau @.
   • Tiêu đề: việc nó làm, ví dụ “Kỹ sư backend”
   • Bộ điều hợp: Control Center (built-in). Hãy chọn nó một cách có chủ đích — chỉ harness tích hợp sẵn mới có thể được điều hướng giữa lượt chạy và tạm dừng ở ranh giới lượt, và nó không cần cài CLI nào trên máy chủ.
   • Mô hình: chọn từ danh sách mà nhà cung cấp đã kết nối cung cấp
   • Kỹ năng: gắn bất kỳ kỹ năng nào phù hợp, ví dụ testing hoặc architecture
4. Nhấn Lưu thay đổi

Agent không có bộ điều hợp sẽ chạy trên vòng lặp tích hợp sẵn

Khi trường Bộ điều hợp không được đặt, việc điều phối sẽ quay về Control Center (built-in) — vòng lặp agent bên trong máy chủ, nên không phải cài gì trên máy chủ. Nó vẫn cần một mô hình: khi không đặt mô hình nào, nó hỏi Anthropic mặc định của mình; cách này chạy được nếu bạn đã kết nối một tài khoản Anthropic, còn nếu không sẽ thất bại với No credential for provider "anthropic". Dù sao hãy đặt cả hai một cách minh thị, nếu không bạn sẽ chạy trên một mô hình mà bạn không chọn.

Điểm kiểm tra. Hàng trong danh sách hiển thị tên agent của bạn và một vòng trạng thái rỗng.

Bước 2: Khởi tạo một space

1. Trong thanh bên, tìm mục Không gian và nhấp nút +
2. Đặt tên cho space
3. Trong Thêm agent, chọn agent bạn vừa tạo
4. Nếu không gian làm việc có kho mã nào, hãy chọn những kho mã mà space này sẽ làm việc trên đó
5. Nhấp Tạo

Space mở ra. Ở hậu cảnh, Control Center cấp phát một worktree copy-on-write của các kho mã đã chọn cho cuộc hội thoại này, trên nhánh riêng của nó. Bản checkout nguồn của bạn không bao giờ bị thay đổi.

Bước 3: Gửi một tác vụ

Gõ một tác vụ cụ thể, nhỏ đối với kho mã bạn đã đăng ký. Một việc có kết quả kiểm chứng được là tốt nhất — thêm một bài kiểm thử, sửa một lỗi lint, đổi tên một ký hiệu.

Nhấn Enter. Bạn không cần @-mention ai cả: khi space chỉ có một agent, một tin nhắn thường sẽ đánh thức nó. Trong một space có nhiều agent, @name sẽ chọn một agent.

Control Center lắp ghép prompt từ chỉ dẫn, persona, kỹ năng của agent cùng ngữ cảnh của space, rồi điều phối lượt chạy.

Điểm kiểm tra. Nút gửi của trình soạn biến thành nút dừng — một agent đang làm việc trong cuộc hội thoại này — và văn bản bắt đầu xuất hiện.

Bước 4: Xem nó làm việc

Cuộc hội thoại hiển thị lượt chạy ngay khi nó diễn ra:

• Suy luận, hiển thị nội tuyến khi agent suy nghĩ
• Lời gọi công cụ: đọc và ghi tệp, tìm kiếm, lệnh shell, mỗi lời gọi kèm kết quả của nó
• Văn bản: tóm tắt, giải thích và câu hỏi dành cho bạn

Nếu agent hỏi điều gì đó, hãy trả lời trong cuộc hội thoại và nó sẽ tiếp tục chạy.

Để xem các chỉ số riêng của một lượt chạy cùng các nút tạm dừng, tiếp tục và dừng của nó, hãy tìm agent đang chạy trong mục Agent của khung Chung thuộc space rồi chọn Mở hoạt động.

Trong khung hoạt động, huy hiệu trạng thái hiển thị Đang chạy, rồi Thành công khi lượt chạy kết thúc. Một lượt chạy bị đình trệ hoặc lặp lại hiển thị Bị chặn; lượt chạy gặp lỗi hiển thị Thất bại. Trong danh sách agent, vòng trạng thái rỗng trước lượt chạy đầu tiên và đặc lại khi agent nhàn rỗi trở lại.

Những gì giới hạn lượt chạy: worktree copy-on-write riêng của nó, thông tin xác thực được bộ môi giới cấp lúc khởi chạy và bị thu hồi khi kết thúc, một môi trường đã được làm sạch, bề mặt công cụ mà chế độ của nó cho phép cùng các rào chắn hành động. Những hiệu ứng như push một nhánh hay mở một pull request được kiểm soát riêng — xem Rào chắn.

Bước 5: Kiểm tra kết quả

1. Mở Cài đặt → Không gian làm việc → Agent và chọn agent của bạn
2. Mở tab Nhật ký

Điểm kiểm tra. Một hàng lượt chạy, hiển thị trạng thái, thời lượng, thời điểm bắt đầu và kết thúc cùng bộ điều hợp mà nó đã chạy trên đó.

Các thay đổi của agent được commit trên nhánh của cuộc hội thoại, trong worktree của nó. Commit được tạo với tư cách tác giả là agent, còn bạn được ghi nhận trong trailer Co-Authored-By:.

Nhận một pull request

Không có gì tự mở pull request. Nếu bạn muốn có một cái, hãy yêu cầu ngay trong cuộc hội thoại đó:

Push nhánh này và mở một pull request nhắm vào nhánh mặc định.

Push (gitPush) và việc tạo PR (prCreate) đều mặc định nhắc bạn phê duyệt, nên hãy chờ một xác nhận trước mỗi thao tác. Nếu không có người phê duyệt nào được kết nối khi lời nhắc kích hoạt, hành động sẽ bị từ chối thay vì được cho phép — các rào chắn hành động fail-closed.

PR được mở dưới danh tính GitHub mà lượt chạy đã dùng token của danh tính đó — của bạn, nếu bạn đã lưu token cá nhân — chứ không dưới tên của agent. Quyền tác giả của agent hiển thị trên các commit.

Bạn cũng có thể tự mở nó: khung Kiểm soát mã nguồn của space có nút Tạo pull request đưa nhánh của cuộc hội thoại vào màn hình soạn thảo, còn Pull requests → PR mới mở chính màn hình đó ở trạng thái trống. Đó là chỗ hướng dẫn tiếp theo tiếp nối.

Tóm tắt

Bạn đã tạo một agent, cấu hình bộ điều hợp và mô hình cho nó, giao cho nó một space và một tác vụ rồi xem một lượt chạy thật hoàn tất trong một worktree cách ly mà không đụng tới bản checkout của bạn.

Tiếp theo: Xem xét pull request đầu tiên để tìm hiểu quy trình xem xét.

Để biết thêm về agent: Mô hình agent. Để biết chi tiết về điều phối: Vòng đời điều phối agent.