این گردش کار چگونه فاکتورهای PDF را تجزیه میکند؟

این گردش کار ابتدا متن فاکتورهای PDF را از Google Drive استخراج کرده و سپس با استفاده از مدل GPT-4 OpenAI، دادههای کلیدی مانند اقلام، تاریخها و مبالغ را به صورت هوشمند تجزیه و تحلیل میکند.

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

شما به یک حساب n8n، دسترسی به Google Drive و Google Sheets (با اعتبارنامههای OAuth2) و یک کلید API OpenAI نیاز دارید. همچنین، فاکتورهای PDF باید در یک پوشه مشخص در Google Drive قرار گیرند.

آیا این گردش کار میتواند انواع مختلف فاکتورها را پردازش کند؟

بله، با استفاده از قدرت GPT-4، این گردش کار قادر به تجزیه و تحلیل و استخراج اطلاعات از انواع مختلف فاکتورهای PDF است، اما کیفیت استخراج ممکن است بسته به پیچیدگی و فرمت فاکتور متفاوت باشد.

دادههای استخراج شده به کجا ذخیره میشوند؟

دادههای استخراج شده از فاکتورها به صورت ساختاریافته در یک سند Google Sheets ثبت میشوند که امکان بررسی و تحلیل آسان را فراهم میکند.

تجزیه خودکار فاکتور PDF با هوش مصنوعی و Google Drive

تجزیه‌کننده فاکتور PDF با قدرت هوش مصنوعی با Google Drive، Google Sheets و OpenAI

این گردش کار، پردازش فاکتورهای PDF ذخیره شده در یک پوشه مشخص Google Drive را خودکار می‌کند. این گردش کار برای کسب‌وکارهایی طراحی شده است که به دنبال ساده‌سازی حسابداری با استخراج داده‌های ساختاریافته فاکتور و ثبت آن‌ها در یک سند Google Sheets هستند. این گردش کار، Google Drive و Google Sheets را با مدل زبان GPT-4 OpenAI برای تجزیه و تحلیل و دسته‌بندی هوشمند متن ادغام می‌کند.

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

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

---

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

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

۱. دریافت و آماده‌سازی فاکتور

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

#### ۱.۱. مانیتور پوشه فاکتور

نوع گره (Node Type): n8n-nodes-base.googleDriveTrigger
هدف: پوشه مشخصی در Google Drive را برای فایل‌های PDF جدید نظارت می‌کند. هنگامی که یک فایل جدید شناسایی می‌شود، گردش کار را راه‌اندازی می‌کند.
پیکربندی:

* رویداد (Event): fileCreated

* پوشه برای نظارت (Folder to watch): شناسه پوشه Google Drive حاوی فاکتورها (مثلاً "1KJ4fvXcKVMGJunsKvPYf8PkX5K9SVwFk").

* بازه زمانی نظارت (Polling Interval): برای بررسی هر دقیقه پوشه برای فایل‌های جدید تنظیم شده است.

ورودی (Input): ندارد (گره راه‌انداز).
خروجی (Output): متادیتای فایل ایجاد شده، شامل شناسه آن.
اعتبارنامه‌ها (Credentials): نیاز به اعتبارنامه‌های OAuth2 Google Drive دارد.
مشکلات احتمالی: خطاهای احراز هویت API Google Drive، مجوزهای ناکافی پوشه، محدودیت‌های نرخ API.

#### ۱.۲. دانلود PDF فاکتور

نوع گره (Node Type): n8n-nodes-base.googleDrive
هدف: فایل PDF فاکتور را با استفاده از شناسه فایل دریافتی از گره راه‌انداز، به صورت داده باینری دانلود می‌کند.
پیکربندی:

* عملیات (Operation): download

* شناسه فایل (File ID): عبارتی که به شناسه فایل ورودی ارجاع می‌دهد: {{$json.id}}.

ورودی (Input): شناسه فایل از گره مانیتور پوشه فاکتور.
خروجی (Output): داده باینری PDF فاکتور.
اعتبارنامه‌ها (Credentials): نیاز به اعتبارنامه‌های OAuth2 Google Drive دارد.
مشکلات احتمالی: حذف یا جابجایی فایل قبل از دانلود، خطاهای احراز هویت، تجاوز از سهمیه API.

#### ۱.۳. استخراج متن PDF

نوع گره (Node Type): n8n-nodes-base.extractFromFile
هدف: محتوای متنی قابل خواندن را از داده‌های باینری PDF استخراج می‌کند. این کار محتوای فاکتور را برای تجزیه و تحلیل هوش مصنوعی آماده می‌کند.
پیکربندی:

* عملیات (Operation): pdf

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

ورودی (Input): داده باینری PDF از گره دانلود PDF فاکتور.
خروجی (Output): محتوای متنی ساده فاکتور.
سازگاری (Compatibility): نیاز به نسخه ۱.۰ یا بالاتر n8n دارد.
مشکلات احتمالی: کیفیت پایین PDF ممکن است منجر به استخراج ناقص متن شود، مهلت‌های زمانی استخراج، فرمت‌های PDF پشتیبانی نشده.

۲. تجزیه فاکتور با قدرت هوش مصنوعی

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

#### ۲.۱. مدل چت OpenAI

نوع گره (Node Type): @n8n/n8n-nodes-langchain.lmChatOpenAi
هدف: بک‌اند مدل هوش مصنوعی را برای پردازش متن فاکتور فراهم می‌کند.
پیکربندی:

* مدل (Model): gpt-4o-mini (یک نوع GPT-4 مقرون به صرفه و توانا).

ورودی (Input): اعلان‌ها را از ایجنت تجزیه کننده فاکتور هوش مصنوعی دریافت می‌کند.
خروجی (Output): پاسخ تولید شده توسط هوش مصنوعی حاوی اطلاعات تجزیه شده فاکتور.
اعتبارنامه‌ها (Credentials): نیاز به کلید API OpenAI دارد.
مشکلات احتمالی: کلید API نامعتبر، عدم دسترسی به مدل، مشکلات اتصال شبکه.

#### ۲.۲. پارسر خروجی ساختاریافته

نوع گره (Node Type): @n8n/n8n-nodes-langchain.outputParserStructured
هدف: پاسخ هوش مصنوعی را بر اساس یک طرحواره از پیش تعریف شده، به یک شیء JSON تمیز اعتبارسنجی و ساختاردهی می‌کند.
پیکربندی:

* مثال طرحواره JSON (JSON Schema Example): ساختار مورد انتظار برای داده‌های فاکتور را تعریف می‌کند، شامل فیلدهایی مانند شماره فاکتور، تاریخ‌ها، فروشنده، مبالغ و یک آرایه تودرتو برای اقلام خطی.

ورودی (Input): پاسخ خام هوش مصنوعی از مدل چت OpenAI.
خروجی (Output): یک شیء JSON ساختاریافته حاوی داده‌های تجزیه شده فاکتور.
مشکلات احتمالی: خطاهای تجزیه در صورتی که پاسخ هوش مصنوعی به طور قابل توجهی از فرمت مورد انتظار منحرف شود.

#### ۲.۳. ایجنت تجزیه کننده فاکتور هوش مصنوعی

نوع گره (Node Type): @n8n/n8n-nodes-langchain.agent
هدف: پردازش هوش مصنوعی را هماهنگ می‌کند. متن فاکتور استخراج شده را با دستورالعمل‌های خاص برای تجزیه فیلدهای کلیدی و دسته‌بندی فاکتور به مدل چت OpenAI ارسال می‌کند، سپس از پارسر خروجی ساختاریافته برای قالب‌بندی نتیجه استفاده می‌کند.
پیکربندی:

* اعلان (Prompt): مجموعه‌ای از دستورالعمل‌های دقیق برای هوش مصنوعی، که فیلدهای مورد نیاز برای استخراج (شماره فاکتور، تاریخ‌ها، فروشنده، مبالغ، اقلام، مالیات، دسته) و فرمت خروجی JSON مورد نظر را مشخص می‌کند.

* متن ورودی (Input Text): متن خام استخراج شده از گره استخراج متن PDF را در اعلان جاسازی می‌کند: {{$json.text}}.

* پارسر خروجی (Output Parser): برای اجبار پاسخ JSON ساختاریافته فعال شده است.

ورودی (Input): متن استخراج شده از گره استخراج متن PDF.
خروجی (Output): شیء JSON تمیز با داده‌های تجزیه شده فاکتور، آماده برای ذخیره‌سازی.
سازگاری (Compatibility): برای ادغام پارسر خروجی، نسخه ۱.۹ یا بالاتر گره توصیه می‌شود.
مشکلات احتمالی: خطاهای API OpenAI (محدودیت‌های نرخ، احراز هویت)، متن ورودی بدشکل که باعث شکست تجزیه می‌شود، استخراج ناقص منجر به فیلدهای داده گمشده.

۳. ذخیره‌سازی داده‌ها

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

#### ۳.۱. درج داده‌های فاکتور

نوع گره (Node Type): n8n-nodes-base.googleSheets
هدف: داده‌های تجزیه شده فاکتور را به عنوان یک ردیف جدید در یک صفحه گسترده Google Sheets مشخص شده، اضافه می‌کند.
پیکربندی:

* عملیات (Operation): append

* شناسه سند (Document ID): شناسه سند Google Sheets هدف (مثلاً "1u5dHeytao9y3L0Mgv8cSomPVLS3CMrn_eOwXW3oQ3c8").

* نام برگه (Sheet Name): "Invoices" (یا نام برگه مشخص).

* نگاشت ستون (Column Mapping): فیلدهای خروجی JSON تجزیه شده را به طور صریح به ستون‌های مربوطه در Google Sheet نگاشت می‌کند (مثلاً شماره فاکتور، تاریخ فاکتور، نام فروشنده، مبلغ کل، دسته).

ورودی (Input): داده‌های JSON ساختاریافته از ایجنت تجزیه کننده فاکتور هوش مصنوعی.
خروجی (Output): تأیید اضافه شدن ردیف به برگه.
اعتبارنامه‌ها (Credentials): نیاز به اعتبارنامه‌های OAuth2 Google Sheets دارد.
مشکلات احتمالی: خطاهای احراز هویت API Google Sheets، محدودیت‌های سهمیه، عدم تطابق بین فیلدهای JSON و ستون‌های برگه، خطاهای تبدیل نوع داده.

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

این گره‌ها راهنمایی‌های ضروری را برای راه‌اندازی و درک گردش کار ارائه می‌دهند.

#### ۴.۱. گره‌های یادداشت چسبان (Sticky Note Nodes)

نوع گره (Node Type): n8n-nodes-base.stickyNote
هدف: این گره‌ها حاوی متن اطلاعاتی برای راهنمایی کاربران هستند.

* یادداشت چسبان ۱ (دستورالعمل‌های راه‌اندازی): جزئیات ساختار مورد نیاز برای صفحه گسترده Google Sheet "Invoices" را شرح می‌دهد و اعتبارنامه‌های لازم (OAuth2 Google Drive، OAuth2 Google Sheets، کلید API OpenAI) را لیست می‌کند.

* یادداشت چسبان ۲ (مرور کلی گردش کار): خلاصه‌ای سطح بالا از قابلیت‌های گردش کار، از نظارت بر Google Drive تا ذخیره داده‌ها در Google Sheets با استفاده از هوش مصنوعی، ارائه می‌دهد.

* یادداشت چسبان ۳ (توضیح فرآیند): مروری گام به گام از اجرای گردش کار ارائه می‌دهد و نقش هر گره را از ابتدا تا انتها توضیح می‌دهد.

---

جدول خلاصه

نام نود (Node Name)	نوع نود (Node Type)	نقش عملکردی (Functional Role)	ورودی از نود(های) (Input From Node(s))	خروجی به نود(های) (Output To Node(s))	تمرکز مستندات (Documentation Focus)
Invoice Folder Monitor	`googleDriveTrigger`	فعال‌سازی گردش کار با فایل PDF جدید	None	Download Invoice PDF	نظارت بر Google Drive برای فاکتورهای جدید
Download Invoice PDF	`googleDrive`	دانلود باینری فایل PDF فاکتور	Invoice Folder Monitor	PDF Text Extractor	دریافت فایل‌های فاکتور
PDF Text Extractor	`extractFromFile`	استخراج متن از باینری PDF	Download Invoice PDF	Invoice Parser AI Agent	تبدیل PDF به متن
OpenAI Chat Model	`lmChatOpenAi`	فراهم کردن مدل GPT-4 برای تجزیه و تحلیل	Invoice Parser AI Agent	Invoice Parser AI Agent	بک‌اند مدل هوش مصنوعی
Structured Output Parser	`outputParserStructured`	اعتبارسنجی و ساختاردهی خروجی JSON هوش مصنوعی	Invoice Parser AI Agent	Invoice Parser AI Agent	اطمینان از پاسخ‌های ساختاریافته هوش مصنوعی
Invoice Parser AI Agent	`agent`	تجزیه متن فاکتور و دسته‌بندی	PDF Text Extractor, OpenAI Chat Model, Structured Output Parser	Insert Invoice Data	منطق اصلی تجزیه و دسته‌بندی هوش مصنوعی
Insert Invoice Data	`googleSheets`	افزودن داده‌های تجزیه شده فاکتور به شیت	Invoice Parser AI Agent	None	ذخیره داده‌های استخراج شده در Google Sheets
Sticky Note (Setup)	`stickyNote`	دستورالعمل‌های راه‌اندازی	None	None	ساختار Google Sheets، اعتبارنامه‌های مورد نیاز
Sticky Note (Overview)	`stickyNote`	توضیحات گردش کار	None	None	قابلیت‌های کلی گردش کار
Sticky Note (Process)	`stickyNote`	نمای کلی فرآیند گردش کار	None	None	جریان اجرای گام به گام

---

بازسازی گردش کار

برای بازسازی این گردش کار:

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

* اعتبارنامه‌های Google Drive OAuth2 را پیکربندی کنید.

* اعتبارنامه‌های Google Sheets OAuth2 را پیکربندی کنید.

* کلید API OpenAI خود را دریافت و پیکربندی کنید.

2. افزودن گره راه‌انداز:

* یک گره Google Drive Trigger (n8n-nodes-base.googleDriveTrigger) اضافه کنید.

* Event را روی fileCreated تنظیم کنید.

* شناسه Folder to watch را مشخص کنید.

* بازه زمانی نظرسنجی را تنظیم کنید (مثلاً هر دقیقه).

* اعتبارنامه‌های Google Drive خود را انتخاب کنید.

3. افزودن گره دانلود:

* یک گره Google Drive (n8n-nodes-base.googleDrive) اضافه کنید.

* Operation را روی Download تنظیم کنید.

* از عبارت {{$json.id}} برای File ID استفاده کنید.

* اعتبارنامه‌های Google Drive خود را انتخاب کنید.

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

4. افزودن گره استخراج PDF:

* یک گره Extract from File (n8n-nodes-base.extractFromFile) اضافه کنید.

* Operation را روی pdf تنظیم کنید.

* خروجی گره Download Invoice PDF (داده‌های باینری) را به این گره متصل کنید.

5. افزودن گره‌های پردازش هوش مصنوعی:

* یک گره OpenAI Chat Model (@n8n/n8n-nodes-langchain.lmChatOpenAi) اضافه کنید.

* gpt-4o-mini را به عنوان مدل انتخاب کنید.

* اعتبارنامه کلید API OpenAI خود را انتخاب کنید.

* یک گره Structured Output Parser (@n8n/n8n-nodes-langchain.outputParserStructured) اضافه کنید.

* طرحواره JSON خود را برای داده‌های فاکتور تعریف کنید.

* یک گره Agent (@n8n/n8n-nodes-langchain.agent) اضافه کنید.

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

* از {{$json.text}} برای ورودی متن استخراج شده استفاده کنید.

* تجزیه‌کننده خروجی را فعال کرده و آن را به گره Structured Output Parser پیوند دهید.

* خروجی گره PDF Text Extractor را به این گره Agent متصل کنید. اطمینان حاصل کنید که OpenAI Chat Model نیز به عنوان یک ابزار/مدل برای عامل متصل است.

6. افزودن گره Google Sheets:

* یک گره Google Sheets (n8n-nodes-base.googleSheets) اضافه کنید.

* Operation را روی append تنظیم کنید.

* Document ID و Sheet Name را برای گزارش فاکتور خود وارد کنید.

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

* اعتبارنامه‌های Google Sheets خود را انتخاب کنید.

* خروجی گره Invoice Parser AI Agent را به این گره متصل کنید.

7. افزودن یادداشت‌های چسبان:

* گره‌های Sticky Note (n8n-nodes-base.stickyNote) را برای مستندسازی راه‌اندازی، نمای کلی گردش کار و مراحل فرآیند همانطور که در گردش کار توضیح داده شده است، اضافه کنید.

این تنظیمات یک راه‌حل قوی و خودکار برای پردازش فاکتورهای PDF با استفاده از هوش مصنوعی ارائه می‌دهد. می‌توانید این گردش کار و موارد دیگر را در کاتالوگ Axeto پیدا کنید: https://axeto.ai/n8n.