Personalizarea, extinderea și validarea Copilot Cloud Agent

  • 5 minute

GitHub Copilot Cloud Agent rulează într-un mediu GitHub Actions securizat și efemer. Cu câțiva pași de configurare, puteți preconfigura acest mediu pentru a îmbunătăți fiabilitatea și viteza, pentru a extinde capacitățile agentului cu instrumente externe prin Model Context Protocol (MCP) și pentru a aplica cele mai bune practici pentru a testa și valida ieșirea agentului înainte de îmbinare.

Până la sfârșitul acestei unități, veți putea:

  • Preinstalați instrumente, dependențe și secrete pentru a personaliza mediul de dezvoltare al agentului.
  • Extindeți capacitățile agentului utilizând Model Context Protocol (MCP).
  • Testați și validați rezultatul agentului în mod eficient înainte de a îmbina modificările.

Preînsămânțarea mediului de dezvoltare

Preinstalați instrumente și dependențe cucopilot-setup-steps.yml

Creați .github/workflows/copilot-setup-steps.yml pe ramura implicită a depozitului dvs. Fluxul de lucru trebuie să definească o singură lucrare numită copilot-setup-steps. Includeți pașii necesari pentru a instala dependențe sau a configura instrumente.

Exemplu pentru 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

Chei de configurare permise pentru copilot-setup-steps lucrare: steps, permissions, runs-on, container, services, snapshot, timeout-minutes (≤ 59). Orice actions/checkout adâncime de preluare este suprascrisă pentru a permite revenirea în siguranță. Fluxul de lucru de configurare rulează de sine stătător (astfel încât să îl puteți valida) și apoi automat înainte de pornirea agentului.

Alergători mai mari găzduiți de GitHub

  • Adăugați mai întâi alergători mai mari
  • În copilot-setup-steps.yml, setați runs-on la eticheta/grupul (de exemplu, ubuntu-4-core).
  • Sunt acceptate doar alergătorii Ubuntu x64; Alergătorii auto-găzduiți nu sunt acceptați.

Git LFS

Dacă utilizați Git Large File Storage, activați-l în pașii de configurare:

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

Personalizarea firewall-ului

Accesul implicit la internet este limitat pentru a reduce riscul de exfiltrare. Puteți personaliza sau dezactiva firewall-ul conform politicii organizaționale, dacă este necesar.

Extindeți cu protocolul de context model (MCP)

MCP este un standard deschis pentru conectarea LLM-urilor la instrumente și date. Agentul poate utiliza instrumentele furnizate de serverele MCP locale sau la distanță pentru a-și extinde capacitățile.

Notă: Copilot Cloud Agent suportă doar instrumente MCP (nu resurse sau prompturi). Serverele MCP la distanță care necesită OAuth nu sunt acceptate.

Servere MCP implicite

  • Serverul GitHub MCP: Accesați probleme, PR și date GitHub cu un token doar în citire limitat la depozitul curent în mod implicit (puteți personaliza tokenul).
  • Dramaturg MCP Server: Citiți, interacționați și faceți capturi de ecran ale paginilor web accesibile în mediul agentului (localhost/127.0.0.1).

Configurarea depozitului

Administratorii pot declara serverele MCP printr-o configurație JSON în depozit. Odată configurat, agentul utilizează în mod autonom instrumentele disponibile - fără solicitări de aprobare per utilizare. Vezi Extinderea GitHub Copilot Cloud Agent cu MCP.

Cele mai bune practici

  • Revizuiți serverele MCP terțe pentru implicații privind performanța și calitatea rezultatelor.
  • Preferați instrumentele de citire; Dacă există instrumente de scriere, permiteți doar ceea ce este necesar.
  • Validați cu atenție configurația MCP înainte de a salva.

Testarea și validarea rezultatelor agentului

Rămâneți responsabil pentru calitate și securitate:

  • Rulați CI (teste, linters, scanare) pe fiecare PR agent; aceste verificări nu se vor executa până când nu faceți clic pe Aprobare și rulați fluxuri de lucru.
  • Inspectați manual zonele sensibile sau cu impact ridicat.
  • Cereți agentului să genereze teste (de exemplu, "Adăugați teste unitare Jest pentru toate funcțiile în stilul src/utils/ repo următor") - generarea de teste cu mai multe fișiere consumă PRU-uri.
  • Impuneți seturile de reguli, astfel încât PR-urile agenților să treacă testele + scanarea + linting înainte de îmbinare.
  • Etichetați PR-urile agentului (de exemplu, agent-refactor, agent-tests) pentru a monitoriza, tria și reveni dacă este necesar.
  • Repetați instrucțiunile în .github/copilot-instructions.md atunci când vedeți greșeli repetate.
  • Reveniți rapid dacă este necesar și solicitați noi modificări de la agent.

Utilizarea intenționată a PRU-urilor pentru validare

Utilizați PRU-urile pentru sarcini de validare mai profunde, cum ar fi extinderea acoperirii testelor, audituri între directoare sau scanări de zone riscante. Verificările ușoare consumă mai puține PRU, așa că aplicați-le intenționat pentru a maximiza valoarea.

Cu configurarea, extensiile și practicile de validare, pasul final este să utilizați agentul în mod responsabil pentru a proteja bine sarcinile, a proteja mediile și a revizui continuu rezultatele.