## چرا وب‌یار تولز؟

وب‌یار تولز به عنوان یک لایه میانجی بین شما و OpenAI عمل می‌کند و مزایای زیر را ارائه می‌دهد:

- **امنیت بالا**: استفاده از توکن‌های منحصر به فرد
- **کنترل هزینه**: سیستم توکن داخلی و قابل پیش‌بینی
- **ردیابی کامل**: ثبت تمام درخواست‌ها و آمار استفاده
- **مقیاس‌پذیری**: پشتیبانی از ترافیک بالا
- **سادگی**: API ساده و قابل فهم

## مرحله 1: دریافت توکن API

### 1.1 ورود به پنل کاربری
ابتدا وارد حساب کاربری خود در وب‌یار تولز شوید:
```
https://webyartools.com
```

### 1.2 دسترسی به بخش API
از منوی اصلی، روی "پنل توسعه‌دهندگان" یا "API" کلیک کنید.

### 1.3 ایجاد توکن جدید
1. روی "درخواست API" کلیک کنید
2. فرم زیر را پر کنید:
  - **آدرس وب‌سایت**: آدرس n8n instance شما
  - **توضیحات**: "Integration with n8n automation"
  - **دسترسی‌ها**: همه گزینه‌ها را انتخاب کنید
3. روی "ایجاد توکن" کلیک کنید
4. توکن ایجاد شده را کپی و در جای امن نگهداری کنید

## مرحله 2: تنظیم n8n Workflow

### 2.1 ایجاد Workflow جدید
1. در n8n، روی "New workflow" کلیک کنید
2. یک "Manual Trigger" node اضافه کنید

### 2.2 اضافه کردن HTTP Request Node
1. روی "+" کلیک کنید
2. "HTTP Request" را جستجو و انتخاب کنید
3. تنظیمات زیر را وارد کنید:

#### تنظیمات پایه:

```
Method: POST
URL: https://webyartools.com/Api/ProcessRequest
```

#### Headers:

```
Content-Type: application/json
```

#### Body (JSON):

```json
{
 "token": "YOUR_API_TOKEN_HERE",
 "model": "gpt-3.5-turbo",
 "prompt": "سلام، چطور می‌تونم کمکت کنم؟"
}
```

### 2.3 اتصال Nodes
Manual Trigger را به HTTP Request متصل کنید.

## مرحله 3: تست و اجرا

### 3.1 تست اولیه
1. روی "Execute workflow" کلیک کنید
2. منتظر بمانید تا پردازش کامل شود
3. نتیجه را در خروجی HTTP Request مشاهده کنید

### 3.2 بررسی پاسخ موفق
اگر همه چیز درست باشد، پاسخ زیر را دریافت خواهید کرد:
```json
{
 "success": true,
 "response": "سلام! من یک دستیار هوشمند هستم...",
 "tokensUsed": 3,
 "remainingTokens": 4997
}
```

## مرحله 4: استفاده پیشرفته

### 4.1 استفاده با متغیرها
برای استفاده با داده‌های ورودی، Body را به صورت زیر تغییر دهید:
```json
{
 "token": "YOUR_API_TOKEN_HERE",
 "model": "gpt-3.5-turbo",
 "prompt": "{{ $json.user_message }}"
}
```

### 4.2 استفاده با System Prompt

```json
{
 "token": "YOUR_API_TOKEN_HERE",
 "model": "gpt-4",
 "prompt": "{{ $json.user_input }}",
 "systemPrompt": "شما یک دستیار هوشمند فارسی هستید.",
 "temperature": 0.8,
 "maxTokens": 2000
}
```

### 4.3 تولید تصویر

```json
{
 "token": "YOUR_API_TOKEN_HERE",
 "model": "dall-e-3",
 "prompt": "یک گربه نارنجی زیبا"
}
```

## مرحله 5: مدیریت خطاها

### 5.1 اضافه کردن IF Node
برای مدیریت خطاها، یک IF node اضافه کنید:
```
Condition: {{ $json.success }} equals true
```

### 5.2 پردازش خطاها
اگر خطا رخ دهد، پاسخ زیر را دریافت خواهید کرد:

```json
{
 "success": false,
 "error": "پیام خطا"
}
```

## مرحله 6: مدل‌های پشتیبانی شده

### 6.1 مدل‌های متنی

- **gpt-3.5-turbo**: 3 توکن
- **gpt-4**: 3 توکن
- **gpt-4-turbo**: 3 توکن
- **gpt-4o**: 3 توکن

### 6.2 مدل‌های تصویر

- **dall-e-2**: 20 توکن
- **dall-e-3**: 20 توکن

## مرحله 7: مثال‌های کاربردی

### 7.1 Chatbot ساده

```json
{
 "token": "YOUR_TOKEN",
 "model": "gpt-3.5-turbo",
 "prompt": "{{ $json.user_message }}"
}
```

### 7.2 پردازش متن

```json
{
 "token": "YOUR_TOKEN",
 "model": "gpt-4",
 "prompt": "{{ $json.text_to_process }}",
 "systemPrompt": "این متن را تحلیل و خلاصه کن"
}
```

### 7.3 تولید محتوا

```json
{
 "token": "YOUR_TOKEN",
 "model": "gpt-4",
 "prompt": "{{ $json.topic }}",
 "systemPrompt": "یک مقاله 500 کلمه‌ای درباره موضوع داده شده بنویس",
 "maxTokens": 2000
}
```

## مرحله 8: بهینه‌سازی عملکرد

### 8.1 تنظیمات n8n

```
Timeout: 30000
Retry: 3
Batch Size: 10
```

### 8.2 مدیریت حافظه

```json
{
 "max_tokens": 1000,
 "temperature": 0.7,
 "timeout": 30000
}
```

## مرحله 9: عیب‌یابی

### 9.1 خطاهای رایج
- **"توکن نامعتبر است"**: توکن را بررسی کنید
- **"موجودی شما کافی نیست"**: موجودی حساب را بررسی کنید
- **"خطا در ارتباط با OpenAI"**: اتصال اینترنت را بررسی کنید

### 9.2 تست اتصال

```json
{
 "token": "YOUR_TOKEN",
 "model": "gpt-3.5-turbo",
 "prompt": "تست"
}
```

## مرحله 10: امنیت و بهترین روش‌ها

### 10.1 امنیت توکن
- توکن را در متغیرهای محیطی n8n ذخیره کنید
- از Environment Variables استفاده کنید
- توکن را در کدهای عمومی قرار ندهید

### 10.2 مدیریت موجودی

```json
{
 "url": "https://webyartools.com/Api/GetUserInfo",
 "method": "GET",
 "qs": {
   "token": "YOUR_TOKEN"
 }
}
```

## نتیجه‌گیری

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

### مزایای این روش:
- **سادگی**: تنظیمات آسان و قابل فهم
- **امنیت**: استفاده از توکن‌های منحصر به فرد
- **کنترل هزینه**: سیستم توکن قابل پیش‌بینی
- **ردیابی**: ثبت کامل درخواست‌ها و آمار
- **مقیاس‌پذیری**: پشتیبانی از ترافیک بالا

### نکات مهم:
- همیشه توکن خود را در جای امن نگهداری کنید
- موجودی حساب خود را مرتباً بررسی کنید
- از Rate Limiting آگاه باشید
- خطاها را به درستی مدیریت کنید

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