DEV Community

Cover image for فوترة استخدام GitHub Copilot: ما الذي يجب أن تتوقعه فرق API
Yusuf Khalidd
Yusuf Khalidd

Posted on • Originally published at apidog.com

فوترة استخدام GitHub Copilot: ما الذي يجب أن تتوقعه فرق API

لقد تغيّر نموذج فواتير GitHub Copilot أكثر من مرة خلال العام الماضي، وأصبح الآن على فرق الـ API تتبّع ثلاثة مقاييس معًا: مقاعد Copilot، والطلبات المميزة، ودقائق GitHub Actions التي يستهلكها تدقيق الكود على طلبات السحب. هذا الدليل يوضح كيف تقيس كل فئة التكلفة، ولماذا ترتفع الفاتورة غالبًا في مستودعات الـ API، وكيف تضع حدودًا عملية قبل دورة الفوترة التالية.

جرّب Apidog اليوم

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

إذا كنت تقدّر أيضًا تكلفة نماذج الـ APIs التي يستهلكها فريقك مباشرةً، فراجع أدلة تسعير GPT-5.5 وتسعير DeepSeek V4 لتغطية جانب “لكل توكن”.

ملخص سريع

  • يحتوي Copilot الآن على ثلاثة مصادر تكلفة: ترخيص لكل مقعد، وطلبات مميزة، ودقائق Actions لتدقيق الكود.
  • يعمل تدقيق كود Copilot على طلبات السحب كـ GitHub Action، لذلك يستهلك من ميزانية Actions العادية.
  • مستودعات الـ API تستهلك أكثر لأن طلبات السحب غالبًا تشمل مواصفات، عملاء مولّدين، معالجات، واختبارات.
  • الطلبات المميزة تغطي العمل الوكيل مثل Workspace وAgent Mode وCopilot Spaces واختيار نماذج أعلى تكلفة.
  • قبل دورة الفوترة التالية، عيّن حد إنفاق وابدأ بتخصيص 400 إلى 800 دقيقة Actions شهريًا لكل مستودع API نشط، ثم راجع الأرقام بعد 30 يومًا.

المقاييس الثلاثة في فواتير Copilot

كان Copilot في السابق بندًا واحدًا. الآن يجب أن تتعامل معه كالتالي:

  1. مقاعد المستخدمين.
  2. الطلبات المميزة.
  3. دقائق Actions لتدقيق الكود.

1. ترخيص لكل مقعد

هذا هو الجزء الثابت من التكلفة:

Copilot Business    = 10 دولارات / مستخدم / شهر
Copilot Enterprise  = 19 دولارًا / مستخدم / شهر
Enter fullscreen mode Exit fullscreen mode

يغطي المقعد الدردشة، الإكمالات المضمنة، الاقتراحات متعددة الأسطر، تكاملات IDE، والوصول إلى النماذج القياسية.

إجراء عملي:

  • راجع المقاعد كل ربع سنة.
  • احذف المقاعد من المستخدمين غير النشطين.
  • افصل بين مستخدم يستخدم Copilot يوميًا ومستخدم لديه ترخيص لكنه لا يفتح IDE.

2. الطلبات المميزة

الطلبات المميزة هي وحدة قياس GitHub للميزات الأعلى تكلفة. تُستهلك عند استخدام:

  • Agent Mode
  • Workspace
  • Copilot Spaces
  • اختيار نموذج غير افتراضي
  • مهام متعددة الخطوات ينفذها Copilot نيابة عنك

الأسعار الحالية قابلة للتغيير، لكنها تقريبًا كالتالي:

الميزة التكلفة بالطلبات المميزة
الدردشة بالنموذج الافتراضي مجانية للخطط المدفوعة
الإكمالات المضمنة مجانية للخطط المدفوعة
Agent Mode بالنموذج الافتراضي 1 لكل طلب
Workspace بالنموذج الافتراضي 1 لكل طلب
اختيار Claude Sonnet 4.5 مضاعف 1.5x
اختيار GPT-5.5 مضاعف 2x
اختيار GPT-5.5 Pro مضاعف 6x
استعلام Copilot Spaces 1 لكل استعلام

كل مقعد في Copilot Business يأتي مع 300 طلب مميز شهريًا. أما Copilot Enterprise فيأتي مع 1000 طلب. بعد الحصة، تُحتسب الزيادة بسعر 0.04 دولار لكل طلب، حسب حد الإنفاق الذي تضبطه.

مثال شائع في فرق API:

مهمة: "أعد توليد عميل OpenAPI واكتب اختبار عقد لنقطة النهاية الجديدة"

قد ينتج عنها:
- قراءة المواصفات
- تعديل العميل
- تعديل الاختبار
- تحديث ملفات مساعدة
- شرح أو مراجعة التغيير

النتيجة: أمر واحد من المستخدم قد يستهلك عدة طلبات مميزة.
Enter fullscreen mode Exit fullscreen mode

3. دقائق Actions لتدقيق الكود

التغيير المهم هو أن تدقيق كود Copilot على Pull Requests يعمل كبنية GitHub Actions في الخلفية. أي أن وقت التشغيل يُخصم من نفس ميزانية Actions التي يستخدمها CI.

نقطتان مهمتان:

  • دقائق التدقيق ليست حصة منفصلة؛ هي جزء من حصة GitHub Actions الحالية.
  • المستودعات الخاصة تستهلك من الميزانية، بينما Actions على المستودعات العامة تكون مجانية عادةً.

في مستودع API متوسط، قد يستهلك تدقيق Copilot من 2 إلى 6 دقائق لكل Pull Request. أما طلبات السحب الكبيرة، التي تشمل ملفات كثيرة وسياقًا واسعًا، فقد تصل إلى 15 دقيقة.

لماذا تستهلك مستودعات API أكثر؟

1. طلبات السحب أكبر

تغيير API واحد قد يلمس:

  • openapi.yaml
  • عميل TypeScript مولّد
  • عميل Python مولّد
  • معالج الخادم
  • اختبارات العقود
  • وثائق أو أمثلة

كلما زاد الفرق الذي يقرأه Copilot، زادت مدة التدقيق، وبالتالي زادت دقائق Actions.

2. الكود المولّد يرفع حجم المراجعة

حتى إذا لم يكن الكود المولّد هو مصدر الحقيقة، فإن وجوده داخل Pull Request يجعل المراجع يقرأه. لذلك، مراجعة عملاء مولّدين بالكامل قد تستهلك وقتًا دون فائدة كبيرة.

3. تعدد أدوات المراجعة

كثير من فرق API تشغّل أكثر من أداة على كل Pull Request:

  • Copilot review
  • CodeQL
  • Snyk
  • ماسح أمني داخلي
  • اختبارات عقد
  • اختبارات تكامل

كل أداة لها تكلفة تشغيل. Copilot أصبح بندًا إضافيًا يجب قياسه مثل باقي الأدوات.

مثال سريع:

50 Pull Requests شهريًا
× 4 دقائق تدقيق لكل PR
= 200 دقيقة Actions شهريًا لتدقيق Copilot فقط
Enter fullscreen mode Exit fullscreen mode

إذا كان لديك 3 مستودعات API بنفس المعدل:

200 × 3 = 600 دقيقة Actions شهريًا
Enter fullscreen mode Exit fullscreen mode

وهذا قبل احتساب CI العادي.

كيفية تقدير الفاتورة الشهرية

قدّر التكلفة في ثلاث خطوات.

الخطوة 1: احسب تكلفة المقاعد 

Business:
seats_cost = active_users × 10

Enterprise:
seats_cost = active_users × 19
Enter fullscreen mode Exit fullscreen mode

مثال:

10 مطورين على Enterprise
10 × 19 = 190 دولارًا شهريًا
Enter fullscreen mode Exit fullscreen mode

الخطوة 2: احسب الطلبات المميزة

استخدم تقديرًا شهريًا لكل مطور:

  • مستخدم يعتمد على الدردشة فقط: حوالي 150 طلبًا.
  • مستخدم يستخدم Workspace أو Agent Mode بكثافة: 600 إلى 800 طلب.

مع Copilot Business:

premium_overage = max(0, requests_used - 300_per_seat) × 0.04
Enter fullscreen mode Exit fullscreen mode

مثال:

مطور يستخدم 700 طلب مميز شهريًا
الحصة = 300
الزيادة = 400
التكلفة = 400 × 0.04 = 16 دولارًا
Enter fullscreen mode Exit fullscreen mode

إجراء مهم: عيّن حد إنفاق على مستوى المؤسسة. لا تتركه غير محدود إذا لم تكن تراقب الاستخدام يوميًا.

الخطوة 3: احسب دقائق Actions للتدقيق

ابدأ بمتوسط 4 دقائق لكل Pull Request في مستودعات API متوسطة الحجم:

review_minutes = prs_per_month × 4
Enter fullscreen mode Exit fullscreen mode

ثم احسب الزيادة إذا تجاوزت حصة Actions المتبقية:

review_overage = max(0, review_minutes - actions_quota_remaining) × 0.008
Enter fullscreen mode Exit fullscreen mode

مثال لفريق يدمج 200 Pull Request شهريًا:

200 × 4 = 800 دقيقة تدقيق شهريًا
Enter fullscreen mode Exit fullscreen mode

إذا كانت الحصة تغطي ذلك، لن تظهر تكلفة إضافية. إذا كانت الحصة مستهلكة مسبقًا بواسطة CI، ستبدأ الزيادة بالظهور.

مثال تكلفة لفريق API

فريق من 10 مطورين على Copilot Enterprise يدمج 200 Pull Request شهريًا:

المقاعد:
10 × 19 = 190 دولارًا

زيادة الطلبات المميزة:
تقريبًا 40 دولارًا مع استخدام وكيل متوسط

دقائق التدقيق:
200 PR × 4 دقائق = 800 دقيقة
داخل حصة Enterprise غالبًا = 0 دولار إضافي

الإجمالي التقريبي:
230 دولارًا شهريًا
Enter fullscreen mode Exit fullscreen mode

أما فريق Business صغير من 5 مطورين يدمج نفس العدد من Pull Requests فقد يتجاوز حصة Actions بشكل أسرع لأن الحصص أقل.

تحسين مسار CI لتقليل التكلفة

1. تخطَّ تدقيق Copilot لطلبات الروبوتات

لا تحتاج غالبًا إلى مراجعة AI لتحديثات Dependabot أو Renovate.

on:
  pull_request:
    types: [opened, synchronize]

jobs:
  copilot-review:
    if: github.actor != 'dependabot[bot]' && github.actor != 'renovate[bot]'
    runs-on: ubuntu-latest
    steps:
      - uses: github/copilot-review@v1
Enter fullscreen mode Exit fullscreen mode

2. لا تراجع العملاء المولّدين إذا لم يتغير مصدرهم

إذا كنت تولّد عملاء API من openapi.yaml، فاجعل مصدر الحقيقة هو المواصفة. لا تدفع تكلفة مراجعة آلاف الأسطر المولّدة في كل مرة.

نهج عملي:

  1. احسب hash للمواصفة.
  2. قارنها بالفرع الأساسي.
  3. إذا لم تتغير، تخطَّ تدقيق ملفات العملاء المولّدة.
  4. إذا تغيرت، شغّل اختبارات العقد أولًا، ثم المراجعة.

3. استخدم فلترة المسارات

قصر تشغيل التدقيق على الملفات التي تستحق المراجعة:

on:
  pull_request:
    paths:
      - 'apis/**/*.yaml'
      - 'cmd/**'
      - 'internal/**'
      - 'tests/**'
Enter fullscreen mode Exit fullscreen mode

وتجنّب مثلًا:

      - 'generated/**'
      - 'clients/**'
Enter fullscreen mode Exit fullscreen mode

إلا إذا كان الكود المولّد يتم تعديله يدويًا فعلًا.

4. شغّل التدقيق بعد الاختبارات الرخيصة

اجعل ترتيب CI كالتالي:

1. lint
2. validate OpenAPI
3. contract tests
4. unit tests
5. Copilot review
Enter fullscreen mode Exit fullscreen mode

الفكرة: إذا فشل Pull Request في خطوة سريعة ورخيصة، لا داعي لتشغيل مراجعة AI عليه.

إعدادات الحوكمة التي يجب ضبطها

1. حد الإنفاق

عيّنه على مستوى المؤسسة. لا تعتمد على الإعداد الافتراضي إذا كان غير محدود.

قاعدة عملية:

budget_limit = الميزانية المقبولة - 20%
Enter fullscreen mode Exit fullscreen mode

إذا كنت تستطيع قبول 500 دولار زيادة، ابدأ مثلًا بـ 400 دولار.

2. تنبيهات الطلبات المميزة

فعّل التنبيهات عند:

  • 50%
  • 75%
  • 90%

ثم اربطها بـ Slack أو أداة incident management حتى لا تضيع في البريد.

3. سياسة تشغيل المراجعة

اختر أحد النمطين:

تشغيل تلقائي على كل Pull Request

مناسب للفرق الصغيرة أو المستودعات الحساسة.

تشغيل عبر label

مثال:

شغّل Copilot review فقط عند وجود label باسم review-please
Enter fullscreen mode Exit fullscreen mode

هذا يقلل التشغيل غير الضروري، خصوصًا في Pull Requests التوثيقية أو تحديثات الروبوتات.

4. تفعيل الميزات حسب الفريق

لا تفعّل كل ميزات Copilot Enterprise على مستوى المؤسسة دفعة واحدة. ابدأ بفريق API واحد، راقب التكلفة، ثم وسّع النطاق.

أين يتناسب Apidog في سير العمل؟

Apidog ليس بديلًا عن Copilot. دوره العملي هو جعل مواصفات API واختبارات العقود والـ mocks في مكان واحد، بحيث لا تستخدم مراجعة AI إلا عندما تكون مفيدة.

نمط سير عمل قابل للتطبيق:

  1. خزّن مواصفات API وأمثلة الطلبات في Apidog بجانب المستودع.
  2. شغّل اختبارات العقد ضد mock server بدل API مباشر.
  3. اجعل Copilot يراجع منطق المعالج وتغطية الاختبارات، لا صحة أمثلة المواصفة.
  4. شغّل apidog-cli داخل CI للتحقق من العقد قبل مراجعة Copilot.

مثال تسلسل:

Pull Request
→ OpenAPI validation
→ Apidog contract tests
→ unit tests
→ Copilot review
→ merge
Enter fullscreen mode Exit fullscreen mode

هذا مهم لأن مراجعة Copilot هي الخطوة الأعلى تكلفة في المسار. الفشل السريع في مشكلة عقد يوفر دقائق التدقيق للكود الذي يستحق المراجعة فعلًا.

للمزيد عن سير عمل الاختبار، راجع دليل اختبار API بدون Postman، ولتطبيق النمط على نموذج API راجع دليل DeepSeek V4 API.

ماذا تراقب في دورة الفوترة التالية؟

اليوم 1 إلى 7

الاستخدام يبدو طبيعيًا غالبًا. معظم الفرق تبقى تحت حصة الطلبات المميزة في الأسبوع الأول.

اليوم 14 إلى 21

المستخدمون الكثيفون يبدأون بتجاوز الحصة. إذا كان لديك حد إنفاق، قد تفشل بعض الطلبات بدل زيادة الفاتورة.

اليوم 28 إلى 30

تظهر دقائق Actions المتراكمة من تدقيق Copilot بوضوح. قارن الفاتورة مع الشهر السابق، خصوصًا:

  • إجمالي دقائق Actions.
  • عدد Pull Requests.
  • متوسط مدة التدقيق.
  • عدد الطلبات المميزة لكل مستخدم.

بعد نهاية الشهر:

  • انقل المستخدمين الكثيفين إلى Enterprise إذا كان ذلك أوفر.
  • احذف المقاعد غير النشطة.
  • شدّد فلترة المسارات في سير عمل التدقيق.
  • استثنِ الروبوتات والكود المولّد.

أخطاء شائعة

  1. عدم ضبط حد إنفاق

    حلقة Agent واحدة قد ترفع التكلفة بسرعة. ضع حدًا دائمًا.

  2. تفعيل التدقيق على كل المستودعات

    فعّله فقط حيث توجد قيمة مراجعة حقيقية.

  3. مراجعة العملاء المولّدين

    استخدم paths لتجاهلهم.

  4. مراجعة Pull Requests من الروبوتات

    استثنِ Dependabot وRenovate وأي بوت داخلي.

  5. عدم حفظ baseline

    صدّر CSV من واجهة فواتير GitHub شهريًا حتى تعرف أثر أي تغيير.

الأسئلة الشائعة

هل ما زال سعر المقعد 10 دولارات لكل مستخدم؟

نعم لـ Copilot Business: 10 دولارات لكل مستخدم شهريًا. Copilot Enterprise يكلف 19 دولارًا لكل مستخدم شهريًا، وCopilot Pro للأفراد يكلف 10 دولارات شهريًا. فئة المقعد تحدد أيضًا حصة الطلبات المميزة المضمنة.

هل الإكمال التلقائي المضمن أصبح مقاسًا؟

لا. الدردشة بالنموذج الافتراضي والإكمالات المضمنة غير مقاسة للخطط المدفوعة. الطلبات المميزة تغطي الميزات الأعلى تكلفة واختيار النماذج.

ماذا يحدث عند نفاد حصتي من الطلبات المميزة؟

إذا لم تسمح بالزيادة، تبدأ الطلبات بالفشل بسبب الحصة. يمكنك ضبط حد إنفاق للسماح بالتجاوز بسعر 0.04 دولار لكل طلب حتى الحد المحدد.

هل تتم فوترة دقائق Actions الخاصة بتدقيق الكود بشكل منفصل؟

لا. تستهلك نفس حصة GitHub Actions التي يستخدمها CI. لذلك راقب إجمالي Actions وليس تدقيق Copilot فقط.

هل يمكن تعطيل تدقيق كود Copilot بالكامل؟

نعم. يمكن لمسؤول المؤسسة تعطيله عبر السياسات أو تقييد التفعيل حسب الفريق أو المستودع.

هل يعمل تدقيق Copilot على مواصفات API الخاصة؟

نعم. في المستودعات الخاصة، سيستهلك ذلك دقائق Actions. يقرأ المراجع ملفات المواصفات والمعالجات والاختبارات مثل أي ملفات مصدر أخرى.

هل يستهلك تدقيق Copilot طلبات مميزة أيضًا؟

حاليًا، يستهلك دقائق Actions فقط. النموذج المستخدم داخل المراجع جزء من منصة Copilot ولا يُفوَّتر كطلب مميز منفصل. لكن هذا النوع من السياسات قد يتغير، لذلك راقب سجل تغييرات GitHub.

بالنسبة للفرق التي تشغّل تدقيق Copilot ومكالمات API مباشرة داخل CI، يغطي دليل GPT-5.5 free Codex جانب “لكل توكن”، بينما يساعد Apidog في إبقاء طبقة الـ mock واختبارات العقود قبل مراجعة AI، بحيث لا تعمل المراجعة إلا على Pull Requests التي اجتازت الفحوصات الأرخص أولًا.

Top comments (0)