چرا APC Agents باید به صورت پیشفرض از model: inherit استفاده کنند
فایلهای APC agent زمانی بهترین عملکرد را دارند که کوچک و قابل حمل (portable) باشند.
بهترین حالت پیشفرض، استفاده از model: inherit است. تنها زمانی از یک مدل خاص استفاده کنید که پروژهتان به آن نیاز داشته باشد. این قانون باعث تمیز ماندن فایلهای شما میشود. مخزن (repository) قرارداد پروژه را نگه میدارد و زمان اجرا (runtime) انتخاب مدل را انجام میدهد.
یک APC agent در واقع یک شخصیت (persona) در فایل agent شماست. این شخصیت، نام، نقش و مهارتها را تعریف میکند. این فایل نباید تمام پشتهی زمان اجرا (runtime stack) را هاردکد (hardcode) کند و نباید یک ارائهدهنده (vendor) خاص را به عنوان پیشفرض تحمیل کند. وظیفهی آن توصیف شخصیت است و اجازه میدهد runtime کار خود را انجام دهد.
چرا model: inherit بهتر است:
- قابلیت حمل (Portability): ممکن است امروز از APX و فردا از Cursor یا Claude Code استفاده کنید. وراثت (Inheritance) اجازه میدهد agent در تمامی ابزارها کار کند.
- نویز کمتر: هاردکد کردن مدلها در هر فایل باعث ایجاد آشفتگی میشود.
- جداسازی بهتر: APC تعریف میکند که agent چیست، و runtime تعریف میکند که چگونه اجرا شود.
- راهاندازی آسانتر: اعضای تیم میتوانند مخزن شما را کلون کرده و بلافاصله بدون تغییر در فایلهای agent، آن را اجرا کنند.
چه زمانی از یک مدل خاص استفاده کنیم:
تنها در صورتی از یک ارائهدهنده و مدل ID خاص استفاده کنید که پروژه به آن وابسته باشد. به عنوان مثال:
- یک مدل محلی کوچک برای خلاصهسازیهای ساده.
- یک مدل خاص برای پروفایلهای مشخصِ استفاده از ابزار (tool-use).
- یک موتور قابل پیشبینی برای تستهای ثابت (test fixtures).
قبل از ثابت کردن (pin) یک مدل، این تست را انجام دهید:
- آیا مدل بخشی از قرارداد پروژه است؟ آن را ثابت (pin) کنید.
- آیا مدل صرفاً یک انتخاب محلی در زمان اجرا است؟ از
model: inheritاستفاده کنید. - آیا مقدار، یک رمز (secret) یا مختص به یک سیستم خاص است؟ آن را در تنظیمات runtime خود نگه دارید.
شخصیت (agent) را توصیف کنید، نه ماشین را. این کار باعث میشود فایلهای agent شما به جای اینکه وابسته و محدودکننده باشند، کاربردی باقی بمانند.
منبع: https://dev.to/agentprojectcontext/why-apc-agents-should-default-to-model-inherit-1jih
انجمن یادگیری اختیاری: https://t.me/GyaanSetuAi