اتصال Continue به پیکو هوش

Continue افزونه‌ی متن‌باز برای VS Code و JetBrains است که چت، ویرایش درجا و تکمیل خودکار را فراهم می‌کند. پیکربندی آن در فایل config.yaml انجام می‌شود و هر مدل با provider، model، apiBase و apiKey تعریف می‌شود. برای پیکو هوش از provider: openai استفاده می‌کنیم و apiBase را عوض می‌کنیم.

فرمت فایل پیکربندی Continue با نسخه‌ها عوض شده (قبلاً config.json بود). اگر نسخه‌ی شما هنوز JSON می‌خواهد، همان فیلدها را در آرایه‌ی models به‌کار ببرید.

پیش‌نیازها

• یک حساب پیکو هوش و یک کلید API از داشبورد (کلید فقط یک‌بار کامل نمایش داده می‌شود).
• شناسه‌ی دقیق مدل از کاتالوگ؛ در مثال‌ها از gpt-6-sol و claude-sonnet-5-5 استفاده شده است.
• کمی موجودی در کیف پول تومانی یا اعتبار؛ تعرفه را در صفحه‌ی قیمت‌ها ببینید.

راه‌اندازی گام‌به‌گام

1. ۱باز کردن فایل پیکربندی

   در Continue روی آیکون چرخ‌دنده بزنید یا فایل ~/.continue/config.yaml را باز کنید.

2. ۲افزودن مدل

   یک مدل چت با نقش‌های مناسب تعریف کنید.

   کپی

   name: PicoAi
   version: 1.0.0
   schema: v1
   models:
     - name: PicoAi Claude Sonnet
       provider: openai
       model: claude-sonnet-5-5
       apiBase: https://api.picoai.ir/v1
       apiKey: YOUR_API_KEY
       roles:
         - chat
         - edit
         - apply

3. ۳مدل جداگانه برای autocomplete

   برای تکمیل خودکار مدل سریع و ارزان انتخاب کنید. مطمئن شوید مدل انتخابی برای این کار مناسب است.

   کپی

     - name: PicoAi Fast
       provider: openai
       model: gemini-3.8-flash
       apiBase: https://api.picoai.ir/v1
       apiKey: YOUR_API_KEY
       roles:
         - autocomplete

4. ۴ذخیره و انتخاب

   فایل را ذخیره کنید؛ مدل در کشوی انتخاب مدل Continue ظاهر می‌شود.

تست سریع اتصال

پیش از نوشتن منطق برنامه، یک بار فهرست مدل‌ها را بگیرید. اگر پاسخ ۲۰۰ و فهرستی از شناسه‌ها برگشت، کلید، شبکه و آدرس درست است و هر مشکل بعدی مربوط به تنظیمات Continue خواهد بود.

curl https://api.picoai.ir/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

نکته‌های کاربردی برای Continue

• کلید را در فایل secrets یا متغیر محیطی نگه دارید و در پیکربندی ارجاع بدهید، مخصوصاً اگر فایل را در گیت می‌گذارید.
• برای تکمیل خودکار تأخیر کم مهم‌تر از هوش است؛ مدل سریع انتخاب کنید.
• نقش‌ها (roles) را درست بدهید تا مدل سنگین در تکمیل خودکار صدا زده نشود.

عیب‌یابی

هزینه و صورتحساب

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