Tạo và cấu hình một agent

Hướng dẫn này chỉ cho bạn cách thêm một agent vào không gian làm việc và cấu hình nó cho tới khi nó thực sự chạy được.

Mỗi không gian làm việc được gieo tạo sẵn năm agent — một CEO cùng qa, architect, engineer và librarian — nên bạn thường đã có agent trước khi cấu hình bất kỳ agent nào. Những bước dưới đây áp dụng như nhau cho một agent được gieo tạo sẵn lẫn một agent mới.

Trước khi bắt đầu

Bạn đang ở trong một không gian làm việc. Toàn bộ bề mặt nằm tại Cài đặt → Không gian làm việc → Agent (/settings/workspace/agents).
Agent sẽ cần một backend. Hoặc kết nối một nhà cung cấp cho harness tích hợp sẵn tại Cài đặt → Máy chủ → Nhà cung cấp mô hình, hoặc cài Claude Code CLI trên máy đang chạy cc_server.
Nếu bạn muốn agent mang theo kỹ năng, hãy cài chúng trước tại Cài đặt → Không gian làm việc → Kỹ năng. Biểu mẫu agent chỉ cho phép bật/tắt những kỹ năng đã tồn tại trong không gian làm việc.

Thêm agent

Mở Cài đặt → Không gian làm việc → Agent.
Nhấp Agent mới.

Không có hộp thoại và không có trình chọn vai trò. 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 khung chi tiết bên phải.

Giờ bạn sẽ thấy “Agent chưa đặt tên” trong danh sách bên trái, với tab Cài đặt của khung chi tiết đang mở và trường Tên chứa “Agent chưa đặt tên”.

Đặt tên cho nó

Tên — mã định danh ngắn dùng trong @-mention, ví dụ alice. Việc phân tích mention khớp @ theo sau là các ký tự chữ, nên một cái tên chứa dấu gạch nối, dấu chấm hay dấu cách sẽ không bao giờ được mention tới.
Tiêu đề — nhãn dễ đọc với con người, ví dụ “Lập trình viên cao cấp”.
Prompt hệ thống — chỉ dẫn bổ sung tùy chọn, được chèn thành một mục Agent instructions; chúng không thay thế phần còn lại của prompt đã lắp ghép.

Nhấp Lưu thay đổi ở cuối biểu mẫu. Mọi trường trên trang này đều được lưu bằng chính nút đó.

Gán bộ điều hợp và mô hình

Danh sách thả xuống Bộ điều hợp liệt kê những trình chạy mà máy chủ thực sự có. Bộ điều hợp tích hợp sẵn luôn được tìm thấy (nó chính là máy chủ). Claude Code chỉ xuất hiện khi CLI của nó được phát hiện trên máy chủ đó:

Bộ điều hợp	Backend
Control Center (built-in)	Vòng lặp agent trong tiến trình — không có CLI bên ngoài
Claude Code	`claude -p --output-format stream-json`

Chỉ bộ điều hợp tích hợp sẵn mới thi hành chế độ, điều hướng giữa lượt chạy, tạm dừng/tiếp tục, hợp đồng hoàn thành và subagent. Claude Code không cho bạn bất kỳ thứ nào trong số đó. Cursor, Codex và những nhà cung cấp mô hình khác gắn vào bộ điều hợp tích hợp sẵn, chứ không phải những trình chạy riêng.

Danh sách thả xuống Mô hình do bộ điều hợp bạn đã chọn quyết định. Với bộ điều hợp tích hợp sẵn, danh sách đến trực tiếp từ những nhà cung cấp bạn đã kết nối tại Cài đặt → Máy chủ → Nhà cung cấp mô hình, nên một nhà cung cấp không có thông tin xác thực nào được lưu sẽ đóng góp 0 mô hình.

Thêm kỹ năng

Kỹ năng là bộ chọn dạng chip trên các gói kỹ năng đã cài trong không gian làm việc này. Nhấp một chip để bật/tắt nó; dấu tích đánh dấu những cái đã được chọn. Nếu không gian làm việc không có kỹ năng nào, trường này hiển thị “No skills available. Create skills in Settings → Skills first.”

Bạn không chọn kỹ năng riêng của kho mã ở đây. Một kho mã mang theo chúng (trong .agents/skills/, .claude/skills/ hoặc .opencode/skills/) sẽ tự động đóng góp chúng cho bất kỳ agent nào đang làm việc trong kho đó, và chúng được hoán đổi khi agent chuyển sang kho khác — xem Kỹ năng theo phạm vi kho mã.

Đặt tuyến báo cáo và persona

Báo cáo cho — chọn một agent khác theo tên. Việc này dựng nên cây báo cáo mà nút Sơ đồ tổ chức ở đầu trang hiển thị. Đây không phải danh sách mà một trưởng nhóm dùng khi ủy thác — danh sách đó đến từ các thành viên của nhóm và kỹ năng của họ.
Persona — văn bản tự do định hình giọng điệu và hành vi, ví dụ: “Ưu tiên những giải pháp đơn giản, dễ đọc. Viết kiểm thử cho mọi mã mới.”

Tinh chỉnh lượt chạy

Mức suy luận — các tùy chọn đến từ chính những mức mà mô hình đã chọn công bố: Low / Medium / High, cộng Extra High trên các mô hình kiểu OpenAI và Extra High + Max trên các mô hình kiểu Claude. Trường này bị ẩn hoàn toàn khi mô hình đã chọn không khai báo mức tư duy nào, và nó mặc định theo mặc định của chính mô hình.
Kích thước cửa sổ ngữ cảnh — được điền sẵn từ cửa sổ ngữ cảnh của mô hình mỗi khi bạn đổi mô hình, kèm các chip một chạm cho mặc định của mô hình, 200k, 500k và 1M. Giá trị bạn gõ vào sau khi chọn mô hình sẽ được giữ cho tới lần đổi mô hình tiếp theo.
Hết hạn im lặng (phút) — kết thúc một lượt chạy sau khoảng thời gian này mà không có đầu ra. Để trống để dùng mặc định theo từng chế độ.

Cấp quyền hạn

Agent không có công tắc quyền hạn riêng. Những gì nó được push, mở, merge hay truy cập do các quy tắc hành động trong Cài đặt → Không gian làm việc → Quyền của agent quyết định, nơi một quy tắc có thể được giới hạn cho agent này. Mặc định, một lần push, một pull request, một review hoặc merge và một lần ghi vào tracker đều hỏi bạn trước, từng cái một, còn truy cập mạng được cho phép.

Token GitHub của agent luôn chỉ đọc. Một lần push đi qua Control Center, nơi hỏi quy tắc Push lên remote trước khi chuyển tiếp. Xem Cấu hình chính sách sandbox để biết mỗi quy tắc tác động tới một lượt chạy thế nào.

Xác nhận nó chạy

Mở Cài đặt → Máy chủ → Nhà cung cấp mô hình và xác nhận bộ điều hợp bạn đã chọn báo một phiên bản đã cài thay vì “Không tìm thấy”. Nhấp Làm mới để dò lại — bước dò chạy trên máy đang chạy cc_server, chứ không phải trên máy bạn đang nhìn.
Mở một space có agent đó và gửi cho nó một tin nhắn, hoặc @-mention nó trong một space hiện có.
Quay lại Cài đặt → Không gian làm việc → Agent, chọn agent và mở tab Nhật ký. Một lượt chạy sẽ xuất hiện kèm nhãn trạng thái, thời lượng, thời điểm bắt đầu và bộ điều hợp mà nó đã dùng. Xem mở dòng sự kiện của lượt chạy đó.

Nếu không có lượt chạy nào xuất hiện, hãy xem qua Chẩn đoán một agent.

Xóa một agent

Chọn nó trong danh sách. Trên tab Cài đặt, cuộn xuống Vùng nguy hiểm ở cuối biểu mẫu và nhấp Xóa.