مدیر مالی شخصی با هوش مصنوعی: Gemini، تلگرام و Google Sheets

مدیر مالی شخصی با هوش مصنوعی: Gemini، تلگرام و Google Sheets

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

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

---

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

این گردش کار به عنوان یک مدیر مالی شخصی با هوش مصنوعی عمل می‌کند و تلگرام، Google Sheets و Google Gemini AI را به طور یکپارچه ادغام می‌کند. این امکان را به کاربران می‌دهد تا درآمد و هزینه‌ها را از طریق پیام‌های تلگرام ثبت کنند، از جمله یادداشت‌های صوتی که به طور خودکار رونویسی می‌شوند. سپس تمام داده‌های مالی در یک صفحه گسترده Google Sheets ذخیره و مدیریت می‌شوند.

این گردش کار برای موارد زیر طراحی شده است:

1. دریافت و تفسیر ورودی‌ها: دریافت پیام‌های متنی و صوتی از تلگرام.

2. رونویسی یادداشت‌های صوتی: تبدیل پیام‌های صوتی به متن با استفاده از قابلیت‌های صوتی Google Gemini.

3. پردازش داده‌های مالی: استفاده از یک عامل هوش مصنوعی برای درک قصد کاربر، استخراج جزئیات تراکنش مالی و انجام عملیات CRUD (ایجاد، خواندن، به‌روزرسانی، حذف) در Google Sheets.

4. مدیریت مکالمه: حفظ زمینه و انسجام با استفاده از حافظه مکالمه.

5. پاسخ به کاربران: ارسال پاسخ‌های واضح و با فرمت HTML به تلگرام.

6. مدیریت خطا: مدیریت صحیح انواع ورودی‌های پشتیبانی نشده.

یادداشت‌های چسبان در گردش کار، دستورالعمل‌های راه‌اندازی ضروری را برای ربات تلگرام، ادغام Google Sheets و اعتبارنامه‌های هوش مصنوعی ارائه می‌دهند.

---

🧩 جزئیات گردش کار

۱. دریافت و مسیریابی ورودی

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

• Telegram Bot Trigger (n8n-nodes-base.telegramTrigger):

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

* پیکربندی: به به‌روزرسانی‌های message گوش می‌دهد.

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

* خروجی: داده‌های پیام دریافتی را به گره Switch منتقل می‌کند.

• Switch (n8n-nodes-base.switch):

* نقش: پیام‌ها را بر اساس نوع محتوای آن‌ها (متن، صدا یا موارد دیگر) مسیریابی می‌کند.

* پیکربندی:

* اگر message.text وجود داشته باشد، به "Text" مسیریابی می‌کند.

* اگر message.voice وجود داشته باشد، به "Voice" مسیریابی می‌کند.

* در غیر این صورت، به "Unsupported" مسیریابی می‌کند.

* خروجی‌ها: جریان را به Financial Agent (برای متن)، Get a file (برای صدا) یا Send Fallback Message (برای انواع پشتیبانی نشده) هدایت می‌کند.

• Get a file (n8n-nodes-base.telegram):

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

* پیکربندی: از message.voice.file_id از پیام دریافتی استفاده می‌کند.

* خروجی: فایل صوتی باینری را به گره Transcribe a recording ارائه می‌دهد.

۲. رونویسی صدا

این بخش از گردش کار، کلمات گفتاری را به متن تبدیل می‌کند.

• Transcribe a recording (@n8n/n8n-nodes-langchain.googleGemini):

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

* پیکربندی:

* Model: gemini-2.5-flash (یا جایگزین مناسب).

* Input Type: باینری صوتی.

* Resource: رونویسی صدا.

* اعتبارنامه‌ها: نیاز به اعتبارنامه‌های Google Gemini API دارد.

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

۳. پردازش عامل مالی هوش مصنوعی

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

• Financial Agent (@n8n/n8n-nodes-langchain.agent):

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

* پیکربندی:

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

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

* Tools: با ابزارهای Google Sheets و Calculator ادغام می‌شود.

* اعتبارنامه‌ها: نیاز به اعتبارنامه‌های Google Gemini API دارد.

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

• Simple Memory (@n8n/n8n-nodes-langchain.memoryBufferWindow):

* نقش: تاریخچه مکالمه را برای هر کاربر حفظ می‌کند، که با شناسه تلگرام آن‌ها کلیدگذاری شده است، و تعاملات مرتبط با زمینه را تضمین می‌کند.

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

* خروجی: تاریخچه مکالمه را برای گفتگوی منسجم به Financial Agent ارائه می‌دهد.

• Google Gemini Chat Model (@n8n/n8n-nodes-langchain.lmChatGoogleGemini):

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

* اعتبارنامه‌ها: نیاز به اعتبارنامه‌های Google Gemini API دارد.

* ادغام: به صورت داخلی توسط Financial Agent استفاده می‌شود.

• Calculator (@n8n/n8n-nodes-langchain.toolCalculator):

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

* ادغام: به عنوان ابزاری برای Financial Agent در دسترس قرار می‌گیرد.

۴. عملیات داده Google Sheets

این گره‌ها مستقیماً با دفتر مالی Google Sheets شما تعامل دارند.

• Get All Registers (n8n-nodes-base.googleSheetsTool):

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

* پیکربندی:

* Sheet: "Página1" (gid=0).

* Document: شناسه Google Sheets شما.

* Mode: تمام داده‌ها را بدون فیلتر واکشی می‌کند.

* اعتبارنامه‌ها: نیاز به اعتبارنامه‌های Google Sheets OAuth2 API دارد.

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

• Create New Register (n8n-nodes-base.googleSheetsTool):

* نقش: یک ردیف جدید را برای یک تراکنش مالی جدید به صفحه Google Sheet اضافه می‌کند.

* پیکربندی: داده‌ها را به ستون‌های مشخص شده اضافه می‌کند (به عنوان مثال، id, data, tipo, valor, categoria, descricao, metodo_pagamento).

* اعتبارنامه‌ها: نیاز به اعتبارنامه‌های Google Sheets OAuth2 API دارد.

* ورودی: جزئیات تراکنش را از عامل هوش مصنوعی دریافت می‌کند.

• Update Register (n8n-nodes-base.googleSheetsTool):

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

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

* اعتبارنامه‌ها: نیاز به اعتبارنامه‌های Google Sheets OAuth2 API دارد.

* ورودی: جزئیات تراکنش به‌روز شده را از عامل هوش مصنوعی دریافت می‌کند.

• Delete Register (n8n-nodes-base.googleSheetsTool):

* نقش: یک رکورد مالی خاص (ردیف) را از صفحه Google Sheet حذف می‌کند.

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

* اعتبارنامه‌ها: نیاز به اعتبارنامه‌های Google Sheets OAuth2 API دارد.

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

۵. تحویل پاسخ

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

• Send Response (n8n-nodes-base.telegram):

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

* پیکربندی:

* Text: از ویژگی output از نتیجه عامل هوش مصنوعی استفاده می‌کند.

* Chat ID: از پیام اصلی تلگرام (from.id) گرفته شده است.

* Parse Mode: برای نمایش متن فرمت شده روی "HTML" تنظیم شده است.

* Attribution: غیرفعال شده است.

* اعتبارنامه‌ها: نیاز به اعتبارنامه‌های تلگرام API دارد.

۶. مدیریت خطا / بازگشتی

این یک راهکار مناسب برای مدیریت ورودی‌هایی است که گردش کار آن‌ها را درک نمی‌کند.

• Send Fallback Message (n8n-nodes-base.telegram):

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

* پیکربندی: یک پیام متنی ثابت و با فرمت HTML ارسال می‌کند.

* Trigger: توسط گره Switch هنگام پشتیبانی نشدن ورودی (نه متن و نه صدا) فعال می‌شود.

---

📋 جدول خلاصه