مقدمه

ساخت چت‌بات هوشمند با n8n

ساخت چت‌بات هوشمند با n8n: آموزش ساخت چت‌بات هوشمند برای جستجو و تحلیل اطلاعات Google Sheets با n8n و OpenAI

اگر حجم زیادی از اطلاعات مشتریان، محصولات، سفارش‌ها یا هر نوع داده دیگری را در Google Sheets نگهداری می‌کنید، احتمالاً بارها پیش آمده که برای پیدا کردن یک اطلاعات خاص مجبور شده باشید ده‌ها یا حتی صدها ردیف را به‌صورت دستی بررسی کنید. این کار علاوه بر اینکه زمان‌بر است، احتمال خطا را نیز افزایش می‌دهد؛ مخصوصاً زمانی که فایل‌های شما بزرگ‌تر شده و افراد مختلف به‌صورت هم‌زمان از آن‌ها استفاده می‌کنند.

در چنین شرایطی استفاده از هوش مصنوعی در کنار n8n می‌تواند روش کار با داده‌ها را کاملاً متحول کند. این Workflow با ترکیب OpenAI، Google Sheets و AI Agent این امکان را فراهم می‌کند که تنها با نوشتن یک سؤال به زبان طبیعی، اطلاعات موردنیاز خود را از داخل فایل Google Sheets استخراج کنید. به‌عنوان مثال می‌توانید از ربات بپرسید بزرگ‌ترین مشتری شما کدام است، یک مشتری خاص چه اطلاعاتی دارد، مقدار یک ستون برای تمام ردیف‌ها چیست یا حتی براساس داده‌های موجود تحلیل‌های ساده دریافت کنید.

در این Template، عامل هوشمند (AI Agent) به‌جای دریافت کل اطلاعات شیت، تنها داده‌های موردنیاز را از طریق ابزارهای اختصاصی (Tool Workflow) درخواست می‌کند. این روش علاوه بر افزایش سرعت پاسخ‌گویی، باعث کاهش مصرف توکن‌های مدل‌های هوش مصنوعی و بهبود عملکرد Workflow نیز می‌شود.

در این مقاله، تمام بخش‌های این Workflow را به‌صورت مرحله‌به‌مرحله بررسی می‌کنیم، عملکرد هر Node را توضیح می‌دهیم، نحوه شخصی‌سازی آن را آموزش می‌دهیم و رایج‌ترین خطاهای احتمالی را نیز بررسی خواهیم کرد تا بتوانید این Template را متناسب با نیاز خود توسعه دهید. کلمه کلیدی اصلی این مقاله، چت‌بات هوشمند Google Sheets در n8n است و در ادامه به‌صورت کامل نحوه پیاده‌سازی آن را یاد خواهید گرفت.

قبل از شروع

اگر هنوز n8n را نصب نکرده‌اید، پیشنهاد می‌کنیم ابتدا مقاله «آموزش n8n» را مطالعه کنید. در آن مقاله، مراحل نصب با Node.js و Docker، راه‌اندازی اولیه و ساخت اولین Workflow به‌صورت کامل آموزش داده شده است. پس از نصب و راه‌اندازی، به این مقاله بازگردید و مراحل پیاده‌سازی این Workflow را دنبال کنید.

این Workflow چه کاری انجام می‌دهد؟

ین Template با هدف ساخت چت‌بات هوشمند با n8n طراحی شده است و به کاربران اجازه می‌دهد اطلاعات موجود در Google Sheets را با زبان طبیعی جستجو و تحلیل کنند.

در این Workflow، ابتدا کاربر سؤال خود را از طریق Chat Trigger وارد می‌کند. سپس AI Agent سؤال را تحلیل کرده و تصمیم می‌گیرد برای پاسخ دادن به کدام ابزار نیاز دارد. این ابزارها اطلاعات موردنیاز را از Google Sheets استخراج کرده و نتیجه را دوباره در اختیار عامل هوشمند قرار می‌دهند. در نهایت، AI Agent پاسخ مناسب را به کاربر نمایش می‌دهد.

یکی از مهم‌ترین ویژگی‌های این Template این است که به‌جای ارسال کل فایل Google Sheets به مدل هوش مصنوعی، فقط اطلاعات موردنیاز را استخراج می‌کند. این موضوع باعث افزایش سرعت، کاهش هزینه استفاده از API و جلوگیری از ارسال داده‌های غیرضروری می‌شود. این ساختار در JSON Workflow نیز با استفاده از یک AI Agent، مدل OpenAI، سه Tool Workflow و یک Sub-workflow برای خواندن داده‌های Google Sheets پیاده‌سازی شده است.

ساخت چت‌بات هوشمند با n8n

کاربردهای این Workflow

این Template در سناریوهای مختلف قابل استفاده است، از جمله:

• جستجوی اطلاعات مشتریان از روی Google Sheets
• یافتن بزرگ‌ترین مشتری یا پرفروش‌ترین محصول
• پاسخ‌گویی هوشمند به سوالات کاربران درباره داده‌های ثبت‌شده
• ساخت دستیار داخلی برای تیم فروش یا پشتیبانی
• تحلیل سریع اطلاعات بدون نیاز به جستجوی دستی در فایل‌های اکسل
• بررسی مقادیر یک ستون خاص در میان تمام رکوردها
• مشاهده اطلاعات کامل یک ردیف مشخص
• استفاده به‌عنوان هسته اولیه سیستم‌های گزارش‌گیری مبتنی بر هوش مصنوعی

پیش‌نیازهای اجرای این Workflow

برای اجرای صحیح این Template به موارد زیر نیاز خواهید داشت:

فایل JSON این Workflow را از این قسمت دانلود کنید.

رمز فایل: danixai.com

آموزش Import کردن Workflow

• وارد داشبورد n8n شوید.
• روی Import from File کلیک کنید.
• فایل JSON را انتخاب کنید.
• Workflow ایجاد خواهد شد.
• Credentialهای موردنیاز را تنظیم کنید.

ساخت چت‌بات هوشمند با n8n

ساختار Workflow

Workflow موردنظر از دو بخش اصلی تشکیل شده است:

1. Workflow اصلی (Main Workflow) که وظیفه دریافت سؤال کاربر، تحلیل آن توسط هوش مصنوعی و انتخاب ابزار مناسب را بر عهده دارد.
2. Sub-workflow که مانند یک ابزار اختصاصی عمل می‌کند و داده‌های موردنیاز را از Google Sheets استخراج کرده و در اختیار AI Agent قرار می‌دهد. این ساختار باعث می‌شود مدل هوش مصنوعی به‌جای دریافت کل فایل، فقط اطلاعات موردنیاز را دریافت کند که هم سرعت اجرای Workflow را افزایش می‌دهد و هم هزینه استفاده از API را کاهش می‌دهد.

به‌صورت ساده، مسیر اجرای Workflow به شکل زیر است:

  Chat Trigger
        │
        ▼
OpenAI Chat Model
        │
        ▼
     AI Agent
        │
        ▼ 
List Columns Tool 
        │
        ▼
Execute Workflow Trigger
        │
        ▼
Set Google Sheet URL
        │
        ▼
Get Google Sheet Contents
        │
        ▼
Switch (Check Operation)
        │
        ▼
Get Column Names
Prepare Column Data
Filter
        │
        ▼
Prepare Output

آموزش کامل Nodeهای Workflow

1. Chat Trigger

وظیفه Node

این Node نقطه شروع Workflow اصلی است و پیام یا سؤال کاربر را دریافت می‌کند.

ورودی

سؤال کاربر

خروجی

متن سؤال برای ارسال به AI Agent

تنظیمات مهم

نیازی به تنظیمات پیچیده ندارد.

به‌صورت خودکار یک محیط گفتگو در n8n ایجاد می‌کند.

نکات قابل تغییر

می‌توانید آن را با Webhook، Telegram، Slack یا هر Trigger دیگری جایگزین کنید.

دلیل استفاده در Workflow

بدون این Node امکان دریافت درخواست کاربر وجود نخواهد داشت و کل فرآیند آغاز نمی‌شود.

2. OpenAI Chat Model

وظیفه Node

این Node مدل هوش مصنوعی مورد استفاده AI Agent را مشخص می‌کند.

در این Template از مدل GPT-3.5 Turbo با مقدار Temperature برابر صفر استفاده شده تا پاسخ‌ها کاملاً دقیق و قابل پیش‌بینی باشند.

ورودی

Prompt ارسال‌شده توسط AI Agent

خروجی

پاسخ مدل هوش مصنوعی

تنظیمات مهم

• انتخاب مدل
• Temperature
• API Credential

نکات قابل تغییر

• استفاده از GPT-4
• استفاده از مدل‌های جدید OpenAI
• تغییر Temperature برای افزایش یا کاهش خلاقیت

دلیل استفاده در Workflow

AI Agent بدون یک مدل زبانی قادر به تحلیل سؤال کاربر و تصمیم‌گیری نخواهد بود.

3. AI Agent

وظیفه Node

مهم‌ترین بخش این Workflow همین Node است.

AI Agent سؤال کاربر را تحلیل می‌کند، تصمیم می‌گیرد به کدام Tool نیاز دارد، داده‌ها را دریافت کرده و پاسخ نهایی را تولید می‌کند.

در Prompt این Agent مشخص شده که ابتدا ابزار List Columns را اجرا کند تا ساختار داده‌های Google Sheets را بشناسد و سپس بر اساس آن تصمیم بگیرد از کدام ابزار دیگر استفاده کند.

ورودی

سؤال کاربر

خروجی

پاسخ نهایی

تنظیمات مهم

• Agent Type
• Prompt
• اتصال مدل OpenAI
• اتصال Toolها

نکات قابل تغییر

• تغییر Prompt
• افزودن قوانین اختصاصی
• اضافه کردن Toolهای جدید
• محدود کردن نوع پاسخ‌ها

دلیل استفاده در Workflow

این Node مغز اصلی Workflow محسوب می‌شود و تمام تصمیمات هوشمند توسط آن انجام می‌شود.

4. List Columns Tool

وظیفه Node

این Tool لیست تمام ستون‌های Google Sheets را استخراج می‌کند.

AI Agent ابتدا با اجرای این ابزار متوجه می‌شود فایل شامل چه ستون‌هایی است؛ مانند Name، Country، Revenue، Email و سایر فیلدها.

ورودی

درخواست AI Agent

خروجی

نام تمام ستون‌ها

تنظیمات مهم

Operation = column_names

نکات قابل تغییر

• تغییر نام Tool
• تغییر توضیح Tool برای بهبود عملکرد Agent

دلیل استفاده در Workflow

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

5. Get Column Values Tool

وظیفه Node

این ابزار مقدار یک ستون مشخص را برای تمام ردیف‌ها برمی‌گرداند.

برای مثال اگر کاربر بپرسد:

درآمد تمام مشتریان را نمایش بده.

AI Agent از این Tool استفاده خواهد کرد.

ورودی

نام ستون

خروجی

مقدار همان ستون برای تمام رکوردها

تنظیمات مهم

Operation = column_values

نکات قابل تغییر

• تغییر توضیح Tool
• محدود کردن تعداد داده‌های بازگشتی

دلیل استفاده در Workflow

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

6. Get Customer Tool

وظیفه Node

این Tool اطلاعات کامل یک ردیف مشخص را از Google Sheets استخراج می‌کند.

اگر AI Agent شماره ردیف مشتری را بداند، تمام اطلاعات آن مشتری را از طریق این ابزار دریافت می‌کند.

ورودی

شماره ردیف (Row Number)

خروجی

تمام اطلاعات آن مشتری

تنظیمات مهم

Operation = row

نکات قابل تغییر

• تغییر نوع شناسه از Row Number به Customer ID
• اضافه کردن اعتبارسنجی روی شماره ردیف

دلیل استفاده در Workflow

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

7. Execute Workflow Trigger

وظیفه Node

این Node نقطه شروع Sub-workflow است.

هر زمان یکی از Toolها اجرا شود، این Node فعال شده و اطلاعات موردنیاز را از Workflow اصلی دریافت می‌کند.

ورودی

• Operation
• Query

خروجی

ارسال اطلاعات به مراحل بعدی

تنظیمات مهم

• نوع Trigger
• اتصال به Workflow اصلی

نکات قابل تغییر

• امکان استفاده در چند Workflow مختلف
• دریافت پارامترهای بیشتر

دلیل استفاده در Workflow

این Node ارتباط بین Workflow اصلی و Sub-workflow را برقرار می‌کند و امکان استفاده مجدد از منطق استخراج داده را برای چند Tool مختلف فراهم می‌سازد.

8. Set Google Sheet URL

وظیفه Node

این Node آدرس فایل Google Sheets را به Workflow اضافه می‌کند تا مراحل بعدی بدانند داده‌ها باید از کدام فایل خوانده شوند.

در این Template، لینک فایل Google Sheets به‌صورت یک مقدار ثابت در این Node قرار گرفته است و تمام درخواست‌ها از همین فایل خوانده می‌شوند.

ورودی

اطلاعات دریافت‌شده از Execute Workflow Trigger

خروجی

آدرس فایل Google Sheets

تنظیمات مهم

• تعیین Sheet URL
• تعیین Document URL

نکات قابل تغییر

• جایگزین کردن لینک Google Sheets با فایل خود
• دریافت آدرس فایل از Webhook یا Database
• انتخاب فایل‌های مختلف بر اساس نوع درخواست کاربر

دلیل استفاده در Workflow

تمرکز تنظیمات فایل در یک Node باعث می‌شود در صورت تغییر Google Sheet، تنها کافی باشد همین Node را ویرایش کنید.

9. Get Google Sheet Contents

وظیفه Node

این Node ارتباط مستقیم با Google Sheets را برقرار کرده و اطلاعات موردنیاز را دریافت می‌کند.

تمام داده‌هایی که AI Agent برای پاسخ‌گویی نیاز دارد، در نهایت توسط این Node خوانده می‌شوند.

ورودی

آدرس فایل Google Sheets

خروجی

تمام ردیف‌های موجود در Sheet

تنظیمات مهم

• انتخاب Credential گوگل
• انتخاب فایل
• انتخاب Sheet

نکات قابل تغییر

• خواندن چند Sheet مختلف
• محدود کردن تعداد ردیف‌ها
• اعمال فیلتر هنگام خواندن داده‌ها

دلیل استفاده در Workflow

این Node منبع اصلی داده‌های Workflow است و بدون آن امکان دسترسی به اطلاعات Google Sheets وجود نخواهد داشت.

10. Check Operation (Switch)

وظیفه Node

این Node مشخص می‌کند که بسته به درخواست AI Agent، کدام مسیر از Workflow اجرا شود.

در این Template سه مسیر مختلف تعریف شده است:

• دریافت نام ستون‌ها
• دریافت مقادیر یک ستون
• دریافت اطلاعات کامل یک ردیف

بر اساس مقدار پارامتر operation، Switch مسیر مناسب را انتخاب می‌کند.

ورودی

مقدار Operation

خروجی

هدایت داده‌ها به مسیر مناسب

تنظیمات مهم

• تعریف شرط‌ها
• تعیین خروجی هر شرط

نکات قابل تغییر

• اضافه کردن عملیات جدید
• تعریف شرط‌های بیشتر
• ایجاد مسیرهای اختصاصی

دلیل استفاده در Workflow

این Node باعث می‌شود چندین قابلیت مختلف تنها با یک Sub-workflow پیاده‌سازی شوند و نیازی به ساخت چند Workflow جداگانه نباشد.

11. Get Column Names (Set)

وظیفه Node

این Node نام تمام ستون‌های موجود در Google Sheets را استخراج می‌کند.

به‌جای خواندن دستی ساختار فایل، AI Agent از این Node متوجه می‌شود چه فیلدهایی در جدول وجود دارند.

ورودی

اولین ردیف فایل

خروجی

لیست ستون‌ها

تنظیمات مهم

استفاده از تابع استخراج کلیدهای JSON

نکات قابل تغییر

• حذف ستون‌های غیرضروری
• تغییر فرمت خروجی

دلیل استفاده در Workflow

شناخت ساختار جدول اولین مرحله برای پاسخ‌گویی صحیح AI Agent به پرسش‌های کاربران است.

12. Prepare Column Data (Set)

وظیفه Node

این Node زمانی استفاده می‌شود که AI Agent بخواهد مقادیر یک ستون خاص را دریافت کند.

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

ورودی

• داده‌های Google Sheets
• نام ستون انتخاب‌شده

خروجی

• مقدار همان ستون
• شماره ردیف

تنظیمات مهم

• انتخاب ستون به‌صورت داینامیک
• نگهداری Row Number

نکات قابل تغییر

• اضافه کردن ستون‌های بیشتر
• تغییر ساختار خروجی

دلیل استفاده در Workflow

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

13. Filter

وظیفه Node

این Node اطلاعات دریافتی را فیلتر می‌کند تا فقط رکورد موردنظر AI Agent باقی بماند.

اگر شماره ردیف ارسال شده باشد، این Node تنها همان ردیف را عبور می‌دهد.

ورودی

تمام داده‌های Google Sheets

خروجی

یک ردیف یا مجموعه محدودی از داده‌ها

تنظیمات مهم

• تعریف شرط فیلتر
• مقایسه Row Number

نکات قابل تغییر

• فیلتر بر اساس نام مشتری
• فیلتر بر اساس ایمیل
• فیلتر بر اساس کشور
• استفاده از چند شرط هم‌زمان

دلیل استفاده در Workflow

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

14. Prepare Output (Code)

وظیفه Node

این Node آخرین مرحله Sub-workflow است و خروجی را برای AI Agent آماده می‌کند.

در این مرحله، داده‌های استخراج‌شده به فرمت JSON تبدیل شده و به‌صورت یک پاسخ استاندارد به Workflow اصلی برگردانده می‌شوند.

ورودی

داده‌های پردازش‌شده

خروجی

خروجی نهایی JSON

تنظیمات مهم

• کد JavaScript
• ساختار خروجی

نکات قابل تغییر

• تغییر فرمت خروجی
• حذف فیلدهای اضافی
• افزودن اطلاعات تکمیلی
• تبدیل داده‌ها به قالب‌های دیگر

دلیل استفاده در Workflow

AI Agent باید داده‌ها را در قالبی استاندارد دریافت کند تا بتواند پاسخ نهایی را به‌درستی تولید کند.

نحوه شخصی‌سازی Workflow

یکی از ویژگی‌های مهم در ساخت چت‌بات هوشمند با n8n، امکان شخصی‌سازی کامل Agent، Promptها، مدل هوش مصنوعی و ابزارهای مورد استفاده است. در ادامه مهم‌ترین بخش‌هایی که قابلیت شخصی‌سازی دارند را بررسی می‌کنیم.

1. تغییر Promptهای AI Agent

Prompt مهم‌ترین بخش این Workflow است، زیرا مشخص می‌کند AI Agent چگونه سؤال کاربر را تحلیل کند و در چه شرایطی از هر Tool استفاده کند.

برای شخصی‌سازی Prompt می‌توانید:

• قوانین اختصاصی برای پاسخ‌گویی تعریف کنید.
• پاسخ‌ها را کوتاه‌تر یا کامل‌تر کنید.
• زبان پاسخ‌ها را تغییر دهید.
• محدودیت‌هایی برای AI Agent تعیین کنید.
• ترتیب استفاده از Toolها را تغییر دهید.

اگر قصد دارید این Workflow را در یک سازمان یا شرکت استفاده کنید، بهتر است اطلاعات مربوط به قوانین داخلی یا نحوه پاسخ‌گویی را نیز در Prompt اضافه کنید.

2. تغییر مدل هوش مصنوعی

در این Template از یکی از مدل‌های OpenAI استفاده شده است، اما محدود به همین مدل نیستید.

می‌توانید از مدل‌های مختلف استفاده کنید، مانند:

• GPT-4
• GPT-4.1
• GPT-4o
• مدل‌های سبک‌تر برای کاهش هزینه
• مدل‌های سریع‌تر برای پاسخ‌گویی آنی

هنگام انتخاب مدل، باید بین کیفیت پاسخ، سرعت اجرا و هزینه API تعادل برقرار کنید.

3. تغییر Google Sheets

در این Workflow آدرس فایل Google Sheets در یک Node جداگانه تنظیم شده است؛ بنابراین برای استفاده از فایل جدید، کافی است لینک Sheet را تغییر دهید.

همچنین می‌توانید:

• فایل دیگری را انتخاب کنید.
• Sheet متفاوتی را بخوانید.
• چند فایل مختلف را مدیریت کنید.
• فایل را به‌صورت پویا از کاربر دریافت کنید.

4. تغییر Credentialها

اگر قصد دارید Workflow را در محیط دیگری اجرا کنید، لازم است Credentialهای سرویس‌ها را مجدداً تنظیم کنید.

موارد قابل تغییر عبارت‌اند از:

• OpenAI API
• Google Sheets OAuth
• حساب Google

این کار باعث می‌شود Workflow بدون وابستگی به حساب قبلی اجرا شود.

5. تغییر Trigger

در نسخه فعلی، Workflow با استفاده از Chat Trigger آغاز می‌شود، اما در بسیاری از پروژه‌ها ممکن است نیاز داشته باشید فرآیند از مسیر دیگری شروع شود.

برای مثال می‌توانید Chat Trigger را با موارد زیر جایگزین کنید:

• Webhook
• Telegram Trigger
• Slack Trigger
• Discord Trigger
• فرم‌های آنلاین
• API اختصاصی
• Email Trigger

به این ترتیب کاربران می‌توانند از طریق کانال‌های مختلف با AI Agent ارتباط برقرار کنند.

6. افزودن Toolهای جدید

AI Agent تنها به سه Tool محدود نیست.

شما می‌توانید ابزارهای جدیدی اضافه کنید؛ مانند:

• جستجوی مشتری بر اساس ایمیل
• جستجو بر اساس شماره تماس
• محاسبه مجموع فروش
• محاسبه میانگین درآمد
• پیدا کردن بیشترین یا کمترین مقدار
• تولید گزارش‌های آماری
• ارسال اطلاعات به سیستم‌های دیگر

هر Tool جدید می‌تواند به‌صورت یک Sub-workflow مستقل پیاده‌سازی شود و در اختیار AI Agent قرار گیرد.

7. تغییر مسیر اجرای Workflow

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

برای مثال:

• بررسی وضعیت موجودی کالا
• مدیریت سفارش‌ها
• دریافت اطلاعات محصولات
• تحلیل فروش ماهانه
• جستجوی اطلاعات کارمندان

با اضافه کردن شرط‌های جدید در Node Switch، امکان توسعه Workflow بدون تغییر ساختار اصلی فراهم می‌شود.

8. تغییر ساختار خروجی

در انتهای Sub-workflow، خروجی توسط Node Prepare Output آماده می‌شود. در صورت نیاز می‌توانید ساختار داده‌های خروجی را تغییر دهید تا با سایر Workflowها یا سرویس‌های خارجی سازگار باشد.

برای مثال می‌توانید:

• فیلدهای اضافی را حذف کنید.
• اطلاعات بیشتری به خروجی اضافه کنید.
• قالب خروجی را تغییر دهید.
• داده‌ها را برای ارسال به APIهای دیگر آماده کنید.

ساخت چت‌بات هوشمند با n8n

مزایای استفاده از این Workflow

استفاده از این Template مزایای متعددی دارد که مهم‌ترین آن‌ها عبارت‌اند از:

• امکان جستجوی هوشمند اطلاعات بدون نیاز به بررسی دستی فایل‌های Google Sheets
• کاهش زمان دسترسی به اطلاعات و افزایش بهره‌وری کاربران
• کاهش مصرف توکن‌های مدل هوش مصنوعی با ارسال فقط داده‌های موردنیاز
• ساختار ماژولار و قابل توسعه به کمک Sub-workflowها و Toolها
• امکان اتصال آسان به سرویس‌های مختلف و توسعه Workflow بر اساس نیازهای کسب‌وکار
• قابلیت شخصی‌سازی کامل Promptها، مدل هوش مصنوعی و مسیرهای پردازش
• نگهداری ساده‌تر به دلیل تفکیک وظایف بین Workflow اصلی و Sub-workflow
• امکان استفاده به‌عنوان پایه‌ای برای ساخت دستیارهای هوشمند سازمانی یا سیستم‌های گزارش‌گیری مبتنی بر هوش مصنوعی

نکات مهم

برای اینکه این Workflow با پایداری و دقت بیشتری اجرا شود، رعایت نکات زیر توصیه می‌شود:

1.ساختار Google Sheets را تا حد امکان ثابت نگه دارید.

از تغییر مداوم نام ستون‌ها خودداری کنید. AI Agent بر اساس نام ستون‌ها تصمیم می‌گیرد که از کدام Tool استفاده کند و تغییر مکرر آن‌ها ممکن است باعث کاهش دقت پاسخ‌ها شود.

2.از نام‌های واضح برای ستون‌ها استفاده کنید.

به‌جای نام‌های مبهم مانند Column1 یا Data، از نام‌های معناداری مانند Customer Name، Country، Revenue یا Email استفاده کنید تا مدل هوش مصنوعی راحت‌تر ساختار داده‌ها را درک کند.

3.Credentialها را قبل از فعال کردن Workflow بررسی کنید.

اگر اتصال Google Sheets یا OpenAI به‌درستی تنظیم نشده باشد، Workflow در همان مراحل ابتدایی با خطا مواجه خواهد شد. پیش از انتشار، اعتبار Credentialها را بررسی و در صورت نیاز دوباره احراز هویت کنید.

4.Promptهای AI Agent را متناسب با نیاز خود تنظیم کنید.

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

5.از ارسال داده‌های غیرضروری به مدل هوش مصنوعی خودداری کنید.

یکی از مزیت‌های این Template این است که تنها اطلاعات موردنیاز را از Google Sheets استخراج می‌کند. هنگام توسعه Workflow نیز همین رویکرد را حفظ کنید تا هزینه استفاده از API و زمان پردازش کاهش یابد.

6.در فایل‌های بزرگ از صفحه‌بندی یا فیلتر استفاده کنید.

اگر Google Sheets شامل هزاران ردیف باشد، بهتر است قبل از ارسال اطلاعات به AI Agent، داده‌ها را فیلتر یا محدود کنید تا عملکرد Workflow بهینه باقی بماند.

7.Workflow را با سناریوهای مختلف آزمایش کنید.

پس از هر تغییر، سوالاتی با ساختارهای متفاوت از AI Agent بپرسید تا مطمئن شوید تمام مسیرهای Workflow به‌درستی اجرا می‌شوند و ابزار مناسب انتخاب می‌شود.

خطاهای رایج (Troubleshooting)

1.عدم اتصال به Google Sheets

علت:

Credential مربوط به Google Sheets به‌درستی تنظیم نشده یا حساب کاربری به فایل دسترسی ندارد.

راه‌حل:

• Credential را دوباره احراز هویت کنید.
• مطمئن شوید حساب Google انتخاب‌شده به فایل دسترسی دارد.
• لینک فایل Google Sheets را بررسی کنید.

2.AI Agent پاسخ نامرتبط تولید می‌کند.

علت:

Prompt به‌اندازه کافی دقیق نیست یا نام ستون‌های Google Sheets مبهم هستند.

راه‌حل:

• Prompt را بازنویسی و شفاف‌تر کنید.
• از نام‌های واضح برای ستون‌ها استفاده کنید.
• در صورت نیاز، قوانین بیشتری برای انتخاب Toolها به Agent اضافه کنید.

3.اطلاعات مشتری پیدا نمی‌شود.

علت:

شماره ردیف یا مقدار جستجو با داده‌های موجود در Google Sheets مطابقت ندارد.

راه‌حل:

• وجود رکورد موردنظر را در فایل بررسی کنید.
• اطمینان حاصل کنید داده‌های ورودی با فرمت صحیح ارسال می‌شوند.
• در صورت نیاز، منطق جستجو را بر اساس شناسه یا ایمیل تغییر دهید.

4.خطای مربوط به OpenAI API

علت:

کلید API نامعتبر است، اعتبار حساب به پایان رسیده یا محدودیت نرخ درخواست (Rate Limit) اعمال شده است.

راه‌حل:

• از معتبر بودن API Key اطمینان حاصل کنید.
• وضعیت حساب OpenAI را بررسی کنید.
• در صورت نیاز، تعداد درخواست‌های هم‌زمان را کاهش دهید یا از مدل مناسب‌تری استفاده کنید.

5.Workflow در مسیر اشتباه اجرا می‌شود.

علت:

شرط‌های تعریف‌شده در Node Switch یا پارامترهای ارسالی از Toolها به‌درستی تنظیم نشده‌اند.

راه‌حل:

• مقدار پارامتر operation را بررسی کنید.
• شرط‌های Node Switch را بازبینی کنید.
• با استفاده از قابلیت Execute Node در n8n، هر مسیر را به‌صورت جداگانه آزمایش کنید.

ساخت چت‌بات هوشمند با n8n

جمع‌بندی

ساخت چت‌بات هوشمند با n8n نمونه‌ای کاربردی از ترکیب اتوماسیون و هوش مصنوعی است که به شما اجازه می‌دهد بدون نیاز به جستجوی دستی در فایل‌های صفحه‌گسترده، تنها با پرسیدن یک سؤال به زبان طبیعی، اطلاعات موردنیاز خود را دریافت کنید. در این Template، استفاده از AI Agent در کنار Tool Workflowها باعث شده است که فقط داده‌های موردنیاز از Google Sheets استخراج شوند و از ارسال کل اطلاعات به مدل هوش مصنوعی جلوگیری شود. این رویکرد علاوه بر کاهش هزینه استفاده از API، سرعت اجرای Workflow را نیز افزایش می‌دهد.

از سوی دیگر، ساختار ماژولار Workflow توسعه آن را بسیار ساده کرده است. شما می‌توانید Toolهای جدید اضافه کنید، Promptها را تغییر دهید، مدل هوش مصنوعی دیگری انتخاب کنید یا حتی منابع داده متفاوتی را جایگزین Google Sheets کنید. به همین دلیل، این Template می‌تواند نقطه شروع مناسبی برای ساخت دستیارهای هوشمند، سیستم‌های گزارش‌گیری، ابزارهای تحلیل داده و بسیاری از پروژه‌های مبتنی بر هوش مصنوعی باشد. با اعمال شخصی‌سازی‌های مناسب، چت‌بات هوشمند Google Sheets در n8n می‌تواند به یکی از کاربردی‌ترین Workflowهای شما تبدیل شود.

سوالات متداول

1. آیا برای استفاده از این Template باید برنامه‌نویسی بلد باشم؟

خیر. بیشتر تنظیمات از طریق محیط گرافیکی n8n انجام می‌شوند و تنها در صورت نیاز به توسعه قابلیت‌های پیشرفته، ممکن است به آشنایی اولیه با JavaScript نیاز داشته باشید.

2. آیا می‌توان به‌جای Google Sheets از پایگاه داده استفاده کرد؟

بله. با جایگزین کردن Node مربوط به Google Sheets با Nodeهای مربوط به MySQL، PostgreSQL، Airtable یا سایر منابع داده، می‌توانید همین ساختار را برای منابع دیگر نیز پیاده‌سازی کنید.

3. آیا امکان استفاده از مدل‌های دیگر به‌جای OpenAI وجود دارد؟

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

4. آیا این Workflow برای فایل‌های بزرگ Google Sheets مناسب است؟

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

5. آیا می‌توان این Workflow را به تلگرام، Slack یا Discord متصل کرد؟

بله. کافی است Trigger فعلی را با Trigger مربوط به سرویس موردنظر جایگزین کنید یا در انتهای Workflow، پاسخ AI Agent را از طریق Nodeهای مربوط به Telegram، Slack یا Discord برای کاربران ارسال کنید.

GIT