에이전트 구성

이 레퍼런스는 에이전트 엔터티의 모든 필드와, 에이전트가 사용하는 열거형 및 플래그를 나열합니다. 앱에서 에이전트를 만들거나 편집하는 단계별 안내는 에이전트 생성 및 구성을 참고하세요.

에이전트 엔터티 필드

필드	타입	필수	설명
id	String	예	고유한 에이전트 식별자
name	String	예	@멘션에 쓰이는 짧은 식별자
title	String	예	사람이 읽을 수 있는 역할 직함
agentMdPath	String	예	에이전트의 .md 정의 파일에 대한 절대 경로
workspaceId	String	예	소유 워크스페이스(널 불가)
reportsTo	String?	아니요	상위 에이전트 ID
skills	AgentSkills	예	스킬 식별자 집합
persona	String?	아니요	자유 형식의 행동 지침
systemPrompt	String?	아니요	기본 시스템 프롬프트를 재정의합니다
adapterId	String?	아니요	추론 어댑터 id
modelId	String?	아니요	어댑터 내의 모델 id
strictMode	bool	아니요	기본값 false. 행과 에이전트의 AGENTS.md에 기록됩니다
effort	String?	아니요	추론 수준 id(예: 'low', 'xhigh'), 선택한 모델의 thinkingLevels에서 가져옵니다
contextSize	int?	아니요	최대 컨텍스트 창 크기
role	AgentRole?	아니요	에이전트 역할
monthlyBudgetCents	int	아니요	월 지출 상한(센트 단위, 기본값 0은 무제한)
silenceTimeoutMinutes	int?	아니요	무응답 감시(silence timeout) 재정의(분 단위)입니다. null이거나 1–240 범위여야 합니다(생성자에서 강제)
maxConcurrentTasks	int	아니요	기본값 1. 프레즌스 모델이 보고하는 용량 수치입니다(실행 중 및 대기 중 개수를 이 값과 비교합니다)
visibility	AgentVisibility	아니요	기본값 workspace
lifecycleStatus	AgentLifecycleStatus	아니요	거버넌스 상태(기본값 active)입니다. 예산 강제 중지가 기록하며, 조직도와 프레즌스 로스터에 렌더링됩니다. paused 에이전트의 작업도 디스패치는 여전히 받습니다
budgetPolicyId	String?	아니요	공유 예산 정책 id입니다. null이면 monthlyBudgetCents가 직접 적용됩니다
runtimeProfileId	String?	아니요	사용자 지정 런타임 프로필 id
createdAt	DateTime	예	생성 타임스탬프

name과 title은 모두 비어 있으면 안 됩니다(생성자에서 강제). monthlyBudgetCents의 기본값 0은 무제한을 뜻합니다. 상한은 agents.upsert로 기록합니다.

AgentRole 열거형

역할	레이블	설명
ceo	CEO	조정과 위임
coder	Coder	코드 구현
reviewer	Reviewer	PR 리뷰와 분석
qa	QA	테스트와 품질 보증
designer	Designer	UI/UX 구현
security	Security	보안 리뷰와 감사
devops	DevOps	인프라와 배포
pm	PM	제품 관리
general	General	유연한 다목적

AgentVisibility 열거형

값	설명
workspace	기본값입니다. 알 수 없거나 null인 저장 값은 이 값으로 파싱됩니다
private	만든 사용자에게만 비공개

AgentLifecycleStatus 열거형

값	설명
active	기본값입니다. isDispatchable은 이 값에서만 true입니다
paused	예산 강제 중지가 설정합니다. 프레즌스 로스터에 표시되며, 디스패치는 여전히 작업을 받습니다
archived	은퇴 처리되어 활성 로스터에서 숨겨집니다

권한

에이전트는 권한 플래그를 갖지 않습니다. 푸시, 풀 리퀘스트 열기와 게시, 트래커에 쓰기, 네트워크 이그레스는 작업 클래스(gitPush, prCreate, prPublish, vendorSyncWrite, networkEgress)이며, 가드레일이 워크스페이스, 에이전트, 스페이스 범위에서 해석합니다. 실행의 GitHub 토큰은 항상 읽기 범위이며, 푸시는 에이전트 실행 게이트웨이를 거치고 게이트웨이는 전달하기 전에 gitPush 규칙에 묻습니다.

AgentSkills

스킬 식별자의 불변이며 대소문자를 구분하지 않는 집합입니다. 디스패치 시점에 이 슬러그들이 에이전트 오버레이의 스킬 링크로 동기화되며, 그러면 하네스가 링크된 스킬의 프런트매터를 프롬프트에 자동 로드합니다.

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

AgentLiveState(파생)

저장되지 않습니다. 값은 일곱 개입니다. 선언 순서가 우선순위 순서이며(sortPriority, 테스트로 고정됨), 로스터가 정렬하는 순서이기도 합니다:

상태	sortPriority	조건
running	0	실행 로그 중 상태가 running인 것이 있습니다
blocked	1	최신 실행의 활성 상태가 blocked, stalled, looping 중 하나입니다
failed	2	최신 실행의 상태가 error이거나, 활성 상태가 failed 또는 dead입니다
queued	3	실행이 디스패치되었지만 실행 중이 아닙니다. 같은 에이전트의 다른 실행 뒤에 대기 중이거나, 기록되었지만 아직 시작되지 않았습니다
succeeded	4	실행이 성공적으로 끝났습니다
idle	5	에이전트가 이전에 실행된 적이 있고 진행 중인 작업이 없습니다
neverRun	6	실행 로그가 없습니다

queued와 succeeded는 실행 단위 전용입니다. 에이전트의 로스터 상태를 계산하는 deriveAgentLiveState는 이 둘을 결코 만들어 내지 않습니다. 이 함수는 neverRun, running, failed, blocked, idle 중 하나를 반환합니다.

함께 보기

• 에이전트 생성 및 구성
• 에이전트 모델
• 에이전트 디스패치 수명주기