معرفی ابزار متن‌باز MineAgent؛ طراحی بصری ایجنت‌های هوش مصنوعی در مرورگر و تبدیل خودکار به کد پایتون

معرفی پروژه

ابزار MineAgent یک پروژه متن‌باز و محلی (Local) برای مدیریت و هماهنگ‌سازی بصری ایجنت‌های هوش مصنوعی است. با استفاده از این ابزار می‌توانید جریان‌های کاری ایجنت‌ها را در مقیاس صنعتی روی یک بوم گرافیکی در مرورگر (مبتنی بر React Flow) طراحی کنید، فریم‌ورک دلخواه خود را برای تولید خودکار دیاگرام معماری برگزینید و گره‌ها، کدها و مدل‌ها را ویرایش نمایید. در ادامه، با زدن دکمه Save، بوم طراحی‌شده به یک پروژه ایجنت پایتون مستقل و قابل اجرا کامپایل می‌شود و با کلیک روی Run، می‌توانید آن را همراه با دریافت بازخورد زنده (Streaming) برای هر گره، روی سیستم خود اجرا کنید. مخزن این پروژه در گیت‌هاب در دسترس است و بیش از ۱۱۱ ستاره دریافت کرده است. طبق توضیحات فایل راهنمای پروژه، هدف اصلی این ابزار شخصی‌سازی ایجنت‌ها و ایجاد جریان‌های بصری برای کاهش موانع فنی پیش روی کاربران عادی است؛ هم‌چنین برای استفاده‌های تجاری باید نام منبع ذکر شود.

پشته فناوری این پروژه (بر اساس فایل راهنما) عبارت است از:

• بخش فرانت‌اند: React 18 به‌همراه TypeScript، کتابخانه React Flow و ابزار Vite
• بخش بک‌اند: فریم‌ورک FastAPI در پایتون به‌همراه پایگاه داده SQLite (طبق ادعای سازندگان، بدون نیاز به ORM یا وابستگی‌های اضافی پایگاه داده)
• ذخیره‌سازی: نگهداری بوم‌های طراحی در SQLite و ذخیره کدهای تولیدشده در مسیر projects/<canvas>/
• راه‌اندازی: اجرای فایل‌های start.bat یا start.ps1 که به‌طور پیش‌فرض روی آدرس http://127.0.0.1:8000 بالا می‌آیند.

توضیحات فنی و ضرورت ساخت

مشکل چیست؟

نوشتن دستی پایپ‌لاین‌های چندایجنتی با استفاده از فریم‌ورک‌هایی مانند LangChain، LangGraph، AutoGen یا CrewAI برای افراد غیرمتخصص دشوار و پرچالش است. ابزار MineAgent تلاش می‌کند تا طراحی این جریان‌های کاری را کاملاً بصری کند و در خروجی، کدهای واقعی پایتون را تحویل دهد تا کاربر بتواند آن‌ها را به‌راحتی اجرا و توسعه دهد.

قابلیت‌های کلیدی

• بوم طراحی گرافیکی: امکان کشیدن و متصل کردن حدود ۱۱۰ نوع گره مختلف (شامل ایجنت‌ها، ابزارها، پروتکل MCP، بازیابی اطلاعات، گاردهای محافظتی، تأیید انسانی و موارد دیگر) به‌همراه پنل محدودیت‌ها با قوانین از پیش تعریف‌شده
• پشتیبانی از حالت‌های استدلالی متنوع برای هر ایجنت (مانند ReAct، Plan-and-Execute، Goal، Reflexion، ToolCall و Simple) به‌علاوه تعریف روابط سازمانی (مدیر، زیردست یا هم‌رده) با استفاده از ctx.delegate
• اجرای زنده و بلادرنگ: برجسته شدن گره فعال در حین اجرا و نمایش خروجی مدل در سطح توکن در پنل اجرا
• امکان بارگذاری و دریافت قالب‌های آماده جامعه کاربری از طریق Pull Request در گیت‌هاب، به‌همراه پنل دستیار هوش مصنوعی داخلی برای پرسش‌وپاسخ درباره بوم طراحی
• ارائه ابزار اختیاری tools/mock_llm.py که اجازه می‌دهد کل چرخه تبدیل بوم به کد و اجرای آن، حتی بدون داشتن کلید واقعی API به‌درستی کار کند.

محدودیت‌ها

• اسکریپت‌های راه‌اندازی اولیه بیشتر برای محیط‌های محلی و سیستم‌عامل ویندوز بهینه‌سازی شده‌اند؛ بنابراین پیش از شروع، پشتیبانی از سیستم‌عامل خود را بررسی کنید
• کلیدهای API برای پیکربندی گره‌ها و مدل‌ها به‌صورت رمزنگاری‌شده و محلی ذخیره می‌شوند، اما همچنان مسئولیت مدیریت امن این اطلاعات حساس بر عهده کاربر است
• تعداد ستاره‌های پروژه و دامنه امکانات آن همواره در حال تغییر است؛ از این رو فایل راهنمای مخزن (README) را به‌عنوان مرجع اصلی در نظر بگیرید.

کاربردها و نحوه استفاده

این ابزار مناسب چه کسانی است؟

• توسعه‌دهندگانی که به دنبال یک بوم طراحی بصری هستند که مستقیماً به پروژه‌های واقعی پایتون کامپایل شود
• تیم‌هایی که در حال نمونه‌سازی اولیه از جریان‌های چندایجنتی، سیستم‌های RAG و اتصال ابزارها در فریم‌ورک‌های رایج هستند
• مدرسانی که می‌خواهند نحوه هماهنگ‌سازی ایجنت‌ها را بدون شروع از یک مخزن کد خالی به دانشجویان آموزش دهند.

راهنمای شروع به کار

1. مخزن پروژه را از گیت‌هاب کلون کرده و طبق راهنمای شروع سریع، فایل start.bat یا .\start.ps1 را اجرا کنید
2. آدرس http://127.0.0.1:8000 را در مرورگر باز کنید، یک قالب فریم‌ورک یا حالت استدلالی را برگزینید، بوم را ویرایش کنید و با زدن دکمه Save، پروژه خود را در مسیر projects/<name>/ تحویل بگیرید
3. مدل‌های زبانی را در بخش مرکز کاربری پیکربندی کنید (یا برای تست آزمایشی کل مسیر بدون نیاز به مدل واقعی، اسکریپت tools/mock_llm.py را اجرا نمایید)
4. در نهایت روی دکمه Run کلیک کنید تا اجرای گره‌ها را به‌صورت زنده مشاهده نمایید؛ هم‌چنین توصیه می‌شود پیش از انتقال کدهای تولیدشده به محیط عملیاتی، از پنل محدودیت‌ها برای بررسی نهایی استفاده کنید.