رزرو وقت سالن با هوش مصنوعی و گوگل کلندر

رزرو وقت سالن با هوش مصنوعی، Google Calendar و تأییدیه‌های ایمیلی

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

این گردش کار و موارد دیگر را در کاتالوگ n8n شرکت Axeto.ai کاوش کنید.

نمای کلی گردش کار

این گردش کار به چندین بخش منطقی تقسیم شده است:

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

2. مدیریت مکالمه و حافظه هوش مصنوعی: وضعیت و زمینه مکالمه را با استفاده از مدل‌های زبان هوش مصنوعی و بافرهای حافظه برای گفتگوی روان چند مرحله‌ای مدیریت می‌کند.

3. مسیریابی تصمیم‌گیری (رزرو در مقابل بازخورد): ورودی کاربر را ارزیابی می‌کند تا تعیین کند آیا فرآیند باید با تأیید رزرو ادامه یابد یا بازخورد را مدیریت کند.

4. نهایی‌سازی و آماده‌سازی رزرو: داده‌های رزرو تأیید شده را پردازش کرده، آن را قالب‌بندی می‌کند و یک شیء رزرو ساختاریافته آماده می‌کند.

5. پردازش عامل رزرو: از هوش مصنوعی برای تولید یک شیء رویداد Google Calendar و یک ایمیل تأیید حرفه‌ای HTML بر اساس جزئیات رزرو نهایی شده استفاده می‌کند.

6. یکپارچه‌سازی با Google Calendar و ایمیل: رویداد تقویم را در Google Calendar ایجاد کرده و ایمیل تأیید را از طریق Gmail ارسال می‌کند.

7. پاسخ‌های وب‌هوک: پاسخ‌های مناسب را از طریق وب‌هوک به کاربر ارسال می‌کند که وضعیت رزرو (تأیید یا تأیید دریافت) را نشان می‌دهد.

---

تحلیل جزئیات بلوک‌ها

۱. دریافت ورودی و پردازش اولیه

این بلوک با گوش دادن به پیام‌های رزرو کاربر از طریق یک وب‌هوک و سپس ارسال این پیام‌ها به یک عامل هوش مصنوعی برای درک مکالمه‌ای، گردش کار را آغاز می‌کند.

• نودها:

* Webhook (n8n-nodes-base.webhook): به درخواست‌های HTTP POST ورودی حاوی پیام‌های کاربر گوش می‌دهد.

* Information Gathering Agent (@n8n/n8n-nodes-langchain.agent): به عنوان یک دستیار هوش مصنوعی مکالمه‌ای برای سالن عمل می‌کند.

• جزئیات نود:

* Webhook:

* نوع: تریگر وب‌هوک HTTP

* پیکربندی: برای گوش دادن به یک مسیر POST خاص تنظیم شده و برای پاسخ با خروجی نود پیکربندی شده است.

* ورودی: یک درخواست HTTP خارجی با یک payload JSON حاوی پیام کاربر.

* خروجی: payload JSON دریافتی به Information Gathering Agent ارسال می‌شود.

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

* Information Gathering Agent:

* نوع: عامل هوش مصنوعی LangChain (عامل مکالمه)

* پیکربندی:

* نقش: به عنوان "عامل رزرو سالن برای سالن Glow & Grace" عمل می‌کند.

* رفتار: برای جمع‌آوری اطلاعات ضروری رزرو (نوع سرویس، آرایشگر ترجیحی، تاریخ/زمان، درخواست‌های ویژه) درگیر پرسش‌های گرم، مودبانه و گام به گام می‌شود.

* خروجی: JSON ساختاریافته‌ای حاوی پیش‌نویس رزرو یا جزئیات نهایی کاربر تولید می‌کند. این شامل یک مقدار بولی is_pass_next برای نشان دادن زمان جمع‌آوری تمام جزئیات رزرو لازم است.

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

* عبارات کلیدی: ورودی کاربر را از payload JSON وب‌هوک استخراج می‌کند. فیلد is_pass_next برای مسیریابی گردش کار حیاتی است.

* ورودی: payload JSON از نود Webhook.

* خروجی: شیء JSON حاوی is_pass_next (بولی) و message (رشته).

* نیازمندی‌های نسخه: برای قابلیت‌های تجزیه خروجی هوش مصنوعی به نسخه ۱.۸+ n8n نیاز دارد.

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

۲. مدیریت مکالمه و حافظه هوش مصنوعی

این بلوک با حفظ زمینه مکالمه از طریق بافرهای حافظه و تجزیه‌کننده‌های خروجی، تعاملات چند نوبتی منسجم را تضمین می‌کند.

• نودها:

* Simple Memory (@n8n/n8n-nodes-langchain.memoryBufferWindow): تاریخچه مکالمات اخیر را ذخیره می‌کند.

* OpenAI Chat Model (@n8n/n8n-nodes-langchain.lmChatOpenAi): نوبت‌های مکالمه را پردازش می‌کند.

* Auto-fixing Output Parser (@n8n/n8n-nodes-langchain.outputParserAutofixing): خروجی مدل هوش مصنوعی را پاک می‌کند.

* Structured Output Parser (@n8n/n8n-nodes-langchain.outputParserStructured): خروجی هوش مصنوعی را در برابر یک طرحواره تعریف شده اعتبارسنجی می‌کند.

• جزئیات نود:

* Simple Memory:

* نوع: بافر پنجره حافظه LangChain

* پیکربندی: از یک کلید جلسه (مشتق شده از شناسه جلسه چت یا وب‌هوک) برای حفظ زمینه از ۱۵ پیام اخیر استفاده می‌کند.

* ورودی: خروجی از OpenAI Chat Model.

* خروجی: ورودی زمینه‌مند را به Information Gathering Agent ارائه می‌دهد.

* مشکلات احتمالی: شناسایی نادرست کلید جلسه، سرریز بافر حافظه.

* OpenAI Chat Model:

* نوع: ادغام مدل چت OpenAI LangChain

* پیکربندی: از نوع مدل "o3-mini" استفاده می‌کند که برای وظایف تکمیل چت بهینه شده است.

* ورودی: پیام‌های کاربر همراه با تاریخچه مکالمه از Simple Memory.

* خروجی: پاسخ چت تولید شده توسط هوش مصنوعی در فرمت JSON.

* مشکلات احتمالی: خطاهای کلید API یا احراز هویت، محدودیت‌های نرخ API، مهلت‌های زمانی شبکه.

* Auto-fixing Output Parser:

* نوع: تجزیه‌کننده خروجی LangChain با خودکارسازی

* پیکربندی: به طور خودکار ناسازگاری‌های جزئی را در فرمت خروجی مدل هوش مصنوعی تصحیح می‌کند و سازگاری با نودهای بعدی را تضمین می‌کند.

* ورودی: خروجی خام از مدل هوش مصنوعی.

* خروجی: داده‌های JSON پاک شده و ساختاریافته.

* مشکلات احتمالی: شکست تجزیه در صورتی که خروجی هوش مصنوعی به شدت نامعتبر باشد.

* Structured Output Parser:

* نوع: تجزیه‌کننده خروجی ساختاریافته LangChain

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

* ورودی: خروجی JSON پاک شده از Auto-fixing Output Parser.

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

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

۳. مسیریابی تصمیم‌گیری (رزرو در مقابل بازخورد)

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

• نودها:

* Switch (n8n-nodes-base.switch): گردش کار را بر اساس یک شرط مسیریابی می‌کند.

* Respond to Webhook1 (n8n-nodes-base.respondToWebhook): برای درخواست‌های رزرو، تأییدیه ارسال می‌کند.

* Respond to Webhook (n8n-nodes-base.respondToWebhook): پیام‌های بازخورد را به کاربر ارسال می‌کند.

• جزئیات نود:

* Switch:

* نوع: مسیریاب شرطی

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

* true: در مسیر رزرو ادامه می‌یابد.

* false: در مسیر بازخورد ادامه می‌یابد.

* ورودی: خروجی JSON هوش مصنوعی حاوی فیلد is_pass_next.

* خروجی: دو شاخه مجزا برای پردازش رزرو و بازخورد.

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

* Respond to Webhook1 (مسیر رزرو):

* نوع: نود پاسخ وب‌هوک

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

* ورودی: داده‌ها از نود Switch در شاخه رزرو.

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

* مشکلات احتمالی: خطاهای ارسال پاسخ.

* Respond to Webhook (مسیر بازخورد):

* نوع: نود پاسخ وب‌هوک

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

* ورودی: داده‌ها از نود Switch در شاخه بازخورد.

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

* مشکلات احتمالی: خطاهای ارسال پاسخ.

۴. نهایی‌سازی و آماده‌سازی رزرو

این بلوک جزئیات نهایی رزرو را قبل از ارسال به نودهای مسئول ایجاد رویداد تقویم و ایمیل، آماده و قالب‌بندی می‌کند.

• نودها:

* Edit Fields (n8n-nodes-base.set): داده‌ها را تبدیل و آماده می‌کند.

• جزئیات نود:

* Edit Fields:

* نوع: نود Set (تبدیل داده)

* پیکربندی: پیام تأیید رزرو را از خروجی نود Respond to Webhook1 استخراج کرده و در یک فیلد جدید به نام user_data ذخیره می‌کند.

* ورودی: داده‌ها از نود Respond to Webhook1 (مسیر رزرو).

* خروجی: داده‌های JSON غنی شده، شامل فیلد user_data حاوی جزئیات ساختاریافته رزرو.

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

۵. پردازش عامل رزرو

این بلوک از هوش مصنوعی برای ایجاد یک شیء رویداد تقویم Google ساختاریافته و یک ایمیل تأیید HTML خوش‌قالب بر اساس جزئیات رزرو جمع‌آوری شده استفاده می‌کند.

• نودها:

* Booking Agent (@n8n/n8n-nodes-langchain.agent): عامل هوش مصنوعی مسئول ایجاد محتوای تقویم و ایمیل.

* OpenAI Chat Model2 (@n8n/n8n-nodes-langchain.lmChatOpenAi): مدل پیشرفته هوش مصنوعی برای وظایف تولید.

* Structured Output Parser1 (@n8n/n8n-nodes-langchain.outputParserStructured): خروجی تولید شده را اعتبارسنجی می‌کند.

• جزئیات نود:

* Booking Agent:

* نوع: عامل هوش مصنوعی LangChain

* پیکربندی:

* نقش: به عنوان "عامل رزرو برای سالن Glow & Grace" عمل می‌کند.

* وظیفه: با استفاده از ورودی user_data، یک شیء رویداد تقویم Google و HTML ایمیل تأیید ایجاد می‌کند.

* فرمت خروجی: ساختار JSON کاملاً تعریف شده حاوی اشیاء calendar_event و email.

* منطق: قوانین خاص کسب و کار را برای مدت زمان خدمات و الزامات قالب‌بندی در بر می‌گیرد.

* عبارات کلیدی: از user_data از نود Edit Fields به عنوان ورودی استفاده می‌کند.

* ورودی: JSON حاوی داده‌های رزرو.

* خروجی: JSON ساختاریافته با جزئیات برای رویداد تقویم و ایمیل.

* مشکلات احتمالی: مدل هوش مصنوعی خروجی با فرمت نادرست، فیلدهای مورد نیاز مفقود، یا قالب‌بندی نادرست تاریخ/زمان تولید می‌کند.

* OpenAI Chat Model2:

* نوع: مدل چت OpenAI LangChain

* پیکربندی: از نوع مدل "gpt-4.1-mini" برای قابلیت‌های تولید پیشرفته استفاده می‌کند.

* ورودی: دستورالعمل‌های پرامپت ارائه شده توسط نود Booking Agent.

* خروجی: JSON تولید شده توسط هوش مصنوعی حاوی جزئیات تأیید رزرو و اطلاعات رویداد تقویم.

* مشکلات احتمالی: خطاهای API، محدودیت نرخ.

* Structured Output Parser1:

* نوع: تجزیه‌کننده خروجی LangChain

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

* ورودی: خروجی خام هوش مصنوعی از OpenAI Chat Model2.

* خروجی: داده‌های تأیید رزرو ساختاریافته و اعتبارسنجی شده.

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

۶. ادغام با تقویم Google و ایمیل

این بلوک با خدمات خارجی ادغام می‌شود تا قرار ملاقات را در تقویم Google ایجاد کرده و یک ایمیل تأیید حرفه‌ای به کاربر ارسال کند.

• نودها:

* Google Calendar (n8n-nodes-base.googleCalendar): رویدادهای تقویم را ایجاد می‌کند.

* Send a message (Gmail) (n8n-nodes-base.gmail): ایمیل‌های تأیید را ارسال می‌کند.

• جزئیات نود:

* Google Calendar:

* نوع: نود تقویم Google

* پیکربندی:

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

* خلاصه رویداد، شرکت‌کنندگان را تنظیم کرده و کدگذاری رنگی را اعمال می‌کند.

* برای استفاده از یک آدرس ایمیل تقویم خاص (anuj@sapahk.ai) پیکربندی شده است.

* ورودی: فیلدهایی از خروجی Booking Agent مربوط به رویداد تقویم و توضیحات آن.

* خروجی: تأیید رویداد تقویم Google ایجاد شده.

* مشکلات احتمالی: شکست‌های احراز هویت API، قالب‌بندی نادرست تاریخ/زمان، مجوزهای دسترسی ناکافی به تقویم.

* Send a message (Gmail):

* نوع: نود ارسال ایمیل Gmail

* پیکربندی:

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

* از خط موضوع و بدنه HTML تولید شده توسط Booking Agent استفاده می‌کند.

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

* ورودی: جزئیات ایمیل (گیرنده، موضوع، بدنه HTML) از خروجی Booking Agent.

* خروجی: تأیید ارسال ایمیل.

* مشکلات احتمالی: خطاهای احراز هویت SMTP، آدرس‌های ایمیل گیرنده نامعتبر، محدودیت‌های نرخ ارسال ایمیل که توسط Gmail اعمال می‌شود.

۷. پاسخ‌های وب‌هوک

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

• نودها:

* Respond to Webhook (n8n-nodes-base.respondToWebhook)

* Respond to Webhook1 (n8n-nodes-base.respondToWebhook)

• جزئیات نود:

* این نودها در بلوک ۳: مسیریابی تصمیم‌گیری (رزرو در مقابل بازخورد) به تفصیل شرح داده شده‌اند و مسئول ارسال پیام نهایی به کاربر و تکمیل حلقه تعامل هستند.

---

جدول خلاصه