Ajan yapılandırması

Bu referans, ajan varlığındaki her alanı ve ajanın kullandığı enum’ları ve bayrakları listeler. Uygulamada bir ajan oluşturma ya da düzenlemenin adım adım anlatımı için Ajan oluşturma ve yapılandırma sayfasına bakın.

Ajan varlığı alanları

Alan	Tür	Zorunlu	Açıklama
`id`	`String`	Evet	Benzersiz ajan tanımlayıcısı
`name`	`String`	Evet	@ ile anmalar için kısa tanımlayıcı
`title`	`String`	Evet	İnsan tarafından okunabilir görev unvanı
`agentMdPath`	`String`	Evet	Ajanın `.md` tanım dosyasının mutlak yolu
`workspaceId`	`String`	Evet	Sahip çalışma alanı (boş olamaz)
`reportsTo`	`String?`	Hayır	Üst ajan kimliği
`skills`	`AgentSkills`	Evet	Beceri tanımlayıcıları kümesi
`persona`	`String?`	Hayır	Serbest metin davranış talimatları
`systemPrompt`	`String?`	Hayır	Varsayılan sistem istemini geçersiz kılar
`adapterId`	`String?`	Hayır	Çıkarım adaptörü kimliği
`modelId`	`String?`	Hayır	Adaptör içindeki model kimliği
`strictMode`	`bool`	Hayır	Varsayılan `false`. Satıra ve ajanın `AGENTS.md` dosyasına yazılır
`effort`	`String?`	Hayır	Akıl yürütme düzeyi kimliği (örn. `'low'`, `'xhigh'`), seçilen modelin `thinkingLevels` değerinden alınır
`contextSize`	`int?`	Hayır	En büyük bağlam penceresi boyutu
`role`	`AgentRole?`	Hayır	Ajan rolü
`monthlyBudgetCents`	`int`	Hayır	Sent cinsinden aylık harcama üst sınırı (varsayılan `0`, sınırsız)
`silenceTimeoutMinutes`	`int?`	Hayır	Dakika cinsinden sessizlik zaman aşımı geçersiz kılması; null olmalı ya da 1–240 arasında bulunmalıdır (kurucu tarafından doğrulanır)
`maxConcurrentTasks`	`int`	Hayır	Varsayılan `1`. Varlık modelinin bildirdiği kapasite rakamı (çalışan ve kuyruktaki sayımlar bununla karşılaştırılır)
`visibility`	`AgentVisibility`	Hayır	Varsayılan `workspace`
`lifecycleStatus`	`AgentLifecycleStatus`	Hayır	Yönetişim durumu (varsayılan `active`). Bütçe katı durdurması tarafından yazılır ve organizasyon şemasında ve varlık listesinde gösterilir. Gönderim, `paused` bir ajandan hâlâ iş kabul eder
`budgetPolicyId`	`String?`	Hayır	Paylaşılan bütçe politikası kimliği; null olduğunda doğrudan `monthlyBudgetCents` uygulanır
`runtimeProfileId`	`String?`	Hayır	Özel çalışma zamanı profili kimliği
`createdAt`	`DateTime`	Evet	Oluşturma zaman damgası

name ve title ikisi de boş olmamalıdır (kurucu tarafından doğrulanır). Varsayılan monthlyBudgetCents değeri 0 sınırsız anlamına gelir. agents.upsert ile bir üst sınır yazın.

AgentRole enum

Rol	Etiket	Açıklama
`ceo`	CEO	Koordinasyon ve devretme
`coder`	Coder	Kod uygulaması
`reviewer`	Reviewer	PR incelemesi ve analiz
`qa`	QA	Test ve kalite güvencesi
`designer`	Designer	UI/UX uygulaması
`security`	Security	Güvenlik incelemesi ve denetimi
`devops`	DevOps	Altyapı ve dağıtım
`pm`	PM	Ürün yönetimi
`general`	General	Esnek, çok amaçlı

AgentVisibility enum

Değer	Açıklama
`workspace`	Varsayılan; bilinmeyen ve null saklanan değerler buna çözümlenir
`private`	Oluşturan kullanıcıya özel

AgentLifecycleStatus enum

Değer	Açıklama
`active`	Varsayılan. `isDispatchable` yalnızca bu değer için true’dur
`paused`	Bütçe katı durdurması tarafından ayarlanır. Varlık listesinde gösterilir; gönderim hâlâ iş kabul eder
`archived`	Kullanımdan kaldırıldı ve etkin varlık listelerinden gizlendi

İzinler

Bir ajanın izin bayrakları yoktur. Push, pull request açma ve yayınlama, bir takip sistemine yazma ve ağ çıkışı; korumaların çalışma alanı, ajan veya alan kapsamında çözümlediği eylem sınıflarıdır (gitPush, prCreate, prPublish, vendorSyncWrite, networkEgress). Bir çalıştırmanın GitHub belirteci her zaman okuma kapsamlıdır; push’lar, iletmeden önce gitPush kuralına soran ajan çalıştırma ağ geçidinden geçer.

AgentSkills

Değişmez, büyük/küçük harf duyarsız bir beceri tanımlayıcıları kümesi. Gönderimde bu slug’lar ajanın overlay’inde beceri bağlantıları olarak senkronize edilir; ardından harness, bağlı becerilerin frontmatter’ını isteme otomatik yükler.

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

AgentLiveState (türetilmiş)

Saklanmaz. Yedi değer. Bildirim sırası öncelik sırasıdır (sortPriority, bir testle sabitlenmiştir) ve kadronun sıraladığı sıra da budur:

Durum	`sortPriority`	Koşul
`running`	0	Herhangi bir çalıştırma günlüğünün durumu `running`
`blocked`	1	En son çalıştırmanın canlılığı `blocked`, `stalled` veya `looping`
`failed`	2	En son çalıştırmanın durumu `error` ya da canlılığı `failed` veya `dead`
`queued`	3	Bir çalıştırma gönderilmiş ama yürütülmüyor — aynı ajanın başka bir çalıştırmasının arkasında bekletiliyor ya da yazılmış ama henüz başlatılmamış
`succeeded`	4	Çalıştırma başarıyla tamamlandı
`idle`	5	Ajan daha önce çalıştı ve uçuşta hiçbir şeyi yok
`neverRun`	6	Hiç çalıştırma günlüğü yok

queued ve succeeded yalnızca çalıştırma başınadır. Bir ajan için kadro durumunu hesaplayan deriveAgentLiveState ikisini de asla üretmez — neverRun, running, failed, blocked veya idle döndürür.