ایجنٹس کا @-ذکر کریں

یہ گائیڈ دکھاتی ہے کہ کسی اسپیس میں ایجنٹس اور ساتھیوں کا @-ذکر کیسے کریں۔

ایجنٹ کا ذکر کریں

کمپوزر میں @ ٹائپ کریں اور آٹو کمپلیٹ سے کوئی ایجنٹ چنیں، یا نام خود ٹائپ کریں:

@alice fix the login bug

ذکر کردہ ایجنٹ، اگر پہلے سے اسپیس کا شریک نہ ہو تو اُسے اسپیس میں بطور شریک شامل کر دیا جاتا ہے اور اُس اسپیس کے کانٹیکسٹ اور موڈ کے ساتھ ڈسپیچ ہوتا ہے۔ جن شرکا کا ذکر نہیں ہوا وہ پیغام دیکھتے ہیں مگر ڈسپیچ نہیں ہوتے۔

اگر آپ بغیر کسی ایجنٹ کے ذکر کے پیغام بھیجیں تو Control Center خود جواب دینے والا چن لیتا ہے: وہ ایجنٹ جس نے گفتگو میں سب سے آخر میں بات کی ہو؛ ورنہ گفتگو کا مالک، اگر کوئی ہو؛ ورنہ اسپیس کے شرکا میں سے پہلا ٹاپ لیول ایجنٹ۔ ایک ایجنٹ والی اسپیس میں یہ ہمیشہ وہی واحد ایجنٹ ہوتا ہے۔

جانیں کہ نام کیسے میچ ہوتا ہے

ذکر کا ٹوکن حروف کے بڑے یا چھوٹے ہونے سے قطع نظر، بالکل پورے نام یا پریفکس سے میچ ہوتا ہے۔ چنانچہ @arch نام کے ایجنٹ architect تک پہنچتا ہے اور @Alice ایجنٹ alice تک۔

دو نتائج جن کا منصوبہ بناتے وقت خیال رکھنا چاہیے:

مختصر ٹوکن کوئی خرابی نہیں۔ اگر دو ایجنٹس ایک ہی پریفکس رکھتے ہوں تو جو پہلے مل جائے وہی جیتتا ہے، اور یہ کون ہوگا یہ ترتیب پر منحصر ہے — کسی ٹائی بریک قاعدے پر نہیں۔ جب بھی نام ایک جیسے ہوں، پورا نام استعمال کریں۔
ٹوکن کا حصہ صرف حروف، ہندسے اور انڈر اسکور ہوتے ہیں۔ پارسر @(\w+) سے میچ کرتا ہے، چنانچہ @code-reviewer کو ٹوکن code پڑھا جاتا ہے اور @my agent کو my۔ جس ایجنٹ کے نام میں ہائفن، ڈاٹ یا خلا ہو، اُس کا قابلِ اعتماد ذکر ممکن نہیں — بشمول آٹو کمپلیٹ کے، جو نام کو سادہ متن کے طور پر داخل کرتا ہے۔ ایجنٹس کے نام ایک ہی لفظ میں رکھیں، یا انڈر اسکور کے ساتھ۔

ٹیکسٹ کے ایجنٹ تک پہنچنے سے پہلے ذکر اُس سے ہٹا دیے جاتے ہیں۔ چنانچہ جو پیغام صرف ذکر ہو (@alice) وہ کچھ بھی ڈسپیچ نہیں کرتا — اُسے کوئی کام دیں۔

ایک ساتھ کئی ایجنٹس کا ذکر کریں

@alice refactor the auth module. @bob write tests for it.

دونوں ایجنٹس متوازی طور پر اسی گفتگو میں ڈسپیچ ہوتے ہیں اور دونوں کو پورا پیغام ملتا ہے۔

وہ اُس اسپیس کے ورک ٹریز بھی شیئر کرتے ہیں۔ ریپو ورک ٹریز فی اسپیس تیار ہوتے ہیں، فی ایجنٹ نہیں؛ ہر ایجنٹ کو اپنے AGENTS.md، مہارتوں اور کنفیگ کے لیے اپنی الگ اوورلے ورکنگ ڈائریکٹری ملتی ہے، جبکہ مشترکہ ریپوز ریڈ-رائٹ لنک ہوتے ہیں۔ چنانچہ ایک ساتھ ذکر کیے گئے دو ایجنٹس ایک دوسرے کی ترمیمات دیکھ سکتے ہیں — اور اُن سے ٹکرا بھی سکتے ہیں۔

ساتھی کا ذکر کریں

جو بھی @token کسی ایجنٹ سے میچ نہ ہو، اُسے ورک اسپیس کے انسانی اراکین کے خلاف اُن کے ہینڈل سے آزمایا جاتا ہے — وہی حروف کے بڑے یا چھوٹے ہونے سے قطع نظر پورے نام یا پریفکس کا قاعدہ۔

حل ہو جانے والا انسانی ذکر کچھ بھی ڈسپیچ نہیں کرتا۔ یہ خالصتاً پیغام کے میٹا ڈیٹا پر سفر کرتا ہے تاکہ اطلاعات کا روٹر اُس شخص کو پنگ کر سکے۔

ایجنٹس کے نام ہمیشہ پہلے آزمائے جاتے ہیں اور جو ٹوکن کسی ایجنٹ نے لے لیا ہو وہ کبھی اراکین کی فہرست کو نہیں دیا جاتا — ایک @word صرف ایک ہی پرنسپل تک حل ہو سکتا ہے۔

ایجنٹ کو کیا ملتا ہے

ڈسپیچ کیا گیا ایجنٹ اپنے پرامپٹ میں ایک “Summons” بلاک پاتا ہے، جس میں لکھا ہوتا ہے کہ اُسے کس نے بلایا اور اسپیس کا روسٹر درج ہوتا ہے — باقی ایجنٹس (ٹاپ لیول یا ذیلی کے طور پر نشان زد) اور انسانی اراکین — تاکہ اُسے معلوم ہو کہ وہ کس کو کام حوالے کر سکتا ہے۔ یہ بلاک اُسے یہ بھی بتاتا ہے کہ اپنے جواب میں کسی دوسرے ایجنٹ کا ذکر اُس ایجنٹ کو جگا دیتا ہے، اور خود اپنا ذکر نظر انداز کر دیا جاتا ہے۔

جب کوئی ایجنٹ کسی ایجنٹ کا ذکر کرے

ایجنٹ اپنے ہی جواب میں کام حوالے کر سکتا ہے۔ جب کوئی ٹرن بغیر کسی خرابی کے مکمل ہوتا ہے تو اُس کے متن میں موجود ذکر حل کیے جاتے ہیں اور وہ ایجنٹس اسپیس میں شامل کر کے اسی گفتگو میں ڈسپیچ کر دیے جاتے ہیں، اور ذکر کرنے والا ٹرن اُن کا پرامپٹ بنتا ہے۔ جو ٹرن ناکام ہوا یا درمیان میں رک گیا، وہ کسی کو نہیں جگاتا — وہ سوچ کے بیچ میں رک گیا تھا۔

قواعد جان بوجھ کر کمپوزر کے قواعد سے زیادہ سخت ہیں، کیونکہ غلط اندازے کو درست کرنے کے لیے کوئی دیکھ ہی نہیں رہا:

صرف پورے نام۔ کوئی پریفکس میچ نہیں۔ جب کوئی انسان @arch ٹائپ کرے تو یہ architect تک پہنچتا ہے؛ کسی ایجنٹ کی طرف سے یہ کسی تک نہیں پہنچتا۔ جو نام دو ایجنٹس سے میچ ہو وہ بھی کسی تک نہیں پہنچتا۔
کوڈ نثر نہیں ہے۔ فینسڈ بلاکس یا `backticks` کے اندر موجود ذکر نظر انداز کر دیے جاتے ہیں، چنانچہ @Override اینوٹیشن یا pip install foo@1.2 نقل کرنا محفوظ ہے۔ جو فینس بند ہی نہ ہو، وہ اپنے بعد کا سارا کچھ خالی کر دیتا ہے۔
پچھلے ٹوکن سے چپکا ہوا @ ذکر نہیں ہوتا — sam@host.com، pkg/@scope اور node@20 کسی تک حل نہیں ہوتے۔
ہائفن برقرار رہتے ہیں، چنانچہ @code-reviewer ٹوکن code کے بجائے خود اپنے طور پر حل ہوتا ہے۔
فی ٹرن زیادہ سے زیادہ تین ایجنٹس۔ کوئی ایجنٹ خلاصے میں چھ ساتھیوں کی فہرست بنا رہا ہو تو وہ اُنہیں گنوا رہا ہے، بلا رہا نہیں۔

ویک چین اُسی طرح محدود ہوتی ہے جیسے تفویض محدود ہوتی ہے: گہرائی 3، اور جو ایجنٹ پہلے سے چین میں ہو اُسے یہ دوبارہ نہیں جگا سکتی (کوئی A → B → A نہیں)۔ ترتیب والا جوڑا بھی چینز کے پار ریٹ لمٹ ہوتا ہے۔ مسترد شدہ ویک گفتگو میں ایک سسٹم پیغام چھوڑتی ہے جس میں لکھا ہوتا ہے کہ کون سا ذکر نہیں پہنچایا گیا اور کیوں — غیر حل شدہ نام ایسا نہیں کرتا، ورنہ جملے میں موجود کوئی بھی @ اپنی ہی کہانی سنانے لگے۔

جس حوالگی کو نثر پر انحصار نہ کرنا ہو — کوئی درخواست/جواب، یا اسپیس سے باہر کسی ایجنٹ تک پہنچنا — اُس کے لیے بجائے اس کے send_to_agent، ask_agent اور delegate_task ٹولز استعمال کریں۔