اتصال کلاد به n8n؛ از کلید تا اولین اجرای موفق

اتصال کلاد به n8n نقطه‌ای است که یک ورک‌فلو از «جابه‌جا کردن داده» به «تصمیم گرفتن درباره‌ی داده» می‌رسد. تا قبل از آن، ورک‌فلو فقط اطلاعات را از جایی به جای دیگر می‌برد. بعد از آن، می‌تواند بخواند، بفهمد، دسته‌بندی کند و بنویسد.

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

اتصال کلاد به n8n چه چیزهایی لازم دارد

سه چیز، نه بیشتر.

یک کلید API از انتروپیک. این کلید از حساب توسعه‌دهنده‌ی کلاد (Claude API) گرفته می‌شود؛ مستندات رسمی Claude API نحوه‌ی ساختش را توضیح می‌دهد و با اشتراک ماهانه‌ی کلاد فرق دارد. اشتراک برای استفاده از اپلیکیشن است؛ کلید برای اتصال برنامه‌ها. دو صورت‌حساب جدا دارند.

یک نمونه‌ی n8n که بالا باشد. چه ابری، چه روی سرور خودتان. تفاوتی در این مرحله ندارد.

یک کار مشخص. این را جدی بگیرید. «می‌خواهم هوش مصنوعی داشته باشم» یک هدف نیست. «می‌خواهم پیام‌های ورودی را به سه دسته تقسیم کنم» یک هدف است.

مسیر اتصال، قدم به قدم

قدم ششم جایی است که بیشترین وقت را می‌گیرد و بیشترین ارزش را دارد. بقیه‌ی قدم‌ها مکانیکی هستند و مستندات رسمی n8n برای اعتبارنامه‌ی Anthropic و بلوک Anthropic Chat Model هر دو را دقیق نشان می‌دهند.

اگر با محیط n8n آشنا نیستید، آموزش n8n فارسی پیش‌نیاز خوبی است.

کدام مدل را انتخاب کنید

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

Haiku برای کارهای ساده و پرتکرار. دسته‌بندی، برچسب‌گذاری، تشخیص زبان، استخراج یک عدد از متن. سریع است و ارزان.

Sonnet برای اکثر کارها. خلاصه‌سازی، نوشتن پاسخ، تحلیل متوسط. تعادل خوبی بین سرعت، دقت و هزینه دارد و برای شروع بهترین انتخاب است.

Opus برای کارهایی که واقعاً پیچیده‌اند. تحلیل چندمرحله‌ای، تصمیم‌های ظریف، متن‌های طولانی و به‌هم‌ریخته.

قاعده‌ی ساده: با Sonnet شروع کنید. اگر خروجی خوب بود و می‌خواهید ارزان‌تر شود، Haiku را امتحان کنید. اگر خروجی ضعیف بود، به Opus بروید. مقایسه‌ی کامل‌تر در کلاد سونت چیست آمده است و فهرست به‌روز مدل‌ها و قیمتشان در صفحه‌ی رسمی مدل‌های Claude هست.

پرامپت را چطور بنویسید که در ورک‌فلو جواب بدهد

پرامپت داخل اتوماسیون با پرامپتی که در چت می‌نویسید فرق دارد. در چت اگر جواب بد بود، دوباره می‌پرسید. در ورک‌فلو کسی نیست که دوباره بپرسد.

پس سه چیز را رعایت کنید.

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

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

مثال بدهید. یک نمونه ورودی و خروجی درست، بیشتر از سه پاراگراف توضیح کمک می‌کند.

سه ورک‌فلو که ارزش ساختن دارند

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

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

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

تولید پیش‌نویس پاسخ. به‌جای اینکه ربات مستقیم به مشتری جواب بدهد، پیش‌نویس پاسخ را آماده می‌کند و برای تأیید انسان می‌فرستد. این حالت هم سرعت را بالا می‌برد و هم ریسک جواب اشتباه را حذف می‌کند. برای شروع، امن‌ترین الگوست.

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

کنترل هزینه پیش از آنکه دیر شود

یک ورک‌فلو که روزی هزار بار اجرا می‌شود، هزار بار هزینه دارد. چند کار ساده هزینه را چند برابر کم می‌کند.

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

دوم، خروجی را کوتاه بخواهید. حداکثر طول پاسخ را در تنظیمات بلوک مشخص کنید.

سوم، قبل از رسیدن به مدل فیلتر بگذارید. اگر پیام کمتر از پنج کلمه است، شاید اصلاً نیازی به پردازش نداشته باشد.

روش‌های بیشتر در کاهش مصرف توکن توضیح داده شده است.

خطاهای رایج و علتشان

خطای ۴۰۱. کلید اشتباه است یا فاصله‌ی اضافه دارد. دوباره کپی کنید.

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

خروجی JSON نامعتبر. مدل توضیح اضافه نوشته. در پرامپت صریح بگویید فقط JSON و هیچ متن دیگری.

پاسخ ناقص. حداکثر طول خروجی کم است. مقدارش را بالا ببرید.

اجرا خیلی کند است. یا مدل سنگین انتخاب شده یا متن ورودی طولانی است. هر دو قابل اصلاح است.

سوالات متداول

آیا اشتراک ماهانه‌ی کلاد برای این اتصال کافی است؟

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

داده‌های من کجا می‌روند؟

داده‌ای که در پرامپت می‌فرستید به سرور انتروپیک می‌رود و پاسخ برمی‌گردد. اگر اطلاعات حساس دارید، قبل از ارسال آن‌ها را حذف یا جایگزین کنید.

می‌شود چند بلوک کلاد در یک ورک‌فلو داشت؟

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

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

بلوک خطا می‌دهد و ورک‌فلو متوقف می‌شود. برای کارهای مهم یک مسیر جایگزین تعریف کنید که خطا را ثبت کند و بعداً دوباره تلاش کند.

قدم بعدی

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

می‌خواهید خودتان بسازید؟ فصل اتوماسیون دوره‌ی سفر هوش مصنوعی همین اتصال را با مثال‌های واقعی آموزش می‌دهد.

ورک‌فلوهای آماده و نکته‌های کوتاه را در کانال تلگرام منتشر می‌کنیم.