مدیریت خودکار گزارش هزینه AWS با عوامل هوش مصنوعی

مدیریت خودکار گزارش هزینه و استفاده AWS با عوامل هوش مصنوعی

این گردش کار به عوامل هوش مصنوعی امکان می‌دهد تا گزارش‌های هزینه و استفاده AWS (CUR) را از طریق رابط سرور MCP (پروتکل کنترل ماشین) به صورت برنامه‌نویسی مدیریت کنند. این گردش کار عملیات اصلی CUR - ایجاد، اصلاح، فهرست‌بندی و حذف تعاریف گزارش - را از طریق گره‌های ابزار درخواست HTTP n8n در دسترس قرار می‌دهد و امکان مدیریت خودکار و مبتنی بر هوش مصنوعی گزارش‌های صورتحساب AWS را فراهم می‌کند.

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

---

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

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

موارد استفاده کلیدی:

• مدیریت گزارش مبتنی بر هوش مصنوعی: عوامل هوش مصنوعی می‌توانند تعاریف گزارش هزینه و استفاده AWS را بر اساس الزامات یا تحلیل‌های در حال تحول ایجاد، به‌روزرسانی، فهرست‌بندی یا حذف کنند.
• ردیابی خودکار هزینه: با سیستم‌های مبتنی بر هوش مصنوعی ادغام شوید تا اطمینان حاصل کنید که گزارش‌های ردیابی هزینه AWS شما همیشه به درستی پیکربندی شده‌اند.
• بهینه‌سازی DevOps: راه‌اندازی و نگهداری گزارش‌های صورتحساب AWS را به عنوان بخشی از خطوط لوله هوش مصنوعی CI/CD یا عملیاتی خود خودکار کنید.

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

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

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

3. گره‌های عملیات API AWS: چهار گره httpRequestTool که هر کدام به یک عمل خاص API گزارش هزینه و استفاده AWS اختصاص داده شده‌اند:

* DeleteReportDefinition

* DescribeReportDefinitions

* ModifyReportDefinition

* PutReportDefinition

4. یادداشت‌های گروه‌بندی عملیات: یادداشت‌های چسبان که برای سازماندهی بصری و برچسب‌گذاری هر عملیات API AWS در ویرایشگر n8n استفاده می‌شوند.

---

۲. تشریح جزئیات گردش کار

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

این بخش حاوی اطلاعات حیاتی برای کاربران و اپراتورها است.

• گره‌ها (Nodes):

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

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

• جزئیات:

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

* هدف: کاربران را در طول راه‌اندازی گردش کار، پیکربندی اعتبارنامه‌ها (کلید API در هدر Authorization)، فعال‌سازی و نحوه استفاده از URL MCP راهنمایی می‌کند. این بخش بر استفاده از عبارات هوش مصنوعی مانند $fromAI() برای تزریق پارامترهای پویا تأکید دارد و پیوندهایی به پشتیبانی Discord و مستندات n8n ارائه می‌دهد.

* مکان: بالا-چپ ویرایشگر n8n.

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

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

* هدف: API گزارش هزینه و مصرف AWS را توضیح می‌دهد، نقش گردش کار در نمایش آن از طریق یک رابط سازگار با MCP، و عملکرد گره‌های MCP Trigger و HTTP Request را شرح می‌دهد.

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

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

۲.۲ نقطه ورود سرور MCP

این گره به عنوان وب‌هوک (Webhook) عمل می‌کند که عوامل هوش مصنوعی با آن تعامل خواهند داشت.

• گره (Node): AWS Cost and Usage Report Service MCP Server
• نوع: @n8n/n8n-nodes-langchain.mcpTrigger
• عملکرد: منتظر درخواست‌های ورودی از عوامل هوش مصنوعی می‌ماند. این درخواست‌ها را بر اساس پارامترهای ارائه شده توسط هوش مصنوعی به گره‌های عملیات API مناسب AWS هدایت می‌کند.
• پیکربندی:

* مسیر وب‌هوک (Webhook Path): روی aws-cost-and-usage-report-service-mcp تنظیم شده است.

• اتصالات:

* ورودی: ندارد (این یک گره ماشه است).

* خروجی: از طریق اتصالات ai_tool به هر چهار گره عملیات API httpRequestTool AWS متصل می‌شود.

• نیازمندی‌ها: به نسخه n8n با پشتیبانی از گره‌های Langchain MCP (معمولاً v1.95+) نیاز دارد.
• ملاحظات:

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

* از پیکربندی صحیح احراز هویت (کلید API) در گره‌های HTTP Request بعدی اطمینان حاصل کنید.

* درخواست‌های هوش مصنوعی باید حاوی پارامترهای معتبر $fromAI() باشند تا از خطاهای ارزیابی عبارت جلوگیری شود.

۲.۳ گره‌های عملیات API AWS

این گره‌ها تعامل واقعی با سرویس گزارش هزینه و مصرف AWS را انجام می‌دهند. هر کدام از httpRequestTool با احراز هویت هدر HTTP عمومی استفاده می‌کنند.

#### ۲.۳.۱ حذف تعریف گزارش هزینه و مصرف AWS

• گره (Node): Deletes the specified report.
• نوع: n8n-nodes-base.httpRequestTool
• نقش: تعریف گزارش خاص AWS CUR را حذف می‌کند.
• پیکربندی:

* URL: http://cur.{region}.amazonaws.com/#X-Amz-Target=AWSOrigamiServiceGatewayService.DeleteReportDefinition

* متد (Method): POST

* احراز هویت: هدر HTTP عمومی (Authorization با کلید API).

* هدرها (Headers): شامل X-Amz-Target است که به صورت پویا از طریق $fromAI('X-Amz-Target', 'X Amz Target', 'string') تنظیم می‌شود.

* بدنه (Body): مطابق با نیاز API AWS ارسال می‌شود.

• اتصالات:

* ورودی: از AWS Cost and Usage Report Service MCP Server.

* خروجی: پاسخ API AWS را مستقیماً به سرور MCP باز می‌گرداند.

• موارد مرزی (Edge Cases):

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

* هدر X-Amz-Target نادرست می‌تواند باعث شکست تماس API شود.

* جای‌نگار {region} در URL باید به درستی توسط ورودی هوش مصنوعی یا پیکربندی دستی جایگزین شود.

• یادداشت مرتبط: "Delete Report Definition" (یادداشت چسبان).

#### ۲.۳.۲ لیست کردن گزارش‌های هزینه و مصرف AWS

• گره (Node): Lists the AWS Cost and Usage reports available to
• نوع: n8n-nodes-base.httpRequestTool
• نقش: لیستی صفحه‌بندی شده از تعاریف گزارش AWS CUR موجود را بازیابی می‌کند.
• پیکربندی:

* URL: http://cur.{region}.amazonaws.com/#X-Amz-Target=AWSOrigamiServiceGatewayService.DescribeReportDefinitions

* متد (Method): POST

* پارامترهای پرس و جو (Query Parameters):

* MaxResults: به صورت پویا از طریق $fromAI('MaxResults', 'Pagination limit', 'string') تنظیم می‌شود.

* NextToken: به صورت پویا از طریق $fromAI('NextToken', 'Pagination token', 'string') تنظیم می‌شود.

* هدرها (Headers): شامل X-Amz-Target از طریق عبارت هوش مصنوعی است.

* احراز هویت: هدر HTTP عمومی (Authorization با کلید API).

• اتصالات:

* ورودی: از AWS Cost and Usage Report Service MCP Server.

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

• موارد مرزی (Edge Cases):

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

* ممکن است برای مجموعه‌های نتایج بزرگ، محدودیت نرخ API رخ دهد.

* از مشخص شدن صحیح منطقه AWS اطمینان حاصل کنید.

• یادداشت مرتبط: "Describe Report Definitions" (یادداشت چسبان).

#### ۲.۳.۳ اصلاح تعریف گزارش هزینه و مصرف AWS

• گره (Node): Allows you to programmatically update your report p
• نوع: n8n-nodes-base.httpRequestTool
• نقش: یک تعریف گزارش AWS CUR موجود را به‌روزرسانی می‌کند.
• پیکربندی:

* URL: http://cur.{region}.amazonaws.com/#X-Amz-Target=AWSOrigamiServiceGatewayService.ModifyReportDefinition

* متد (Method): POST

* هدرها (Headers): شامل X-Amz-Target از طریق عبارت هوش مصنوعی است.

* احراز هویت: هدر HTTP عمومی (Authorization با کلید API).

* بدنه (Body): با پارامترهای به‌روزرسانی لازم ارسال می‌شود.

• اتصالات:

* ورودی: از AWS Cost and Usage Report Service MCP Server.

* خروجی: پاسخ API AWS که موفقیت یا شکست اصلاح را نشان می‌دهد.

• موارد مرزی (Edge Cases):

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

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

• یادداشت مرتبط: "Modify Report Definition" (یادداشت چسبان).

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

• گره (Node): Creates a new report using the description that yo
• نوع: n8n-nodes-base.httpRequestTool
• نقش: یک تعریف گزارش AWS CUR جدید با پارامترهای ارائه شده به صورت پویا ایجاد می‌کند.
• پیکربندی:

* URL: http://cur.{region}.amazonaws.com/#X-Amz-Target=AWSOrigamiServiceGatewayService.PutReportDefinition

* متد (Method): POST

* هدرها (Headers): شامل X-Amz-Target از طریق عبارت هوش مصنوعی است.

* احراز هویت: هدر HTTP عمومی (Authorization با کلید API).

* بدنه (Body): با جزئیات تعریف گزارش جدید ارسال می‌شود.

• اتصالات:

* ورودی: از AWS Cost and Usage Report Service MCP Server.

* خروجی: پاسخ API AWS که ایجاد گزارش را تأیید می‌کند.

• موارد مرزی (Edge Cases):

* پارامترهای گم‌شده یا بدشکل باعث شکست API می‌شود.

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

* جای‌نگار {region} باید به درستی جایگزین شود.

• یادداشت مرتبط: "Put Report Definition" (یادداشت چسبان).

۲.۴ یادداشت‌های گروه‌بندی عملیات

چهار یادداشت چسبان صرفاً برای سازماندهی بصری در ویرایشگر n8n استفاده می‌شوند:

• "Delete Report Definition"
• "Describe Report Definitions"
• "Modify Report Definition"
• "Put Report Definition"

---

۳. جدول خلاصه