ایجنٹ کنفیگریشن

یہ حوالہ ایجنٹ ہستی کی ہر فیلڈ، نیز اس کے استعمال کردہ enum اور فلیگ درج کرتا ہے۔ ایپ میں ایجنٹ بنانے یا اس میں ترمیم کرنے کا مرحلہ وار طریقہ ایجنٹ بنائیں اور کنفیگر کریں میں دیکھیں۔

ایجنٹ ہستی کی فیلڈز

فیلڈ	قسم	لازمی	وضاحت
id	String	ہاں	ایجنٹ کا منفرد شناخت کنندہ
name	String	ہاں	@-ذکر کے لیے مختصر شناخت کنندہ
title	String	ہاں	انسان کے پڑھنے کے قابل عہدے کا عنوان
agentMdPath	String	ہاں	ایجنٹ کی .md تعریفی فائل کا مطلق راستہ
workspaceId	String	ہاں	مالک ورک اسپیس (غیر null)
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?	نہیں	خاموشی ٹائم آؤٹ کی اوور رائیڈ منٹوں میں؛ 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 enum

رول	لیبل	وضاحت
ceo	CEO	کوآرڈینیشن اور تفویض
coder	Coder	کوڈ کا عمل درآمد
reviewer	Reviewer	PR ریویو اور تجزیہ
qa	QA	ٹیسٹنگ اور معیار کی یقین دہانی
designer	Designer	UI/UX کا عمل درآمد
security	Security	سیکیورٹی ریویو اور آڈٹ
devops	DevOps	انفراسٹرکچر اور ڈیپلائمنٹ
pm	PM	پروڈکٹ مینجمنٹ
general	General	لچکدار، کثیر المقاصد

AgentVisibility enum

قدر	وضاحت
workspace	ڈیفالٹ؛ نامعلوم اور null محفوظ اقدار اسی میں پارس ہوتی ہیں
private	صرف بنانے والے صارف کے لیے نجی

AgentLifecycleStatus enum

قدر	وضاحت
active	ڈیفالٹ۔ isDispatchable صرف اسی قدر کے لیے true ہے
paused	بجٹ ہارڈ اسٹاپ اسے سیٹ کرتا ہے۔ موجودگی کے روسٹر پر دکھایا جاتا ہے؛ ڈسپیچ پھر بھی کام وصول کرتا ہے
archived	ریٹائر شدہ اور فعال روسٹروں سے پوشیدہ

اجازتیں

ایجنٹ کوئی اجازتی فلیگ نہیں رکھتے۔ پش، pull requests کھولنا اور شائع کرنا، ٹریکر پر لکھنا اور نیٹ ورک ایگریس ایکشن کلاسز ہیں (gitPush، prCreate، prPublish، vendorSyncWrite، networkEgress) جنہیں گارڈریلز ورک اسپیس، ایجنٹ یا اسپیس کے دائرے میں حل کرتے ہیں۔ رن کا GitHub ٹوکن ہمیشہ صرف پڑھنے کے دائرے میں ہوتا ہے؛ پش ایجنٹ رن گیٹ وے سے گزرتے ہیں، جو آگے بڑھانے سے پہلے gitPush قاعدے سے پوچھتا ہے۔

AgentSkills

مہارت شناخت کنندگان کا ایک ناقابلِ تغیر، غیر حساسِ حروف مجموعہ۔ ڈسپیچ کے وقت یہ slugs ایجنٹ کے اوورلے میں مہارت لنکوں کے طور پر سنک کیے جاتے ہیں؛ پھر ہارنس لنک شدہ مہارتوں کا frontmatter خودکار طور پر پرامپٹ میں لوڈ کر دیتا ہے۔

{'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 واپس کرتا ہے۔

مزید دیکھیں

• ایجنٹ بنائیں اور کنفیگر کریں
• ایجنٹ ماڈل
• ایجنٹ ڈسپیچ لائف سائیکل