Ügynökkonfiguráció

Ez a referencia felsorolja az ügynökentitás összes mezőjét, valamint a használt enumokat és jelzőket. Az ügynök alkalmazásbeli létrehozásának vagy szerkesztésének lépésről lépésre haladó bemutatását lásd: Ügynök létrehozása és konfigurálása.

Az ügynökentitás mezői

Mező	Típus	Kötelező	Leírás
`id`	`String`	Igen	Egyedi ügynökazonosító
`name`	`String`	Igen	Rövid azonosító az @-említésekhez
`title`	`String`	Igen	Ember által olvasható szerepkör-megnevezés
`agentMdPath`	`String`	Igen	Az ügynök `.md` definíciós fájljának abszolút útvonala
`workspaceId`	`String`	Igen	A tulajdonos munkaterület (nem null)
`reportsTo`	`String?`	Nem	A szülő ügynök azonosítója
`skills`	`AgentSkills`	Igen	Készségazonosítók halmaza
`persona`	`String?`	Nem	Szabad szöveges viselkedési utasítások
`systemPrompt`	`String?`	Nem	Felülírja az alapértelmezett rendszerpromptot
`adapterId`	`String?`	Nem	A következtetési adapter azonosítója
`modelId`	`String?`	Nem	Modellazonosító az adott adapteren belül
`strictMode`	`bool`	Nem	Alapértelmezés: `false`. A sorba és az ügynök `AGENTS.md` fájljába íródik
`effort`	`String?`	Nem	Gondolkodási szint azonosítója (pl. `'low'`, `'xhigh'`), a kiválasztott modell `thinkingLevels` értékéből véve
`contextSize`	`int?`	Nem	A kontextusablak maximális mérete
`role`	`AgentRole?`	Nem	Az ügynök szerepköre
`monthlyBudgetCents`	`int`	Nem	Havi költési plafon centben (alapértelmezés `0`, korlátlan)
`silenceTimeoutMinutes`	`int?`	Nem	A csend-időtúllépés felülírása percben; nullnak kell lennie, vagy 1–240 közé kell esnie (konstruktorban érvényesítve)
`maxConcurrentTasks`	`int`	Nem	Alapértelmezés: `1`. A jelenléti modell által jelentett kapacitásérték (a futó és a várakozó futtatások számát ehhez hasonlítja)
`visibility`	`AgentVisibility`	Nem	Alapértelmezés: `workspace`
`lifecycleStatus`	`AgentLifecycleStatus`	Nem	Irányítási állapot (alapértelmezés: `active`). A költségkeret kemény leállása írja, és a szervezeti ábrán meg a jelenléti névsoron jelenik meg. Az indítás továbbra is elfogad munkát egy `paused` ügynöktől
`budgetPolicyId`	`String?`	Nem	Megosztott költségkeret-szabályzat azonosítója; ha null, közvetlenül a `monthlyBudgetCents` érvényes
`runtimeProfileId`	`String?`	Nem	Egyéni futásidejű profil azonosítója
`createdAt`	`DateTime`	Igen	Létrehozási időbélyeg

A name és a title egyaránt nem lehet üres (konstruktorban érvényesítve). A monthlyBudgetCents 0 alapértelmezése a korlátlant jelenti. Felső korlátot az agents.upsert hívással írhat.

Az AgentRole enum

Szerepkör	Címke	Leírás
`ceo`	CEO	Koordináció és delegálás
`coder`	Coder	Kódmegvalósítás
`reviewer`	Reviewer	PR-átnézés és -elemzés
`qa`	QA	Tesztelés és minőségbiztosítás
`designer`	Designer	UI/UX-megvalósítás
`security`	Security	Biztonsági átnézés és auditálás
`devops`	DevOps	Infrastruktúra és telepítés
`pm`	PM	Termékmenedzsment
`general`	General	Rugalmas, többcélú

Az AgentVisibility enum

Érték	Leírás
`workspace`	Az alapértelmezés; az ismeretlen és a null tárolt értékek erre oldódnak fel
`private`	Csak a létrehozó felhasználó számára látható

Az AgentLifecycleStatus enum

Érték	Leírás
`active`	Az alapértelmezés. Az `isDispatchable` csak ennél az értéknél igaz
`paused`	A költségkeret kemény leállása állítja be. A jelenléti névsoron jelenik meg; az indítás továbbra is elfogad munkát
`archived`	Visszavonva és elrejtve az aktív névsorokból

Jogosultságok

Az ügynöknek nincsenek jogosultságjelzői. A push, a pull requestek megnyitása és közzététele, a követőbe írás és a hálózati kimenő forgalom műveletosztályok (gitPush, prCreate, prPublish, vendorSyncWrite, networkEgress), amelyeket a korlátok munkaterület, ügynök vagy tér hatókörében oldanak fel. A futás GitHub-tokenje mindig csak olvasási hatókörű; a pushok az ügynökfuttatási átjárón mennek át, amely a továbbítás előtt megkérdezi a gitPush szabályt.

AgentSkills

Készségazonosítók megváltoztathatatlan, kis-nagybetűt nem megkülönböztető halmaza. Indításkor ezek a slugok készséghivatkozásokként szinkronizálódnak az ügynök overlay-ében; a harness ezután automatikusan betölti a hivatkozott készségek frontmatterjét a promptba.

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

AgentLiveState (származtatott)

Nincs tárolva. Hét érték. A deklarációs sorrend egyben a prioritási sorrend (sortPriority, amelyet egy teszt rögzít), és a névsor is e szerint rendez:

Állapot	`sortPriority`	Feltétel
`running`	0	Bármelyik futásnapló állapota `running`
`blocked`	1	A legutóbbi futtatás életjelzése `blocked`, `stalled` vagy `looping`
`failed`	2	A legutóbbi futtatás állapota `error`, vagy az életjelzése `failed` vagy `dead`
`queued`	3	Egy futtatás el van indítva, de nem fut — egy másik, ugyanahhoz az ügynökhöz tartozó futtatás mögött vár, vagy be van írva, de még nem indult el
`succeeded`	4	A futtatás sikeresen befejeződött
`idle`	5	Az ügynök már futott korábban, és nincs folyamatban lévő munkája
`neverRun`	6	Nincsenek futásnaplók

A queued és a succeeded kizárólag egy-egy futtatásra vonatkozik. A deriveAgentLiveState, amely egy ügynök névsorban megjelenő állapotát számítja ki, soha nem állítja elő egyiket sem — neverRun, running, failed, blocked vagy idle értéket ad vissza.