نمای کلی اجرایی و اهمیت معماری
انتشار نسخه use-acp-compatible-harnesses-wit از ورسِل یک نقطه عطف معماری قابل توجه برای لایه مهارکننده SDK هوش مصنوعی محسوب میشود و پشتیبانی از پروتکل کلاینت عامل (ACP) را به طور رسمی ادغام میکند. از لحاظ تاریخی، اکوسیستم مهارکننده در ابزارهای مدرن هوش مصنوعی نیازمند آداپتورهای سختافزار محور و وابسته به زمان اجرا بود. هر محیط برنامهنویسی پشتیبانیشده—از جمله Claude Code و Codex گرفته تا Pi، Deep Agents و OpenCode—نیازمند یک لایه یکپارچهسازی سفارشی برای پر کردن فاصله بین منطق انتزاعی عامل و اجرای ملموس زمان اجرا بود. این الگوی طراحی، وفاداری بالا و پارامترهای یکپارچهسازی بهینهسازیشدهای را تضمین میکرد، اما زمانی که تیمها تلاش میکردند مهارکنندههای کدنویسی نوظهور یا اختصاصی فاقد آداپتورهای بومی و از پیش ساختهشده را در اکوسیستم اتخاذ کنند، اصطکاک قابل توجهی ایجاد میکرد.
با این انتشار، ورسِل بسته @ai-sdk/harness-acp را معرفی میکند که به شکل اساسی نحوه طراحی و استقرار لایههای آداپتور را تغییر میدهد. @ai-sdk/harness-acp به جای عمل به عنوان یک پوشش مستقیم برای یک زمان اجرای ایزوله، به عنوان یک متا-آداپتور عمل میکند که قادر است با هر بسته پروتکلی سازگار با ACP ارتباط برقرار کند. با انتزاعیسازی لایه ارتباطی در قالب یک پروتکل استاندارد، این نسخه انتزاع مهارکننده SDK هوش مصنوعی را از پیادهسازیهای زمان اجرای فردی جدا میکند. معماران و توسعهدهندگان اکنون میتوانند قابلیتهای عامل خود را به سرعت مقیاسبندی کنند تا از هر مهارکنندهای که از مشخصات پروتکل کلاینت عامل پشتیبانی میکند، پشتیبانی نمایند و در نتیجه جریانهای کاری مهندسی هوش مصنوعی خود را در برابر تغییرات سریع در چشمانداز زمانهای اجرای عاملی، آیندهنگر سازند.
پیشرفتهای اصلی و ارگونومی توسعهدهنده
پیشرفت مهندسی محوری در این نسخه، معرفی HarnessAgent همراه با بسته @ai-sdk/harness-acp است. توسعهدهندگان دیگر به مجموعه محدودی از آداپتورهای زمان اجرای نگهداریشده به صورت بومی محدود نیستند. در عوض، پیادهسازی یک مهارکننده کدنویسی جدید یا سفارشی مستلزم ارسال مستقیم بسته سازگار با ACP هدف به تابع کمکی createACP، نگاشت پیکربندیهای پایه مهارکننده، و سپس نمونهسازی HarnessAgent درست مانند هر آداپتور قدیمی است. این الگوی نمونهسازی یکپارچه، ارگونومی توسعهدهنده را به طور چشمگیری بهبود میبخشد و صرف نظر از ویژگیهای زمان اجرای زیرین، یک سطح API سازگار را فراهم میکند.
با این حال، خلوص معماری با مبادلات عملگرایانه متعادل شده است. پروتکل کلاینت عامل یک لایه انتزاعی عمومی روی مهارکنندههای کدنویسی فراهم میکند، اما این تعمیم گاهی اوقات میتواند رفتارهای سطح پایین را مبهم کند. تیم مهندسی ورسِل به صراحت خاطرنشان میکند که لایه مهارکننده SDK هوش مصنوعی عمدتاً از ACP جدا باقی میماند زیرا پروتکلهای جهانی نمیتوانند همیشه تلهمتری داخلی ظریف، مشخصات جریانسازی بهینهسازیشده یا مدیریت خطای تخصصی زمانهای اجرای خاص را ثبت کنند. در نتیجه، آداپتورهای مستقیمی مانند @ai-sdk/harness-claude-code و @ai-sdk/harness-codex گزینه ترجیحی برای پلتفرمهای مستقیمی باقی میمانند که در آنها اجرای بسیار یکپارچه و با عملکرد بالا از اهمیت بالایی برخوردار است. متا-آداپتور ACP شکاف حیاتی برای زمانهای اجرای طولانیمدت، مهارکنندههای محلی سفارشی و عاملهای نوظهوری را پر میکند که فاقد یک بسته یکپارچهسازی اختصاصی و مستقیم هستند.
ماتریس مقایسه معماری
| بعد | مبنای قبلی (آداپتورهای وابسته به زمان اجرا) | نسخه جدید (use-acp-compatible-harnesses-wit) |
تأثیر معماری |
|---|---|---|---|
| تأخیر زمان اجرا | سربار حداقل؛ فرایندهای مستقیم تابع و اتصالات بهینهسازیشده به ازای هر زمان اجرا. | سربار کوچک سریالسازی پروتکل به دلیل لایه انتزاعی ACP. | مبادله عملکرد جزئی برای زمانهای اجرای طولانیمدت در ازای قابلیت گسترش بینهایت. |
| رد پای حافظه | کم تا متوسط؛ آداپتورهای فردی فقط زمانی بارگذاری میشوند که صراحتاً وارد شوند. | بارگذاری پویا بستههای متا-آداپتور از طریق createACP. |
کاهش حجم انباشته با اجتناب از وارد کردنهای ایستا برای هر زمان اجرای عامل خاص. |
| سازگاری API | رابطهای تکهتکه که نیازمند کد یکپارچهسازی سفارشی برای زمانهای اجرای جدید هستند. | رابط یکپارچه از طریق HarnessAgent و @ai-sdk/harness-acp. |
تجربه توسعهدهنده به شدت سادهشده و سربار نگهداری برای مهارکنندههای سفارشی. |
تغییرات ساختارشکن و نکات مهاجرت
این نسخه کاملاً با نسخههای قبلی SDK هوش مصنوعی و پیادهسازیهای مهارکننده موجود سازگار است. هیچ تغییر ساختارشکنی در آداپتورهای قدیمی مانند @ai-sdk/harness-claude-code یا @ai-sdk/harness-codex ایجاد نشده است. پایگاههای کد موجود که از پوششهای وابسته به زمان اجرا استفاده میکنند، بدون تغییر یا هشدار منسوخشدگی به کار خود ادامه خواهند داد. از توسعهدهندگان تشویق میشود که آداپتورهای مستقیم فعلی خود را برای محیطهای Claude Code و Codex حفظ کنند تا حداکثر کارایی و عمق تلهمتری حفظ شود. مهاجرت صرفاً یک مسیر اختیاری است که برای پروژههایی در نظر گرفته شده است که نیاز به یکپارچهسازی محیطهای کدنویسی جدید و غیربومی همراه با یک بسته سازگار با ACP دارند.
راهنمای گامبهگام ارتقاء
برای یکپارچهسازی یک مهارکننده سازگار با ACP در پروژه SDK هوش مصنوعی خود، این دو مرحله اصلی پیادهسازی را دنبال کنید:
- بسته اصلی مهارکننده ACP را در کنار بسته زمان اجرای سازگار با ACP هدف خود نصب کنید.
- متا-آداپتور را با استفاده از
createACPپیکربندی کرده و آن را به بلوک مقداردهی اولیه استانداردHarnessAgentارسال کنید.
import { HarnessAgent } from '@ai-sdk/harness';
import { createACP } from '@ai-sdk/harness-acp';
import * as customAcpRuntime from 'my-acp-compatible-harness';
// مرحله ۱: ایجاد نمونه آداپتور ACP با بسته هدف
const acpHarness = createACP({
package: customAcpRuntime,
mapping: {
// قوانین نگاشت پایه مهارکننده را در اینجا پیکربندی کنید
executionMode: 'standard',
},
});
// مرحله ۲: ارسال مهارکننده حاصل به HarnessAgent
const agent = new HarnessAgent({
harness: acpHarness,
// پیکربندیهای اضافی عامل...
});
export async function runAgentTask(prompt: string) {
const result = await agent.execute({ prompt });
return result;
}