دسترسی به داده‌های CO2 با API CarbonDoomsDay برای ایجنت‌های ه…

دسترسی به داده‌های اندازه‌گیری CO2 با API CarbonDoomsDay برای ایجنت‌های هوش مصنوعی

این گردش کار به عنوان یک سرور MCP (Model-Controller-Provider) عمل می‌کند و API CarbonDoomsDay را در دسترس ایجنت‌های هوش مصنوعی قرار می‌دهد. این امکان را به ایجنت‌ها می‌دهد تا داده‌های اندازه‌گیری دی‌اکسید کربن (CO2) را به صورت لحظه‌ای و تاریخی از رصدخانه Mauna Loa استعلام کنند.

شما می‌توانید این گردش کار و سایر گردش کارها را در کاتالوگ Axeto پیدا کنید: گردش کارهای n8n Axeto AI

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

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

1. راه‌اندازی و مستندات: شامل یادداشت‌های چسبان برای نگهداری‌کنندگان و یکپارچه‌سازان گردش کار.

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

3. تعامل با API - بازیابی داده‌های CO2: شامل نودهای ابزار درخواست HTTP برای دریافت داده‌های CO2 از API CarbonDoomsDay.

---

تجزیه و تحلیل بلوک به بلوک

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

این بلوک دستورالعمل‌های ضروری راه‌اندازی، راهنمای استفاده و نمای کلی از هدف گردش کار را ارائه می‌دهد.

• نودها:

* دستورالعمل‌های راه‌اندازی (یادداشت چسبان)

* مرور کلی گردش کار (یادداشت چسبان)

* برچسب CO2 (یادداشت چسبان)

• جزئیات:

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

* مرور کلی گردش کار (یادداشت چسبان): هدف گردش کار را به عنوان یک سرور API شبیه REST در زمان واقعی برای سطوح CO2 از طریق CarbonDoomsDay توضیح می‌دهد و نقش نودها و عملیات موجود را خلاصه می‌کند.

* برچسب CO2 (یادداشت چسبان): یک برچسب بصری که نودهای درخواست HTTP مربوط به CO2 را گروه‌بندی می‌کند.

---

۲. نقطه پایانی تریگر MCP

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

• نودها:

* سرور MCP CarbonDoomsDay (تریگر MCP)

• جزئیات:

* سرور MCP CarbonDoomsDay (تریگر MCP):

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

* نقش: یک وب‌هوک در مسیر /carbondoomsday-mcp برای فراخوانی توسط ایجنت‌های هوش مصنوعی ایجاد می‌کند. این به عنوان رابط سرور برای ابزارهای هوش مصنوعی سازگار با MCP عمل می‌کند.

* پیکربندی:

* مسیر وب‌هوک: /carbondoomsday-mcp

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

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

* الزامات نسخه: نیاز به نسخه n8n 1.94 یا بالاتر دارد.

* موارد لبه‌ای:

* URL وب‌هوک باید به صورت عمومی قابل دسترسی باشد.

* در صورت در دسترس نبودن گردش کار یا سرور، احتمال بروز مشکل در زمان‌بندی یا اتصال وجود دارد.

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

---

۳. تعامل با API - بازیابی داده‌های CO2

این بلوک شامل نودهای ابزار درخواست HTTP است که با API CarbonDoomsDay تعامل دارند. عبارات مبتنی بر هوش مصنوعی به طور پویا پارامترهای پرس و جو و مسیر را پر می‌کنند.

• نودها:

* لیست اندازه‌گیری‌های CO2 (ابزار درخواست HTTP)

* دریافت اندازه‌گیری CO2 بر اساس تاریخ (ابزار درخواست HTTP)

• جزئیات:

* لیست اندازه‌گیری‌های CO2 (ابزار درخواست HTTP):

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

* نقش: نقطه پایانی /api/co2/ را برای لیست کردن اندازه‌گیری‌های CO2 استعلام می‌کند و از فیلترها و صفحه‌بندی اختیاری پشتیبانی می‌کند.

* پیکربندی:

* URL: https://api.carbondoomsday.com/api/co2/

* متد: GET

* احراز هویت: احراز هویت هدر HTTP عمومی (از طریق اعتبارنامه‌ها پیکربندی شده است).

* پارامترهای پرس و جو: به طور پویا با استفاده از عبارات $fromAI() برای پارامترهایی مانند ppm، date، date__range، ordering، page و limit پر می‌شود.

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

* ورودی: از نود تریگر MCP هنگام فراخوانی ابزار "لیست اندازه‌گیری‌های CO2".

* خروجی: پاسخ خام JSON را از API CarbonDoomsDay برمی‌گرداند.

* موارد لبه‌ای:

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

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

* خطاهای احراز هویت در صورت نادرست یا مفقود بودن اعتبارنامه‌ها.

* زمان‌بندی شبکه یا خرابی API.

* دریافت اندازه‌گیری CO2 بر اساس تاریخ (ابزار درخواست HTTP):

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

* نقش: داده‌های اندازه‌گیری CO2 را برای یک تاریخ خاص از نقطه پایانی /api/co2/{date}/ دریافت می‌کند.

* پیکربندی:

* URL: https://api.carbondoomsday.com/api/co2/{{ $fromAI('date', 'Date', 'string') }}/

* متد: GET

* احراز هویت: احراز هویت هدر HTTP عمومی (از طریق اعتبارنامه‌ها).

* پارامتر مسیر: date، که به طور پویا از طریق عبارت $fromAI() پر می‌شود.

* توضیحات ابزار: مشابه نود "لیست اندازه‌گیری‌های CO2".

* ورودی: از نود تریگر MCP هنگام فراخوانی ابزار "دریافت اندازه‌گیری CO2 بر اساس تاریخ".

* خروجی: پاسخ خام JSON از API.

* موارد لبه‌ای:

* فرمت تاریخ مفقود یا نامعتبر می‌تواند باعث خطاهای API شود (به عنوان مثال، 404، 400).

* شکست احراز هویت.

* مشکلات شبکه یا زمان‌بندی.

---

جدول خلاصه

---

بازتولید گردش کار

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

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

* یک یادداشت چسبان "مرور کلی گردش کار" ایجاد کنید که هدف گردش کار، نقش سرور MCP، استفاده از پارامترهای هوش مصنوعی و عملیات را توضیح دهد.

* یک یادداشت چسبان کوچک "CO2" به عنوان برچسب بصری اضافه کنید.

2. افزودن نود تریگر MCP:

* یک نود تریگر MCP (@n8n/n8n-nodes-langchain.mcpTrigger) اضافه کنید.

* مسیر وب‌هوک را روی "carbondoomsday-mcp" تنظیم کنید.

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

3. ایجاد نود درخواست HTTP "لیست اندازه‌گیری‌های CO2":

* یک نود ابزار درخواست HTTP (n8n-nodes-base.httpRequestTool) اضافه کنید.

* URL: https://api.carbondoomsday.com/api/co2/

* متد: GET

* احراز هویت: احراز هویت هدر HTTP عمومی را از طریق اعتبارنامه‌ها پیکربندی کنید.

* پارامترهای پرس و جو: پارامترها را با مقادیر تنظیم شده با استفاده از عبارات $fromAI() اضافه کنید:

* ppm: {{$fromAI('ppm', 'Ppm', 'number')}}

* date: {{$fromAI('date', 'Date', 'string')}}

* date__range: {{$fromAI('date__range', 'Multiple values may be separated by commas.', 'string')}}

* ordering: {{$fromAI('ordering', 'Which field to use when ordering the results.', 'string')}}

* page: {{$fromAI('page', 'A page number within the paginated result set.', 'number')}}

* limit: {{$fromAI('limit', 'Number of results to return per page.', 'number')}}

* یک توضیحات ابزار توصیفی اضافه کنید.

4. ایجاد نود درخواست HTTP "دریافت اندازه‌گیری CO2 بر اساس تاریخ":

* یک نود ابزار درخواست HTTP (n8n-nodes-base.httpRequestTool) اضافه کنید.

* URL: https://api.carbondoomsday.com/api/co2/{{$fromAI('date', 'Date', 'string')}}/"

* متد: GET

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

* یک توضیحات ابزار توصیفی اضافه کنید.

5. اتصال نودها:

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

6. راه‌اندازی اعتبارنامه‌ها:

* اطمینان حاصل کنید که اعتبارنامه‌های لازم برای API CarbonDoomsDay در n8n پیکربندی شده‌اند.