پرش به متن
محاسب ۳۶۵ نرم‌افزار حسابداری، انبار و فروش
مردی پشت میز که کلیدی کوچک در دست دارد، و روی صفحه‌ی لپ‌تاپش درجه‌ای گرد دیده می‌شود که سقفی تا میانه‌ی مسیر روی آن نشانه‌گذاری شده است.

کلید API دستیار n8n: راه‌اندازی با سقف خرج

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

در پایان این راهنما دستیار هوش مصنوعی n8n به یک مدل وصل است و با گفت‌وگو برایتان گردش کار می‌سازد — با کلیدی که سقف خرج دارد و تاریخ انقضا، و نمی‌تواند یک‌شبه اعتبارتان را ببرد. مهم‌ترین نکته این است که ترتیب کارها را رعایت کنید: اول فضای کاری با سقف، بعد کلید. برعکسش قابل اصلاح نیست و باید کلید را دور بیندازید.

این نوشته ادامه‌ی شروع کار با n8n است. دستیار اختیاری است و اگر سراغش نروید، هیچ قابلیتی از n8n را از دست نمی‌دهید.

دستیار چیست و چه چیزی نیست

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

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

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

ترتیب درست، در یک نگاه

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

گام ۱: حساب توسعه‌دهنده بسازید

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

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

⚠ این حساب با اشتراک گفت‌وگوی همان شرکت یکی نیست. اگر دنبال کلید در تنظیمات اشتراکتان می‌گردید، آن‌جا نیست.

گام ۲: فضای کاری با سقف خرج بسازید

کجا: تنظیمات حساب، بخش فضاهای کاری.
چه کنید: یک فضای کاری تازه بسازید و برایش سقف خرج ماهانه بگذارید.

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

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

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

گام ۳: کلید را بسازید

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

قلمچه بگذاریدچرا
نامنامی که بگوید کجا استفاده می‌شودشش ماه بعد باید بدانید کدام کلید مال کدام سامانه است
انقضاتاریخ بگذارید، مثلاً نود روزکلیدی که تاریخ ندارد، اگر نشت کند تا ابد باز است
دامنه‌ی دسترسیهمان فضای کاری گام ۲سقف خرج از همین‌جا اعمال می‌شود

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

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

گام ۴: کلید را در n8n بگذارید

کجا: در n8n، بخش تنظیمات دستیار.
چه کنید: ارائه‌دهنده را انتخاب کنید، کلید را بچسبانید و مدل را انتخاب کنید.

چه می‌بینید: پنجره به مرحله‌ی بعد می‌رود. همین یعنی کلید پذیرفته شد.
اگر نه: اگر رد شد، معمولاً یا کلید کامل کپی نشده یا دامنه‌ی دسترسی‌اش اشتباه است.

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

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

فهرست مدل‌ها معمولاً یکی را «پیشنهادی» علامت می‌زند و آن گران‌ترینشان است. برای شروع، مدل میانی را بگذارید: کارتان را راه می‌اندازد و اعتبارتان چند برابر بیشتر دوام می‌آورد. اگر دیدید برای گردش کارهای پیچیده کم می‌آورد، همان‌جا عوضش کنید.

گام ۵: محیط ایزوله را رد کنید

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

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

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

از کجا بفهمید درست شد

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

عیب‌یابی

نشانهعلتچاره
کلید پذیرفته نمی‌شودکلید ناقص کپی شده یا دامنه‌ی دسترسی‌اش غلط استکلید تازه بسازید و این بار کامل کپی کنید
کلید پذیرفته شد ولی پرسش جواب نمی‌گیردسرویس درخواست را از نشانی سرور شما قبول نمی‌کندهمان کلید را از دستگاه دیگری بسنجید تا معلوم شود ایراد از کلید است یا از مسیر
اعتبار سریع‌تر از انتظار تمام می‌شودمدل گران انتخاب شده یا گردش کاری در حلقه افتادهمدل میانی را بگذارید و در حساب ببینید کدام روز پرخرج بوده
سقف خرج روی کلید پیدا نمی‌شودسقف روی فضای کاری است، نه روی کلیددر بخش هزینه، همان فضای کاری را انتخاب کنید
کلید در فضای پیش‌فرض ساخته شدهفضای کاری سر ساختن کلید تعیین می‌شودکلید را باطل کنید و یکی تازه با دامنه‌ی درست بسازید

محدودیت‌ها

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

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

پرسش‌های پرتکرار

دستیار n8n برای کار کردن به چه چیزی احتیاج دارد؟
یک کلید API از حساب توسعه‌دهنده‌ی همان شرکتی که مدلش را می‌خواهید. اشتراک معمولی گفت‌وگو چنین کلیدی نمی‌دهد؛ حساب و اعتبارش جداست.
چرا باید اول فضای کاری بسازم و بعد کلید؟
چون سقف خرج روی فضای کاری می‌نشیند نه روی کلید، و فضای کاری هر کلید سر ساختنش تعیین می‌شود و بعداً جابه‌جا نمی‌شود. کلیدی که در فضای پیش‌فرض ساخته شود هیچ سقفی ندارد.
اگر گردش کاری در حلقه بیفتد چقدر ممکن است خرج شود؟
تا همان سقفی که روی فضای کاری گذاشته‌اید. بدون سقف، تا جایی که اعتبارتان برسد. برای شروع یک سقف کوچک بگذارید و بعد بالا ببرید.
کلید را کجا نگه دارم؟
فقط داخل خود برنامه. در هیچ تصویر و پیامی نفرستیدش؛ تصویری که از صفحه می‌گیرید در پوشه‌های موقت و بایگانی‌ها می‌ماند. اگر یک بار این اتفاق افتاد، باطل کردن کلید تنها راه کامل است.
کدام مدل را انتخاب کنم؟
فهرست معمولاً گران‌ترین را پیشنهادی علامت می‌زند. برای شروع مدل میانی را بگذارید؛ کارتان را راه می‌اندازد و اعتبارتان چند برابر بیشتر دوام می‌آورد.
محیط ایزوله‌ی اجرای کد لازم است؟
نه برای کار معمولی. مستند n8n می‌گوید دست‌کم چهار گیگابایت حافظه و دو هسته می‌خواهد و باید روی ماشینی باشد که هیچ چیز دیگری رویش نیست، چون اجراکننده‌اش با دسترسی کامل بالا می‌آید.
داده‌ی گردش کار من کجا می‌رود؟
پرسش‌ها، گردش کارها و داده‌ی اجرا به همان سرویس مدل می‌رود. خود n8n این را در پنجره‌ی اتصال می‌نویسد. برای داده‌ی مشتری این یک تصمیم است، نه یک تیک.
کلید پذیرفته شد ولی پرسش جواب نمی‌گیرد، چرا؟
سنجش کلید و صدا زدن واقعی مدل دو چیز جدا هستند. همان کلید را از دستگاه دیگری بسنجید تا معلوم شود ایراد از کلید است یا از مسیر شبکه‌ی سرور.

نظرها

نظرها در حالِ بار شدن است…

مطلب‌های دیگر