استقرار AI Agent در کنسول پاستا؛ اجرای نمونه رسمی، تنظیم فرمان اجرا، پورت و بررسی سلامت، نگه‌داری داده و رفع خطاهای رایج.
پیش از شروع
- حساب فعال و دسترسی ساخت پروژه در فضای کاری داشته باشید. از داده آزمایشی استفاده کنید.
- نام پروژه، ناحیه، منابع و هزینه را پیش از تأیید نهایی بررسی کنید. کلیدها و رمزها را فقط در تنظیمات خصوصی کنسول وارد کنید.
نمونه و فایل‌های لازم
مشاهده فایل‌های نمونه AI Agent؛ فایل‌های اصلی: requirements.txt و main.py؛ نقطه شروع API ایجنت. فرمان زیر کل مخزن را دریافت می‌کند؛ پوشه این آموزش fastapi است.
git clone https://github.com/Paasta-Cloud/examples.git
cd examples/fastapiبرای AI Agent پوشه نمونه اختصاصی در مخزن وجود ندارد. ابتدا نمونه FastAPI را برای API وب منتشر کنید؛ این نمونه به‌تنهایی مدل را فراخوانی نمی‌کند.
کلید مدل را به‌عنوان Secret سمت سرور ثبت کنید و اتصال را طبق راهنمای API هوش مصنوعی بسازید. مدل فعال، سقف هزینه و مجوز ابزارها را مشخص کنید.
کار طولانی را به Worker جدا منتقل کنید. حافظه ماندگار و صف باید به دیتابیس، Redis یا دیسک مناسب متصل باشند؛ فایل موقت حافظه دائمی ایجنت نیست.
ساخت پروژه از کنسول
- در کنسول «ساخت اپلیکیشن» را باز کنید و منبع
Gitیا آپلود سورس را انتخاب کنید. - برای
Git، مخزنexamplesو شاخهmainرا انتخاب کنید و پوشه پروژه درMonorepoراfastapiقرار دهید. برای آپلود، فقط محتوای همان پوشه را بفرستید؛node_modules،.venvو خروجی ساخت محلی لازم نیستند. - نتیجه بررسی سورس را بخوانید. اگر مخزن را برای پروژه خودتان
forkکرده‌اید، اتصالGitباید به همان مخزن دارای تغییرات اشاره کند. - در تنظیمات اجرا، پورت 8000 و مسیر سلامت
/healthرا بررسی کنید. فرمان اجرا و متغیرهای موردنیاز را با جدول زیر تطبیق دهید. - پلن، ناحیه، دیسک و هزینه منابع را مرور کنید و ساخت را تأیید کنید. مراحل ساخت و اجرا را در صفحه استقرار دنبال کنید.
فرمان‌ها و تنظیمات نمونه
| تنظیم | مقدار |
|---|---|
| ساخت یا نصب | pip install -r requirements.txt |
| اجرا | uvicorn main:app --host 0.0.0.0 --port 8000 |
| پورت داخلی | 8000 |
| مسیر سلامت | /health |
فرمان ساخت را برای شناخت مراحل می‌بینید؛ پاستا آن را از سورس تشخیص می‌دهد. override فرمان اجرا فقط وقتی لازم است که فرمان پروژه با نمونه فرق داشته باشد. پورت داخلی باید با پورت واقعی برنامه یکسان باشد؛ پورت رایانه محلی معیار نیست.
بررسی نتیجه
دامنه HTTPS پروژه را باز کنید. نتیجه مورد انتظار نمونه: پاسخ سلامت API؛ سپس پاسخ ایجنت با اتصال مدل انتخابی.
مسیر /health باید پاسخ موفق بدهد. در لاگ اجرا خطای تکرارشونده نباشد؛ بعد از آماده‌شدن برنامه، یک درخواست واقعی و یک refresh را هم بررسی کنید.
curl -i https://YOUR_PROJECT.paasta.app/healthآدرس بالا نمونه است؛ دامنه واقعی را از صفحه پروژه کپی کنید، چون ممکن است دامنه ناحیه داشته باشد.
خطاهای رایج AI Agent
401 از ارائه‌دهنده مدل
کلید، Base URL و مجوز مدل را بررسی کنید؛ کلید را در لاگ یا کد مرورگر چاپ نکنید.
درخواست وب زمان‌بر قطع می‌شود
کار طولانی را در Worker اجرا کنید و از API شناسه کار و وضعیت آن را برگردانید.
حافظه بعد از انتشار پاک می‌شود
حافظه را در دیتابیس یا دیسک پایدار ذخیره کنید؛ افزایش تعداد نسخه‌ها فایل محلی را مشترک نمی‌کند.
انتشار نسخه بعدی و داده ماندگار
برای نسخه بعدی از همان پروژه استفاده کنید. فایل موقت داخل برنامه ماندگار نیست؛ داده مهم را در دیتابیس یا دیسک پایدار نگه دارید و قبل از تغییر ساختار داده بکاپ بگیرید. Rollback نسخه برنامه، migration یا داده دیتابیس را خودکار به عقب برنمی‌گرداند.