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

لقد تغير نموذج فواتير GitHub Copilot مرتين في العام الماضي، وتغير مرة أخرى هذا الشهر. اعتبارًا من هذا الشهر، يبدأ تدقيق الكود بواسطة Copilot على طلبات السحب (Pull Requests) باستهلاك دقائق GitHub Actions من حساب الفوترة الذي يمتلك المستودع. بالإضافة إلى حصة الطلبات المميزة (Premium Request Quota) التي ظهرت في الربع الأخير، تتعامل فرق API الآن مع ثلاثة مقاييس في آن واحد: مقاعد Copilot، والطلبات المميزة، ودقائق Actions. يشرح هذا الدليل ما يقيسه كل مقياس، وكيف تؤثر فاتورة تدقيق الكود الجديدة على مستودعات API بشكل خاص، وكيفية تقدير التكاليف قبل ظهورها في الفاتورة.

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

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

ملخص سريع

• يحتوي Copilot على ثلاثة مقاييس: ترخيص لكل مقعد، وطلبات مميزة (حسب النموذج)، والآن دقائق Actions لتدقيق الكود بواسطة Copilot.
• يتم تدقيق الكود على طلبات السحب (PRs) كإجراء GitHub Action في الخلفية. كل تدقيق يستهلك دقائق Actions من ميزانية Actions العادية للمؤسسة.
• مستودعات الـ API تستهلك أكثر من المتوسط لأن طلبات السحب أكبر (مواصفات + عملاء مُنشأة + معالج + اختبارات) وتتم المراجعات عبر وكلاء متعددين.
• تحدد الطلبات المميزة العمل "الوكيل" (مساحة العمل، وضع الوكيل، مساحات Copilot). لا تزال المحادثات القياسية وإكمال الكود غير محدودة للفئات المدفوعة.
• حدد حدود الإنفاق قبل دورة الفوترة التالية. خصص ما بين 400 إلى 800 دقيقة Actions شهريًا لكل مستودع API نشط وراجع ذلك بعد 30 يومًا.

المقاييس الثلاثة وما يقيسونه بالفعل

اعتاد Copilot أن يكون فاتورة واحدة. الآن أصبح ثلاثة.

المقياس 1: ترخيص لكل مقعد

الرسوم الثابتة. 10 دولارات لكل مستخدم شهريًا لـ Copilot Business، و19 دولارًا لكل مستخدم شهريًا لـ Copilot Enterprise. يدفع هذا مقابل الدردشة، وعمليات الإكمال المضمنة، والاقتراحات متعددة الأسطر، وتكاملات بيئة التطوير المتكاملة (IDE)، والوصول إلى مجمع النماذج القياسية. المقاعد هي أسهل بند يمكن التنبؤ به والأكثر عرضة لزيادة التخصيص. قم بمراجعتها مرة واحدة كل ربع عام واستعد المقاعد من المستخدمين غير النشطين.

المقياس 2: الطلبات المميزة

الطلبات المميزة هي عملة GitHub للميزات الأكثر تكلفة. أي شيء يعمل في وضع الوكيل (agent mode) أو مساحة العمل (Workspace) أو مساحات Copilot (Copilot Spaces) أو اختيار نموذج يتجاوز الإعداد الافتراضي، يُحسب كطلب مميز واحد أو أكثر حسب النموذج.

الأسعار الحالية (قابلة للمراجعة):

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

بالنسبة لفريق API، فإن الطلبات التي تحرك المقياس هي مهام وضع الوكيل مثل "إعادة إنشاء عميل OpenAPI" أو "كتابة اختبار عقد لنقطة النهاية الجديدة هذه". تميل هذه المهام إلى أن تكون متعددة الخطوات داخليًا، لذا يمكن أن يؤدي أمر مستخدم واحد إلى أربعة أو خمسة طلبات مميزة.

المقياس 3: دقائق Actions (جديد لتدقيق الكود)

هذا هو التغيير الذي فاجأ الفرق هذا الشهر. عندما يجري Copilot تدقيقًا آليًا للكود على طلب سحب، يعمل التدقيق كإجراء GitHub Action تحت نفس البنية التحتية لـ Actions التي يستخدمها CI الخاص بك. تُخصم الدقائق التي يستهلكها التدقيق من ميزانية Actions العادية للمؤسسة.

شيئان يجب معرفتهما:

• الدقائق مُتضمنة بالفعل في حصة GitHub Plans Actions الحالية (3000 دقيقة/شهر على خطة Team، 50000 دقيقة على خطة Enterprise لـ Linux runners). إنها ليست حصة منفصلة.
• تكلف المراجعات على المستودعات الخاصة أكثر من المستودعات العامة لأن Actions على المستودعات الخاصة يتم احتسابها ضمن ميزانية الدقائق الخاصة بك، بينما Actions على المستودعات العامة مجانية.

يستهلك تدقيق كود Copilot النموذجي على طلب سحب API من 2 إلى 6 دقائق من Actions. يمكن أن يصل التدقيق الثقيل (فرق كبير، ملفات متعددة، سياق المستودع الكامل) إلى 15 دقيقة. اضرب هذا في عدد طلبات السحب التي يدمجها فريقك وستحصل على بند ذي معنى في الفاتورة.

لماذا تستهلك مستودعات الـ API هذه المقاييس بشكل أكبر

ثلاث خصائص لمستودعات الـ API تزيد من التكلفة:

1. طلبات السحب أكبر. يلمس تغيير API النموذجي المواصفات (openapi.yaml)، والعملاء المُنشأة بلغتين أو ثلاث لغات، ومعالج الخادم، واختبارات العقود. يقرأ تدقيق Copilot كل ذلك، ويستغرق وقتًا أطول، ويستهلك دقائق أكثر من تعديل واجهة أمامية لملف واحد.
2. الكود المُنشأ يُحرف عدد التوكنات. حتى عندما يتم تجاهل العملاء المُنشأة بواسطة Git، فإن العديد من الفرق تلتزم بها. يقرأ التدقيق كل ذلك ويدفع ثمن الامتياز.
3. وكلاء مراجعة متعددون يعملون لكل طلب سحب. الفرق التي تشغل تدقيق Copilot جنبًا إلى جنب مع CodeQL و Snyk وماسح أمني مخصص تدفع لكل منها على حدة. Copilot هو الوافد الجديد؛ أما الآخرون فكانوا بالفعل مُقاسين.

التأثير العملي: فريق API يدمج 50 طلب سحب شهريًا بمعدل 4 دقائق لكل تدقيق يستهلك 200 دقيقة Actions شهريًا لتدقيق Copilot وحده. هذا يمثل 7 بالمائة من الحصة الشهرية لفئة Team لمستودع واحد. ثلاثة مستودعات وتصل إلى 21 بالمائة قبل أي تشغيل لـ CI.

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

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

الخطوة 1: المقاعد

احسب مستخدمي Copilot النشطين واضربهم في سعر المقعد.

seats = active_users × $10  (Business)
      = active_users × $19  (Enterprise)

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

تقدير لكل مطور شهريًا. يستهلك مستخدم Workspace الكثيف حوالي 600 إلى 800 طلب؛ بينما يستهلك المستخدم الذي يستخدم الدردشة فقط حوالي 150 طلبًا. مع الحصة المضمنة البالغة 300 (Business)، توقع أن تبدأ الزيادات من جانب المستخدمين الكثيفين.

premium_overage = max(0, requests_used - 300_per_seat) × $0.04

عيّن حد إنفاق على مستوى المؤسسة حتى لا يتجاوز تكرار وكيل جامح ميزانيتك. الإعداد الافتراضي هو غير محدود، وهو الإعداد الافتراضي الخاطئ لأي فريق لا يراقب بنشاط.

الخطوة 3: دقائق Actions لتدقيق الكود

اضرب عدد طلبات السحب المدمجة شهريًا في الدقائق لكل تدقيق. متوسط 4 دقائق معقول لطلبات سحب API متوسطة الحجم.

review_minutes = prs_per_month × 4
review_overage = max(0, review_minutes - actions_quota_remaining)
                 × $0.008  (Linux private repos)

اجمع الثلاثة. بالنسبة لفريق مكون من 10 مطورين يدمج 200 طلب سحب شهريًا، تكون الأرقام التقريبية حوالي:

• المقاعد: 190 دولارًا (Enterprise)
• زيادة الطلبات المميزة: 40 دولارًا (استخدام وكيل معتدل)
• دقائق التدقيق: 800/شهر، ضمن حصة Enterprise بالكامل، 0 دولار
• المجموع: حوالي 230 دولارًا فوق خط أساس المقعد

الفرق الأصغر على مستوى Business تتجاوز الحصص بشكل أسرع لأن الحصص أكثر صرامة. فريق Business مكون من 5 مطورين يدمجون نفس الـ 200 طلب سحب سيستهلكون حصة Actions ويبدأون في دفع 6 دولارات لكل 1000 دقيقة تدقيق.

ما يتغير في مسار CI الخاص بك

ثلاثة تغييرات ملموسة في المسار تسدد التكلفة بين عشية وضحاها.

1. تخطي تدقيق Copilot على الروبوتات وطلبات السحب من 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

2. تخزين فروقات العميل المُنشأة مؤقتًا. إذا كان مستودعك يعيد إنشاء العملاء في كل طلب سحب، فإن التدقيق يقرأ الفرق في كل مرة. قم بتخزين الإخراج المُنشأ خلف دالة تجزئة محسوبة وتخطى مهمة التدقيق عندما تتطابق دالة التجزئة مع الفرع الأساسي.

3. تشغيل تدقيق Copilot على عامل تصفية مسار أصغر لمستودعات API. قصر التدقيق على ملفات المعالج والمواصفات والاختبار. تخطى العملاء المُنشأة بالكامل. تظل جودة التدقيق عالية؛ وتنخفض الدقائق إلى النصف.

on:
  pull_request:
    paths:
      - 'apis/**/*.yaml'
      - 'cmd/**'
      - 'internal/**'
      - 'tests/**'

الحوكمة: عناصر التحكم الأربعة التي يجب على كل فريق API تعيينها

تستغرق هذه الخطوات 20 دقيقة وتمنع معظم الفواتير المفاجئة.

1. حد الإنفاق. عينه على مستوى المؤسسة، وليس على مستوى المستودع. الإعداد الافتراضي هو غير محدود؛ اختر رقمًا لا تتردد فيه وخفضه بنسبة 20 بالمائة.
2. تنبيهات الطلبات المميزة. يرسل GitHub رسائل بريد إلكتروني عند 50 و75 و90 بالمائة من الحصة المضمنة. اربطها بـ Slack أو أداة إدارة الحوادث الخاصة بك حتى لا تضيع في صناديق البريد الوارد.
3. سياسة المستودع بشأن مشغلات المراجعة. قرر ما إذا كان تدقيق Copilot ينطلق في كل طلب سحب أو فقط على طلبات السحب التي تحمل التسمية review-please. النموذج القائم على التسميات يخفض التكاليف بنسبة 60 بالمائة تقريبًا دون فقدان المراجعات التي تكتشف مشكلات حقيقية.
4. النشر لكل فريق. قم بتمكين ميزات Copilot Enterprise لكل فريق بدلاً من على مستوى المؤسسة. يتم شحن الميزات الجديدة كخيار للموافقة عليه؛ لا يتعين عليك تحمل تكلفة كل إصدار لحظة إطلاقه.

أين يتناسب Apidog

Apidog ليس بديلاً عن Copilot؛ بل هو الطبقة التي تحافظ على اختبار عقودك ضمن أداة واحدة بدلاً من ثلاث. النمط الذي يحافظ على التكاليف والجودة قابلة للتنبؤ:

• توجد المواصفات وأمثلة الطلبات المحفوظة في مجموعة Apidog الملتزم بها جنبًا إلى جنب مع المستودع.
• يتم تشغيل اختبارات العقد مقابل خادم Apidog الوهمي، وليس API المباشر. عمليات التشغيل الوهمية مجانية وسريعة.
• يركز تدقيق Copilot على منطق المعالج وتغطية الاختبار، وليس على ما إذا كان مثال المواصفات محدثًا.
• يقوم سير عمل CI بتشغيل apidog-cli للتحقق من صحة العقد في 30 ثانية ولا يقوم بتشغيل تدقيق Copilot إلا إذا نجح التحقق.

هذا التسلسل مهم لأن تدقيق Copilot هو الخطوة الأكثر تكلفة في المسار. الفشل السريع في مشكلة عقد يوفر دقائق التدقيق للكود الذي يستحقها بالفعل. يغطي دليل اختبار API بدون Postman سير عمل Apidog الوهمي الأساسي؛ ويوضح دليل DeepSeek V4 API النمط المطبق على نموذج API.

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

ثلاثة أمور يجب وضعها في الاعتبار:

• اليوم 1 إلى 7: يبدو استخدام الطلبات المميزة طبيعيًا. تبقى معظم الفرق أقل من حصة الـ 300/مقعد المضمنة في الأسبوع الأول.
• اليوم 14 إلى 21: يتجاوز المستخدمون الكثيفون الحصة المضمنة. إذا قمت بتعيين حد للإنفاق، فتبدأ الطلبات في الفشل لهؤلاء المستخدمين. بدون حد، تزداد الفاتورة.
• اليوم 28 إلى 30: يتراكم استخدام دقائق Actions من تدقيق Copilot. هذا هو الوقت الذي تلاحظ فيه الفرق البند الجديد في الفاتورة. قارنها بفاتورة الشهر السابق جنبًا إلى جنب.

قم بالتدقيق في نهاية الشهر. انقل المستخدمين الكثيفين إلى فئة Enterprise (1000 طلب مضمن)، قلل مقاعد المستخدمين غير النشطين، وشدد عامل تصفية المسار على سير عمل التدقيق.

الأخطاء الشائعة

بعد تدقيق اثني عشر فريق API في الشهر الماضي، تظهر نفس المشكلات الخمس:

1. لا يوجد حد للإنفاق. يمكن أن تستمر حلقة وكيل واحدة لساعات. دائمًا ضع حدًا.
2. تفعيل التدقيق على كل مستودع. اختر المستودعات التي يحقق فيها التدقيق فائدة حقيقية. قم بتعطيله في الأماكن الأخرى.
3. مراجعة العملاء المُنشأة. قم بتصفيتهم حسب المسار.
4. مراجعة طلبات السحب من الروبوتات. قم بتصفية dependabot و renovate وأي تحديثات تلقائية داخلية.
5. عدم وجود مقاييس أساسية. بدون لقطة "قبل"، لا يمكنك معرفة ما إذا كان التغيير في سير العمل قد وفر المال. واجهة مستخدم الفوترة في GitHub توفر تصدير CSV؛ اسحبه شهريًا.

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

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

هل يتم قياس الإكمال التلقائي المضمن الآن؟لا. النموذج الافتراضي للمحادثة والإكمال التلقائي المضمن غير مقاس للفئات المدفوعة. تغطي الطلبات المميزة الميزات الأكثر تكلفة واختيار النماذج.

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

هل يتم فوترة دقائق Actions الجديدة لتدقيق الكود بشكل منفصل؟لا. إنها تستهلك نفس مجموعة دقائق Actions مثل بقية CI الخاص بك. تتبع إجمالي استخدام Actions واضبط مشغلات سير العمل للحفاظ على الميزانية في حدودها.

هل يمكنني تعطيل تدقيق كود Copilot بالكامل؟نعم. يمكن لمسؤول المؤسسة إلغاء اشتراك المستودعات على مستوى السياسة. يتحكم نفس الإعداد في التسجيل لكل فريق.

هل سيعمل تدقيق Copilot على مواصفات API الخاصة؟نعم. تستهلك المستودعات الخاصة دقائق Actions؛ المستودعات العامة مجانية. يقرأ المراجع ملفات المواصفات والمعالج مثل أي مصدر آخر.

هل يستخدم تدقيق Copilot طلبات مميزة أيضًا؟حاليًا، يستهلك دقائق Actions فقط. النموذج الذي يستخدمه المراجع هو جزء من منصة Copilot ولا يتم فوترته بشكل منفصل كطلب مميز. هذا هو الجزء الأكثر احتمالًا للتغير في الربع القادم؛ راقب سجل تغييرات GitHub.

بالنسبة للفرق التي تشغل تدقيق Copilot ومكالمات API النموذجية المباشرة في CI، يغطي دليل GPT-5.5 free Codex الجانب "لكل توكن" وApidog يغلف طبقة الوهم والعقد بحيث يتم تشغيل مراجعة الذكاء الاصطناعي فقط على طلبات السحب التي تجتاز الفحوصات الرخيصة أولاً.