اتصال Pi به چابکان

Pi یک عامل برنامه‌نویسی قابل توسعه در ترمینال است. برای اتصال به چابکان، provider سفارشی را در فایل مدل‌های Pi تعریف کنید.

نصب

پس از آماده‌سازی سرویس و کلید، با Node.js نسخهٔ ۲۲٫۱۹ یا جدیدتر:

npm install -g --ignore-scripts @earendil-works/pi-coding-agent

این نام پکیج مربوط به نسخهٔ جاری پروژه است. روش نصب و نیازمندی نسخه را در راهنمای رسمی Pi بررسی کنید.

تنظیم کلید و مدل

کلید را در همان ترمینالی تنظیم کنید که Pi را اجرا می‌کند:

export CHABOKAN_AI_API_KEY='sk-chbk-REPLACE_WITH_YOUR_KEY'

در Windows PowerShell:

$env:CHABOKAN_AI_API_KEY = "sk-chbk-REPLACE_WITH_YOUR_KEY"

فایل ~/.pi/agent/models.json را ایجاد یا ویرایش و provider زیر را با تنظیمات فعلی ادغام کنید:

{
  "providers": {
    "chabokan": {
      "baseUrl": "https://ai.chabokan.net/v1",
      "api": "openai-completions",
      "apiKey": "${CHABOKAN_AI_API_KEY}",
      "models": [
        { "id": "YOUR_MODEL_ID" }
      ]
    }
  }
}

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

اجرا و آزمون

از پوشهٔ آزمایشی پروژه اجرا کنید:

pi --provider chabokan --model 'YOUR_MODEL_ID'

در رابط Pi نیز /model فهرست مدل‌ها را باز می‌کند و فایل مدل‌ها را دوباره می‌خواند. برای تغییر provider سفارشی، لازم نیست با حساب OpenAI وارد شوید؛ احراز هویت از کلید چابکان انجام می‌شود. انتخاب مدل، گزینه‌های CLI

ابتدا یک پاسخ متنی کوتاه بگیرید و آن را در لاگ درخواست‌ها بررسی کنید. سپس خواندن یک فایل آزمایشی را امتحان کنید؛ توانایی عامل به پشتیبانی ابزار در مدل وابسته است.

رفع خطا

مشکل	اقدام
provider یا مدل دیده نمی‌شود	ساختار providers، نام chabokan و Model ID را بررسی و /model را دوباره باز کنید.
401	موجودبودن متغیر کلید در محیط اجرای Pi و فعال‌بودن کلید را بررسی کنید.
خطای پارامتر یا محدودیت context	مشخصات مدل را با فهرست مدل‌ها تطبیق دهید؛ ظرفیت ساختگی در تنظیمات ننویسید.
پاسخ متنی هست ولی ابزارخوانی شکست می‌خورد	مدل دارای tools انتخاب کنید و آزمون ابزار را جدا انجام دهید.

افزونه‌ها و تنظیمات پروژه می‌توانند روی رفتار عامل اثر بگذارند؛ برای آزمون نخست از پوشهٔ آزمایشی کنترل‌شده استفاده کنید. عیب‌یابی عمومی