اتوماسیون API Clarify با n8n و عوامل هوش مصنوعی

جستجو و تحلیل داده‌های صوتی و تصویری با API Clarify و ادغام عامل هوش مصنوعی

این گردش کار یک رابط سرور API جامع و خودکار برای Clarify API (https://api.clarify.io/) ارائه می‌دهد. این رابط ۲۱ عملیات متمایز Clarify API را در دسترس قرار می‌دهد که برای ادغام یکپارچه با عامل‌های هوش مصنوعی از طریق یک تریگر پلتفرم چند کاناله (MCP) طراحی شده است. این امر به عامل‌های هوش مصنوعی امکان می‌دهد تا بسته‌های رسانه‌ای را به صورت برنامه‌نویسی مدیریت کنند، به گزارش‌ها دسترسی یابند و در داده‌های صوتی و تصویری جستجو انجام دهند، با پارامترهایی که به صورت پویا از طریق عبارات مبتنی بر هوش مصنوعی تزریق می‌شوند.

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

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

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

1. راه‌اندازی و رابط سرور MCP: نقطه ورود برای عامل‌های هوش مصنوعی را پیکربندی می‌کند و اطلاعات ضروری راه‌اندازی و نمای کلی را ارائه می‌دهد.

2. عملیات بسته‌ها: مجموعه‌ای کامل از عملیات CRUD و مدیریتی را برای بسته‌های رسانه‌ای، آهنگ‌ها، فراداده‌ها و بینش‌ها پیاده‌سازی می‌کند.

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

---

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

۱. راه‌اندازی سرور MCP و رابط کاربری

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

گره‌ها (Nodes):

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

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

* پیکربندی: محتوای متنی ثابت.

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

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

* پیکربندی: محتوای markdown ثابت.

• سرور MCP Clarify API (MCP Trigger - @n8n/n8n-nodes-langchain.mcpTrigger)

* نقش: به عنوان نقطه ورود اصلی عمل می‌کند و یک URL وب‌هوک (مانند your-n8n-url/api/v1/webhook/clarify-api-mcp) را برای فراخوانی عملیات Clarify API توسط عامل‌های هوش مصنوعی در دسترس قرار می‌دهد.

* پیکربندی: مسیر روی clarify-api-mcp تنظیم شده است.

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

* خروجی: درخواست‌های ورودی را بر اساس درخواست عامل هوش مصنوعی به گره‌های مناسب HTTP Request Tool هدایت می‌کند.

* موارد لبه‌ای (Edge Cases):

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

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

* نکته نسخه: به نسخه n8n نیاز دارد که از گره @n8n/n8n-nodes-langchain.mcpTrigger پشتیبانی کند.

---

۲. عملیات بسته‌ها (Bundles)

این بلوک عملکرد اصلی است که قابلیت‌های مدیریتی جامعی را برای بسته‌های رسانه از طریق ۱۸ گره اختصاصی HTTP Request Tool ارائه می‌دهد. هر گره مستقیماً به یک نقطه پایانی خاص Clarify API برای اقدامات مربوط به بسته نگاشت می‌شود.

گره‌ها (Nodes):

• لیست بسته‌ها (HTTP Request Tool)

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

* پیکربندی: GET /v1/bundles

* عبارات کلیدی (Key Expressions): $fromAI('limit', ...), $fromAI('embed', ...), $fromAI('iterator', ...)

• ایجاد بسته (HTTP Request Tool)

* نقش: یک بسته رسانه جدید ایجاد می‌کند.

* پیکربندی: POST /v1/bundles

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

• حذف بسته (HTTP Request Tool)

* نقش: یک بسته را با شناسه آن حذف می‌کند.

* پیکربندی: DELETE /v1/bundles/{{bundle_id}}

* عبارات کلیدی (Key Expressions): $fromAI('bundle_id', ...)

• بازیابی بسته (HTTP Request Tool)

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

* پیکربندی: GET /v1/bundles/{{bundle_id}}

* عبارات کلیدی (Key Expressions): $fromAI('bundle_id', ...), $fromAI('embed', ...)

• به‌روزرسانی بسته (HTTP Request Tool)

* نقش: جزئیات یک بسته موجود را با شناسه آن به‌روزرسانی می‌کند.

* پیکربندی: PUT /v1/bundles/{{bundle_id}}

* عبارات کلیدی (Key Expressions): $fromAI('bundle_id', ...)

• بازیابی بینش‌های بسته (HTTP Request Tool)

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

* پیکربندی: GET /v1/bundles/{{bundle_id}}/insights

* عبارات کلیدی (Key Expressions): $fromAI('bundle_id', ...)

• درخواست اجرای بینش (HTTP Request Tool)

* نقش: فرآیند تجزیه و تحلیل بینش را برای