تحلیل هوشمندانه روندهای NFT با عامل n8n و OpenSea

تحلیل روندهای بازار NFT با یک عامل تحلیل OpenSea مبتنی بر هوش مصنوعی

این سند یک گردش کار n8n را برای تحلیل روندهای بازار NFT با استفاده از هوش مصنوعی و API OpenSea تشریح می‌کند. این روشی ساختاریافته برای پرس‌وجو در داده‌های NFT ارائه می‌دهد و آن را برای معامله‌گران، کلکسیونرها و سرمایه‌گذاران قابل دسترس می‌سازد.

دسته‌بندی‌ها: هوش مصنوعی، NFT، تحلیل، OpenSea

گره‌های استفاده شده:

• n8n-nodes-base.stickyNote
• @n8n/n8n-nodes-langchain.agent
• @n8n/n8n-nodes-langchain.lmChatOpenAi
• n8n-nodes-base.executeWorkflowTrigger
• @n8n/n8n-nodes-langchain.toolHttpRequest
• @n8n/n8n-nodes-langchain.memoryBufferWindow

لینک کاتالوگ Axeto: https://axeto.ai/n8n

---

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

عامل تحلیل OpenSea یک گردش کار n8n مبتنی بر هوش مصنوعی است که از API OpenSea و مدل‌های پیشرفته هوش مصنوعی (مانند GPT-4o-mini) برای ارائه بینش‌های ساختاریافته و بلادرنگ در بازار NFT استفاده می‌کند. این گردش کار برای معامله‌گران، کلکسیونرها و سرمایه‌گذاران NFT که به دنبال تحلیل‌های دقیق در مورد مجموعه‌های NFT، تراکنش‌های کیف پول و روندهای گسترده‌تر بازار هستند، ایده‌آل است.

گردش کار به اجزای کلیدی زیر سازماندهی شده است:

• ۱.۱ دریافت ورودی: درخواست‌های ورودی کاربر و داده‌های جلسه را از طریق یک تریگر گردش کار مدیریت می‌کند.
• ۱.۲ هسته پردازش هوش مصنوعی: از یک مدل زبانی (مانند GPT-4o-mini) به عنوان "مغز عامل تحلیل" برای تفسیر درخواست‌های کاربر و تعیین فراخوانی‌های مناسب API OpenSea استفاده می‌کند. این بخش با استفاده از یک بافر حافظه، زمینه مکالمه را حفظ می‌کند.
• ۱.۳ ابزارهای یکپارچه‌سازی API OpenSea: شامل چندین گره toolHttpRequest است که به عنوان ابزارهای هوش مصنوعی برای تعامل با نقاط پایانی خاص API OpenSea پیکربندی شده‌اند، برای موارد زیر:

* آمار مجموعه

* رویدادهای جهانی NFT

* رویدادهای فیلتر شده بر اساس آدرس کیف پول

* رویدادهای فیلتر شده بر اساس اسلاگ مجموعه

* رویدادهای فیلتر شده بر اساس NFT خاص (شناسایی شده توسط زنجیره، قرارداد و شناسه توکن)

• ۱.۴ ارکستراسیون عامل هوش مصنوعی: گره "عامل تحلیل OpenSea" به عنوان عامل هوش مصنوعی مرکزی عمل می‌کند، فراخوانی‌ها را بر اساس پرس‌وجوی تفسیر شده کاربر به ابزار صحیح API OpenSea هدایت می‌کند، انطباق API را تضمین می‌کند و خطاها را مدیریت می‌کند.
• ۱.۵ یادداشت‌های مستندات و پشتیبانی: یادداشت‌های چسبان (Sticky notes) تعبیه شده در گردش کار، راهنمایی‌های دقیق، دستورالعمل‌های استفاده، نکات عیب‌یابی و اطلاعات تماس پشتیبانی را ارائه می‌دهند.

---

۲. تشریح گره‌ها (Nodes)

۲.۱ دریافت ورودی

• هدف: این بخش به عنوان نقطه ورود گردش کار (workflow) عمل می‌کند و پرس‌وجوهای کاربر و شناسه‌های جلسه را برای شروع فرآیند تجزیه و تحلیل دریافت می‌کند.
• گره‌ها (Nodes):

* گره راه‌انداز ورودی گردش کار (Workflow Input Trigger)

* نوع: executeWorkflowTrigger

* نقش: اجرای گردش کار را آغاز می‌کند. این گره برای پذیرش ورودی‌هایی مانند message (پرس‌وجوی کاربر) و sessionId (برای حفظ زمینه مکالمه) طراحی شده است.

* پیکربندی: منتظر راه‌اندازهای خارجی (مانند وب‌هوک‌ها، ادغام با پلتفرم‌هایی مانند تلگرام) برای ارائه پارامترهای ورودی لازم است.

* ورودی‌ها: داده‌ها از یک راه‌انداز خارجی.

* خروجی‌ها: داده‌های دریافتی را به گره "عامل تحلیل OpenSea" (OpenSea Analytics Agent) ارسال می‌کند.

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

۲.۲ هسته پردازش هوش مصنوعی

• هدف: این بخش مسئول تفسیر پرس‌وجوهای کاربر با استفاده از یک مدل زبان هوش مصنوعی و حفظ زمینه مکالمه برای تعاملات چندمرحله‌ای است.
• گره‌ها (Nodes):

* مغز عامل تحلیل (Analytics Agent Brain)

* نوع: lmChatOpenAi (پیکربندی شده با مدلی از OpenAI مانند GPT-4o-mini)

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

* پیکربندی: از یک مدل مشخص OpenAI (مانند GPT-4o-mini) با تنظیمات پیش‌فرض استفاده می‌کند. به اعتبارنامه‌های معتبر OpenAI API نیاز دارد.

* ورودی‌ها: مستقیماً به گره‌های ورودی متصل نیست؛ به عنوان مدل زبانی مورد استفاده گره عامل عمل می‌کند.

* خروجی‌ها: داده‌های پردازش شده پرس‌وجو را به گره عامل ارائه می‌دهد.

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

* حافظه عامل تحلیل (Analytics Agent Memory)

* نوع: memoryBufferWindow

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

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

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

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

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

۲.۳ ابزارهای یکپارچه‌سازی API OpenSea

• هدف: این بخش شامل چندین گره toolHttpRequest است که هر کدام به عنوان یک ابزار هوش مصنوعی برای واکشی داده‌های خاص از نقاط پایانی مختلف API OpenSea پیکربندی شده‌اند.
• گره‌ها (Nodes):

* دریافت آمار مجموعه OpenSea (OpenSea Get Collection Stats)

* نوع: toolHttpRequest

* نقش: آمار جامع یک مجموعه NFT، از جمله قیمت کف (floor price)، حجم معاملات، تعداد فروش و ارزش بازار را بازیابی می‌کند.

* پیکربندی:

* URL: https://api.opensea.io/api/v2/collections/{collection_slug}/stats

* هدرها (Headers): Accept: application/json

* احراز هویت (Authentication): احراز هویت هدر HTTP با استفاده از کلید API OpenSea.

* پارامترها (Parameters): collection_slug (به صورت پویا ارائه می‌شود).

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

* خروجی‌ها: داده‌های JSON حاوی آمار مجموعه را برمی‌گرداند.

* ملاحظات: یک slug نامعتبر منجر به خطای 404 می‌شود. کلیدهای API گمشده باعث شکست احراز هویت می‌شوند.

* دریافت رویدادهای OpenSea (OpenSea Get Events)

* نوع: toolHttpRequest

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

* پیکربندی:

* URL: https://api.opensea.io/api/v2/events

* پارامترهای کوئری (Query Parameters): event_type, after, before, limit, next (همه اختیاری).

* هدرها (Headers): Accept: application/json

* احراز هویت (Authentication): احراز هویت هدر HTTP با استفاده از کلید API OpenSea.

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

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

* ملاحظات: پارامترهای نامعتبر می‌توانند منجر به خطاهای 400 شوند و خرابی API ممکن است منجر به خطاهای 500 شود.

* دریافت رویدادهای OpenSea بر اساس حساب (OpenSea Get Events by Account)

* نوع: toolHttpRequest

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

* پیکربندی:

* URL: https://api.opensea.io/api/v2/events/accounts/{address}

* پارامترهای کوئری (Query Parameters): after, before, chain, event_type, limit, next (اختیاری).

* هدرها (Headers): Accept: application/json

* احراز هویت (Authentication): احراز هویت هدر HTTP با استفاده از کلید API OpenSea.

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

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

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

* دریافت رویدادهای OpenSea بر اساس مجموعه (OpenSea Get Events by Collection)

* نوع: toolHttpRequest

* نقش: رویدادهای مربوط به یک مجموعه NFT خاص را واکشی می‌کند.

* پیکربندی:

* URL: https://api.opensea.io/api/v2/events/collection/{collection_slug}

* پارامترهای کوئری (Query Parameters): after, before, event_type, limit, next (اختیاری).

* هدرها (Headers): Accept: application/json

* احراز هویت (Authentication): احراز هویت هدر HTTP با استفاده از کلید API OpenSea.

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

* خروجی‌ها: داده‌های رویداد JSON را برای مجموعه مشخص شده برمی‌گرداند.

* ملاحظات: slug یا پارامترهای نامعتبر می‌توانند باعث خطا شوند.

* دریافت رویدادهای OpenSea بر اساس NFT (OpenSea Get Events by NFT)

* نوع: toolHttpRequest

* نقش: داده‌های رویداد تاریخی یک NFT خاص را بازیابی می‌کند که با بلاک‌چین، آدرس قرارداد و شناسه توکن آن شناسایی می‌شود.

* پیکربندی:

* URL: https://api.opensea.io/api/v2/events/chain/{chain}/contract/{address}/nfts/{identifier}

* پارامترهای کوئری (Query Parameters): after, before, event_type, limit, next (اختیاری).

* هدرها (Headers): Accept: application/json

* احراز هویت (Authentication): احراز هویت هدر HTTP با استفاده از کلید API OpenSea.

* ورودی‌ها: chain, آدرس قرارداد، شناسه توکن و فیلترهای اختیاری ارائه شده توسط عامل هوش مصنوعی.

* خروجی‌ها: تاریخچه رویداد JSON را برای NFT خاص برمی‌گرداند.

* ملاحظات: پارامتر chain باید از لیست مجاز باشد (مانند matic برای Polygon). بلاک‌چین، آدرس یا شناسه نامعتبر منجر به خطا می‌شود.

۲.۴ ارکستراسیون عامل هوش مصنوعی

• هدف: گره "عامل تحلیل OpenSea" (OpenSea Analytics Agent) به عنوان ارکستراتور مرکزی عمل می‌کند. این گره پرس‌وجوهای کاربر را دریافت می‌کند، آن‌ها را با استفاده از مغز و حافظه هوش مصنوعی تفسیر می‌کند و به طور پویا گره‌های ابزار API OpenSea مناسب را برای بازیابی داده‌های درخواستی فراخوانی می‌کند.
• گره‌ها (Nodes):

* عامل تحلیل OpenSea (OpenSea Analytics Agent)

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

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

* پیکربندی:

* عبارت متن ورودی (Input text expression): ={{ $json.message }} (به پرس‌وجوی کاربر ارجاع می‌دهد).

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

* ابزارهای پیوند داده شده (Tools linked): شامل تمام گره‌های toolHttpRequest API OpenSea، "مغز عامل تحلیل" (Analytics Agent Brain) و "حافظه عامل تحلیل" (Analytics Agent Memory) است.

* ورودی‌ها: پرس‌وجوی کاربر را از "گره راه‌انداز ورودی گردش کار" (Workflow Input Trigger) دریافت می‌کند.

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

* ملاحظات:

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

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

* اجرای قراردادهای نام‌گذاری خاص برای نام‌های بلاک‌چین (مانند نگاشت "polygon" به "matic") حیاتی است.

* الزامات نسخه: سازگاری با نسخه v1.8+ گره عامل Langchain یا نسخه سازگار را تضمین کنید.

۲.۵ یادداشت‌های مستندات و پشتیبانی

• هدف: یادداشت‌های چسبان (Sticky Notes) به صورت استراتژیک در بوم گردش کار قرار گرفته‌اند تا مستندات، دستورالعمل‌های استفاده، راهنمایی عیب‌یابی و اطلاعات تماس پشتیبانی را به راحتی در دسترس قرار دهند.
• گره‌ها (Nodes):

* یادداشت چسبان (Sticky Note) (نمونه‌های متعدد)

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

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

---

۳. جدول خلاصه