Cấu hình agent

Trang tham chiếu này liệt kê mọi trường trên thực thể agent, cùng các enum và cờ mà nó dùng. Để xem hướng dẫn từng bước về cách tạo hoặc chỉnh sửa một agent trong ứng dụng, xem Tạo và cấu hình một agent.

Các trường của thực thể agent

Trường	Kiểu	Bắt buộc	Mô tả
`id`	`String`	Có	Mã định danh duy nhất của agent
`name`	`String`	Có	Mã định danh ngắn dùng cho @-mention
`title`	`String`	Có	Chức danh vai trò dễ đọc với con người
`agentMdPath`	`String`	Có	Đường dẫn tuyệt đối tới tệp định nghĩa `.md` của agent
`workspaceId`	`String`	Có	Không gian làm việc sở hữu (non-null)
`reportsTo`	`String?`	Không	Id agent cha
`skills`	`AgentSkills`	Có	Tập hợp các mã định danh kỹ năng
`persona`	`String?`	Không	Chỉ dẫn hành vi dạng văn bản tự do
`systemPrompt`	`String?`	Không	Ghi đè prompt hệ thống mặc định
`adapterId`	`String?`	Không	Id adapter suy luận
`modelId`	`String?`	Không	Id mô hình trong adapter đó
`strictMode`	`bool`	Không	Mặc định `false`. Được ghi vào hàng và vào `AGENTS.md` của agent
`effort`	`String?`	Không	Id mức suy luận (ví dụ `'low'`, `'xhigh'`), lấy từ `thinkingLevels` của mô hình được chọn
`contextSize`	`int?`	Không	Kích thước tối đa của cửa sổ ngữ cảnh
`role`	`AgentRole?`	Không	Vai trò agent
`monthlyBudgetCents`	`int`	Không	Mức trần chi tiêu hàng tháng tính bằng cent (mặc định `0`, không giới hạn)
`silenceTimeoutMinutes`	`int?`	Không	Ghi đè thời gian hết hạn im lặng tính bằng phút; phải là null hoặc trong khoảng 1–240 (được assert trong hàm khởi tạo)
`maxConcurrentTasks`	`int`	Không	Mặc định `1`. Con số năng lực mà mô hình hiện diện báo cáo (số lượt chạy đang chạy và đang xếp hàng được đối chiếu với nó)
`visibility`	`AgentVisibility`	Không	Mặc định `workspace`
`lifecycleStatus`	`AgentLifecycleStatus`	Không	Trạng thái quản trị (mặc định `active`). Được ghi bởi cơ chế dừng cứng ngân sách và hiển thị trên sơ đồ tổ chức cùng danh sách hiện diện. Việc điều phối vẫn nhận công việc từ một agent `paused`
`budgetPolicyId`	`String?`	Không	Id chính sách ngân sách dùng chung; khi null thì `monthlyBudgetCents` được áp dụng trực tiếp
`runtimeProfileId`	`String?`	Không	Id hồ sơ runtime tùy chỉnh
`createdAt`	`DateTime`	Có	Dấu thời gian tạo

name và title đều phải khác rỗng (được assert trong hàm khởi tạo). Giá trị mặc định 0 của monthlyBudgetCents nghĩa là không giới hạn. Hãy ghi một mức trần bằng agents.upsert.

Enum AgentRole

Vai trò	Nhãn	Mô tả
`ceo`	CEO	Điều phối và ủy thác
`coder`	Coder	Triển khai mã
`reviewer`	Reviewer	Xem xét và phân tích PR
`qa`	QA	Kiểm thử và bảo đảm chất lượng
`designer`	Designer	Triển khai UI/UX
`security`	Security	Xem xét và kiểm toán bảo mật
`devops`	DevOps	Hạ tầng và triển khai
`pm`	PM	Quản lý sản phẩm
`general`	General	Linh hoạt, đa mục đích

Enum AgentVisibility

Giá trị	Mô tả
`workspace`	Giá trị mặc định; các giá trị đã lưu không xác định và null đều phân giải về nó
`private`	Riêng tư với người dùng đã tạo

Enum AgentLifecycleStatus

Giá trị	Mô tả
`active`	Giá trị mặc định. `isDispatchable` chỉ đúng với giá trị này
`paused`	Được đặt bởi cơ chế dừng cứng ngân sách. Hiển thị trên danh sách hiện diện; việc điều phối vẫn nhận công việc
`archived`	Đã nghỉ và bị ẩn khỏi các danh sách hiện diện đang hoạt động

Quyền hạn

Agent không mang cờ quyền hạn nào. Push, mở và xuất bản pull request, ghi vào tracker và egress mạng là các lớp hành động (gitPush, prCreate, prPublish, vendorSyncWrite, networkEgress) mà rào chắn phân giải ở phạm vi không gian làm việc, agent hoặc space. Token GitHub của một lượt chạy luôn chỉ có phạm vi đọc; các lần push đi qua cổng lượt chạy agent, nơi hỏi quy tắc gitPush trước khi chuyển tiếp.

AgentSkills

Một tập hợp bất biến, không phân biệt chữ hoa chữ thường, gồm các mã định danh kỹ năng. Khi điều phối, những slug đó được đồng bộ thành các liên kết kỹ năng trong overlay của agent; sau đó harness tự động nạp frontmatter của các kỹ năng được liên kết vào prompt.

{'flutter', 'dart', 'rest-api'}

AgentLiveState (giá trị dẫn xuất)

Không được lưu. Bảy giá trị. Thứ tự khai báo chính là thứ tự ưu tiên (sortPriority, được ghim bằng một bài kiểm thử), cũng là thứ tự mà danh sách hiện diện sắp xếp theo:

Trạng thái	`sortPriority`	Điều kiện
`running`	0	Bất kỳ log lượt chạy nào có trạng thái `running`
`blocked`	1	Độ sống của lượt chạy mới nhất là `blocked`, `stalled` hoặc `looping`
`failed`	2	Trạng thái của lượt chạy mới nhất là `error`, hoặc độ sống của nó là `failed` hoặc `dead`
`queued`	3	Một lượt chạy đã được điều phối nhưng chưa thực thi — bị xếp sau một lượt chạy khác của cùng agent, hoặc đã được ghi nhưng chưa bắt đầu
`succeeded`	4	Lượt chạy đã kết thúc thành công
`idle`	5	Agent đã từng chạy và hiện không có gì đang thực thi
`neverRun`	6	Không tồn tại log lượt chạy nào

queued và succeeded chỉ dành cho từng lượt chạy. deriveAgentLiveState, hàm tính trạng thái danh sách hiện diện cho một agent, không bao giờ tạo ra hai giá trị đó — nó trả về neverRun, running, failed, blocked hoặc idle.