GitHub Copilot felhőügynök csatlakoztatása Azure MCP-kiszolgálóhoz azd-bővítmények használatával

Használja az Azure Developer CLI (azd) bővítményt (azure.coding-agent), hogy felügyelt identitással biztonságos, hatókörre korlátozott Azure-hozzáférést biztosítson a GitHub Copilot felhőügynök számára. A bővítmény létrehozza a felügyelt identitást, konfigurálja az összevont hitelesítő adatokat, és beállítja a GitHub Actions munkafolyamatot az adattárban.

A Bővítmények áttekintése című cikkből megtudhatja, hogyan bővítik a bővítmények a képességeket azd.

Előfeltételek

Az Azure Developer CLI (azd) telepítése. Lásd a telepítési utasításokat.
Azure-előfizetés, amely lehetővé teszi erőforráscsoportok és felügyelt identitások létrehozását.
Az Copilot felhőügynökhöz engedélyezett GitHub adattár helyi klónja.
Adattárengedélyek a következőhöz:
- Frissítse a copilot GitHub-környezetet.
- Konfigurálja Copilot felhőügynök beállításait.
- A .github/workflows mappába történő módosítások feltöltése.
Az adattárhoz legalább egy konfigurált Git-remote szükséges (közös hitelesítő adatokhoz).

A Copilot felhőügynök bővítmény telepítése vagy frissítése

Telepítés első alkalommal

azd extension install azure.coding-agent

Frissítés a legújabb verzióra

azd extension upgrade azure.coding-agent

Ellenőrizze, hogy telepítve van-e:
```
azd extension list --installed
```
Látnia kell a listában a(z) azure.coding-agent elemet.

A Copilot felhőügynök bővítmény használata

A Copilot felhőügynök bővítmény automatizálja Azure hozzáférés konfigurálását a Copilot felhőügynök felügyelt identitásán keresztül. A beállítás elvégzéséhez néhány manuális lépést is végre kell hajtania.

Az Azure-hozzáférés engedélyezése

A helyi adattár könyvtárának gyökerében futtassa a következő parancsot:
```
azd coding-agent config
```
A bővítmény munkafolyamatának befejezéséhez kövesse a képernyőn megjelenő utasításokat.

A konfiguráció során a bővítmény:
- Létrehoz (vagy újra felhasznál) egy erőforráscsoportot.
- Azure-beli felügyelt identitást hoz létre.
- Hozzárendeli az Olvasó szerepkört ahhoz az identitáshoz, amely kiterjed az erőforrás-csoportra.
- Összevont hitelesítő adatokat hoz létre, amely összekapcsolja a GitHub-adattárat a felügyelt identitással.
- Munkafolyamatot és kapcsolódó objektumokat ad hozzá (vagy frissít copilot-setup-steps.yml ).
- Útmutatást nyújt a GitHub környezeti beállításainak véglegesítéséhez.copilot

Beállítás ellenőrzése (nem kötelező)

Listázhatja a felügyelt identitást a létrehozott (vagy frissített) erőforráscsoportban:
```
az identity list --resource-group <resource-group-name>
```
A GitHubon nyissa meg a Settings>Environments>copilot környezetet, és erősítse meg a felügyelt identitásra hivatkozó összevont hitelesítőadat-bejegyzést (a tulajdonos kiállítójának tükröznie kell a GitHubot).

Azure MCP-kiszolgáló konfigurálása a Copilot felhőügynökhöz

A azd coding-agent bővítmény létrehoz egy pull request-et egy ághoz az új GitHub munkafolyamat fájllal origin/azd-enable-copilot-coding-agent-with-azure. Ha az Azure MCP Server-kapcsolatot szeretné használni az main ágban, egyesítse ezt a lekérdezést.

A lekéréses kérelem leírása és a bővítmény kimeneti naplói egyaránt tartalmaznak egy JSON-konfigurációs kódrészletet, a Azure MCP-kiszolgáló Copilot felhőügynökhöz való konfigurálásához:
```
{
    "mcpServers": {
        "Azure": {
            "type": "local",
            "command": "npx",
            "args": [
                "-y",
                "@azure/mcp@latest",
                "server",
                "start"
            ],
            "tools": [
                "*"
            ]
        }
    }
}
```
Az Azure MCP-kiszolgáló konfigurálásához nyissa meg az adattár Beállítások lapját.
Válassza a Copilot>Felhőügynök lehetőséget a bal oldali navigációs panelen.
Illessze be a JSON-kódrészletet a PR-ből az MCP konfiguráció mezőjébe, és válassza a MCP konfiguráció mentése opciót.

A Copilot felhőügynök bővítmény tesztelése

Nyissa meg az adattárat a GitHubon.
Válassza az Ügynökök megnyitása ikont a jobb felső navigációs sávon.
A felugró panelen válassza ki azt az adattárat és ágat, amelyet a azd parancshoz használt. Ha egyesítette a létrehozott lekéréses kérelmet main, válassza a lehetőséget main.
Adjon meg egy kérést, amely kifejezetten arra utasítja a Copilot felhőügynököt, hogy használja a konfigurált Azure MCP-kiszolgálót, például:
```
Use the Azure MCP Server to list the resource groups in my subscription.
Do not traverse or analyze the repository at all. Use only the Azure MCP Server.
```
Az Enter billentyűt lenyomva futtassa a parancssort, és utasítsa Copilot felhőügynököt, hogy hozzon létre és futtasson egy új feladatot.

Megjegyzés:

A Copilot felhőügynök-feladatait a main-tól eltérő ágon is futtathatja, ha azt az ágat választja ki a kiugró panelen.
Válassza ki a panel alján megjelenő feladatot a tevékenység részleteinek lapjára való navigáláshoz.
Nézze át a kimenetet, hogy látható-e a Copilot felhőügynök:
- Indítsa el az Azure MCP-kiszolgálót:
- Különböző eszközök hívása az Azure-erőforrásokra vonatkozó információk gyűjtéséhez:
- Az erőforráscsoport megjelenítése a végső kimenetben:

Engedélyek konfigurálása a felügyelt identitáshoz

A azd coding-agent bővítmény létrehoz egy Azure-beli felügyelt identitást, amelyet az Azure MCP-kiszolgáló használ az erőforrások eléréséhez. Ez a beállítás lehetővé teszi, hogy különböző szerepköröket rendeljen a felügyelt identitáshoz a Azure MCP-kiszolgáló képességeinek és engedélyeinek szabályozásához.

Alapértelmezés szerint a bővítmény csak a Reader szerepkört rendeli hozzá az erőforráscsoport hatóköréhez. Rendeljen hozzá további szerepköröket, vagy bővítse a hatókört, ha az ügynöknek további képességekre van szüksége. Lásd a beépített szerepköröket.

A szerepkör hozzárendelése például az Contributor erőforráscsoport hatókörében:

az role assignment create --assignee <principal-id-or-client-id> --role Contributor --scope /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>

Hibaelhárítás

Az alábbi szakaszok a tapasztalt gyakori problémákat emelik ki.

Nincsenek konfigurálva git-távvezérlők

Adjon hozzá egy távoli kapcsolatot, hogy federációs hitelesítő adatok generálhatók legyenek.

git remote add origin <https://github.com/<your-org>/<your-repo>.git>
git fetch origin

Rendszergazdai jogosultságokkal kell rendelkeznie az adattárhoz

A Copilot felhőügynökhöz tartozó GitHub-adattár konfigurálása rendszergazdai jogosultságokat igényel. E jogosultságok nélkül nem frissítheti a Copilot környezetet a felügyelt identitás hitelesítő adatainak használatára, és nem frissítheti az adattár MCP-konfigurációját.

Ha ezt a hibát látja, emelnie kell a jogosultságait.

(!) An error occurred, see the readme for troubleshooting and prerequisites:
    https://github.com/Azure/azure-dev/blob/main/cli/azd/extensions/azure.coding-agent/README.md
Error: failed to create GitHub environment copilot in repository owner/repository: exit code: 1, stdout: {"message":"Must have admin rights to Repository.","documentation_url":"https://docs.github.com/rest/deployments/environments#create-or-update-an-environment","status":"403"}, stderr: gh: Must have admin rights to Repository. (HTTP 403)

Lejárt a frissítési jogkivonat

Jelentkezzen be újra:

azd auth login

Adjon hozzá jelölőket, például --tenant-id <tenant-id> vagy --use-device-code szükség szerint.

Diagnosztikai kimenet javítása

Hibakeresési mód használata:

azd coding-agent config --debug

Az összes belső parancs és azok kimenete a konzolra van nyomtatva.

Következő lépések

Bővítse az identitásengedélyeket (csak szükség esetén) szerepek hozzárendelésével
További automatizálás integrálása a munkafolyamat kibővítésével .github/workflows/
További bővítményfunkciók megismerése: Bővítmények áttekintése
Az Azure RBAC alapelveinek áttekintése

Közreműködés

Az Azure Developer CLI-erőforrásokhoz való hozzájáruláshoz tekintse meg a közreműködői útmutatót. A lekéréses kérelmekhez közreműködői licencszerződés aláírására lehet szükség.

Magatartási kódex

Ez a projekt a Microsoft nyílt forráskódú magatartási kódexét követi.

Visszajelzés

Hasznosnak találta ezt az oldalt?

Utolsó frissítés időpontja: 2026-07-18