چت با اسناد Nextcloud با هوش مصنوعی و LangChain

چت تعاملی با اسناد از طریق هوش مصنوعی با استفاده از فایل‌های Nextcloud

این گردش کار امکان پرس‌وجوهای تعاملی مبتنی بر هوش مصنوعی را بر روی اسناد ذخیره شده در پوشه‌های Nextcloud شما فراهم می‌کند. این گردش کار از عوامل هوش مصنوعی LangChain و مدل‌های زبان OpenAI برای ارائه پاسخ‌های متنی بر اساس محتوای فایل‌ها، که به صورت پویا از فضای ذخیره‌سازی Nextcloud شما دریافت و پردازش می‌شوند، بهره می‌برد.

ویژگی‌های کلیدی:

• پرس‌وجوی تعاملی اسناد: مستقیماً در مورد محتوای اسناد خود سؤال بپرسید.
• پشتیبانی از فرمت‌های چندگانه: فایل‌های PDF، Markdown و DOCX را پردازش می‌کند.
• یکپارچه‌سازی با Nextcloud: فایل‌ها را به طور یکپارچه از پوشه‌های مشخص شده Nextcloud دریافت می‌کند.
• خلاصه‌سازی با کمک هوش مصنوعی: خلاصه‌های دقیقی از محتوای اسناد خود دریافت کنید.

موارد استفاده:

• ایجاد یک رابط مکالمه‌ای برای مخزن اسناد Nextcloud خود.
• خودکارسازی استخراج و تجمیع محتوای اسناد برای تحلیل هوش مصنوعی.
• ایجاد یک دستیار هوش مصنوعی که می‌تواند بر اساس فضای ذخیره‌سازی فایل‌های خصوصی شما به سؤالات پاسخ دهد.

---

تشریح گردش کار (Workflow Breakdown)

این گردش کار به چندین بلوک منطقی تقسیم شده است که هر کدام مسئول بخشی خاص از فرآیند چت اسناد با هوش مصنوعی هستند.

۱. دریافت ورودی چت

این بلوک به پیام‌های ورودی چت گوش می‌دهد و به عنوان نقطه ورود برای پرس‌وجوهای کاربر عمل می‌کند.

• Node: When chat message received (LangChain Chat Trigger)

* Function: به عنوان یک شنونده وب‌هوک (webhook listener) برای دریافت پیام‌های چت خارجی عمل می‌کند.

* Configuration:

* یک وب‌هوک عمومی برای دریافت پیام‌ها راه‌اندازی می‌شود.

* یک پیام خوش‌آمدگویی اولیه: "سلام! 👋 اسم من یوهان است. چطور می‌توانم به شما کمک کنم؟" پیکربندی شده است.

* Input: پیام چت دریافتی از طریق وب‌هوک.

* Output: پیام دریافتی را برای پردازش به AI Agent ارسال می‌کند.

* Edge Cases: در دسترس نبودن وب‌هوک، پیام‌های ورودی نامعتبر.

۲. راه‌اندازی AI Agent

این بلوک اجزای اصلی هوش مصنوعی، از جمله مدل زبان، حافظه مکالمه و ابزار سفارشی برای تعامل با Nextcloud را پیکربندی می‌کند.

• Nodes:

* OpenAI Chat Model (LangChain OpenAI Chat Model)

* Function: مدل زبان هوش مصنوعی را برای تولید پاسخ‌ها فراهم می‌کند.

* Configuration: از مدل سفارشی "qwen3-235b-a22b" استفاده می‌کند.

* Credentials: به کلید API OpenAI شما نیاز دارد.

* Input: پیام‌های چت از گره When chat message received.

* Output: پاسخ‌ها را به عامل AI Nextcloud ارسال می‌کند.

* Edge Cases: خرابی احراز هویت API، محدودیت‌های نرخ، نام مدل نامعتبر.

* Simple Memory (LangChain Memory Buffer Window)

* Function: زمینه مکالمه را حفظ می‌کند و به هوش مصنوعی اجازه می‌دهد نوبت‌های قبلی چت را به خاطر بسپارد.

* Configuration: از تنظیمات پیش‌فرض استفاده می‌کند.

* Input: پیام‌های چت از OpenAI Chat Model.

* Output: زمینه مکالمه را به عامل AI Nextcloud ارسال می‌کند.

* Edge Cases: بارگذاری بیش از حد حافظه یا کوتاه شدن در مکالمات بسیار طولانی.

* AI Nextcloud (LangChain AI Agent)

* Function: پردازش هوش مصنوعی را هماهنگ می‌کند و مدل زبان، حافظه و ابزار Nextcloud را با هم مرتبط می‌سازد.

* Configuration: از گزینه‌های پیش‌فرض عامل استفاده می‌کند.

* Input: به OpenAI Chat Model، Simple Memory و Nextcloud Tool متصل است.

* Output: پاسخ نهایی تولید شده توسط هوش مصنوعی.

* Edge Cases: خرابی عامل در حین پردازش، خطا در هنگام فراخوانی ابزارها.

* Nextcloud Tool (LangChain Tool Workflow)

* Function: به عنوان ابزاری برای عامل هوش مصنوعی عمل می‌کند و به آن امکان خواندن فایل‌ها از Nextcloud را می‌دهد.

* Configuration: گردش کار فرعی nextcloud-folder را با پارامتر پویا path فراخوانی می‌کند.

* Input: مسیر پوشه ارائه شده توسط عامل AI Nextcloud.

* Output: محتوای فایل را به عامل AI Nextcloud بازمی‌گرداند.

* Edge Cases: مسیرهای پوشه نامعتبر، مشکلات اتصال API Nextcloud.

۳. بازیابی فایل Nextcloud (گردش کار فرعی)

این گردش کار فرعی مسئول دریافت فایل‌ها از پوشه مشخص شده Nextcloud، دانلود آن‌ها و آماده‌سازی برای استخراج محتوا است.

• Nodes:

* When Executed by Another Workflow (Execute Workflow Trigger)

* Function: نقطه ورود برای گردش کار فرعی، پذیرش پارامتر ورودی path (مسیر پوشه Nextcloud).

* Input: پارامتر path.

* Output: مسیر را به گره test data ارسال می‌کند.

* Edge Cases: پارامترهای ورودی گمشده.

* test data (Code)

* Function: اطمینان حاصل می‌کند که در صورت عدم ارائه مسیر، از مسیر پیش‌فرض پوشه (/test/folder) استفاده می‌شود.

* Input: path از تریگر.

* Output: مسیر پوشه را به گره Get Files ارسال می‌کند.

* Edge Cases: path مقدار null یا undefined باشد.

* Get Files (Nextcloud Folder List)

* Function: تمام فایل‌های موجود در پوشه مشخص شده Nextcloud را لیست می‌کند.

* Credentials: به اطلاعات احراز هویت API Nextcloud شما نیاز دارد.

* Input: مسیر پوشه.

* Output: متادیتای هر فایل در پوشه.

* Edge Cases: مسیر نامعتبر، خرابی احراز هویت API، پوشه خالی.

* If readable (If Node)

* Function: فایل‌ها را فیلتر می‌کند و بررسی می‌کند که آیا نوع محتوای آن‌ها برای استخراج پشتیبانی می‌شود (PDF, Markdown, DOCX).

* Input: متادیتای فایل از Get Files.

* Output: فایل‌های پشتیبانی شده را به گره Download File هدایت می‌کند.

* Edge Cases: انواع فایل‌های پشتیبانی نشده فیلتر می‌شوند.

* Download File (Nextcloud Download)

* Function: محتوای فایل‌های قابل خواندن را دانلود می‌کند.

* Credentials: به اطلاعات احراز هویت API Nextcloud شما نیاز دارد.

* Input: مسیر فایل از If readable.

* Output: داده‌های فایل باینری را برای پردازش به گره Switch ارسال می‌کند.

* Edge Cases: فایل یافت نشد، خطاهای دانلود.

۴. پردازش نوع فایل

این بلوک استخراج محتوای متنی از انواع فایل‌های مختلف را مدیریت می‌کند.

• Nodes:

* Switch (Switch Node)

* Function: فایل‌های دانلود شده را بر اساس contentType آن‌ها به گره استخراج مناسب هدایت می‌کند.

* Input: داده‌های فایل دانلود شده.

* Output: فایل‌ها را به گره‌های استخراج PDF، Markdown یا DOCX هدایت می‌کند.

* Edge Cases: انواع محتوای ناشناخته ممکن است پردازش نشوند.

* PDF (Extract From File - PDF)

* Function: محتوای متنی را از فایل‌های PDF استخراج می‌کند.

* Input: فایل‌های PDF از گره Switch.

* Output: متن استخراج شده را به گره کد add path 1 ارسال می‌کند.

* Edge Cases: PDFهای خراب، خرابی استخراج.

* Markdown (Extract From File - Text)

* Function: متن ساده را از فایل‌های Markdown استخراج می‌کند.

* Input: فایل‌های Markdown از گره Switch.

* Output: متن استخراج شده را به گره کد add path 2 ارسال می‌کند.

* Edge Cases: سینتکس Markdown نامعتبر.

* DOCX (Word2Text - Community Node)

* Function: فایل‌های DOCX را به متن ساده تبدیل می‌کند.

* Input: فایل‌های DOCX از گره Switch.

* Output: متن استخراج شده را به گره کد add path 3 ارسال می‌کند.

* Edge Cases: نسخه‌های DOCX پشتیبانی نشده، خطاهای تبدیل.

* Note: این گره به بسته جامعه n8n-nodes-word2text نیاز دارد.

* add path 1, add path 2, add path 3 (Code Nodes)

* Function: مسیر پوشه اصلی را به داده‌های متن استخراج شده برای قابلیت ردیابی اضافه می‌کند.

* Input: موارد متن استخراج شده.

* Output: متن با مسیر افزوده شده را به گره Aggregate ارسال می‌کند.

* Edge Cases: اطلاعات مسیر گمشده در داده‌های ورودی.

۵. تجمیع و خروجی

این بلوک نهایی تمام محتوای فایل استخراج شده را تجمیع کرده و آن را به عنوان یک خروجی واحد برای عامل هوش مصنوعی آماده می‌کند.

• Nodes:

* Aggregate (Aggregate Node)

* Function: تمام محتوای فایل پردازش شده را در یک آرایه واحد ترکیب می‌کند.

* Input: داده‌های فایل استخراج شده و با مسیر افزوده شده از گره‌های add path.

* Output: یک شیء داده تجمیع شده واحد.

* Edge Cases: ورودی خالی منجر به تجمیع خالی می‌شود.

* output (Set Node)

* Function: داده‌های تجمیع شده را در یک فیلد خروجی نهایی به نام "output" قالب‌بندی می‌کند.

* Input: داده‌های تجمیع شده.

* Output: ساختار داده نهایی آماده برای عامل هوش مصنوعی یا استفاده خارجی.

* Edge Cases: مدیریت داده‌های null یا خالی.

---

جزئیات فنی

خلاصه نودها

نودهای جامعه مورد نیاز

• n8n-nodes-word2text

سرویس‌های خارجی

• OpenAI: برای پردازش مدل زبان.
• Nextcloud: برای ذخیره‌سازی و بازیابی فایل.

---

شروع کار

1. تنظیم اعتبارنامه‌ها:

* کلید API OpenAI خود را در گره OpenAI Chat Model پیکربندی کنید.

* اعتبارنامه‌های API Nextcloud خود را در گره‌های Nextcloud Folder List و Nextcloud Download پیکربندی کنید.

2. نصب گره‌های جامعه: بسته n8n-nodes-word2text را نصب کنید.

3. پیکربندی مسیر Nextcloud: در گره test data در زیر-Workflow، مسیر پیش‌فرض /test/folder را تنظیم کنید یا اطمینان حاصل کنید که هنگام فعال شدن زیر-Workflow، پارامتر path به درستی ارائه می‌شود.

4. فعال‌سازی Workflow: یک پیام چت را به URL Webhook ارائه شده توسط گره When chat message received ارسال کنید تا چت مبتنی بر هوش مصنوعی با اسناد آغاز شود.

---

گردش کارهای بیشتر n8n را در Axeto.ai کاوش کنید: https://axeto.ai/n8n