From 994d6b226e163fd0105f0b249846c4cbfa53a242 Mon Sep 17 00:00:00 2001 From: MohammadAminDHM Date: Wed, 16 Apr 2025 11:57:53 +0330 Subject: [PATCH] Add i18n support for multilingual documentation in mkdocs.yml --- docs/fa/concepts/why-multi-agent.md | 55 ++++++++++++++++++++++++++++ docs/fa/index.md | 56 +++++++++++++++++++++++++++++ mkdocs.yml | 20 +++++++++++ requirements.txt | 1 + 4 files changed, 132 insertions(+) create mode 100644 docs/fa/concepts/why-multi-agent.md create mode 100644 docs/fa/index.md diff --git a/docs/fa/concepts/why-multi-agent.md b/docs/fa/concepts/why-multi-agent.md new file mode 100644 index 00000000..55916f38 --- /dev/null +++ b/docs/fa/concepts/why-multi-agent.md @@ -0,0 +1,55 @@ +# چرا سیستم‌های چند عامله؟ + +سیستم‌های چند عامله یک رویکرد قدرتمند برای حل مسائل پیچیده با استفاده از همکاری بین عامل‌های هوش مصنوعی است. در این صفحه، مزایای اصلی و دلایل استفاده از این سیستم‌ها را بررسی می‌کنیم. + +## مزایای کلیدی + +### ۱. تقسیم وظایف پیچیده +سیستم‌های چند عامله می‌توانند مسائل پیچیده را به زیر وظایف کوچکتر و قابل مدیریت تقسیم کنند. هر عامل می‌تواند روی یک جنبه خاص از مسئله تمرکز کند و با تخصص خود به حل آن بپردازد. + +### ۲. افزایش کارایی +با تقسیم کار بین چندین عامل، می‌توان وظایف را به صورت موازی انجام داد و سرعت پردازش را افزایش داد. این موضوع به ویژه در پروژه‌های بزرگ و پیچیده اهمیت دارد. + +### ۳. انعطاف‌پذیری و مقیاس‌پذیری +سیستم چند عامله به راحتی قابل گسترش است. می‌توانید عامل‌های جدید را اضافه کنید یا عامل‌های موجود را تغییر دهید بدون اینکه نیاز به تغییر کل سیستم باشد. + +## نمونه کاربردی + +```python +from swarms import Agent, Swarm + +# تعریف عامل‌ها با تخصص‌های مختلف +researcher = Agent(name="researcher", task="جمع‌آوری اطلاعات") +analyst = Agent(name="analyst", task="تحلیل داده") +writer = Agent(name="writer", task="نگارش گزارش") + +# ایجاد گروه با عامل‌های متخصص +research_team = Swarm( + agents=[researcher, analyst, writer], + workflow="sequential" +) + +# اجرای پروژه تحقیقاتی +result = research_team.run("تحقیق در مورد روند‌های بازار و تهیه گزارش") +``` + +## مقایسه با سیستم‌های تک عامله + +| ویژگی | سیستم تک عامله | سیستم چند عامله | +|-------|----------------|-----------------| +| پیچیدگی | محدود به توانایی یک عامل | توزیع پیچیدگی بین عامل‌ها | +| مقیاس‌پذیری | محدود | بالا | +| انعطاف‌پذیری | کم | زیاد | +| سرعت پردازش | متوسط | بالا (پردازش موازی) | +| مدیریت خطا | نقطه شکست واحد | مقاوم در برابر خطا | + +## نتیجه‌گیری + +سیستم‌های چند عامله یک راه‌حل قدرتمند برای پروژه‌های پیچیده هستند. با تقسیم وظایف بین عامل‌های متخصص، می‌توانید: + +- کارایی را افزایش دهید +- انعطاف‌پذیری بیشتری داشته باشید +- مقیاس‌پذیری را بهبود بخشید +- مدیریت خطا را بهتر کنید + +برای اطلاعات بیشتر در مورد پیاده‌سازی، به بخش [راهنمای پیاده‌سازی](../best-practices/implementation.md) مراجعه کنید. \ No newline at end of file diff --git a/docs/fa/index.md b/docs/fa/index.md new file mode 100644 index 00000000..d58f9935 --- /dev/null +++ b/docs/fa/index.md @@ -0,0 +1,56 @@ +# سیستم‌های چند عامله LLM + +به راهنمای جامع سیستم‌های چند عامله خوش آمدید! این مستندات به شما کمک می‌کند تا سیستم‌های چند عامله قدرتمند و کارآمد را با استفاده از مدل‌های زبانی بزرگ (LLMs) ایجاد و مدیریت کنید. + +## مزایای اصلی + +* 🤝 **همکاری هوشمند** - عامل‌های متعدد که برای حل مسائل پیچیده با هم همکاری می‌کنند +* 🎯 **تخصص متمرکز** - هر عامل روی یک وظیفه خاص تمرکز می‌کند +* 🔄 **انعطاف‌پذیری** - سیستم قابل تطبیق با نیازهای در حال تغییر +* 📈 **مقیاس‌پذیری** - افزودن عامل‌های جدید برای گسترش قابلیت‌ها + +## شروع سریع + +برای شروع کار با سیستم چند عامله، این مراحل را دنبال کنید: + +```python +from swarms import Agent, Swarm + +# ایجاد عامل‌ها +agent1 = Agent(name="agent1", task="تحلیل داده") +agent2 = Agent(name="agent2", task="تولید گزارش") + +# ایجاد گروه +swarm = Swarm(agents=[agent1, agent2]) + +# اجرای وظیفه +result = swarm.run("تحلیل داده‌های فروش و تولید گزارش") +``` + +## ساختار پروژه + +- `swarms/` - کتابخانه اصلی +- `examples/` - نمونه‌های کاربردی +- `docs/` - مستندات +- `tests/` - تست‌های واحد + +## نصب + +```bash +pip install swarms +``` + +## مشارکت + +ما از مشارکت‌های جامعه استقبال می‌کنیم! لطفاً [راهنمای مشارکت](contributing.md) ما را مطالعه کنید. + +## پشتیبانی + +برای سوالات و پشتیبانی: +- 📖 [مستندات](https://swarms.readthedocs.io) +- 💬 [انجمن](https://github.com/swarms/discussions) +- 🐛 [گزارش مشکلات](https://github.com/swarms/issues) + +## مجوز + +این پروژه تحت مجوز MIT منتشر شده است. برای جزئیات بیشتر [فایل مجوز](LICENSE) را ببینید. \ No newline at end of file diff --git a/mkdocs.yml b/mkdocs.yml index dc4bb0b5..34cf40a3 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -59,6 +59,26 @@ plugins: - search - minify: minify_html: true + - i18n: + default_language: en + languages: + en: English + fa: فارسی + nav_translations: + fa: + Home: خانه + "Core Concepts": مفاهیم اصلی + "Why Multi-Agent Systems?": چرا سیستم‌های چند عامله؟ + "Limitations of Individual Agents": محدودیت‌های عامل‌های انفرادی + "Multi-Agent Architecture": معماری چند عامله + "Best Practices": بهترین شیوه‌ها + "Implementation Guide": راهنمای پیاده‌سازی + "Communication Protocols": پروتکل‌های ارتباطی + "Error Handling": مدیریت خطا + "Performance Optimization": بهینه‌سازی عملکرد + "FAQ": سوالات متداول + "Tips & Troubleshooting": نکات و عیب‌یابی + "Glossary": واژه‌نامه extra: social: diff --git a/requirements.txt b/requirements.txt index 62a01a4d..9bbf210b 100644 --- a/requirements.txt +++ b/requirements.txt @@ -23,3 +23,4 @@ networkx aiofiles httpx # vllm>=0.2.0 +mkdocs-i18n>=0.4.4