دستیار هوشمند Gmail و تقویم با Gemini Chat

دستیار هوشمند Gmail و تقویم با Gemini Chat

8 دقیقه مطالعه · منتشر شده ۱۴۰۵/۴/۲۶

دانلود workflow

فایل JSON آماده import در n8n — credentialها باید در n8n شما تنظیم شوند.

  1. فایل JSON را دانلود کنید.
  2. در n8n: Workflows → Import from File.
  3. Credentialهای هر node را متصل کنید.
  4. workflow را فعال کنید.

شناسه workflow: 8234 · منبع: کاتالوگ Pixori

رابط دستیار Gmail و تقویم با هوش مصنوعی و Gemini Chat

این گردش کار به شما یک دستیار هوش مصنوعی قدرتمند ارائه می‌دهد که به طور یکپارچه با Gmail و Google Calendar شما ادغام می‌شود و از طریق یک رابط مکالمه‌ای قابل دسترسی است. با استفاده از درک زبان پیشرفته Google Gemini، این دستیار می‌تواند درخواست‌های شما را تفسیر کند، اقداماتی مانند زمان‌بندی جلسات، مدیریت ایمیل‌ها و بازیابی رویدادهای تقویم را انجام دهد و با اطلاعات واضح و زمینه‌ای پاسخ دهد.

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

---

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

این گردش کار به عنوان یک دستیار بهره‌وری شخصی عمل می‌کند. این برنامه از طریق یک وب‌هوک به درخواست‌های ورودی گوش می‌دهد، آن‌ها را با استفاده از یک عامل مبتنی بر Google Gemini پردازش می‌کند و برای انجام دستورات شما با Gmail و Google Calendar تعامل می‌کند.

قابلیت‌های کلیدی:

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

ساختار گردش کار:

1. دریافت ورودی: درخواست‌ها را از طریق یک وب‌هوک HTTP دریافت می‌کند.

2. پیش‌پردازش ورودی: متن ورودی را پاکسازی و استاندارد می‌کند.

3. مدل زبان هوش مصنوعی: از Google Gemini برای درک و تولید زبان طبیعی استفاده می‌کند.

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

5. اجرای ابزار: با APIهای Gmail و Google Calendar تعامل می‌کند.

6. مدیریت حافظه: زمینه مکالمه را برای تعاملات چند نوبتی حفظ می‌کند.

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

---

🛠️ تجزیه و تحلیل گره به گره

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

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

  • Webhook

* نوع: n8n-nodes-base.webhook

* نقش: به عنوان نقطه ورود عمل می‌کند و به درخواست‌های HTTP POST ورودی در نقطه پایانی /chat گوش می‌دهد. این گره برای پذیرش درخواست‌ها از هر مبدأ و انتظار برای پاسخ از گره‌های پایین‌دستی پیکربندی شده است.

* پیکربندی:

* متد HTTP: POST

* حالت پاسخ: Wait for Response

* مسیر: /chat

مبدأهای مجاز:

* اتصالات: داده‌ها را به گره Set ارسال می‌کند.

  • Set

* نوع: n8n-nodes-base.set

* نقش: متن ورودی کاربر را از فیلدهای بالقوه مختلف در درخواست ورودی (مانند body.text, text, body.input) استخراج کرده و آن را در یک فیلد واحد input ادغام می‌کند. این استانداردسازی تضمین می‌کند که عامل هوش مصنوعی ورودی سازگار دریافت کند.

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

* اتصالات: ورودی استاندارد شده را به AI Agent ارسال می‌کند.

۲. مدل زبان هوش مصنوعی و هسته عامل

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

  • Google Gemini Chat Model

* نوع: @n8n/n8n-nodes-langchain.lmChatGoogleGemini

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

* پیکربندی: به اعتبارنامه API گوگل نیاز دارد. برای دستورالعمل‌های خاص به AI Agent متکی است.

* اتصالات: به عنوان مدل زبان به گره AI Agent تغذیه می‌شود.

  • AI Agent

* نوع: @n8n/n8n-nodes-langchain.agent

* نقش: هماهنگ‌کننده مرکزی. درخواست کاربر را با استفاده از Google Gemini Chat Model تفسیر می‌کند، "مانیفست ابزار" خود (فهرستی از ابزارهای موجود و عملکردهای آن‌ها) را بررسی می‌کند و تصمیم می‌گیرد که کدام ابزارها را برای انجام درخواست فراخوانی کند. همچنین زمینه مکالمه را مدیریت کرده و در صورت نیاز از کاربر برای شفاف‌سازی درخواست می‌کند.

* پیکربندی:

* دستور سیستم (System Prompt): رفتار عامل را تعریف می‌کند، بر استفاده از ابزار، تأیید کاربر برای اقدامات مخرب و درخواست‌های شفاف‌سازی تأکید می‌کند.

* ابزارها (Tools): شامل تعاریف برای ابزارهای Gmail، Google Calendar و تاریخ/زمان است.

* ورودی (Input): به فیلد input از گره Set پیوند داده شده است.

* وابستگی‌ها: به نسخه ۲.۲ یا بالاتر n8n نیاز دارد.

* اتصالات:

* ورودی را از Set و Google Gemini Chat Model دریافت می‌کند.

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

* اطلاعات پردازش شده را به گره Prepare Reply خروجی می‌دهد.

۳. گره‌های اجرای ابزار

این گره‌ها با تعامل با سرویس‌های خارجی مانند Gmail و Google Calendar اقدامات واقعی را انجام می‌دهند.

  • Send a message in Gmail

* نوع: n8n-nodes-base.gmailTool (ارسال پیام)

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

* پیکربندی: گیرنده، موضوع و بدنه به طور پویا توسط AI Agent تنظیم می‌شوند.

* اتصالات: توسط AI Agent فراخوانی می‌شود.

  • Get many messages in Gmail

* نوع: n8n-nodes-base.gmailTool (دریافت پیام‌ها)

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

* پیکربندی: پارامترهای پرس و جو به طور پویا توسط AI Agent تنظیم می‌شوند.

* اتصالات: توسط AI Agent فراخوانی می‌شود.

  • Get many events in Google Calendar

* نوع: n8n-nodes-base.googleCalendarTool (دریافت رویدادها)

* نقش: رویدادها را از Google Calendar شما در بازه‌های زمانی و تاریخ مشخص شده واکشی می‌کند.

* پیکربندی: timeMin و timeMax به طور پویا توسط AI Agent تنظیم می‌شوند.

* اتصالات: توسط AI Agent فراخوانی می‌شود.

  • Date & Time

* نوع: n8n-nodes-base.dateTimeTool

* نقش: عبارات تاریخ و زمان زبان طبیعی (مانند "سه‌شنبه آینده ساعت ۳ بعد از ظهر") را به فرمت استاندارد ISO 8601 تبدیل می‌کند که برای زمان‌بندی دقیق ضروری است.

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

* اتصالات: توسط AI Agent فراخوانی می‌شود.

  • Get availability in a calendar in Google Calendar

* نوع: n8n-nodes-base.googleCalendarTool (بررسی در دسترس بودن)

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

* پیکربندی: بازه زمانی برای بررسی به طور پویا تنظیم می‌شود.

* اتصالات: توسط AI Agent فراخوانی می‌شود.

  • Create an event in Google Calendar

* نوع: n8n-nodes-base.googleCalendarTool (ایجاد رویداد)

* نقش: رویدادهای جدید را در Google Calendar شما زمان‌بندی می‌کند، از جمله جزئیاتی مانند عنوان، زمان، شرکت‌کنندگان و توضیحات. می‌تواند به طور اختیاری پیوند Google Meet را شامل شود.

* پیکربندی: جزئیات رویداد به طور پویا توسط AI Agent پر می‌شود.

* اتصالات: توسط AI Agent فراخوانی می‌شود.

  • Update an event in Google Calendar

* نوع: n8n-nodes-base.googleCalendarTool (به‌روزرسانی رویداد)

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

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

* اتصالات: توسط AI Agent فراخوانی می‌شود.

۴. مدیریت حافظه

این جزء تضمین می‌کند که دستیار زمینه مکالمه شما را به خاطر می‌سپارد.

  • Simple Memory

* نوع: @n8n/n8n-nodes-langchain.memoryBufferWindow

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

* پیکربندی: اندازه پنجره حافظه را تنظیم می‌کند.

* اتصالات: تاریخچه مکالمه را به AI Agent ارائه می‌دهد.

۵. آماده‌سازی پاسخ و پاسخ به وب‌هوک

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

  • Prepare Reply

* نوع: n8n-nodes-base.set

* نقش: خروجی نهایی را از AI Agent گرفته و آن را در یک فیلد reply ساختاربندی می‌کند و از فرمت سازگار برای پاسخ اطمینان حاصل می‌کند.

* اتصالات: پاسخ قالب‌بندی شده را به گره Respond to Webhook ارسال می‌کند.

  • Respond to Webhook

* نوع: n8n-nodes-base.respondToWebhook

* نقش: یک پاسخ HTTP 200 OK را به فراخواننده وب‌هوک اصلی ارسال می‌کند و چرخه درخواست-پاسخ را با پاسخ تولید شده توسط هوش مصنوعی تکمیل می‌کند.

* اتصالات: این گره نهایی در مسیر اصلی گردش کار است.

---

📊 جدول خلاصه

نام گره (Node Name)نوع گره (Node Type)نقش عملکردی (Functional Role)متصل به (خروجی) (Connected To (Output))
Webhookn8n-nodes-base.webhookنقطه ورود برای درخواست‌های چتSet
Setn8n-nodes-base.setنرمال‌سازی متن ورودی کاربرAI Agent
Google Gemini Chat Model@n8n/n8n-nodes-langchain.lmChatGoogleGeminiپردازش زبان هوش مصنوعیAI Agent
AI Agent@n8n/n8n-nodes-langchain.agentمنطق اصلی، انتخاب ابزار، مدیریت مکالمهPrepare Reply
Send a message in Gmailn8n-nodes-base.gmailToolارسال ایمیل‌ها(فراخوانی داخلی ابزار) (Internal Tool Call)
Get many messages in Gmailn8n-nodes-base.gmailToolخواندن ایمیل‌ها(فراخوانی داخلی ابزار) (Internal Tool Call)
Get many events in Google Calendarn8n-nodes-base.googleCalendarToolبازیابی رویدادهای تقویم(فراخوانی داخلی ابزار) (Internal Tool Call)
Date & Timen8n-nodes-base.dateTimeToolتبدیل تاریخ/زمان زبان طبیعی(فراخوانی داخلی ابزار) (Internal Tool Call)
Get availability in a calendarn8n-nodes-base.googleCalendarToolبررسی در دسترس بودن تقویم(فراخوانی داخلی ابزار) (Internal Tool Call)
Create an event in Google Calendarn8n-nodes-base.googleCalendarToolزمان‌بندی رویدادهای جدید(فراخوانی داخلی ابزار) (Internal Tool Call)
Update an event in Google Calendarn8n-nodes-base.googleCalendarToolاصلاح رویدادهای موجود(فراخوانی داخلی ابزار) (Internal Tool Call)
Simple Memory@n8n/n8n-nodes-langchain.memoryBufferWindowحفظ زمینه مکالمهAI Agent
Prepare Replyn8n-nodes-base.setساختاربندی خروجی نهایی هوش مصنوعیRespond to Webhook
Respond to Webhookn8n-nodes-base.respondToWebhookارسال پاسخ نهایی به فراخواننده(پایان گردش کار) (End of Workflow)

Nodeهای استفاده‌شده

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

این گردش کار n8n چه کاری انجام می‌دهد؟

این گردش کار یک دستیار هوش مصنوعی ایجاد می‌کند که با Gmail و Google Calendar شما ادغام می‌شود. این دستیار می‌تواند جلسات را زمان‌بندی کند، ایمیل‌ها را مدیریت کند و رویدادهای تقویم را از طریق یک رابط مکالمه‌ای با استفاده از Gemini Chat بازیابی کند.

چه ابزارهایی در این گردش کار استفاده شده است؟

این گردش کار از گره‌هایی مانند Webhook، Set، Google Gemini Chat Model، AI Agent، Gmail Tool، Google Calendar Tool و Memory Buffer Window استفاده می‌کند تا ورودی را دریافت کرده، درخواست‌ها را پردازش کند و با سرویس‌های گوگل تعامل داشته باشد.

چگونه می‌توانم از این دستیار هوش مصنوعی استفاده کنم؟

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

آیا این گردش کار نیاز به تنظیمات خاصی دارد؟

بله، برای استفاده از مدل Google Gemini Chat، نیاز به اعتبارنامه API گوگل دارید. همچنین، پیکربندی گره Webhook برای دریافت درخواست‌ها و گره AI Agent برای تعریف رفتار دستیار ضروری است.

workflowهای مرتبط

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