skill پر مبنی بار بار چلنے والا Hermes کام بنائیں اور پہلی اجرا کی جانچ کریں

Hermes چلانے والے افراد کسی بار بار چلنے والے کام کے ساتھ جانچی ہوئی skill منسلک کر سکتے ہیں تاکہ ہر اجرا ایک ہی طریقۂ کار سے شروع ہو۔ مفید جانچ یہ ہے کہ ایک مقررہ اجرا مجاز ان پٹ پڑھے، قابل قبول مقامی رپورٹ بنائے، اور درج کرے کہ درحقیقت کس ماڈل اور میزبان نے اسے سنبھالا۔ یہ رہنما ایسے منتظم کے لیے ہے جو Hermes پروفائل، فراہم کنندہ کے اکاؤنٹ اور gateway میزبان کو کنٹرول کرتا ہو۔ BIG CHANGE نے سرکاری cron ہدایت نامے اور متعلقہ دستاویزات کا 19 اکتوبر 2026 کو جائزہ لیا؛ ہم نے Hermes نصب نہیں کیا اور کوئی کام نہیں چلایا۔

بنیادی تبدیلی

• کیا بدلا: Hermes مقررہ پرامپٹ سے پہلے جانچی ہوئی skill لوڈ کر سکتا ہے، اسے منتخب کام کی جگہ میں چلا سکتا ہے اور نتیجہ مقامی طور پر محفوظ کر سکتا ہے۔ منتظم کام کو موقوف حالت میں بنا کر جانچ سکتا ہے اور اسی کام کی ID دوبارہ جاری کر سکتا ہے۔
• یہ کیوں اہم ہے: دہرائے جانے والے معلوماتی کام میں ایک جانچا ہوا طریقہ استعمال ہو سکتا ہے۔ منتظم کو پھر بھی وقت آنے پر چلنے والی اجرا کو مجاز ان پٹ سے ملانا ہوگا؛ محفوظ شیڈول یہ ثابت نہیں کرتا کہ skill کی کون سی ترمیم یا ماڈل استعمال ہوا، یا رپورٹ درست ہے۔
• کن باتوں پر نظر رکھیں: مسلسل استعمال gateway میزبان کی دستیابی اور پہلی اجرا کے رپورٹ کے معیار پر پورا اترنے پر منحصر ہے۔ کام فعال چھوڑنے سے پہلے کوشش، پیداوار اور دستیاب فراہم کنندہ/ماڈل کے شواہد دیکھیں؛ ہر تعطل کے بعد اس کی درست حالت دوبارہ جانچیں۔

کچھ بھی مقرر کرنے سے پہلے

ایک چھوٹی، مجاز ان پٹ فائل اور پہلے سے موجود الگ کام کی جگہ چنیں۔ طے کریں کہ درست مختصر رپورٹ میں کیا ضروری ہے، وہ کہاں ان پٹ کا حوالہ دے، اور کون سا ڈیٹا نہ ملنے پر اسے رکنا چاہیے۔ پہلا کام صرف معلوماتی رکھیں: بیرونی اشاعت، ریکارڈ میں تبدیلی یا پیداوار میں راز نہ ہوں۔ اسے بار بار چلانے کی الگ اجازت لیں۔ ترتیب دیا ہوا Hermes، قابل استعمال ماڈل/فراہم کنندہ راستہ اور اسناد، اور مقررہ اجرا کے لیے دستیاب رہ سکنے والا gateway میزبان بھی درکار ہیں۔ نصب نسخہ اور hermes cron create --help جانچیں، کیونکہ عوامی ہدایت نامہ ہر اختیار کے لیے نسخہ نہیں بتاتا۔ فوری آغاز کا رہنما تنصیب و ترتیب بتاتا ہے؛ فراہم کنندگان کا رہنما ماڈل کی پراسیسنگ کا راستہ بتاتا ہے۔ تکرار شروع کرنے سے پہلے ایک بے ضرر، ایک بار کی گفتگو یہ راستہ جانچ سکتی ہے، لیکن یہ مقررہ اجرا کی کامیابی کا ثبوت نہیں۔

یہاں skill ایک جانچا ہوا SKILL.md طریقہ ہے، اجازت کی حد نہیں۔ skills/local-input-report/SKILL.md کو اصل مالک پروفائل کے HERMES_HOME کے تحت رکھیں؛ ~/.hermes/skills/local-input-report/SKILL.md پہلے سے طے شدہ پروفائل کی مثال ہے۔ استعمال سے پہلے اس کم سے کم طریقے کو منظور شدہ ان پٹ اور رپورٹ کے معیار کے مطابق ڈھالیں:

---
name: local-input-report
description: Report checked facts from one approved local input.
---

Read only <absolute-permitted-input-path> in the job workspace. In a short report, name that file, state only facts supported by it, and cite the relevant part. Flag missing data and stop. Do not send messages or change files or external records.

اصل فائل دیکھیں اور اسی پروفائل میں hermes skills list سے تصدیق کریں کہ Hermes اسے ڈھونڈ لیتا ہے۔ اس کے بجائے منصوبے کی مقامی skill استعمال کرنے پر skills کا ہدایت نامہ کہتا ہے کہ غیر تعاملی cron اجرا سے پہلے تعاملی اعتماد اور اسکین کا فیصلہ ضروری ہے؛ cron خود اعتماد نہیں دیتا۔ فعال ٹولز اور حقیقی فائل رسائی کو الگ جانچیں۔ skill کا مواد یا ترمیم درج کریں تاکہ اس کا نام جائزے کا بدل نہ بنے۔

ایک کام بنائیں، پھر جانچیں

1. ہر کمانڈ اسی مالک پروفائل پر چلائیں: نیچے کی مثالیں پہلے سے طے شدہ پروفائل استعمال کرتی ہیں، جبکہ نام والے پروفائل کو hermes -p NAME جیسے اپنے انتخاب کنندہ کی ہر کمانڈ میں ضرورت ہوتی ہے۔ اس پروفائل کا موجودہ ماڈل hermes model سے اور gateway و وقفے وقفے کی جانچ کے عمل کی حالت hermes cron status سے دیکھیں۔ طے کریں کہ فراہم کنندہ اور ماڈل صراحت سے مقرر کریں گے یا موجودہ مرکزی ماڈل کو باندھیں گے۔ فی کام مقرر کردہ انتخاب کو cron.model اور cron.model_provider پر فوقیت حاصل ہے؛ ان مشترک ترتیبات کو موجودہ مرکزی ماڈل پر فوقیت ہے۔ لہٰذا غیر مقرر ماڈل والا کام متعلقہ طے شدہ قدر بدلنے پر ماڈل بدل سکتا ہے۔ محفوظ ترتیب پھر بھی حقیقی اجرا میں استعمال شدہ ماڈل ثابت نہیں کرتی۔
2. تکرار کی اجازت کے بعد POSIX shell کی اس CLI مثال کو جانچی ہوئی skill اور پہلے سے موجود کام کی جگہ کے مکمل راستے کے مطابق ڈھالیں۔ پہلے نصب مدد میں ہر اختیار کی تصدیق کریں۔ بیک سلیش سے سطر جاری رکھنا POSIX shell کی ساخت ہے؛ دوسرے پلیٹ فارم پر اپنے shell کی ساخت استعمال کریں۔ پرامپٹ جان بوجھ کر محدود ہے اور مقامی ترسیل پہلی پیداوار مالک پروفائل میں رکھتی ہے:

   hermes cron create "every 1h" \
     "Use the attached reviewed skill to read only the permitted input. Return a short local report with its source and missing-data note. Do not send or change external records." \
     --skill local-input-report \
     --name "Local input report" \
     --workdir "/absolute/existing/workspace" \
     --pin \
     --paused --paused-reason "Awaiting owner review"

کمانڈ چلانے سے پہلے کام کی جگہ کا راستہ بدلیں، کام کا منفرد نام چنیں اور skill فائل میں ان پٹ کی عارضی نشاندہی بدلیں۔ CLI پہلے سے مقامی ترسیل کرتی ہے۔ cron کا ہدایت نامہ صریح انتخاب کے لیے --model اور --provider بھی بتاتا ہے۔ یہ راستہ چننے پر اپنی تنصیب کے حقیقی فراہم کنندہ/ماڈل شناخت کنندگان استعمال کریں۔ اسناد پرامپٹ یا shell کی تاریخ میں نہ ڈالیں۔ --workdir Hermes کو کام کی جگہ کی ہدایات تلاش کرنے دیتا ہے؛ اس کے بغیر cron مخزن سے الگ چلتا ہے۔ نئے موقوف کام میں جاری کیے جانے تک next_run_at نہیں ہوتا۔

مقامی ترسیل طے کرتی ہے کہ حتمی رپورٹ کہاں محفوظ ہوگی۔ پرامپٹ اور ماڈل پراسیسنگ میں استعمال ہونے والا تمام ان پٹ پھر بھی منتخب ماڈل/فراہم کنندہ کے راستے جاتا ہے؛ جاری کرنے سے پہلے اس ڈیٹا بہاؤ کی منظوری دیں۔

3. واپس آنے والی کام کی ID محفوظ رکھیں۔ hermes cron list سے اس کی skill، کام کی جگہ، ترسیل اور موقوف حالت پڑھ کر جانچیں؛ hermes cron status سے شیڈولر کی حالت دیکھیں۔ موجودہ سرکاری CLI ماخذ فہرست کی قطاروں میں محفوظ ماڈل/فراہم کنندہ خانے نہیں دکھاتا۔ مالک پروفائل کی cron/jobs.json صرف پڑھنے کے لیے کھول کر عین ID میں محفوظ مقررہ انتخاب، ماڈل/فراہم کنندہ اور ماڈل پراسیسنگ کی بدلی ہوئی ترتیبات دیکھیں، یا کام کی تفصیل کا وہ منظر استعمال کریں جسے نصب نسخہ واقعی سہارا دیتا ہو۔ اسناد پرنٹ نہ کریں۔ محفوظ ترتیبات کو منظور شدہ فائل، رپورٹ کے معیار اور دائرے سے ملائیں۔ ضرورت ہو تو اسی کام کو hermes cron edit <job_id> ... سے درست کریں؛ دوسری نقل بنانے کی کوئی وجہ نہیں۔
4. مقررہ اجرا دیکھنے کے لیے تیار ہوں تو hermes cron resume <job_id> استعمال کریں۔ اگلے حقیقی اجرا کا وقت اور gateway کی آخری کامیاب وقفہ جاتی جانچ پڑھیں۔ gateway تقریباً ہر منٹ جانچتا ہے؛ سامنے چلنے والے gateway کا میزبان چلتا رہنا چاہیے۔ hermes cron tick کسی ایجنٹ کام کے لیے gateway شروع نہیں کرتا۔ سروس یا دوبارہ آغاز برداشت کرنے والے عمل کی میزبان کے لحاظ سے مخصوص ضروریات ہیں؛ لیپ ٹاپ بند ہونے یا دوبارہ آغاز کے بعد ضمانت ماننے کے بجائے منتخب میزبان جانچیں۔
5. ایک مقررہ وقت گزرنے کے بعد hermes cron runs <job_id> --limit 20 اور مالک پروفائل کے cron/output/<job_id>/ کے تحت متعلقہ فائل دیکھیں۔ رپورٹ کو اصل ان پٹ اور قبولیت کے معیار سے ملائیں۔ کوشش کے مقررہ اور حاصل کیے جانے کے وقت، حتمی حالت، اور دستیاب گفتگو کے ریکارڈ یا اجرا کی پیمائش میں واقعی استعمال شدہ فراہم کنندہ اور ماڈل دیکھیں۔ نصب ریکارڈ یہ شناخت نہ دکھائیں تو نامعلوم درج کریں۔ شیڈولر کی جانچ، قبول کردہ اجرا یا completed کی حالت بذات خود رپورٹ کی درستی ثابت نہیں کرتی۔
6. عین اسی کام کو hermes cron pause <job_id> سے موقوف کریں اور hermes cron list میں دوبارہ پڑھیں۔ یہ آئندہ خودکار شیڈولنگ روکتا ہے، جاری کوشش ختم نہیں کرتا۔ صریح دستی اجرا موقوف حالت میں بھی منتظم کا استثنا ہے۔ قبولیت کے معیار پورے ہوئے یا نہیں، یہ طے کرتے وقت تاریخ اور مقامی پیداوار محفوظ رکھیں۔

ناکامی پر اسی کام کو بحال کریں

پہلے عین کوشش اور پیداوار پڑھیں، پھر کام کے last_error، last_fire_error اور last_delivery_error خانے دستیاب ہوں تو دیکھیں۔ hermes cron status رکی ہوئی وقفہ جاتی جانچ یا ناقابل تحریر cron ذخیرے اور چل کر ناکام ہونے والے کام میں فرق کرتا ہے۔ فراہم کنندہ کی ترتیبات بدلنے سے پہلے مالک پروفائل اور gateway میزبان دیکھیں: تعاملی shell اور سروس مختلف اسناد پڑھ سکتے ہیں۔ صرف متاثرہ ترتیب درست کریں، حالت پھر جانچیں، اور اسی ID کو صرف تب جاری کریں جب دائرہ اب بھی منظور ہو۔ ترسیل غیر یقینی ہو تو دوبارہ کوشش سے پہلے مطلوبہ منزل دیکھیں؛ اڈاپٹر کے بھیجنا قبول کرنے کے بعد بھی مہلت ختم ہو سکتی ہے۔

دستاویز میں cron ہدایت نامے کا قبول شدہ اجرا کی بحالی والا حصہ کہتا ہے کہ منقطع عمل یا تیار شدہ مگر نہ ملنے والا اجرا جائزے تک موقوف رہتا ہے؛ اجرا کی تاریخ کے مطابق نامعلوم حالت کی کوششیں کبھی خودکار طور پر دوبارہ نہیں چلتیں۔ دوبارہ آغاز کے بعد بحالی طے کرنے سے پہلے نصب کام کی موقوف حالت اور عین کوشش کی شناخت دیکھیں۔ تداخل آزمانے کے لیے فعال کوشش کو دو بار مت چلائیں۔ Hermes میں شیڈولر جانچ کا قفل، اسی جاری کام کو دوبارہ قبول کرنے سے بچاؤ اور قابل ترتیب مشترک متوازی حد ہے۔ یہ کنٹرول بیرونی نظام میں عین ایک بار اثر کی ضمانت نہیں دیتے۔

فراہم کنندہ کا استعمال اور ہمیشہ دستیاب میزبان رقم خرچ کر سکتے ہیں۔ ایک محدود ان پٹ سے شروع کریں اور مسلسل رفتار چننے سے پہلے مقررہ اجرا کے بعد فراہم کنندہ کا استعمال دیکھیں۔ دستاویزی قبل از اجرا اسکرپٹ کی مہلت skill پر مبنی ماڈل کی باری یا اس کے بل کو محدود نہیں کرتی؛ صفائی اور غیرفعال رہنے کی حدیں الگ ہیں۔ پرامپٹ میں لکھی آخری تاریخ ہدایت ہے، سخت اخراجات کنٹرول نہیں۔ اگر بے حد ماڈل باری یا غیر یقینی ضمنی اثر برداشت نہیں کر سکتے تو مناسب کنٹرول ملنے تک کام موقوف رکھیں۔ یہ رہنما دستاویزی رویہ بیان کرتا ہے، نہ کہ ناپا ہوا اجرا، قیمت، قابل اعتماد ہونے کا نتیجہ یا بچت کا دعویٰ۔