پرش به محتوای اصلی
پرش به محتوای مقاله

معماری فایل‌محور Eve؛ تبدیل پوشه‌های دیسک به قراردادهای رفتاری عامل‌های هوش

·۲۷ شهریور ۱۴۰۵۳ دقیقه مطالعه
عامل هوشمند پایدار با ایو بسازید
عامل هوشمند پایدار با ایو بسازید
اشتراک‌گذاری
واقعاً چه چیز جدید است؟

جایگزینی کامل فایل‌های JSON و رشته‌های متنی با ساختار پوشه‌بندی دیسک به عنوان قرارداد رفتاری عامل؛ تبدیل پرامپت به یک کدبیس قابل استقرار و نسخه‌بندی.

تصور کنید یک پوشه ساده روی دیسک شما، تبدیل به سند قانونی و اجرایی برای رفتار یک عامل هوش مصنوعی شود. این ایده، هسته مرکزی Eve است؛ فریم‌ورکی برای ساخت عامل‌های بک‌اند بادوام (Durable Agents) روی Vercel که پیکربندی‌های حجیم را با یک سلسله‌مراتب پوشه‌ای جایگزین کرده است تا مشخصات قابل خواندن برای انسان را از کدهای اجرایی جدا کند.

بسیاری از فریم‌ورک‌های فعلی بر پایه فایل‌های JSON یکپارچه یا رشته‌های پرامپت مبهم هستند که نسخه‌بندی و نگهداری آن‌ها کابوس توسعه‌دهندگان است. Eve با تبدیل دیسک به «منبع حقیقت»، مدیریت عامل‌ها را شبیه به پروژه‌های سنتی نرم‌افزاری می‌کند. این رویکرد درست زمانی معرفی می‌شود که صنعت به سمت عامل‌های «بادوام» حرکت می‌کند؛ سیستم‌هایی که می‌توانند وضعیت (State) خود را حفظ کرده و گردش‌کارهای پیچیده را در جلسات مختلف از سر بگیرند.

زمینه و منطق فریم‌ورک

این فریم‌ورک به صورت بسته eve در npm توزیع شده و یک فایل اجرایی CLI متناظر با نام eve ارائه می‌دهد. این ابزار از یک ساختار دایرکتوری خاص برای تعریف قابلیت‌های عامل استفاده می‌کند. برای مثال، فایل instructions.md به عنوان پرامپت همیشگی (Always-on) عمل می‌کند، در حالی که فایل agent.ts تنظیمات تکمیلی زمان اجرا مانند نام مدل، بیلد (Build) و متدهای فشرده‌سازی (Compaction) را مدیریت می‌کند.

طبق مستندات eve.dev، منطق داخلی این فریم‌ورک به سه لایه مجزا تقسیم شده است:

  • کانال (Channel): ورودی‌های انتقال (مانند HTTP یا Slack) را نرمال‌سازی کرده، سیاست‌های تحویل را اعمال می‌کند و مالک آدرس‌های محلی کانال است.
  • هارنس (Harness): یک واحد کاری هوش مصنوعی را اجرا کرده و خروجی { session, next } را برمی‌گرداند.
  • زمان اجرا (Runtime): وضعیت را ذخیره می‌کند، دستور next را دنبال کرده، رویدادها را استریم می‌کند و مالک ابزارهای اولیه گردش‌کار مانند start()، resumeHook()، createHook() و getWritable() است.

عوامل هوشمند پایدار با ایو بسازید.

جزئیات فنی و پیاده‌سازی

توسعه‌دهندگان می‌توانند با دستور npx eve@latest init پروژه را آغاز کنند. این دستور ساختار دایرکتوری را ایجاد کرده، وابستگی‌ها را نصب می‌کند، Git را مقداردهی اولیه کرده و سرور توسعه را فعال می‌کند. کاربران می‌توانند با فلگ‌های خاص، تنظیمات را شخصی‌سازی کنند:

  • --model: برای انتخاب مدل از AI Gateway (مثلاً openai/gpt-5.5).
  • --reasoning high: برای تنظیم سطح تلاش استدلال روی حالت بالا.
  • --channel-web-nextjs: برای افزودن یک اپلیکیشن Web Chat.

برای پیاده‌سازی عملی، مثلاً در یک عامل هواشناسی، توسعه‌دهنده ابزاری در TypeScript با استفاده از Zod برای اعتبارسنجی طرحواره (Schema) ورودی‌ها می‌سازد. ابزاری مانند get_weather.ts می‌تواند با استفاده از defineTool تعریف شود تا داده‌های خاصی مثل temperatureF: 72 را برگرداند. این عامل سپس می‌تواند از طریق تابع defineAgent در فایل agent.ts به مدل‌هایی نظیر gpt-5.4-mini متصل شود.

Eve همچنین الگوهای پیشرفته عامل‌محور را از طریق یک سلسله‌مراتب پوشه‌ای اختصاصی پشتیبانی می‌کند:

  • subagents/: برای ایجاد عامل‌های فرزند متخصص با استفاده از defineAgent.
  • schedules/: برای تعریف کارهای تکرارشونده (Recurring Jobs) برای عامل.
  • connections/: برای اتصال به سرورهای خارجی پروتکل زمینه مدل (MCP).
  • workspace/: فایل‌هایی که در هر جلسه به محیط Sandbox تزریق می‌شوند.
  • hooks/: برای اشتراک در رویدادهای استریم و چرخه حیات عامل.

این چرخش به سمت معماری فایل‌محور، مدل ذهنی توسعه‌دهنده را از «مهندسی پرامپت» (Prompt Engineering) به «معماری عامل» تغییر می‌دهد. با جداسازی لایه انتقال از منطق هوش مصنوعی، Eve عامل‌ها را در محیط‌های عملیاتی پیش‌بینی‌پذیرتر کرده و عیب‌یابی آن‌ها را آسان‌تر می‌کند. در واقع، این سیستم پرامپت و مجموعه ابزارهای عامل را به جای دستورالعمل‌های شکننده، به یک کدبیس قابل استقرار تبدیل می‌کند.

برای کسانی که روی Vercel توسعه می‌دهند، این یعنی عامل‌ها اکنون به شهروندان درجه‌یک بک‌اند با قابلیت ذخیره‌سازی بومی وضعیت تبدیل شده‌اند. استفاده از یک پروتکل HTTP عمومی که حول محور sessionId می‌چرخد، تضمین می‌کند که این عامل‌ها بدون افشای منطق داخلی کانال، قابل بازرسی و کنترل خارجی باشند. برای شروع، توسعه‌دهندگان می‌توانند با دستور eve init یک عامل پایه به همراه اپلیکیشن Web Chat مستقر کنند.

گام بعدی شما

  • با دستور eve init یک عامل ساده به همراه اپلیکیشن Web Chat مستقر کنید تا تفاوت مدیریت فایل‌محور را حس کنید.
  • ساختار subagents را برای شکستن کارهای پیچیده به تکالیف کوچک‌تر و تخصصی‌تر به کار بگیرید.
  • اتصال‌های MCP را در پوشه connections تعریف کنید تا عامل شما به داده‌های خارجی زنده دسترسی یابد.

اما داستان سخت‌افزاری این تحول و نحوه مدیریت حافظه در مقیاس بالا حتی شگفت‌انگیزتر است — به تحلیل ما درباره‌ی بهینه‌سازی‌های KV Cache مراجعه کنید.

چرا این موضوع مهم است؟

این فریم‌ورک با تکیه بر اعتبار معماری Vercel، استقرار عامل‌های بادوام را از یک چالش زیرساختی به یک فرآیند ساده توسعه تبدیل می‌کند. این تغییر باعث می‌شود توسعه‌دهندگان بتوانند عامل‌هایی بسازند که برخلاف مدل‌های فعلی، حافظه و وضعیت خود را در طول روزها حفظ می‌کنند.

تأثیر برای ایران

توسعه‌دهندگان ایرانی که از Vercel استفاده می‌کنند، می‌توانند با این ابزار بدون درگیر شدن با پیچیدگی‌های مدیریت State، عامل‌های پیشرفته بسازند. دسترسی به مدل‌های مورد نیاز همچنان نیازمند API Gateway یا پروکسی است.

·نگاه ما
تحریریه دات‌هوش

Eve با تبدیل پرامپت به یک ساختار فایل‌سیستمی، در واقع در حال تبدیل «هنر» مهندسی پرامپت به «مهندسی» نرم‌افزار است. این رویکرد ریسک توهمات ناشی از پرامپت‌های بیش از حد طولانی را کاهش می‌دهد، زیرا هر بخش از رفتار عامل در یک فایل مجزا و قابل تست قرار می‌گیرد. در واقع، ما شاهد گذار از مدل‌های «تک-پرامپتی» به مدل‌های «ماژولار» هستیم.

منابع

این گزارش با خط‌لولهٔ خودکار دات‌هوش از منابع معتبر جهانی تدوین و زیر نظر تحریریه منتشر شده است. روش کار ما

گفتگو

پنج‌شنبه‌های هوش‌محور

بسته‌ی هفتگی دات‌هوش

۵ خبر، ۲ ابزار، ۱ پرامپت در هر شماره. به‌زودی راه‌اندازی می‌شود — هر پنج‌شنبه صبح.

خبر کلیدی
ابزار کاربردی
پرامپت حرفه‌ای
تحلیل پژوهش
به‌زودی
زاویه‌ی ایرانی
به‌زودی
تمرین این هفته
به‌زودی

راهنماهای دات‌هوش

راهنماهای کاربردیِ دات‌هوش برای کار با هوش مصنوعی — از همین‌جا شروع کنید:

دات‌هوش

راهنمای فارسی هوش مصنوعی — با نگاه به ایران

اخبار روزانه، معرفی ابزارها و مدل‌ها، و آموزشِ کار با هوش مصنوعی؛ همیشه با این پرسش که از ایران چه چیزی کار می‌کند و چه چیزی نه.