خطای ۴۰۱ کلودفلر

چت ویجت و محیط آزمایشی هر دو با خطای "متاسفم — خطایی رخ داد" از کار می‌افتند. انتهای فایل storage/logs/laravel.log نشان می‌دهد:

Workers AI 401: {"success":false,"error":[{"code":2009,"message":"Unauthorized"}]}

کلودفلر توکن API ارسال‌شده توسط Pitchbar در فراخوانی Workers AI را رد کرده است. این صفحه کتابچه بازیابی است.

تشخیص

این دستور curl را از سرور Pitchbar خود اجرا کنید و مقادیر واقعی را از .env یا /settings/system → AI جایگزین کنید:

ACCOUNT_ID="شناسه-۳۲-کاراکتری-هگز-را-وارد-کنید"
TOKEN="توکن-جدید-را-وارد-کنید"
curl -i -X POST "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/ai/run/@cf/baai/bge-base-en-v1.5" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text":["hello"]}'

سه نتیجه ممکن:

پاسخ	دلیل	راه‌حل
۲۰۰ + JSON با اعداد اعشاری	کلودفلر سالم است؛ Pitchbar یک توکن کش‌شده قدیمی از bootstrap/cache/config.php ارسال می‌کند.	php artisan config:clear && php artisan cache:clear && php artisan view:clear
۴۰۱	شناسه حساب با حسابی که توکن برای آن صادر شده است مطابقت ندارد، یا Workers AI در این حساب فعال نیست، یا توکن اشتباه وارد شده است (فاصله، کپی ناقص).	لیست بررسی زیر را مشاهده کنید.
۴۰۳	توکن برای حساب معتبر است اما حوزه Workers AI: Read را ندارد.	توکن را با حوزه صحیح دوباره صادر کنید. "حوزه‌های مورد نیاز" را در زیر مشاهده کنید.

لیست بررسی ۴۰۱ (به ترتیب اولویت)

1. تأیید کنید که CLOUDFLARE_ACCOUNT_ID با حسابی که توکن را صادر کرده است مطابقت دارد. با همان ایمیلی که برای ایجاد توکن استفاده شده است، وارد کلودفلر شوید ← Workers & Pages ← نوار کناری سمت راست ← شناسه حساب (هگز ۳۲ کاراکتری). آن را در Pitchbar ← تنظیمات ← سیستم ← هوش مصنوعی ← Cloudflare وارد کنید. رایج‌ترین دلیل ۴۰۱ با یک توکن جدید، شناسه حساب نامطابق است.
2. تأیید کنید که Workers AI در این حساب فعال است. داشبورد ← هوش مصنوعی ← Workers AI. اگر دکمه "شروع کنید" را می‌بینید، برای فعالسازی روی آن کلیک کنید. سطح رایگان بیشتر نصب‌های در مقیاس CodeCanyon را پوشش می‌دهد.
3. توکن را به‌صورت تمیز دوباره تولید کنید. داشبورد ← پروفایل من ← توکن‌های API ← ایجاد توکن ← توکن سفارشی. از حوزه‌های ذکر شده در زیر استفاده کنید. منابع حساب: "شامل → حساب خاص → حساب شما". رشته توکن را بدون فاصله اضافی کپی کرده، در Pitchbar وارد کنید و ذخیره کنید.
4. با نقطه پایانی تأیید بررسی کنید.

   curl -i "https://api.cloudflare.com/client/v4/user/tokens/verify" \
     -H "Authorization: Bearer NEW_TOKEN"

   پاسخ مورد انتظار: "status":"active". تأیید می‌کند که خود رشته توکن معتبر است. حوزه را تأیید نمی‌کند.

حوزه‌های مورد نیاز توکن API کلودفلر

پشته پیش‌فرض کلودفلر Pitchbar از Workers AI برای چت + جستجوی هوشمند، Vectorize برای بازیابی و Cloudflare Browser Rendering برای اسکن استفاده می‌کند. توکن نیاز دارد:

حوزه	دلیل
Workers AI: Read	استنتاج چت + جستجوی هوشمند
Vectorize: Write	ایجاد / حذف / تغییر شاخص + پرس‌وجو (نوشتن به معنای خواندن است)
Browser Rendering: Write	اسکن صفحات برای منابع دانش
Workers Scripts: Write	استقرار یک‌کلیکی پردازشگر cron از /settings/system → پردازشگر cron

نیاز نیست: درگاه هوش مصنوعی، ذخیره‌سازی R2، Pages. نسخه‌های قبلی Pitchbar حوزه درگاه هوش مصنوعی را پیشنهاد می‌کردند — این راهنمایی گمراه‌کننده بود و در نسخه v2.0.0 حذف شد.

پس از کار کردن توکن

Pitchbar توکن را در اولین درخواست در bootstrap/cache/config.php کش می‌کند. پس از به‌روزرسانی توکن در /settings/system → AI، باید کش را پاک کنید:

php artisan config:clear
php artisan cache:clear
php artisan view:clear

سپس محیط آزمایشی را در /admin/agents/{id}/playground دوباره امتحان کنید. باید فوراً کار کند.