يمثل دمج نماذج الذكاء الاصطناعي المتقدمة مثل GPT-5 في سير عمل التطوير قفزة كبيرة إلى الأمام في إنتاجية المطورين. مع الإصدار الأخير من Cursor CLI، أصبح بإمكان المستخدمين الآن الوصول إلى أدوات سطر أوامر قوية تستفيد من أحدث تقنيات الذكاء الاصطناعي.
يقدم هذا الدليل شرحًا تقنيًا خطوة بخطوة لاستخدام GPT-5 عبر Cursor CLI لإنشاء تصاميم واجهة برمجة التطبيقات (API) ورمز الخادم، ثم استيراد هذه العناصر والتحقق منها باستخدام Apidog. ستحصل على أوامر دقيقة، وأمثلة عملية للأوامر، وأنماط أتمتة لـ CI، ونصائح للتقوية. حيثما أمكن، سأقوم بالربط بالوثائق والأمثلة الرسمية حتى تتمكن من تكرار كل خطوة.
فهم Cursor CLI ودمج GPT-5
يمثل Cursor CLI حدودًا جديدة في التطوير بمساعدة الذكاء الاصطناعي، حيث يجلب قدرات منصة Cursor مباشرة إلى طرفيتك. تم إطلاقه كإصدار تجريبي مبكر، ويسمح بتفاعل سلس بين واجهة سطر الأوامر (CLI) والمحرر، ويدعم نماذج ذكاء اصطناعي متعددة، بما في ذلك GPT-5 الذي تم تقديمه حديثًا من OpenAI. يُعرف GPT-5 بقدراته المحسنة في الاستدلال والترميز، ويعد بمعالجة المهام المعقدة بدقة أكبر من سابقاته.
يتيح دمج GPT-5 في Cursor CLI للمطورين تنفيذ الأوامر، وأتمتة سير العمل، وإنشاء التعليمات البرمجية مباشرة من الطرفية. تتضمن الواجهة، كما هو موضح في صور منشور X، خيارات مثل تحميل الأعمال الفنية من واجهات برمجة التطبيقات، وتشغيل التشغيل، وإخراج ملخصات التغيير، مع GPT-5 الذي يدعم تنفيذ الأوامر. يوفر هذا الإعداد بيئة مرنة حيث يمكن للمطورين تبديل النماذج وإدارة المهام بكفاءة.
تثبيت Cursor CLI والتحقق
الخطوة 1 — التثبيت (سطر واحد):
curl https://cursor.com/install -fsS | bash
هذا هو سطر التثبيت الرسمي الموثق بواسطة Cursor لـ CLI. بعد ذلك، تصبح أوامر CLI متاحة (على سبيل المثال، cursor-agent). (Cursor، Cursor)
الخطوة 2 — التحقق من التثبيت والإصدار:
cursor-agent --version
cursor-agent status
يدعم CLI أوامر --version و status (الأخير يظهر حالة المصادقة وتكوين نقطة النهاية). (Cursor)
الخطوة 3 — المصادقة (خياران)
تدفق المتصفح (موصى به لأجهزة التطوير):
cursor-agent login
# هذا يفتح متصفحك ويكمل المصادقة.
cursor-agent status
مفتاح API (موصى به للنصوص البرمجية / CI):
أنشئ مفتاح API في لوحة تحكم Cursor الخاصة بك.
قم بتصديره:
export CURSOR_API_KEY="sk_XXXX..."
# أو مرره مباشرة للأوامر الفردية:
cursor-agent --api-key sk_XXXX... "إعادة هيكلة وحدة المصادقة"
يقبل CLI --api-key أو متغير البيئة CURSOR_API_KEY للأتمتة غير التفاعلية.
ملاحظة الأمان: يمكن لـ Cursor Agent قراءة، وتعديل، وتشغيل أوامر shell — قم بتشغيله فقط في سياقات موثوقة أو على مشغلات CI آمنة. تشير وثائق CLI صراحة إلى تطور تدابير الأمان.
تأكيد الوصول إلى GPT-5 وعلامات النموذج
يكشف Cursor CLI عن علامة -m, --model لتحديد النماذج. تتضمن أمثلة النماذج sonnet-4، sonnet-4-thinking، و gpt-5. يمكنك أيضًا تبديل النماذج داخل الجلسات التفاعلية عبر الأمر الشرطة المائلة /model. استخدم العلامة -m للنصوص البرمجية.
فحص سريع (سرد النماذج تفاعليًا):
ابدأ CLI، ثم استخدم /model:
cursor-agent
# داخل الجلسة، اكتب:
/model
# أو استخدم:
cursor-agent -m gpt-5 "اطبع النماذج المتاحة وتأكد من الوصول"
ملاحظة أيضًا: أعلنت Cursor عن توفر GPT-5 داخل Cursor؛ توقع رؤية gpt-5 مدرجًا.
حالة استخدام ملموسة: إنشاء مواصفات OpenAPI 3.0 باستخدام GPT-5 (خطوة بخطوة)
سنطلب من GPT-5 (عبر Cursor CLI) إنتاج ملف OpenAPI YAML لواجهة برمجة تطبيقات دفعات بسيطة. ثم سنقوم باستيراد هذا الملف إلى Apidog وتشغيل الاختبارات.
الخطوة 3.1 — صياغة أمر صارم (التحكم في التنسيق مهم)
عند إنشاء عناصر قابلة للقراءة آليًا، اطلب من النموذج أن يخرج محتويات الملف فقط (بدون علامات Markdown، بدون تعليقات). استخدم أمثلة قليلة لإجبار المخططات والتسميات المتسقة. توصي OpenAI Cookbook ووثائق Cursor بأوامر نظام صارمة وتنسيق الاستجابة لتجنب النص الغلافي غير المرغوب فيه. (OpenAI Cookbook، Cursor)
مثال على الأمر (موجز وصريح):
OpenAPI 3.0.3openapi.yamlالأمان: رمز مميز حامل Authorization (HTTP bearer)
نقاط النهاية:
POST /payments — إنشاء دفعة؛ نص الطلب application/json؛ الاستجابة 201
GET /payments/{paymentId} — الحصول على دفعة بواسطة المعرف؛ الاستجابة 200 أو 404
PUT /payments/{paymentId} — تحديث البيانات الوصفية؛ الاستجابة 200
DELETE /payments/{paymentId} — إلغاء؛ الاستجابة 204
مكونات/مخططات لـ PaymentRequest، PaymentResponse، ومخطط Error
أمثلة على نصوص الطلبات والاستجابات
استخدم USD وادخل amount كعدد صحيح من السنتات
components.securitySchemesالخطوة 3.2 — استدعاء Cursor CLI بشكل غير تفاعلي والتقاط YAML
استخدم -m gpt-5 لاختيار GPT-5 و -p لطباعة الاستجابات (غير تفاعلي). أعد توجيه الإخراج القياسي إلى openapi.yaml.
# عيّن مفتاح API الخاص بك في CI أو محليًا:
export CURSOR_API_KEY="sk_..."
# إنشاء غير تفاعلي مع اختيار النموذج ووضع الطباعة
cursor-agent -m gpt-5 -p "أنشئ OpenAPI 3.0.3 YAML لواجهة برمجة تطبيقات المدفوعات (انظر الأمر أعلاه)" > openapi.yaml
شرح:
-m gpt-5 يفرض استخدام GPT-5.
-p يطبع استجابة النموذج، والتي تعيد توجيهها إلى ملف لاستخدامها لاحقًا. يدعم Cursor CLI --output-format و -p للبرمجة النصية. (Cursor)
إذا أدرج النموذج عن طريق الخطأ نصًا غلافيًا، أعد التشغيل بصياغة أكثر صرامة: أجب بـ YAML فقط، بدءًا من 'openapi:' — هذا يقلل من الفوضى.
التحقق من صحة YAML الذي تم إنشاؤه محليًا (فحوصات سريعة للتأكد من السلامة)
قبل التحميل أو الاستيراد:
تدقيق YAML:
npm i -g yaml-cli # اختياري
yaml validate openapi.yaml
مدقق OpenAPI (Speccy / Spectral):
npm install -g @stoplight/spectral
spectral lint openapi.yaml
أصلح أي مشاكل مخطط تم الإبلاغ عنها (أحيانًا تسيء GPTs استخدام type: integer مقابل format: int64، أو تحذف required، أو تضع components في غير مكانها). هذه تعديلات يدوية سريعة.
استيراد مواصفات OpenAPI إلى Apidog (خياران)
يدعم Apidog الاستيراد اليدوي عبر واجهة المستخدم أو استيراد API (POST /v1/projects/{projectId}/import-openapi) لسير العمل البرمجي. اختر النهج الذي يناسب خط أنابيبك. (docs.apidog.com، openapi.apidog.io)
الخيار أ — الاستيراد اليدوي عبر واجهة المستخدم (سريع، موصى به للتكرار الأول)
افتح Apidog ← إنشاء مشروع ← إعدادات المشروع ← استيراد البيانات ← OpenAPI.
يمكنك إما سحب وإسقاط ملفات JSON أو YAML في المنطقة الموضحة أدناه، أو ببساطة النقر على المنطقة لتصفح واختيار الملف المطلوب من مدير ملفات نظامك.
عند استخدام استيراد URL، يرجى توفير URL المباشر لملف بيانات JSON أو YAML، وليس URL الأساسي لواجهة مستخدم Swagger.
استيراد - إعدادات متقدمة
الخيار ب — الاستيراد البرمجي (CI / أتمتة)
إذا كنت تستضيف openapi.yaml على URL ثابت (S3، GitHub الخام)، فاستدعِ نقطة نهاية استيراد OpenAPI:
# مثال: استيراد عبر Apidog API (يتطلب APIDOG_ACCESS_TOKEN و projectId)
curl --location -g --request POST "https://api.apidog.com/v1/projects/${APIDOG_PROJECT_ID}/import-openapi?locale=en-US" \
--header "Authorization: Bearer ${APIDOG_ACCESS_TOKEN}" \
--header "Content-Type: application/json" \
--data-raw '{
"input": {"url": "https://my-bucket.s3.amazonaws.com/openapi.yaml"},
"options": {
"targetEndpointFolderId": 0,
"endpointOverwriteBehavior": "OVERWRITE_EXISTING"
}
}'
تُعطي الاستجابة عدادات لنقاط النهاية والمخططات التي تم إنشاؤها/تحديثها — استخدم ذلك للتأكد من النجاح في CI. تتضمن وثيقة API نقطة نهاية POST هذه والمثال.
إنشاء اختبارات في Apidog أو استيراد حالات نقطة النهاية (دليل سريع)
بمجرد أن تكون مواصفات OpenAPI في Apidog:
استخدم واجهة مستخدم Apidog لإنشاء قوالب طلبات ونماذج أجسام تلقائيًا.
قم بتكوين بيئة (URL أساسي للمرحلة + متغير بيئة رمز API).
أنشئ سيناريو اختبار: قم بتسلسل اختبارات دورة الحياة القياسية (إنشاء ← قراءة ← تحديث ← حذف). يدعم Apidog إنشاء سيناريوهات الاختبار والتأكيدات الآلية عبر وحدة الاختبارات. (docs.apidog.com)
إذا كنت تفضل أتمتة إنشاء الاختبارات، يمكنك برمجة استدعاءات Appdog API لإنشاء سيناريوهات الاختبار برمجيًا (يقدم Apidog OpenAPI لـ API الخاص به). راجع وثائق Apidog API لنقاط النهاية. (openapi.apidog.io)
تثبيت Apidog CLI وتشغيل الاختبارات محليًا أو في CI
التثبيت عالميًا:
# Node.js (v16+) مطلوب
npm install -g apidog-cli
# تحقق
node -v && apidog -v
يمكن لـ Apidog CLI التشغيل عبر الإنترنت (مع رمز وصول) أو محليًا/دون اتصال باستخدام سيناريوهات الاختبار المصدرة. للتشغيل عبر الإنترنت، مرر --access-token مع رمز وصول Apidog الخاص بك.
تشغيل سيناريو اختبار محفوظ (عبر الإنترنت):
export APIDOG_ACCESS_TOKEN="sk_apidog_..."
apidog run --access-token $APIDOG_ACCESS_TOKEN -t <TEST_ID> -e <ENV_ID> -r html,cli
تشغيل محليًا (من سيناريوهات الاختبار المصدرة):
apidog run ./exported-scenarios/payment-tests.json --report cli
يتكامل Apidog CLI بسلاسة في خطوط أنابيب CI وينتج تقارير CLI/HTML لتشغيل الاختبارات.
مثال على الأتمتة الشاملة: إنشاء مواصفات باستخدام GPT-5، استيراد إلى Apidog، تشغيل الاختبارات (GitHub Actions)
فيما يلي سير عمل GitHub Actions بسيط يوضح النمط.
name: GPT5 → Apidog CI
on: [push]
jobs:
generate-and-test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Install Node.js and Apidog CLI
uses: actions/setup-node@v4
with:
node-version: '18'
- run: npm install -g apidog-cli
- name: Install Cursor CLI
run: curl https://cursor.com/install -fsS | bash
- name: Generate OpenAPI via Cursor (headless)
env:
CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}
run: |
cursor-agent -m gpt-5 -p "Generate OpenAPI 3.0.3 YAML for a Payments API. Only return raw YAML." > openapi.yaml
# Basic validation
npx @stoplight/spectral lint openapi.yaml || true
- name: Upload openapi.yaml to S3 (or GitHub Raw)
run: |
# خطوات التحميل هنا -- تعتمد على البنية التحتية الخاصة بك
echo "Upload to bucket and set OPENAPI_URL"
- name: Import to Apidog via API
env:
APIDOG_ACCESS_TOKEN: ${{ secrets.APIDOG_ACCESS_TOKEN }}
APIDOG_PROJECT_ID: ${{ secrets.APIDOG_PROJECT_ID }}
run: |
curl -s -X POST "https://api.apidog.com/v1/projects/${APIDOG_PROJECT_ID}/import-openapi?locale=en-US" \
-H "Authorization: Bearer ${APIDOG_ACCESS_TOKEN}" \
-H "Content-Type: application/json" \
--data-raw "{\"input\":{\"url\":\"${{ env.OPENAPI_URL }}\"},\"options\":{}}"
- name: Run Apidog tests
env:
APIDOG_ACCESS_TOKEN: ${{ secrets.APIDOG_ACCESS_TOKEN }}
run: |
apidog run --access-token $APIDOG_ACCESS_TOKEN -t 637132 -e 358171 -r cli
ملاحظات:
استبدل خطوات S3 / التحميل باستضافة العناصر الخاصة بك.
احتفظ بالأسرار CURSOR_API_KEY، APIDOG_ACCESS_TOKEN، و APIDOG_PROJECT_ID في أسرار المستودع.
وافق على المواصفات التي تم إنشاؤها وتحقق منها قبل نشرها في الإنتاج.
يدعم كل من Apidog و Cursor الاستخدام بدون واجهة رسومية/CI: يدعم Cursor CLI صراحة استخدام الوكيل بدون واجهة رسومية عبر البيئات، وتم بناء Apidog CLI لتكامل CI.
متقدم: اجعل الوكيل يقوم بتعديل التعليمات البرمجية، وتشغيل الاختبارات محليًا، وتثبيت التعديلات
يمكن لوكيل Cursor تعديل الملفات وتشغيل أوامر shell (مع مراعاة الموافقات). تتيح لك هذه الإمكانية:
طلب من GPT-5 إنشاء رمز خادم (Express/Flask/FastAPI).
مراجعة الفروقات في الطرفية.
قبول التطبيق، تشغيل npm test، وتثبيت التغييرات تلقائيًا.
مثال على التسلسل (تطوير محلي):
# إنشاء رمز + تطبيق
cursor-agent -m gpt-5 "أنشئ مسار Express v4 في src/routes/payments.js بمعالجات لـ POST/GET/PUT/DELETE واختبارات وحدة (jest). قم بتشغيل الاختبارات بعد التطبيق."
# سيقترح Cursor CLI تعديلات؛ قم بمراجعتها واسمح أو ارفض أوامر shell محددة.
تصف الوثائق مجموعة أدوات الوكيل (عمليات الملفات، البحث، تشغيل أوامر shell) وتؤكد على نقاط مراجعة وتدفقات عمل التسجيل. استخدمها للحفاظ على التحكم في التعديلات الآلية.
تصحيح الأخطاء الشائعة
أنتج GPT YAML غير صالح — أعد التشغيل بأمر دقيق "YAML فقط"، أو عالجه لاحقًا باستخدام sed/yq لإزالة الأسطر الزائدة.
يبلغ استيراد Apidog عن حقول مفقودة — افحص components ومعرفات العمليات؛ يعين Apidog summary، operationId، و path بشكل تفضيلي لأسماء نقاط النهاية. أصلحها في المواصفات، ثم أعد الاستيراد.
يفشل Apidog CLI بسبب المتغيرات أو مسارات الملفات — استخدم المسارات المطلقة لتحميل الملفات في تشغيل CLI وتحقق من تعيين متغيرات البيئة. تشرح وثائق Apidog مشاكل مسار الملفات الشائعة وكيفية تكوين تشغيل CLI.
الأمان والحوكمة (مهم جدًا)
لا تقم أبدًا بتشغيل الوكيل ببيانات اعتماد مرتفعة على رمز غير موثوق به. يحذر Cursor من أن CLI يمكنه تشغيل أوامر shell وتعديل الملفات؛ احمِ أسرار الإنتاج بعناية.
التعامل مع الأسرار: احتفظ بمفاتيح API وأسرار البيئة في مخزن أسرار CI الخاص بك. استخدم Apidog Vault / متغيرات البيئة بدلاً من تضمين الرموز المميزة في المواصفات. يدعم Apidog تكاملات الخزائن (HashiCorp، Azure Key Vault).
وافق على تغييرات الوكيل يدويًا عندما يقترح الوكيل عمليات نظام ملفات أو shell؛ اطلب خطوة موافقة بشرية واحدة على الأقل في CI لدفعات الإنتاج.
أمثلة: أوامر دقيقة يمكنك نسخها
إنشاء OpenAPI YAML (مختصر):
cursor-agent -m gpt-5 -p "أخرج فقط OpenAPI 3.0.3 YAML صالحًا لواجهة برمجة تطبيقات 'المدفوعات' مع POST /payments، GET/PUT/DELETE /payments/{paymentId}. استخدم components.schemas PaymentRequest و PaymentResponse. أضف أمثلة. لا تدرج أي علامات Markdown أو تعليقات."
اجعل Cursor يكتب معالج Express واختبارات:
cursor-agent -m gpt-5 -p "أنشئ معالجات مسار Express في src/routes/payments.js مع اختبارات وحدة مقابلة في tests/payments.test.js. نفذ تخزينًا أساسيًا في الذاكرة. قدم نصوص package.json لتشغيل الاختبارات. أخرج فقط تصحيح JSON يظهر أسماء الملفات والمحتويات الكاملة بتنسيق JSON."
تحويل وصف README موجود إلى مواصفات OpenAPI:
cursor-agent -m gpt-5 -p "حوّل وصف README API التالي إلى OpenAPI 3.0.3 YAML. أخرج YAML فقط. [الصق فقرات README]"
لماذا يجب إقران GPT-5 + Cursor CLI + Apidog؟
يجلب Cursor CLI GPT-5 إلى الطرفية ويدعم الأتمتة غير التفاعلية، وعمليات الملفات، واستخدام CI بدون واجهة رسومية. هذا يقلل الاحتكاك عندما تريد عناصر يتم إنشاؤها آليًا مباشرة في مستودعك.
يوفر GPT-5 دقة واستدلالًا أعلى لإنشاء التعليمات البرمجية والمخططات (أضاف Cursor دعم GPT-5 داخل المنتج).
يكمل Apidog الحلقة: استورد مواصفات OpenAPI الناتجة، أنشئ خوادم وهمية، قم بتشغيل اختبارات الدخان والتكامل، وصدر التقارير — مما يتيح حلقة تغذية راجعة قوية للتطوير/الاختبار.
الخاتمة
يمنحك سير العمل هذا نمطًا عمليًا: إنشاء (GPT-5 عبر Cursor CLI) ← استيراد/فحص (Apidog) ← محاكاة واختبار (Apidog CLI/UI). إنه يسرع عملية النماذج الأولية، وبالاقتران مع التحقق (Spectral، اختبارات الوحدة) يمكنك الانتقال بأمان من الفكرة إلى التكامل. مع التوسع، أضف حواجز حماية أكثر صرامة: بوابات التحقق من المخطط، الموافقات اليدوية على الرمز الذي تم إنشاؤه، ومجموعات الاختبار المتدحرجة.
