Cursor تطلق SDK بلغة TypeScript لبناء وكلاء برمجيين

بقلم: فريق تحرير العلامة التقنية التصنيف: تطوير الويب ٣٠ أبريل ٢٠٢٦

أعلنت شركة Cursor، المعروفة بتقنياتها الذكية في تحرير الأكواد، عن إطلاق النسخة التجريبية العامة من Cursor SDK، وهي مكتبة بلغة TypeScript تمنح المطورين إمكانية الوصول البرمجي إلى نفس البيئة التي تدعم تطبيق Cursor المكتبي وواجهة سطر الأوامر والويب. هذا الإطلاق يمثل تحولًا مهمًا في كيفية تقديم أدوات البرمجة الذكية، حيث لم تعد مجرد مساعدات تفاعلية بجانب المطورين، بل أصبحت بنية تحتية يمكن للمنظمات دمجها في أنظمتها الحالية.

تحويل الأدوات التفاعلية إلى بنية تحتية قابلة للبرمجة

إذا كنت قد استخدمت Cursor من قبل، فربما تعرفها كأداة تطوير حيث تتفاعل مع وكيل في الوقت الفعلي — تطلب منه كتابة دوال، إصلاح أخطاء، أو شرح كود. لكن Cursor SDK تغير نموذج الوصول. بدلاً من أن يكون المطور جالسًا أمام لوحة المفاتيح، يمكنك الآن استدعاء الوكيل برمجيًا من أي مكان في مشروعك، سواء من خلال تفعيل خط أنابيب CI/CD أو خدمة خلفية أو إدماجه مباشرة داخل منتج آخر.

كيفية البدء مع SDK

للشروع في استخدام Cursor SDK، كل ما عليك فعله هو تنفيذ أمر بسيط:

npm install @cursor/sdk

بعد ذلك، يمكنك إنشاء مثيل لوكيل، وإرسال مهمة، واستلام الرد، وكل ذلك بلغة TypeScript. إليك مثال بسيط:

import { Agent } from "@cursor/sdk";
const agent = await Agent.create({ apiKey: process.env.CURSOR_API_KEY!, model: { id: "composer-2" }, local: { cwd: process.cwd() }, });
const run = await agent.send("Summarize what this repository does");
for await (const event of run.stream()) {
    console.log(event);
}

تحديات بناء وكلاء برمجيين

قبل الغوص في ما يقدمه SDK، من المهم فهم المشكلة التي يحلها. يتطلب بناء وكلاء برمجيين سريعون وموثوقون جهدًا هندسيًا كبيرًا: تأمين بيئات العمل، إدارة الحالة والجلسات، إعداد البيئة، وإدارة السياق. وعندما يتم إصدار نموذج جديد، غالبًا ما يتعين على فرق التطوير إعادة العمل على حل الوكلاء بالكامل للاستفادة منه. Cursor SDK يلغي هذه التعقيدات، مما يسمح للفرق بالتركيز على بناء وكلاء مفيدين بدلاً من الحفاظ على البنية التحتية الأساسية.

إيجابيات استخدام Cursor SDK

تتمتع Cursor SDK بعدة ميزات تجعل منها خيارًا مثاليًا للمطورين:

• تنفيذ محلي أو سحابي: يمكن للوكلاء التنفيذ على جهاز المطور المحلي لسرعة التكرار، أو في سحابة Cursor ضد VM مخصص مع تأمين قوي، أو على عمال موطنين للمجموعات ذات متطلبات أمان صارمة.
• البنية التحتية الكاملة: يرث الوكلاء من SDK بنية Cursor الكاملة، بما في ذلك إدارة السياق الذكية، دعم خوادم MCP، المهارات، الخطافات، والوكلاء الفرعيين.
• سهولة التبديل بين النماذج: يمكن للمطورين تغيير النموذج المستخدم بسهولة من خلال تعديل حقل واحد في معلمة النموذج، مما يتيح توجيه المهام إلى أفضل نموذج لكل حالة.

مشاريع البداية والمزيد من الموارد

لتسريع عملية التبني، قامت Cursor بنشر مستودع وصفات على GitHub يحتوي على أربعة مشاريع بداية، بما في ذلك أداة تخطيط مدعومة بالوكلاء تفتح PRs تلقائيًا عند سحب المهندسين لبطاقة. كما أصدرت Cursor SDK كملحق في Cursor Marketplace لمساعدة المطورين على البدء في البناء مباشرة من داخل المحرر.

باختصار، Cursor SDK في مرحلته التجريبية العامة، مما يوفر للمطورين الوصول البرمجي إلى نفس النماذج والبنية التحتية التي تدعم تطبيقات Cursor المختلفة. يعد هذا خطوة كبيرة نحو بناء وكلاء برمجيين أكثر فعالية وسهولة في الاستخدام.