تخصيص وتوسيع والتحقق من وكيل Copilot Cloud

  • 5 دقائق

يعمل GitHub Copilot Cloud Agent داخل بيئة GitHub Actions آمنة ومؤقتة. من خلال بضع خطوات تكوين، يمكنك إعداد هذه البيئة مسبقا لتحسين الموثوقية والسرعة، وتوسيع إمكانات العامل باستخدام أدوات خارجية من خلال بروتوكول سياق النموذج (MCP)، وتطبيق أفضل الممارسات لاختبار إخراج العامل والتحقق من صحته قبل الدمج.

بنهاية هذه الوحدة ، ستتمكن من:

  • قم بتثبيت الأدوات والتبعيات والأسرار مسبقا لتخصيص بيئة تطوير العامل.
  • قم بتوسيع إمكانات العامل باستخدام بروتوكول سياق النموذج (MCP).
  • اختبار إخراج العامل والتحقق من صحته بشكل فعال قبل دمج التغييرات.

البذر المسبق لبيئة التنمية

أدوات التثبيت المسبق والتبعيات باستخدامcopilot-setup-steps.yml

قم بالإنشاء .github/workflows/copilot-setup-steps.yml في الفرع الافتراضي لمستودعك. يجب أن يحدد سير العمل وظيفة واحدة باسم copilot-setup-steps. قم بتضمين أي خطوات مطلوبة لتثبيت التبعيات أو إعداد الأدوات.

مثال على TypeScript:

name: "Copilot Setup Steps"

on:
  workflow_dispatch:
  push:
    paths:
      - .github/workflows/copilot-setup-steps.yml
  pull_request:
    paths:
      - .github/workflows/copilot-setup-steps.yml

jobs:
  copilot-setup-steps:
    runs-on: ubuntu-latest
    permissions:
      contents: read
    steps:
      - name: Checkout code
        uses: actions/checkout@v5
      - name: Set up Node.js
        uses: actions/setup-node@v4
        with:
          node-version: "20"
          cache: "npm"
      - name: Install JavaScript dependencies
        run: npm ci

مفاتيح التكوين المسموح بها للوظيفة copilot-setup-steps : steps, permissions, runs-on, container, services, snapshot, timeout-minutes (≤ 59). يتم تجاوز أي actions/checkout عمق جلب للسماح بالتراجع الآمن. يتم تشغيل سير عمل الإعداد بشكل مستقل (حتى تتمكن من التحقق من صحته) ثم تلقائيا قبل بدء تشغيل العامل.

عدائين أكبر مستضافة من GitHub

  • أضف عدائين أكبر أولا
  • في copilot-setup-steps.yml، قم بالتعيين runs-on إلى التسمية/المجموعة (على سبيل المثال، ubuntu-4-core).
  • يتم دعم عدائي Ubuntu x64 فقط ؛ لا يتم دعم المتسابقين المستضافين ذاتيا.

جيت إل إف إس

إذا كنت تستخدم Git Large File Storage، فقم بتمكينه في خطوات الإعداد:

jobs:
  copilot-setup-steps:
    runs-on: ubuntu-latest
    permissions:
      contents: read
    steps:
      - uses: actions/checkout@v5
        with:
          lfs: true

تخصيص جدار الحماية

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

التوسيع باستخدام بروتوكول سياق النموذج (MCP)

MCP هو معيار مفتوح لتوصيل LLMs بالأدوات والبيانات. يمكن للعامل استخدام الأدوات التي توفرها خوادم MCP المحلية أو البعيدة لتوسيع قدراته.

ملاحظة: يدعم Copilot Cloud Agent أدوات MCP فقط (وليس الموارد أو التوجيهات). خوادم MCP البعيدة التي تتطلب OAuth غير متوافقة.

خوادم MCP الافتراضية

  • خادم GitHub MCP: مشكلات الوصول والعلاقات العامة وبيانات GitHub باستخدام رمز مميز للقراءة فقط محدد النطاق للمستودع الحالي افتراضيا (يمكنك تخصيص الرمز المميز).
  • خادم الكاتب المسرحي MCP: اقرأ صفحات الويب التي يمكن الوصول إليها داخل بيئة الوكيل والتفاعل معها والتقط لقطات شاشة لها (localhost/127.0.0.1).

تكوين المستودع

يمكن للمسؤولين الإعلان عن خوادم MCP عبر تكوين JSON في المستودع. بمجرد التكوين، يستخدم العامل بشكل مستقل الأدوات المتاحة - لا توجد مطالبات بالموافقة لكل استخدام. انظر توسيع وكيل السحابة Copilot في GitHub مع MCP.

أفضل الممارسات

  • راجع خوادم MCP التابعة لجهات خارجية لمعرفة الآثار المترتبة على الأداء وجودة الإخراج.
  • تفضل أدوات القراءة ؛ إذا كانت أدوات الكتابة موجودة ، اسمح فقط بما هو ضروري.
  • تحقق من صحة تكوين MCP بعناية قبل الحفظ.

اختبار والتحقق من صحة إخراج العامل

تظل مسؤولا عن الجودة والأمان:

  • قم بتشغيل CI (الاختبارات ، الليترات ، المسح) على كل وكيل PR ؛ لن يتم تشغيل عمليات التحقق هذه حتى تنقر على الموافقة على مهام سير العمل وتشغيلها.
  • افحص المناطق عالية التأثير أو الحساسة يدويا.
  • اطلب من الوكيل إنشاء اختبارات (على سبيل المثال ، "إضافة اختبارات وحدة Jest لجميع الوظائف بنمط src/utils/ الريبو التالي") - يستهلك إنشاء اختبار متعدد الملفات PRUs.
  • فرض مجموعات القواعد بحيث يجب أن يجتاز PRs الوكيل الاختبارات + المسح + الوبر قبل الدمج.
  • PRs عامل التسمية (على سبيل المثال، agent-refactor, agent-tests) للمراقبة والفرز والرجوع إذا لزم الأمر.
  • كرر التعليمات في .github/copilot-instructions.md عندما ترى أخطاء متكررة.
  • ارجع بسرعة إذا لزم الأمر واطلب تغييرات جديدة من الوكيل.

استخدام وحدات PRUs عمدا للتحقق من الصحة

استفد من وحدات PRUs لمهام التحقق من الصحة الأعمق مثل توسيع تغطية الاختبار أو عمليات التدقيق عبر الدلائل أو عمليات فحص المنطقة المحفوفة بالمخاطر. تستهلك الشيكات خفيفة الوزن عددا أقل من PRUs ، لذا قم بتطبيقها عن قصد لتعظيم القيمة.

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