Copilot क्लाउड एजेंट को अनुकूलित, विस्तारित और मान्य करना
GitHub Copilot Cloud Agent एक सुरक्षित, अल्पकालिक GitHub एक्शन वातावरण के अंदर चलता है। कुछ कॉन्फ़िगरेशन चरणों के साथ आप विश्वसनीयता और गति में सुधार करने के लिए इस वातावरण को पहले से सीड कर सकते हैं, मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) के माध्यम से बाहरी उपकरणों के साथ एजेंट की क्षमताओं का विस्तार कर सकते हैं, और विलय से पहले एजेंट के आउटपुट का परीक्षण और सत्यापन करने के लिए सर्वोत्तम प्रथाओं को लागू कर सकते हैं।
इस इकाई के अंत तक, आप निम्न में सक्षम होंगे:
- एजेंट के विकास वातावरण को अनुकूलित करने के लिए उपकरण, निर्भरताएँ और रहस्य प्रीइंस्टॉल करें।
- मॉडल संदर्भ प्रोटोकॉल (MCP) का उपयोग करके एजेंट की क्षमताओं का विस्तार करें।
- परिवर्तनों को मर्ज करने से पहले एजेंट आउटपुट का प्रभावी ढंग से परीक्षण और सत्यापन करें।
विकास के माहौल को पूर्व-बीज बनाना
के साथ उपकरण और निर्भरताएं प्रीइंस्टॉल करेंcopilot-setup-steps.yml
अपने रिपॉजिटरी की डिफ़ॉल्ट शाखा पर बनाएं .github/workflows/copilot-setup-steps.yml । वर्कफ़्लो को किसी एकल कार्य को नामित copilot-setup-stepsकरना चाहिए. निर्भरताएँ स्थापित करने या उपकरण सेट करने के लिए आवश्यक कोई भी चरण शामिल करें।
टाइपस्क्रिप्ट के लिए उदाहरण:
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)। - केवल उबंटू x64 धावक समर्थित हैं; स्व-होस्ट किए गए धावक समर्थित नहीं हैं।
गिट एलएफएस
यदि आप Git बड़ी फ़ाइल संग्रहण का उपयोग करते हैं, तो इसे सेटअप चरणों में सक्षम करें:
jobs:
copilot-setup-steps:
runs-on: ubuntu-latest
permissions:
contents: read
steps:
- uses: actions/checkout@v5
with:
lfs: true
फ़ायरवॉल अनुकूलन
एक्सफिल्ट्रेशन जोखिम को कम करने के लिए डिफ़ॉल्ट इंटरनेट एक्सेस सीमित है। यदि आवश्यक हो तो आप फ़ायरवॉल को प्रति संगठनात्मक नीति को अनुकूलित या अक्षम कर सकते हैं।
मॉडल संदर्भ प्रोटोकॉल (MCP) के साथ विस्तार करें
एमसीपी एलएलएम को टूल और डेटा से जोड़ने के लिए एक खुला मानक है। एजेंट अपनी क्षमताओं का विस्तार करने के लिए स्थानीय या दूरस्थ MCP सर्वर द्वारा प्रदान किए गए टूल का उपयोग कर सकता है।
नोट: Copilot Cloud Agent केवल MCP टूल का समर्थन करता है (संसाधन या संकेत नहीं)। OAuth की आवश्यकता वाले दूरस्थ MCP सर्वर समर्थित नहीं हैं.
डिफ़ॉल्ट MCP सर्वर
- GitHub MCP सर्वर: डिफ़ॉल्ट रूप से वर्तमान रेपो के दायरे में केवल पढ़ने के लिए टोकन के साथ समस्याओं, पीआर और GitHub डेटा तक पहुंचें (आप टोकन को अनुकूलित कर सकते हैं)।
- नाटककार एमसीपी सर्वर: एजेंट के वातावरण (लोकलहोस्ट/127.0.0.1) के अंदर पहुंच योग्य वेब पेजों को पढ़ें, उनके साथ बातचीत करें और स्क्रीनशॉट लें।
रिपॉजिटरी कॉन्फ़िगरेशन
व्यवस्थापक रेपो में JSON कॉन्फ़िगरेशन के माध्यम से MCP सर्वर घोषित कर सकते हैं। एक बार कॉन्फ़िगर होने के बाद, एजेंट स्वायत्त रूप से उपलब्ध टूल का उपयोग करता है - कोई प्रति-उपयोग अनुमोदन संकेत नहीं। MCP के साथ GitHub Copilot क्लाउड एजेंट का विस्तार करना देखें।
सबसे सही तरीके
- प्रदर्शन और आउटपुट गुणवत्ता निहितार्थ के लिए तृतीय-पक्ष MCP सर्वर की समीक्षा करें।
- पढ़ने के उपकरण पसंद करें; यदि लेखन उपकरण मौजूद हैं, तो केवल वही अनुमति दें जो आवश्यक है।
- सहेजने से पहले MCP कॉन्फ़िगरेशन को सावधानीपूर्वक सत्यापित करें।
एजेंट आउटपुट का परीक्षण और सत्यापन
आप गुणवत्ता और सुरक्षा के लिए जवाबदेह बने रहते हैं:
- प्रत्येक एजेंट पीआर पर सीआई (परीक्षण, लिंटर्स, स्कैनिंग) चलाएं; ये जाँचें तब तक नहीं चलेंगी जब तक आप स्वीकार करें पर क्लिक नहीं करते और वर्कफ़्लो चलाएँ.
- मैन्युअल रूप से उच्च प्रभाव या संवेदनशील क्षेत्रों का निरीक्षण करें।
- एजेंट से परीक्षण उत्पन्न करने के लिए कहें (उदाहरण के लिए, "रेपो शैली का अनुसरण करने वाले
src/utils/सभी कार्यों के लिए जेस्ट यूनिट परीक्षण जोड़ें") - मल्टी-फाइल परीक्षण पीढ़ी पीआरयू का उपभोग करती है। - नियम लागू करें ताकि एजेंट पीआर को मर्ज से पहले परीक्षण + स्कैनिंग + लाइनिंग पास करना पड़े।
- लेबल एजेंट पीआर (उदाहरण के लिए,
agent-refactor, agent-tests) की निगरानी करने के लिए, ट्राइएज करने और यदि आवश्यक हो तो वापस लौटने के लिए। - जब आप बार-बार गलतियाँ देखते हैं तो .github/copilot-instructions.md में निर्देशों को पुनरावृत्त करें।
- यदि आवश्यक हो तो जल्दी से वापस लौटें और एजेंट से नए परिवर्तनों का अनुरोध करें।
सत्यापन के लिए जानबूझकर पीआरयू का उपयोग करना
गहन सत्यापन कार्यों के लिए पीआरयू का लाभ उठाएं जैसे कि परीक्षण कवरेज विस्तार, निर्देशिकाओं में ऑडिट, या जोखिम भरे क्षेत्र स्कैन। हल्के चेक कम पीआरयू की खपत करते हैं, इसलिए मूल्य को अधिकतम करने के लिए उन्हें जानबूझकर लागू करें।
कॉन्फ़िगरेशन, एक्सटेंशन और सत्यापन प्रथाओं के साथ, अंतिम चरण एजेंट का जिम्मेदारी से उपयोग करना है कार्यों को अच्छी तरह से स्कोप करना, वातावरण की सुरक्षा करना और परिणामों की लगातार समीक्षा करना।