[{"content":"VS Code چی هست؟ 🤔 Visual Studio Code که بهش می‌گن VS Code، یه ویرایشگر کد فوق‌العاده سبک، رایگان و متن‌باز (Open Source) هستش که شرکت مایکروسافت ساخته.\nتوی دنیای برنامه‌نویسی، VS Code الان محبوب‌ترین ویرایشگر کد به حساب میاد. چرا؟ چون:\nرایگانه — هیچ هزینه‌ای نداره سبکه — روی هر سیستمی به راحتی اجرا می‌شه قابلیت نصب افزونه (Extension) داره — می‌تونین هزاران ابزار مختلف بهش اضافه کنین از Git پشتیبانی می‌کنه — یعنی می‌تونین کدهاتون رو مدیریت و کنترل کنید داشبورد دیباگ (Debug) داره — یعنی می‌تونین خطاهای کدتون رو راحت پیدا کنین قابلیت هوش مصنوعی داره — با دستیار های متنوعی می‌تونین کد بزنین روی سه تا سیستم‌عامل اصلی (ویندوز، مک و لینوکس) اجرا می‌شه به زبان ساده: VS Code مثل یه دفترچه یاداشت حرفه‌ای برای برنامه‌نویسه که هر وسیله‌ای که نیاز دارین می‌تونین بهش اضافه کنین!\nنکته مهم: VS Code رو با Visual Studio اشتباه نگیرین! Visual Studio یه نرم‌افزار سنگین و حرفه‌ای‌تره که بیشتر روی ویندوز کار می‌کنه، ولی VS Code سبک‌تره و روی همه سیستم‌عامل‌ها اجرا می‌شه.\nنصب VS Code روی ویندوز 🪟 مرحله ۱: دانلود فایل نصب برین به سایت رسمی: code.visualstudio.com صفحه که باز بشه، خودکار دکمه Download for Windows رو می‌بین. روش کلیک کنین. یه فایل با اسم VSCodeUserSetup-xxxx.exe دانلود می‌شه. نکته: دو نوع نصب‌کننده وجود داره:\nUser Setup (توصیه می‌شه) — نیاز به دسترسی ادمین نداره و مخصوص حساب کاربری خودتونه System Setup — نیاز به دسترسی ادمین داره و برای همه کاربرای سیستم نصب می‌کنه مرحله ۲: اجرای فایل نصب فایل دانلود شده رو دوبار کلیک کنین تا اجرا بشه. توافقنامه (License Agreement) رو قبول کنین و Next بزنین. مسیر نصب رو انتخاب کنین (همون پیش‌فرض خوبه). توی صفحه Select Additional Tasks، حتماً این گزینه‌ها رو تیک بزنین: ✅ Add to PATH — این خیلی مهمه! با این کار می‌تونین از ترمینال با دستور code . VS Code رو باز کنین ✅ Add \u0026ldquo;Open with Code\u0026rdquo; action to Windows Explorer file context menu ✅ Add \u0026ldquo;Open with Code\u0026rdquo; action to Windows Explorer directory context menu دکمه Install رو بزنین. بعد از تموم شدن نصب، تیک Launch Visual Studio Code رو بزنین و Finish رو بزنین. مرحله ۳: اجرا و تست VS Code باز می‌شه و صفحه خوش‌آمدگویی (Welcome) رو می‌بین. برای تست از خط فرمان (CMD یا PowerShell)، دستور زیر رو بزنین: code . اگه VS Code باز شد، یعنی نصب کاملاً درسته! 🎉\nنصب VS Code روی macOS 🍎 مرحله ۱: دانلود برین به سایت رسمی: code.visualstudio.com دکمه Download for macOS رو بزنین. یه فایل ZIP دانلود می‌شه. نکته: اگه مک شما تراشه Apple Silicon (M1, M2, M3) داره یا Intel، خیالتون راحت باشه — گزینه Universal رو انتخاب کنین که روی هر دو نوع کار می‌کنه.\nمرحله ۲: نصب فایل ZIP دانلود شده رو دوبار کلیک کنین تا از حالت فشرده خارج بشه. فایل Visual Studio Code.app رو بگیرین و بکشین توی پوشه Applications. برین پوشه Applications و دوبار کلیک کنین روی VS Code تا اجرا بشه. اگه پیام امنیتی اومد که \u0026ldquo;این برنامه از اینترنت دانلود شده\u0026rdquo;، دکمه Open رو بزنین — این طبیعیه! مرحله ۳: فعال‌سازی دستور ترمینال برای اینکه بتونین از ترمینال مک با دستور code . VS Code رو باز کنین:\nVS Code رو باز کنین. کلیدهای Cmd+Shift+P رو بزنین تا Command Palette باز بشه. تایپ کنین: Shell Command گزینه Shell Command: Install \u0026lsquo;code\u0026rsquo; command in PATH رو انتخاب کنین. ترمینال رو بندین و دوباره باز کنین. حالا می‌تونین از دستور code . استفاده کنین. نصب با Homebrew (روش سریع‌تر): اگه Homebrew نصب دارین، فقط کافیه این دستور رو بزنین:\nbrew install --cask visual-studio-code نصب VS Code روی لینوکس 🐧 نصب روی لینوکس بسته به توزیعی که دارین کمی متفاوته. بیاین روش‌های مختلف رو ببینیم:\nروش ۱: اوبونتو / دبیان (Debian/Ubuntu) روش ساده (دانلود فایل .deb) برین به سایت رسمی: code.visualstudio.com دکمه Debian (.deb) رو بزنین و فایل رو دانلود کنین. ترمینال رو باز کنین و دستور زیر رو بزنین: sudo apt install ./\u0026lt;اسم-فایل\u0026gt;.deb مثلاً:\nsudo apt install ./code_1.96.0-1734602286_amd64.deb روش حرفه‌ای (با مخزن مایکروسافت — توصیه می‌شه) این روش باعث می‌شه VS Code به‌صورت خودکار آپدیت بشه:\n# نصب ابزارهای لازم sudo apt update sudo apt install wget gpg # دریافت کلید امنیتی مایکروسافت wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor \u0026gt; packages.microsoft.gpg sudo install -D -o root -g root -m 644 packages.microsoft.gpg /etc/apt/keyrings/packages.microsoft.gpg # اضافه کردن مخزن echo \u0026#34;deb [arch=amd64,arm64,armhf signed-by=/etc/apt/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main\u0026#34; | sudo tee /etc/apt/sources.list.d/vscode.list \u0026gt; /dev/null # بروزرسانی و نصب sudo apt update sudo apt install code روش ۲: فدورا / RHEL / CentOS # دانلود فایل .rpm # یا استفاده از مخزن مایکروسافت: sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc echo -e \u0026#34;[code]\\nname=Visual Studio Code\\nbaseurl=https://packages.microsoft.com/yumrepos/vscode\\nenabled=1\\nautorefresh=1\\ntype=rpm-md\\ngpgcheck=1\\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc\u0026#34; | sudo tee /etc/yum.repos.d/vscode.repo \u0026gt; /dev/null # نصب با dnf (فدورا ۲۲ به بعد) dnf check-update sudo dnf install code # یا برای نسخه‌های قدیمی‌تر با yum sudo yum install code روش ۳: نصب با Snap (روی همه توزیع‌ها) sudo snap install --classic code این روش رو همه توزیع‌های لینوکس پشتیبانی می‌کن و خودکار آپدیت می‌شه.\nاجرا در لینوکس بعد از نصب، برای اجرا:\nاز منوی برنامه‌ها Visual Studio Code رو انتخاب کنین یا توی ترمینال دستور زیر رو بزنین: code قدم‌های بعد از نصب ✅ بعد از اینکه VS Code رو نصب کردین، این کارها رو انجام بدین:\n۱. نصب افزونه‌های مفید از منوی سمت چپ، آیکون چهارخانه (Extensions) رو بزنین و این افزونه‌ها رو نصب کنین:\nPersian Language Pack — برای فارسی کردن محیط (اگه دوست دارین) Python — اگه با پایتون کار می‌کنین Prettier — برای مرتب کردن کد Live Server — برای دیدن زنده سایت‌های HTML ۲. تنظیم دلخواه از منوی File \u0026gt; Preferences \u0026gt; Settings می‌تونین ظاهر و تنظیمات VS Code رو شخصی‌سازی کنین تم (Theme) مورد علاقه‌تون رو انتخاب کنین ۳. تست نهایی یه پوشه جدید بسازین، توی ترمینال برین اون پوشه و دستور code . رو بزنین — اگه VS Code با اون پوشه باز شد، یعنی همه چی عالیه! 🚀\nجمع‌بندی 📝 سیستم‌عامل روش نصب سختی ویندوز دانلود و اجرای .exe ⭐ خیلی آسون مک دانلود و انتقال به Applications ⭐ خیلی آسون لینوکس نصب از طریق ترمینال یا Snap ⭐⭐ نسبتاً آسون VS Code یه ابزار فوق‌العاده‌ست که چه تازه‌کار باشین چه حرفه‌ای، به کارتون میاد. نصبش هم که دیدین چقدر راحته!\nحالا برین و شروع کنین به کدنویسی! 🎉\n","permalink":"https://naturalai.ir/blog/posts/vscode-install/","summary":"\u003ch2 id=\"vs-code-چی-هست-\"\u003eVS Code چی هست؟ 🤔\u003c/h2\u003e\n\u003cp\u003eVisual Studio Code که بهش می‌گن \u003cstrong\u003eVS Code\u003c/strong\u003e، یه ویرایشگر کد فوق‌العاده سبک، \u003cstrong\u003eرایگان\u003c/strong\u003e و \u003cstrong\u003eمتن‌باز\u003c/strong\u003e (Open Source) هستش که شرکت مایکروسافت ساخته.\u003c/p\u003e\n\u003cp\u003eتوی دنیای برنامه‌نویسی، VS Code الان محبوب‌ترین ویرایشگر کد به حساب میاد. چرا؟ چون:\u003c/p\u003e\n\u003cul\u003e\n\u003cli\u003e\u003cstrong\u003eرایگانه\u003c/strong\u003e — هیچ هزینه‌ای نداره\u003c/li\u003e\n\u003cli\u003e\u003cstrong\u003eسبکه\u003c/strong\u003e — روی هر سیستمی به راحتی اجرا می‌شه\u003c/li\u003e\n\u003cli\u003e\u003cstrong\u003eقابلیت نصب افزونه (Extension) داره\u003c/strong\u003e — می‌تونین هزاران ابزار مختلف بهش اضافه کنین\u003c/li\u003e\n\u003cli\u003e\u003cstrong\u003eاز Git پشتیبانی می‌کنه\u003c/strong\u003e — یعنی می‌تونین کدهاتون رو مدیریت و کنترل کنید\u003c/li\u003e\n\u003cli\u003e\u003cstrong\u003eداشبورد دیباگ (Debug) داره\u003c/strong\u003e — یعنی می‌تونین خطاهای کدتون رو راحت پیدا کنین\u003c/li\u003e\n\u003cli\u003e\u003cstrong\u003eقابلیت هوش مصنوعی داره\u003c/strong\u003e — با دستیار های متنوعی می‌تونین کد بزنین\u003c/li\u003e\n\u003cli\u003e\u003cstrong\u003eروی سه تا سیستم‌عامل اصلی (ویندوز، مک و لینوکس) اجرا می‌شه\u003c/strong\u003e\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003eبه زبان ساده: VS Code مثل یه دفترچه یاداشت حرفه‌ای برای برنامه‌نویسه که هر وسیله‌ای که نیاز دارین می‌تونین بهش اضافه کنین!\u003c/p\u003e","title":"راهنمای نصب VS Code - Visual Studio Code روی ویندوز، لینوکس و مک"},{"content":"ایجنت هوش مصنوعی اندروید استودیو چیه؟ اندروید استودیو از یه ایجنت هوش مصنوعی به اسم Gemini استفاده می‌کنه. این ایجنت می‌تونه:\nکد براتون بنویسه و کاملش کنه باگ‌ها رو پیدا و رفع کنه خطاهای Gradle، Logcat و Crash رو تحلیل کنه مستقیماً برنامه رو روی دستگاه نصب و تست کنه بین چند فایل همزمان تغییر ایجاد کنه ولی دو تا مشکل بزرگ داره: ۱. محدودیت نسخه رایگان: توی نسخه رایگان، یه نسخه سبک از Gemini 2.5 Pro با context window کوچک دریافت می‌کنید. اگه پروژه بزرگ دارید، ممکنه جواب‌هاش کامل نباشه.\n۲. فقط جمینای! اندروید استودیو به صورت پیش‌فرض فقط از مدل‌های Gemini پشتیبانی می‌کنه. نمی‌تونید از Claude، GPT یا مدل‌های دیگه استفاده کنید\u0026hellip; مگه اینکه یه راه بلد باشید که الآن بهتون یاد می‌دم 😉\nراه حل: اتصال به Natural AI به عنوان پروایدر خارجی خوشبختانه اندروید استودیو یه قابلیت داره به اسم Remote Third-Party Provider که به شما اجازه میده هر سرویس OpenAI-compatible رو بهش وصل کنید.\nمرحله ۱: گرفتن API Key از Natural AI کافیه برید سایت Natural AI، ثبت‌نام کنید و از بخش تنظیمات یه کلید API بگیرید. این کلید رو برای مرحله بعد نیاز دارید.\nمرحله ۲: باز کردن تنظیمات از منوی File (ویندوز) یا Android Studio (مک) برید به Settings. توی کادر جستجوی تنظیمات، بنویسید AI. از نتایج، گزینه Model Providers رو انتخاب کنید. مرحله ۳: افزودن پروایدر جدید روی علامت + (افزودن پروایدر جدید) کلیک کنید. گزینه Third-Party Remote Provider رو انتخاب کنید. مرحله ۴: پر کردن اطلاعات اتصال حالا این اطلاعات رو وارد کنید:\nفیلد مقدار Description یه اسم بامزه مثل Natural AI URL https://naturalai.ir/api/v1 Type OpenAI-Compatible (از منوی کشویی انتخاب کنید) API Key کلیدی که از Natural AI گرفتید بعد از وارد کردن API Key، چند لحظه صبر کنید تا لیست مدل‌ها لود بشه. یه مدل که دوست دارید انتخاب کنید (مثلاً Qwen یا DeepSeek).\nمرحله ۵: ذخیره و شروع کار روی OK یا Apply کلیک کنید. حالا برید توی چت ایجنت (پنل کناری). از منوی بالای چت، مدل جدیدی که اضافه کردید رو انتخاب کنید. 🎉 تبریک! الآن می‌تونید با مدل دلخواه خودتون توی اندروید استودیو کد بزنید، بدون محدودیت جمینای!\nجمع‌بندی چی شد که انجام دادیم؟ خیلی ساده: ✅ از Natural AI کلید API گرفتیم ✅ اندروید استودیو رو به Natural AI وصل کردیم ✅ از محدودیت مدل‌های جمینای خلاص شدیم ✅ حالا می‌تونیم از ده‌ها مدل مختلف توی اندروید استودیو استفاده کنیم\nبرای گرفتن API Key از Natural AI: کافیه برید سایت Natural AI، ثبت‌نام کنید و از بخش تنظیمات (Dashboard/Settings) کلید API خودتون رو بگیرید. با این کلید می‌تونید به ده‌ها مدل هوش مصنوعی معروف دسترسی داشته باشید.\nشما میتوانید لیست مدلها را از اینجا ببینید. پیشنهاد میکنیم برای شروع از مدلهای ارزان قیمتی مثل deepseek استفاده کنید و میزان مصرف را مدیریت کنید.\n","permalink":"https://naturalai.ir/blog/posts/android-studio-agent/","summary":"\u003ch2 id=\"ایجنت-هوش-مصنوعی-اندروید-استودیو-چیه\"\u003eایجنت هوش مصنوعی اندروید استودیو چیه؟\u003c/h2\u003e\n\u003cp\u003eاندروید استودیو از یه ایجنت هوش مصنوعی به اسم \u003cstrong\u003eGemini\u003c/strong\u003e استفاده می‌کنه. این ایجنت می‌تونه:\u003c/p\u003e\n\u003cul\u003e\n\u003cli\u003eکد براتون بنویسه و کاملش کنه\u003c/li\u003e\n\u003cli\u003eباگ‌ها رو پیدا و رفع کنه\u003c/li\u003e\n\u003cli\u003eخطاهای Gradle، Logcat و Crash رو تحلیل کنه\u003c/li\u003e\n\u003cli\u003eمستقیماً برنامه رو روی دستگاه نصب و تست کنه\u003c/li\u003e\n\u003cli\u003eبین چند فایل همزمان تغییر ایجاد کنه\u003c/li\u003e\n\u003c/ul\u003e\n\u003ch3 id=\"ولی-دو-تا-مشکل-بزرگ-داره\"\u003eولی دو تا مشکل بزرگ داره:\u003c/h3\u003e\n\u003cp\u003e\u003cstrong\u003e۱. محدودیت نسخه رایگان:\u003c/strong\u003e توی نسخه رایگان، یه نسخه سبک از Gemini 2.5 Pro با \u003cstrong\u003econtext window کوچک\u003c/strong\u003e دریافت می‌کنید. اگه پروژه بزرگ دارید، ممکنه جواب‌هاش کامل نباشه.\u003c/p\u003e","title":"آموزش اتصال دستیار هوش مصنوعی اندروید استودیو Android Studio به سرویس های غیر از جمینای"},{"content":"Qdrant چیست؟ Qdrant (تلفظ: کادْرَنت) یک دیتابیس برداری (Vector Database) قدرتمند و متن‌باز (Open Source) است که به زبان Rust نوشته شده.\nبه زبان ساده: توی دیتابیس‌های معمول مثل MySQL یا PostgreSQL، ما داده‌ها رو به صورت ردیف و ستون ذخیره می‌کنیم و بر اساس مقادیر اون‌ها جستجو می‌کنیم. اما Qdrant مخصوص ذخیره‌سازی بردارها (Vectors) ساخته شده — همون اعدادی که مدل‌های هوش مصنوعی (مثل ChatGPT یا مدل‌های embedding) تولید می‌کنند.\nکاربردهای اصلی Qdrant جستجوی معنایی (Semantic Search): مثلاً بهش می‌گی «تغییرات اقلیمی» و مقالات مربوط به «گرمایش زمین» رو برات پیدا می‌کنه سیستم‌های توصیه‌گر (Recommendation Systems): مثل «محصولات مشابه» در فروشگاه‌های اینترنتی حافظه بلندمدت برای AI Agentها و RAG (Retrieval-Augmented Generation) تشابه‌یابی تصاویر، صداها و متن‌ها ویژگی‌های مهم Qdrant ⚡ فوق‌العاده سریع — نوشته شده با Rust و از SIMD پشتیبانی می‌کنه 🔍 فیلتر کردن پیشرفته — می‌تونی همزمان با جستجوی برداری، روی JSON metadata هم فیلتر اعمال کنی 📊 مقیاس‌پذیر — تا میلیاردها بردار رو پشتیبانی می‌کنه 🔄 جستجوی ترکیبی (Hybrid Search) — ترکیب جستجوی معنایی + جستجوی متنی 🖥️ رابط کاربری تحت وب — داشبورد بصری برای مدیریت 📦 Client Library برای زبان‌های مختلف: Python, JavaScript, Rust, Go, Java, .NET روش‌های نصب Qdrant Qdrant رو به ۴ روش اصلی می‌شه نصب کرد. بیایید هرکدوم رو ببینیم:\n✅ روش ۱: نصب با Docker (ساده‌ترین روش — توصیه‌شده) این روش هم روی لینوکس و هم روی ویندوز جواب میده.\nروی لینوکس # مرحله ۱: کشیدن image از Docker Hub docker pull qdrant/qdrant # مرحله ۲: اجرای کانتینر (با ذخیره‌سازی دائمی) docker run -p 633:633 -p 6334:6334 \\ -v \u0026#34;$(pwd)/qdrant_storage:/qdrant/storage\u0026#34; \\ qdrant/qdrant روی ویندوز (با Docker Desktop) # مرحله ۱: کشیدن image docker pull qdrant/qdrant # مرحله ۲: اجرا docker run -p 633:633 -p 6334:6334 ^ -v \u0026#34;%cd%/qdrant_storage:/qdrant/storage\u0026#34; ^ qdrant/qdrant ⚠️ نکته مهم برای ویندوز: به دلیل مشکلات فایل‌سیستم در WSL، توصیه می‌شه مسیر ذخیره‌سازی رو داخل یک volume مخصوص Docker بذارید، نه روی فایل‌سیستم ویندوز.\nبعد از اجرا، به این آدرس‌ها دسترسی دارید سرویس آدرس REST API http://localhost:633 Web UI (داشبورد) http://localhost:633/dashboard gRPC API localhost:6334 ✅ روش ۲: نصب با استفاده از باینری مستقیم (بدون Docker) Qdrant فایل‌های باینری آماده برای سیستم‌عامل‌های مختلف ارائه می‌ده.\nروی لینوکس (Ubuntu/Debian) # دانلود آخرین نسخه (مثلاً v1.18.3) - فایل .deb wget https://github.com/qdrant/qdrant/releases/download/v1.18.3/qdrant_1.18.3-1_amd64.deb # نصب sudo dpkg -i qdrant_1.18.3-1_amd64.deb # اجرا qdrant روی لینوکس (نسخه فشرده — عمومی) # دانلود فایل tar.gz wget https://github.com/qdrant/qdrant/releases/download/v1.18.3/qdrant-x86_64-unknown-linux-gnu.tar.gz # استخراج tar -xzf qdrant-x86_64-unknown-linux-gnu.tar.gz # اجرا ./qdrant روی ویندوز # ۱. از صفحه Releases گیت‌هاب دانلود کن: # https://github.com/qdrant/qdrant/releases # فایل: qdrant-x86_64-pc-windows-msvc.zip # ۲. فایل رو extract کن # ۳. توی CMD یا PowerShell اجرا کن: .\\qdrant.exe ✅ روش ۳: نصب از روی سورس (منبع کد) — برای لینوکس و macOS اگر نیاز به کامپایل اختصاصی برای معماری خاصی دارید:\n# پیش‌نیاز: نصب Rust curl --proto \u0026#39;=https\u0026#39; --tlsv1.2 -sSf https://sh.rustup.rs | sh # clone کردن مخزن git clone https://github.com/qdrant/qdrant.git cd qdrant # کامپایل cargo build --release --bin qdrant # باینری در مسیر: ./target/release/qdrant ✅ روش ۴: نصب کتابخانه Python (حالت Local Mode) اگر برنامه‌نویس پایتون هستی، می‌تونی حتی بدون اجرای سرور، Qdrant رو مستقیم در کدت استفاده کنی:\npip install qdrant-client و بعد توی کد پایتون:\nfrom qdrant_client import QdrantClient # حالت Local — بدون نیاز به سرور! client = QdrantClient(\u0026#34;:memory:\u0026#34;) # یا با مسیر مشخص client = QdrantClient(path=\u0026#34;/tmp/my_qdrant_db\u0026#34;) 🚀 شروع سریع (Quick Start) — بعد از نصب بعد از اینکه Qdrant رو اجرا کردی، می‌تونی با یه درخواست ساده REST API امتحانش کنی:\n# بررسی وضعیت سرور curl http://localhost:633 و برای استفاده در پایتون:\nfrom qdrant_client import QdrantClient from qdrant_client.http.models import Distance, VectorParams client = QdrantClient(\u0026#34;http://localhost:633\u0026#34;) # ساخت یک Collection جدید client.create_collection( collection_name=\u0026#34;my_collection\u0026#34;, vectors_config=VectorParams(size=128, distance=Distance.COSINE), ) # اضافه کردن چند نقطه (Point) client.upsert( collection_name=\u0026#34;my_collection\u0026#34;, points=[ {\u0026#34;id\u0026#34;: 1, \u0026#34;vector\u0026#34;: [0.1]*128, \u0026#34;payload\u0026#34;: {\u0026#34;name\u0026#34;: \u0026#34;سند اول\u0026#34;}}, {\u0026#34;id\u0026#34;: 2, \u0026#34;vector\u0026#34;: [0.2]*128, \u0026#34;payload\u0026#34;: {\u0026#34;name\u0026#34;: \u0026#34;سند دوم\u0026#34;}}, ] ) 🧪 نکات مهم نکته توضیح 🔌 پورت‌ها پورت 633 برای REST API / پورت 6334 برای gRPC 💾 فضای ذخیره‌سازی نیاز به SSD یا NVMe — از NFS و S3 پشتیبانی نمی‌کنه 🖥️ Docker روی ویندوز مراقب مشکلات فایل‌سیستم در WSL باشید 🔐 امنیت پیش‌فرض بدون احراز هویت — حتماً برای پروداکشن امن کنید ☁️ ابر Qdrant Cloud هم سرویس رایگان داره 📚 جمع‌بندی Qdrant یک دیتابیس برداری مدرن، سریع و قدرتمنده که بهترین گزینه برای کارهای هوش مصنوعی، جستجوی معنایی و RAG هست. ساده‌ترین راه نصب استفاده از Docker هست که روی هر دو سیستم‌عامل لینوکس و ویندوز جواب میده. بعد از اجرا با docker run، فقط کافیه پورت 633 رو باز کنی و API آماده استفاده است.\n","permalink":"https://naturalai.ir/blog/posts/qdrant-install/","summary":"\u003ch2 id=\"qdrant-چیست\"\u003eQdrant چیست؟\u003c/h2\u003e\n\u003cp\u003eQdrant (تلفظ: \u003cem\u003eکادْرَنت\u003c/em\u003e) یک دیتابیس برداری (Vector Database) قدرتمند و متن‌باز (Open Source) است که به زبان Rust نوشته شده.\u003c/p\u003e\n\u003cp\u003eبه زبان ساده: توی دیتابیس‌های معمول مثل MySQL یا PostgreSQL، ما داده‌ها رو به صورت ردیف و ستون ذخیره می‌کنیم و بر اساس مقادیر اون‌ها جستجو می‌کنیم. اما Qdrant مخصوص ذخیره‌سازی بردارها (Vectors) ساخته شده — همون اعدادی که مدل‌های هوش مصنوعی (مثل ChatGPT یا مدل‌های embedding) تولید می‌کنند.\u003c/p\u003e","title":"معرفی و آموزش نصب دیتابیس Qdrant"},{"content":"Zoo Code چیه و چرا باید استفاده کنیم؟ Zoo Code یه افزونه قدرتمند و متن‌باز برای VS Code هست که به شما امکان میده با هوش مصنوعی مستقیماً توی محیط کدنویسی‌تون تعامل داشته باشید. برخلاف چت‌های معمولی، Zoo Code میتونه کل پروژه شما رو بخونه، ویرایش کنه و به عنوان یه دستیار هوشمند کنار شما باشه.\nتوی این مقاله، قدم‌به‌قدم یاد می‌گیرید چطور Zoo Code رو به Natural AI وصل کنید و از قابلیت‌های پیشرفته‌ش استفاده کنید.\nپیش‌نیاز: Zoo Code یه افزونه برای VS Code هست، پس اول باید VS Code رو روی سیستم‌تون نصب داشته باشید. اگه هنوز نصب نکردین، نگران نباشید — مقاله راهنمای نصب VS Code روی ویندوز، لینوکس و مک رو ببینید و بعد برگردین اینجا. 😊\nقبل از شروع: برای دنبال کردن این آموزش، اول باید از Natural AI یه کلید API (API Key) بگیرید. کافیه وارد سایت بشید، برید بخش تنظیمات و کلید خودتون رو دریافت کنید. این کلید مثل رمز عبور برای ارتباط با سرویس هست.\n۱. نصب Zoo Code توی VS Code خیلی ساده‌ست: VS Code رو باز کنید. از منوی سمت چپ، روی آیکون Extensions (چهارتا مربع) کلیک کنید. توی کادر جستجو، بنویسید Zoo Code. اولین نتیجه که توسط Zoo Team منتشر شده رو انتخاب کنید. روی دکمه Install (نصب) کلیک کنید. 🎉 تمام! حالا Zoo Code نصب شده و توی نوار کناری VS Code یه آیکون جدید (شبیه زرافه 🦒) می‌بینید.\n۲. تنظیمات اولیه و اتصال به Natural AI بعد از نصب، باید Zoo Code رو به یه پروایدر هوش مصنوعی وصل کنید. اینجا ما Natural AI رو انتخاب می‌کنیم. مرحله ۱: باز کردن تنظیمات روی آیکون Zoo Code (زرافه 🦒) توی نوار کناری کلیک کنید. یه صفحه چت باز میشه. توی بالای صفحه چت، یه آیکون چرخ‌دنده (تنظیمات) هست. روش کلیک کنید. مرحله ۲: اضافه کردن پروایدر جدید توی صفحه تنظیمات، برید به بخش Providers. روی دکمه Add Provider (اضافه کردن پروایدر) کلیک کنید. یه لیست از انواع اتصالات می‌بینید. معروف‌ترین‌شون OpenAI Compatible هست. اون رو انتخاب کنید. مرحله ۳: تنظیم اتصال Natural AI حالا باید اطلاعات سرویس رو وارد کنید: فیلد مقدار مورد نظر Name هر اسمی مثل \u0026ldquo;Natural AI\u0026rdquo; Base URL https://naturalai.ir/api/v1 API Key کلیدی که از Natural AI گرفتید Model بعد از وارد کردن API Key، لیست مدل‌ها لود میشه. یکی رو انتخاب کنید (مثلاً Qwen یا DeepSeek) نکته مهم: فیلد Base URL رو دقیقاً به این شکل وارد کنید: https://naturalai.ir/api/v1\nمرحله ۴: تنظیمات اضافی پایین صفحه یه سری تنظیمات دیگه هست مثل:\nStream response (پاسخ‌های زنده): بذارید روشن باشه Enable thinking (تفکر عمیق): برای شروع نیاز نیست فعلاً اینا رو دست نزنید و با پیش‌فرض بمونید.\nمرحله ۵: ذخیره و شروع مکالمه روی Save کلیک کنید. حالا برمی‌گردید پایین صفحه. یه قسمت به اسم Model می‌بینید که مدل انتخابی شما اونجاست. توی کادر چت، هر سوالی بپرسید! ایجنت جواب میده و حتی میتونه کد اجرا کنه. ✅ اتصال شما برقرار شد! حالا می‌تونید از هوش مصنوعی توی محیط کدنویسی استفاده کنید.\n۳. کار پیشرفته‌تر: Index کردن پروژه (جستجوی هوشمند توی کدها) این قابلیت به Zoo Code اجازه میده کل پروژه شما رو بخونه، بفهمه و توی یه پایگاه داده برداری ذخیره کنه. نتیجه‌ش چی میشه؟\nچرا باید پروژه رو Index کنیم؟ مزایای Index کردن پروژه:\nپروژه جدید پروژه بزرگ (قدیمی) • ایجنت میتونه ساختار پروژه رو از اول بفهمه • باگ‌ها رو سریع‌تر پیدا می‌کنه • کدهای تکراری نمی‌نویسه • کدهای قدیمی رو می‌فهمه و توسعه می‌ده • معماری بهتری پیشنهاد می‌ده • مستندات خودکار تولید می‌کنه • خطاهای ابتدایی رو می‌گیره • وابستگی‌ها و ارتباط بین فایل‌ها رو می‌فهمه نصب Qdrant (پایگاه داده برداری) برای Index کردن، Zoo Code از Qdrant استفاده می‌کنه. Qdrant یه دیتابیس برداری (Vector Database) هست که اطلاعات پروژه رو به صورت برداری ذخیره می‌کنه.\nروش نصبش رو می‌تونید از اینجا ببینید Qdrant: https://naturalai.ir/blog/posts/qdrant-install/ برای این آموزش، فرض می‌کنیم Qdrant روی سیستم شما نصب و اجراس. تنظیم اتصال به Qdrant و Index کردن مرحله ۱: رفتن به بخش دیتابیس پایین صفحه چت Zoo Code، یه دکمه به اسم Database هست. روش کلیک کنید. مرحله ۲: راه‌اندازی اتصال روی دکمه Setup کلیک کنید. مثل دفعه قبل، OpenAI Compatible رو انتخاب کنید. مرحله ۳: تنظیم مدل Embedding این بار تنظیمات کمی فرق داره: فیلد مقدار مورد نظر Base URL https://naturalai.ir/api/v1 (همون آدرس قبلی) API Key همون کلید Natural AI Model bge-m3 Model Dimensions 1024 توضیح کوتاه درباره bge-m3: این یه مدل Embedding (جاسازی) هست که توسط شرکت BAAI ساخته شده. کارش اینه که متن و کد رو به بردارهای عددی تبدیل کنه تا کامپیوتر بتونه \u0026ldquo;معنی\u0026rdquo; کدها رو بفهمه. عدد 1024 یعنی هر تکه از کد شما به یه بردار ۱۰۲۴تایی تبدیل میشه. هرچه این عدد بزرگتر باشه، دقت بیشتری داره.\nمرحله ۴: تنظیم آدرس Qdrant - توی بخش Qdrant URL، آدرس دیتابیس محلی رو وارد کنید. معمولاً این آدرس پیش‌فرض هست: http://localhost:6333 مرحله ۵: ذخیره و شروع Index 1. روی Save کلیک کنید. حالا دکمه Start Indexing رو بزنید. منتظر بمونید تا Zoo Code پروژه شما رو بخونه و Index کنه. این کار ممکنه چند دقیقه طول بکشه (به حجم پروژه بستگی داره). علامت موفقیت اگه همه چیز خوب پیش بره:\nبالای بخش دیتابیس، یه دایره سبز رنگ ظاهر میشه. 🌟 یعنی پروژه شما با موفقیت Index شده و آماده استفاده هوشمنده. نکته جالب: از این به بعد، هر تغییری توی پروژه بدید، Zoo Code خودکار Index رو به‌روز می‌کنه. نیاز به کار اضافه ندارید.\n۴. ایجنت‌های کدنویسی Zoo Code چجوری کار می‌کنن؟ Zoo Code فقط یه چت ساده نیست. این ابزار از ایجنت‌های تخصصی (Modes) استفاده می‌کنه که هرکدوم برای یه کار خاص طراحی شدن:\nحالت‌های مختلف ایجنت: حالت (Mode) کاربرد مثال Code Mode 🤖 کدنویسی روزمره، اضافه کردن قابلیت‌ها، رفع باگ‌های ساده \u0026ldquo;یه تابع برای اعتبارسنجی ایمیل به پروژه اضافه کن\u0026rdquo; Architect Mode 🏗️ طراحی معماری، مهاجرت، تصمیم‌گیری فنی \u0026ldquo;بهترین ساختار دیتابیس برای پروژه من چیه؟\u0026rdquo; Ask Mode 💬 سوالات عمومی، توضیح کد، مستندات \u0026ldquo;این تابع چه کاری انجام میده؟\u0026rdquo; Debug Mode 🐛 پیدا کردن ریشه باگ‌ها، بررسی خطاهای پیچیده \u0026ldquo;چرا این خطا توی لاگ میاد؟\u0026rdquo; چطور از ایجنت‌ها استفاده کنیم؟ توی صفحه چت، بالای کادر متن، یه منوی کشویی می‌بینید که Code نوشته (حالت پیش‌فرض). روش کلیک کنید و حالت مورد نظر رو انتخاب کنید. حالا هر چی توی کادر بنویسید، ایجنت همون نقش رو بازی می‌کنه. مثال عملی: فرض کنید باگ دارید. حالت رو بذارید روی Debug Mode و بگید: \u0026ldquo;برنامه موقع ثبت‌نام کرش می‌کنه. کمکم کن ریشه مشکل رو پیدا کنم.\u0026rdquo; ایجنت کل پروژه Index شده رو بررسی می‌کنه و جواب دقیق میده.\nجمع‌بندی و نکات نهایی ✅ کاری که توی این مقاله انجام دادیم:\nZoo Code رو توی VS Code نصب کردیم. Natural AI رو به عنوان پروایدر تنظیم کردیم. پروژه رو با استفاده از bge-m3 و Qdrant Index کردیم. با حالت‌های مختلف ایجنت‌ها آشنا شدیم. حالا دیگه می‌تونید مثل یه برنامه‌نویس حرفه‌ای، با دستیار هوشمند خودتون کد بزنید، باگ پیدا کنید و مستندات بنویسید. 🚀\nبرای گرفتن API Key از Natural AI: کافیه برید سایت Natural AI، ثبت‌نام کنید و از بخش تنظیمات (Dashboard/Settings) کلید API خودتون رو بگیرید. با این کلید می‌تونید به ده‌ها مدل هوش مصنوعی معروف دسترسی داشته باشید.\nشما میتوانید لیست مدلها را از اینجا ببینید. پیشنهاد میکنیم برای شروع از مدلهای ارزان قیمتی مثل deepseek استفاده کنید و میزان مصرف را مدیریت کنید.\n","permalink":"https://naturalai.ir/blog/posts/zoo-code-install/","summary":"\u003ch2 id=\"zoo-code-چیه-و-چرا-باید-استفاده-کنیم\"\u003eZoo Code چیه و چرا باید استفاده کنیم؟\u003c/h2\u003e\n\u003cp\u003eZoo Code یه افزونه قدرتمند و \u003cstrong\u003eمتن‌باز\u003c/strong\u003e برای VS Code هست که به شما امکان میده با هوش مصنوعی مستقیماً توی محیط کدنویسی‌تون تعامل داشته باشید. برخلاف چت‌های معمولی، Zoo Code میتونه کل پروژه شما رو بخونه، ویرایش کنه و به عنوان یه دستیار هوشمند کنار شما باشه.\u003c/p\u003e\n\u003cp\u003eتوی این مقاله، قدم‌به‌قدم یاد می‌گیرید چطور Zoo Code رو به \u003cstrong\u003eNatural AI\u003c/strong\u003e وصل کنید و از قابلیت‌های پیشرفته‌ش استفاده کنید.\u003c/p\u003e","title":"معرفی و آموزش راه اندازی دستیار برنامه نویسی Zoo Code"},{"content":"شرکت Anthropic روز جمعه از مدل جدید خود به نام Opus 5 رونمایی کرد؛ جدیدترین نسخه از مدل سنگین‌وزن و محبوب این شرکت. اگرچه Opus 5 از مدل Fable 5 کوچک‌تر است، اما هم قیمت پایین‌تری دارد و هم محدودیت‌های کمتری اعمال می‌کند؛ به همین خاطر احتمالاً در بیشتر موارد، انتخاب اول کاربران خواهد بود.\nنکته جالب اینجاست که Opus 5 در برخی از معیارهای سنجش عملکرد که در این اطلاعیه منتشر شده، حتی از Fable 5 هم بهتر عمل کرده است.\nجایگاه Opus 5 در خانواده مدل‌های سری ۵ عرضه Opus 5 تنها دو ماه پس از انتشار Opus 4.8 (که ۲۸ اردیبهشت ماه در دسترس قرار گرفت) انجام می‌شود. از طرفی، مدل‌های Mythos 5، Fable 5 و Sonnet 5 همگی در خرداد ماه عرضه شدند و حالا تنها مدل سبک‌وزن Haiku است که هنوز به سری ۵ ارتقا پیدا نکرده و منتظر به‌روزرسانی است.\nقابلیت راستی‌آزمایی و تکرار گام‌به‌گام Anthropic در پست معرفی این مدل تأکید کرده که Opus 5 «در راستی‌آزمایی کار خود و تکرار گام‌به‌گام تا رسیدن به نتیجه مطلوب، بسیار توانمندتر شده است». به عنوان مثال، در آزمایش‌های انجام‌شده، Opus 5 با دریافت یک راهنمای ناقص، موفق شد یک خط لوله کامل پردازش تصویر (بینایی کامپیوتری) را از صفر بنویسد.\nمحدودیت‌های کمتر نسبت به Fable 5 نکته بسیار مهم دیگر این است که Opus 5 از بسیاری از محدودیت‌هایی که از زمان عرضه، گریبانگیر Fable بوده، رها شده است. مشابه نسل قبلی خود، سیاست نگهداری ۳۰ روزه داده‌ها که برای Fable و Mythos اعمال می‌شود، شامل Opus 5 نمی‌شود. این سیاست پیشتر نگرانی کاربرانی را که به حریم خصوصی خود حساس بودند، برانگیخته بود.\nمحدودیت‌های امنیت سایبری البته همچنان محدودیت‌های قابل توجهی برای Opus 5 در نظر گرفته شده، به ویژه در حوزه امنیت سایبری و کارهایی مثل تولید بدافزار (اکسپلویت) یا تست نفوذ. مثلاً محافظت‌های Opus 5 مانع از اسکن آسیب‌پذیری‌ها در فایل‌های باینری نرم‌افزاری می‌شود، اما جستجوی آسیب‌پذیری در کد منبع مجاز است، چون احتمال بیشتری دارد که با هدف دفاعی انجام شود.\nبه طور کلی، Anthropic پیش‌بینی می‌کند که این دسته‌بندی‌های امنیتی برای Opus 5 حدود ۸۵ درصد کمتر از Fable 5 فعال شوند. این خود نشان می‌دهد که شرکت برای مدل کم‌توان‌تر، رویکرد سهل‌گیرانه‌تری در پیش گرفته است.\nویژگی بازگشت خودکار (Automatic Fallbacks) علاوه بر این، Anthropic ابزاری جدید را معرفی کرده تا وقتی این محافظت‌ها فعال می‌شوند، اختلال کمتری ایجاد کنند. کاربران می‌توانند یک ویژگی آزمایشی (بتا) به نام «بازگشت خودکار» (Automatic Fallbacks) را فعال کنند. با این کار، اگر یک درخواست (پرامپت) دسته‌بندی ایمنی را فعال کند، سیستم به طور خودکار آن را به یک مدل کم‌توان‌تر ارسال می‌کند. نتیجه این می‌شود که کاربران API که این گزینه را فعال کرده‌اند، به جای دریافت پیام خطا، یک پاسخ عملی دریافت می‌کنند.\n","permalink":"https://naturalai.ir/blog/posts/opus-5-launch/","summary":"\u003cp\u003eشرکت Anthropic روز جمعه از مدل جدید خود به نام \u003cstrong\u003eOpus 5\u003c/strong\u003e رونمایی کرد؛ جدیدترین نسخه از مدل سنگین‌وزن و محبوب این شرکت. اگرچه Opus 5 از مدل Fable 5 کوچک‌تر است، اما هم قیمت پایین‌تری دارد و هم محدودیت‌های کمتری اعمال می‌کند؛ به همین خاطر احتمالاً در بیشتر موارد، انتخاب اول کاربران خواهد بود.\u003c/p\u003e\n\u003cp\u003eنکته جالب اینجاست که Opus 5 در برخی از معیارهای سنجش عملکرد که در این اطلاعیه منتشر شده، حتی از \u003cstrong\u003eFable 5\u003c/strong\u003e هم بهتر عمل کرده است.\u003c/p\u003e","title":"عرضه Opus 5: مدل جدید Anthropic با محدودیت‌های کمتر و قیمت پایین‌تر"},{"content":"مقدمه تصور کنید یک دستیار دارید که فقط حرف نمی‌زند؛ می‌تواند اسنادتان را بخواند، به دیتابیس شرکت وصل شود، در Jira تسک ثبت کند، و حتی از طرف شما ایمیلی بفرستد. Natural AI دقیقاً همین کار را می‌کند.\nچت‌بات‌های هوش مصنوعی امروز از یک «صفحه گفتگو» ساده فراتر رفته‌اند. در این مقاله، با قابلیت‌های Natural AI آشنا می‌شوید و می‌بینید چطور می‌تواند فرآیندهای سازمان شما را متحول کند.\nبخش ۱: چت‌بات معمولی نیست در Natural AI، چت‌بات فقط پاسخ نمی‌دهد؛ فکر می‌کند، جستجو می‌کند، و عمل انجام می‌دهد.\n۱.۱ گفتگوی تعاملی با Stream پاسخ کلمه‌به‌کلمه می‌آید و می‌توانید لحظه به لحظه ببینید مدل چطور به جواب می‌رسد. این قابلیت برای دیباگ و تصحیح به‌موقع بسیار مفید است.\n۱.۲ تفکر عمیق (Deep Thinking) وقتی سوال پیچیده‌ای دارید، نیازی نیست چندبار سوال را عوض کنید. Natural AI می‌تواند قبل از پاسخ، یک زنجیره استدلال داخلی (Chain-of-Thought) تولید کند و بعد جواب نهایی را بدهد. برای معماری نرم‌افزار، تحلیل مالی، و مسائل چندمرحله‌ای عالی است.\n۱.۳ خروجی غنی چت‌بات فقط متن ساده تولید نمی‌کند. می‌تواند:\nنمودار Mermaid بکشد (فلوچارت، C4 معماری، نمودار توالی) کد با Syntax Highlight بنویسد جدول‌های Markdown تولید کند و حتی ADR (سند تصمیم‌گیری معماری) کامل با ساختار استاندارد خروجی بدهد بخش ۲: پایگاه دانش؛ وقتی ربات کتابخانه شما را می‌شناسد یکی از قوی‌ترین ویژگی‌های Natural AI، پایگاه دانش (Knowledge Base) است. این یعنی چت‌بات شما فقط بر اساس اطلاعات عمومی پاسخ نمی‌دهد؛ بلکه می‌تواند:\nفایل‌های PDF، Word، Excel، JSON را پردازش کند پاسخ با استناد بدهد (یعنی منبع دقیق جواب را نشان دهد) بر اساس محتوای سازمان شما جواب بدهد، نه حدس مدل مثال کاربردی: فرض کنید کاتالوگ محصولات، سیاست مرجوعی، و قوانین داخلی شرکت را در پایگاه دانش آپلود کرده‌اید. تیم پشتیبانی می‌تواند سوال کند: «آیا کفش سایز ۴۲ موجود است؟» و ربات دقیقاً از JSON محصولات جواب می‌دهد، نه اینکه حدس بزند.\nامکان اشتراک‌گذاری پایگاه دانش با همکاران هم وجود دارد—یک پایگاه، برای کل تیم.\nبخش ۳: سرورهای MCP؛ پل ارتباطی به دنیای بیرون MCP (Model Context Protocol) جایی است که چت‌بات تبدیل به دستیار عملیاتی می‌شود. Natural AI می‌تواند به سرویس‌های خارجی متصل شود:\nJira: تسک‌های من را نشان بده، یک issue جدید ایجاد کن GitHub: آخرین Pull Requestها را لیست کن پایگاه داده: فروش دیروز را به تفکیک شهر گزارش بده APIهای داخلی: وضعیت سرور را چک کن Spotify: یک پلی‌لیست انرژیک برای ورزش بساز نکته امنیتی مهم: اجرای ابزارها روی سرور انجام می‌شود، نه در مرورگر کاربر. شما می‌توانید برای هر فراخوانی، تأیید دستی بخواهید یا به مدل «اجازه به همه در این گفتگو» بدهید.\nبخش ۴: مدل‌های شخصی؛ دستیار اختصاصی خودت این قابلیت شاید قوی‌ترین و منحصربه‌فردترین ویژگی Natural AI باشد. شما می‌توانید یک مدل شخصی (Custom Model) بسازید که ترکیبی است از:\nیک مدل پایه OpenAI (مثلاً GPT-4 یا Claude) یک پایگاه دانش (RAG) چند سرور MCP یک پرامپت سیستم ثابت مثال: فرض کنید می‌خواهید یک دستیار فروش داشته باشید. یک مدل شخصی به نام sales-assistant می‌سازید، به آن پایگاه دانش کاتالوگ محصولات و MCP متصل به CRM را می‌دهید، و پرامپت می‌نویسید: «فقط فارسی جواب بده و همیشه تخفیف‌های فعال را در پاسخ ذکر کن.»\nبعد در API فقط model: \u0026quot;sales-assistant\u0026quot; را می‌فرستید و همه تنظیمات خودکار اعمال می‌شود.\nبخش ۵: API سازگار با OpenAI Natural AI کاملاً با استاندارد OpenAI سازگار است. یعنی اگر قبلاً با OpenAI کار کرده‌اید، فقط کافیست:\nimport openai client = openai.OpenAI( base_url=\u0026#34;https://your-domain.com/api/v1\u0026#34;, api_key=\u0026#34;wp_your_key\u0026#34; ) و تمام قابلیت‌های RAG، MCP، و مدل شخصی شما از طریق API در دسترس است. این یعنی می‌توانید Natural AI را در:\nاپلیکیشن موبایل خود ربات تلگرام ویجت چت سایت و هر سرویس دیگری Embed کنید. بخش ۶: اتصال به Agentهای برنامه‌نویسی یک قابلیت جذاب دیگر: Natural AI را می‌توانید به Cursor، Continue، Android Studio و سایر IDEها وصل کنید. یعنی مدل‌ها و MCPهای شخصی‌سازی‌شده‌تان را مستقیماً در محیط توسعه استفاده کنید.\nسناریوهای واقعی در یک نگاه سناریو ترکیب نتیجه پشتیبانی فروشگاه پایگاه دانش + چت پاسخ دقیق به سوالات مشتری با استناد به کاتالوگ مدیریت پروژه MCP + Jira + چت مشاهده و ایجاد تسک با زبان طبیعی تحلیل داده MCP + SQL + API گزارش فروش بدون نیاز به Dashboard مهاجرت از OpenAI API سازگار تغییر فقط base URL و کلید توسعه نرم‌افزار مدل شخصی + MCP + Agent IDE دستیار کدنویسی اختصاصی جمع‌بندی Natural AI یک چت‌بات ساده نیست. یک پلتفرم یکپارچه هوش مصنوعی است که:\nگفتگو، دانش، و عمل را در یک جا جمع کرده با استاندارد باز (OpenAI API, MCP) ساخته شده هم در مرورگر و هم در API و هم در IDE قابل استفاده است و مهم‌تر از همه، شما می‌توانید آن را دقیقاً مطابق نیاز خود شخصی‌سازی کنید راهنمای بخش‌های مختلف اپ Natural AI حالا که مقاله را خواندید، بیایید ببینیم در پنل Natural AI خودتان دقیقاً هر بخش چه قابلیت‌هایی دارد:\n۱. چت‌بات (بخش اصلی گفتگو) ویژگی قابلیت نوار ورودی شامل دکمه‌های انتخاب مدل، فعال‌سازی پایگاه دانش، MCP، تفکر عمیق، پیوست فایل تاریخچه ذخیره خودکار مکالمات، جستجو در متن گفتگوها، دسته‌بندی با رنگ پاسخ غنی نمودار Mermaid، کد با Syntax Highlight، جدول، ADR تفکر عمیق فعال‌سازی با شدت کم تا خیلی زیاد دسترسی به اینترنت جستجوی وب در لحظه برای اطلاعات به‌روز پیوست تصویر، PDF، Word، Excel کاربرد: ایده‌پردازی، تحلیل اسناد، کدنویسی، دیباگ، ترجمه، و هر چیزی که نیاز به یک مکالمه هوشمند دارید.\n۲. دستیارها (آماده و از پیش تنظیم شده) دستیار کاربرد دستیار موسیقی پخش پلی‌لیست و آهنگ طلا و دلار قیمت لحظه‌ای و تحلیل روند بورس تحلیل نمادها و سیگنال کریپتو قیمت ارزهای دیجیتال برنامه‌نویس حرفه‌ای نوشتن و رفع اشکال کد کاربرد: بدون نیاز به تنظیم، یک دستیار تخصصی برای کارهای مشخص دارید.\n۳. پایگاه دانش (RAG) قابلیت توضیح آپلود فایل PDF, Word, Excel, JSON, TXT پردازش هوشمند پاراگراف‌بندی خودکار، embedding جستجوی معنایی پاسخ با استناد به منبع اشتراک‌گذاری دعوت همکاران با شماره موبایل Reference نمایش متن دقیق chunk استفاده شده کاربرد: FAQ فروشگاه، مستندات فنی، قوانین داخلی، کاتالوگ محصولات.\n۴. مدل‌های شخصی (Custom Models) فیلد توضیح نام مدل عنوان نمایشی (مثلاً «دستیار فروش») Model Tag شناسه API (مثلاً sales-assistant) مدل پایه یکی از مدل‌های OpenAI فعال پایگاه دانش اتصال به یک Knowledge Base سرورهای MCP انتخاب چند سرور همزمان پرامپت سیستم دستورالعمل ثابت (نقش، لحن، محدودیت) کاربرد: ترکیب همه قابلیت‌ها در یک مدل واحد و فراخوانی با یک model_tag در API.\n۵. سرورهای MCP (اتصال به دنیای بیرون) تنظیم توضیح Config JSON پیکربندی اتصال (URL, transport, headers) SSE / HTTP پشتیبانی از streamable HTTP و JSON-RPC تست ابزار اجرای ابزار با ورودی نمونه تأیید اجرا کاربر می‌تواند قبل از اجرا تأیید یا رد کند پل stdio اتصال به سرورهای محلی با ابزار mcp-proxy کاربرد: اتصال به Jira، GitHub، دیتابیس، APIهای داخلی، جستجوی وب، و هر سرویس دارای MCP.\n۶. API Endpoint توضیح POST /api/v1/chat/completions تولید متن با RAG, MCP, stream GET /api/v1/models لیست مدل‌ها و model_tagهای شخصی GET /api/v1/credit نمایش اعتبار فعلی کلید API کلید با پیشوند wp_... برای احراز هویت کاربرد: Embed کردن در اپ موبایل، ربات تلگرام، ویجت چت سایت، و هر سرویس دیگر.\n۷. هزینه و اعتبار بخش توضیح شارژ حساب انتخاب مبلغ و پرداخت از درگاه گزارش مصرف تاریخچه تراکنش‌ها (generate, embedding, شارژ) نرخ مدل‌ها از GET /api/v1/models جدول خلاصه: هر بخش اپ Natural AI چه کاری برای شما می‌کند بخش یک خط توضیح چت‌بات جایی که همه چیز شروع می‌شود—آزمایش، تست، و اجرا دستیارها ربات‌های آماده برای کارهای مشخص بدون نیاز به تنظیم پایگاه دانش کتابخانه اختصاصی شما که ربات از آن جواب می‌دهد مدل‌های شخصی ترکیب سفارشی از مدل، دانش، ابزار، و دستورالعمل سرورهای MCP پل ارتباطی ربات به دنیای واقعی (API, DB, Jira\u0026hellip;) API پنجره برنامه‌نویسی به همه این قابلیت‌ها کلید API کلید امن برای اتصال سرویس‌های خارجی اعتبار کیف پول برای استفاده از سرویس شروع کار: جهت دسترسی به هوش مصنوعی Natural AI از اینجا، کار را شروع کنید.\n","permalink":"https://naturalai.ir/blog/posts/natural-ai-intro/","summary":"\u003ch2 id=\"مقدمه\"\u003eمقدمه\u003c/h2\u003e\n\u003cp\u003eتصور کنید یک دستیار دارید که فقط حرف نمی‌زند؛ می‌تواند اسنادتان را بخواند، به دیتابیس شرکت وصل شود، در Jira تسک ثبت کند، و حتی از طرف شما ایمیلی بفرستد. \u003cstrong\u003eNatural AI\u003c/strong\u003e دقیقاً همین کار را می‌کند.\u003c/p\u003e\n\u003cp\u003eچت‌بات‌های هوش مصنوعی امروز از یک «صفحه گفتگو» ساده فراتر رفته‌اند. در این مقاله، با قابلیت‌های Natural AI آشنا می‌شوید و می‌بینید چطور می‌تواند فرآیندهای سازمان شما را متحول کند.\u003c/p\u003e\n\u003chr\u003e\n\u003ch2 id=\"بخش-۱-چتبات-معمولی-نیست\"\u003eبخش ۱: چت‌بات معمولی نیست\u003c/h2\u003e\n\u003cp\u003eدر Natural AI، چت‌بات فقط پاسخ نمی‌دهد؛ فکر می‌کند، جستجو می‌کند، و عمل انجام می‌دهد.\u003c/p\u003e","title":"چت بات هوشمند Natural AI نچرال ای آی: از گفتگوی ساده تا دستیار عملیاتی سازمان"}]