راهنمای جامع اتصال و استفاده از API هوشی در پلتفرم n8n برای اتوماسیون گردش کار

مقدمه: اتوماسیون هوشمند با هوش مصنوعی و API

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

معرفی پلتفرم n8n: اتوماسیون گردش کار بدون نیاز به کدنویسی

n8n یک پلتفرم قدرتمند و انعطاف‌پذیر برای اتوماسیون گردش کار است که به کاربران اجازه می‌دهد فرآیندهای مختلف را با اتصال سرویس‌های گوناگون به یکدیگر، خودکارسازی کنند. این ابزار با رویکرد «کم‌کد» (low-code)، کاربران را قادر می‌سازد بدون نیاز به دانش عمیق برنامه‌نویسی و تنها با استفاده از یک رابط کاربری بصری و مبتنی بر نود (node-based)، گردش کارهای خود را طراحی و پیاده‌سازی کنند. قابلیت متن‌باز بودن و امکان خودمیزبانی (self-hostable) n8n، کنترل کاملی بر داده‌ها و فرآیندها را به کاربران می‌دهد. هدف اصلی n8n، ساده‌سازی وظایف تکراری و اتصال سرویس‌های مختلف برای تمرکز کاربران بر فعالیت‌های مهم‌تر و خلاقانه‌تر است.

معرفی پلتفرم هوشی: دسترسی یکپارچه به قدرت هوش مصنوعی

هوشی (hooshi.net) پلتفرمی است که با هدف تسهیل دسترسی کاربران به جدیدترین فناوری‌های هوش مصنوعی طراحی شده است. این پلتفرم، دسترسی به طیف گسترده‌ای از مدل‌های پیشرفته هوش مصنوعی را از طریق یک API یکپارچه فراهم می‌کند. ماهیت «همه‌کاره» (all-in-one) هوشی و ارائه یک API واحد برای دسترسی به مدل‌های متعدد، فرآیند توسعه را برای کاربران، به‌ویژه توسعه‌دهندگان فارسی‌زبان، به طور قابل توجهی ساده‌تر می‌کند. هوشی با ارائه قیمت‌گذاری شفاف و رقابتی، گزینه‌ای ایده‌آل برای بهره‌مندی از قدرت هوش مصنوعی محسوب می‌شود. برای شروع، کافیست در hooshi.net ثبت‌نام کنید و اولین توکن API خود را بسازید.

ویژگی‌ها و مزایای کلیدی n8n

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

• کم‌کد (Low-code): رابط کاربری بصری و قابلیت کشیدن و رها کردن (drag-and-drop) نودها، ساخت گردش کار را ممکن می‌سازد. امکان استفاده از کدهای جاوااسکریپت نیز برای وظایف پیچیده‌تر وجود دارد.
• منبع‌باز (Source-available) و خودمیزبان (Self-hostable): امکان نصب و اجرای n8n بر روی زیرساخت شخصی، که کنترل کامل بر داده‌ها و امنیت را به همراه دارد. گزینه‌های میزبانی ابری نیز در دسترس است.
• رابط کاربری دوستانه: طراحی بصری مبتنی بر بلوک‌های سازنده، پیکربندی و مدیریت گردش کارها را آسان می‌کند.
• انعطاف‌پذیری بالا: امکان ساخت گردش کارهای بسیار پیچیده و سفارشی.

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

مفاهیم کلیدی در n8n: نودها، گردش کار، و تریگرها

برای کار با n8n، آشنایی با مفاهیم اصلی آن ضروری است:

• نودها (Nodes): بلوک‌های سازنده اصلی که هر کدام عملکرد یا برنامه کاربردی خاصی را نمایندگی می‌کنند. نودهایی مانند HTTP Request برای ارسال درخواست به APIها، Set برای تنظیم مقادیر، If برای منطق شرطی، و Merge برای ترکیب داده‌ها در n8n وجود دارند.
• گردش کار (Workflows): مجموعه‌ای از نودهای متصل به هم که یک فرآیند خاص را خودکار می‌کنند. داده‌ها بین نودها جریان یافته و عملیات مشخصی بر روی آن‌ها انجام می‌شود.
• تریگرها (Triggers): نقطه شروع یک گردش کار که بر اساس وقوع یک رویداد خاص (مانند زمان‌بندی، دریافت درخواست وب، یا رویدادی در سرویس دیگر) فعال می‌شود.

روش‌های اتصال هوشی به n8n

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

۱. استفاده از HTTP Request Node (روش اصلی)

با توجه به عدم وجود نود اختصاصی برای هوشی در n8n، استفاده از HTTP Request Node بهترین و مرسوم‌ترین روش برای برقراری ارتباط است. این روش انعطاف‌پذیری کامل و کنترل دقیق بر درخواست‌ها را فراهم می‌کند.

تنظیمات پایه HTTP Request برای هوشی:

• آدرس API (URL): `https://api.hooshi.net/v1/chat/completions` (این endpoint با استاندارد OpenAI سازگار است).
• متد HTTP: `POST` (برای ارسال داده‌های JSON).
• احراز هویت (Authentication): در بخش Authentication، گزینه “Predefined Credential Type” را انتخاب کرده و نوع آن را روی “Header Auth” تنظیم کنید. سپس در فیلد Name مقدار `Authorization` و در Value قسمت `Bearer YOUR_API_KEY` را وارد کنید. YOUR_API_KEY را با کلید API که از hooshi.net دریافت کرده‌اید، جایگزین نمایید.

ساختار Body درخواست (JSON):

{
  "model": "gpt-4o",
  "messages": [
    {
      "role": "system",
      "content": "شما یک دستیار هوشمند هستید که به زبان فارسی پاسخ می‌دهید."
    },
    {
      "role": "user", 
      "content": "سوال کاربر"
    }
  ],
  "temperature": 0.7,
  "max_tokens": 1000,
  "stream": false
}

پارامترهای کلیدی عبارتند از:

• model: نام مدل مورد نظر (مانند `gpt-4o` یا مدل‌های دیگر هوشی).
• messages: آرایه‌ای از پیام‌ها شامل نقش (`role`) و محتوا (`content`).
• temperature: کنترل خلاقیت پاسخ (۰ تا ۱).
• max_tokens: حداکثر طول پاسخ.
• stream: فعال‌سازی پاسخ تدریجی (معمولاً `false`).

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

۲. استفاده از OpenAI Node با تنظیمات سفارشی

روش دوم، استفاده از OpenAI Node موجود در n8n با تغییر Base URL است. این روش ساده‌تر اما کمی محدودتر از HTTP Request Node عمل می‌کند.

• در تنظیمات Credentials نود OpenAI:
• کلید API را با کلید API هوشی خود جایگزین کنید.
• Base URL را به `https://api.hooshi.net/v1` تغییر دهید.
• مدل مورد نظر خود را انتخاب کنید.

این روش برای use case های استاندارد مناسب است و نیاز کمتری به پیکربندی دستی دارد.

۳. استفاده از Code Node با Python

برای کاربردهای پیشرفته‌تر و کنترل بیشتر، می‌توانید از Code Node با زبان Python استفاده کنید:

import requests
import json

# تنظیم کلید API از ورودی یا تنظیمات
api_key = "YOUR_HOOSHI_API_KEY" # یا از items[0]['json']['api_key']
base_url = "https://api.hooshi.net/v1/chat/completions"

# تنظیم headers
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}

# تنظیم body درخواست
body = {
  "model": "gpt-4o",
  "messages": [
    {
      "role": "system",
      "content": "شما یک دستیار هوشمند هستید که به زبان فارسی پاسخ می‌دهید."
    },
    {
      "role": "user", 
      "content": "سوال کاربر"
    }
  ],
  "temperature": 0.7,
  "max_tokens": 1000,
  "stream": false
}

# ارسال درخواست
resp headers=headers, data=json.dumps(body))

# پردازش پاسخ
if response.status_code == 200:
    result = response.json()
    # اینجا می‌توانید نتیجه را پردازش کرده و به خروجی نود ارسال کنید
    return [result]
else:
    # مدیریت خطا
    return [{"error": response.text}]

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

چرا هوشی؟

هوشی با ارائه یک API یکپارچه و قدرتمند، دسترسی به آخرین مدل‌های هوش مصنوعی را برای توسعه‌دهندگان و کسب‌وکارها آسان کرده است. با تمرکز بر سادگی، شفافیت در بیلینگ و قیمت‌گذاری رقابتی، هوشی بهترین انتخاب برای ادغام هوش مصنوعی در گردش کارهای خود است. برای شروع و کشف قابلیت‌های بی‌نظیر هوشی، همین امروز در hooshi.net ثبت‌نام کنید!