Építsen, teszteljen és telepítsen MI ügynököket a Microsoft Foundry Agent Service-hez Hosted Agents formájában – teljes egészében a VS Code-ból a Microsoft Foundry kiterjesztés és a Foundry Toolkit használatával.
A Hosted Agents jelenleg előzetes verzióban érhetők el. A támogatott régiók korlátozottak - lásd a régió elérhetőségét.
Minden laborban az
agent/mappa a Foundry kiterjesztés által automatikusan generált, ezt követően testreszabhatja a kódot, helyileg tesztelhet, majd telepíthet.
Arab | Bangla | Bolgár | Burmai (Myanmar) | Kínai (egyszerűsített) | Kínai (hagyományos, Hong Kong) | Kínai (hagyományos, Makaó) | Kínai (hagyományos, Tajvan) | Horvát | Cseh | Dán | Holland | Észt | Finn | Francia | Német | Görög | Héber | Hindi | Magyar | Indonéz | Olasz | Japán | Kannada | Khmer | Koreai | Litván | Maláj | Malayalam | Marathi | Nepáli | Nigériai pidgin | Norvég | Perzsa (Fárszi) | Lengyel | Portugál (Brazília) | Portugál (Portugália) | Pandzsábi (Gurmukhi) | Román | Orosz | Szerb (cirill) | Szlovák | Szlovén | Spanyol | Szuahéli | Svéd | Tagalog (Filippínó) | Tamil | Telugu | Thai | Török | Ukrán | Urdu | Vietnami
Inkább helyben klónozná?
Ez a tároló több mint 50 nyelvi fordítást tartalmaz, amelyek jelentősen megnövelik a letöltési méretet. Ha fordítások nélkül szeretné klónozni, használja a sparse checkout-ot:
Bash / macOS / Linux:
git clone --filter=blob:none --sparse https://github.com/microsoft-foundry/Foundry_Toolkit_for_VSCode_Lab.git cd Foundry_Toolkit_for_VSCode_Lab git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'CMD (Windows):
git clone --filter=blob:none --sparse https://github.com/microsoft-foundry/Foundry_Toolkit_for_VSCode_Lab.git cd Foundry_Toolkit_for_VSCode_Lab git sparse-checkout set --no-cone "/*" "!translations" "!translated_images"Ez mindent megad, amire szüksége van a kurzus elvégzéséhez, sokkal gyorsabb letöltéssel.
flowchart TB
subgraph Local["Helyi fejlesztés (VS Code)"]
direction TB
FE["Microsoft Foundry
Kiterjesztés"]
FoundryToolkit["Foundry Eszközkészlet
Kiterjesztés"]
Scaffold["Előkészített Ügynök Kód
(main.py · agent.yaml · Dockerfile)"]
Inspector["Ügynök Ellenőrző
(Helyi tesztelés)"]
FE -- "Új
Felügyelt Ügynök létrehozása" --> Scaffold
Scaffold -- "F5 Hibakeresés" --> Inspector
FoundryToolkit -.- Inspector
end
subgraph Cloud["Microsoft Foundry"]
direction TB
ACR["Azure Konténer
Regisztráció"]
AgentService["Foundry Ügynök Szolgáltatás
(Felügyelt Ügynök Futásideje)"]
Model["Azure OpenAI
(gpt-4.1 / gpt-4.1-mini)"]
Playground["Foundry Játszótér
& VS Code Játszótér"]
ACR --> AgentService
AgentService -- "/responses API" --> Model
AgentService --> Playground
end
Scaffold -- "Telepítés
(Docker build + push)" --> ACR
Inspector -- "POST /responses
(localhost:8088)" --> Scaffold
Playground -- "Tesztelési parancsok" --> AgentService
style Local fill:#f0f4ff,stroke:#4a6cf7,stroke-width:2px
style Cloud fill:#fff4e6,stroke:#f59e0b,stroke-width:2px
Folyamat: A Foundry kiterjesztés létrehozza az ügynököt → Ön testreszabja a kódot és utasításokat → helyileg teszt a Agent Inspectorral → telepít a Foundry-be (Docker image pusholva az ACR-be) → ellenőrzi a Playground-ban.
| Labor | Leírás | Állapot |
|---|---|---|
| Labor 01 - Egyszemélyes Ügynök | Építse meg az „Magyarázd el, mintha vállalati vezető lennék” ügynököt, tesztelje helyileg, majd telepítse a Foundry-be | ✅ Elérhető |
| Labor 02 - Többügynökös munkafolyamat | Építse meg a „Önéletrajz → Munkaalkalmasság értékelő” ügynököt - 4 ügynök együttműködve pontozza az önéletrajz illeszkedését és készít tanulási tervet | ✅ Elérhető |
Ebben a műhelyben megépíti az „Magyarázd el, mintha vállalati vezető lennék” ügynököt – egy MI ügynököt, amely a nehezen érthető technikai zsargont átalakítja nyugodt, igazgatósági szintű összefoglalóvá. Mert legyünk őszinték, senki sem akar a felsővezetésben hallani olyanokról, hogy „szálkészlet kimerülés szinkron hívások miatt, amelyek a v3.2-ben jelentek meg.”
Ezt az ügynököt egy túl sok eset után építettem, amikor a tökéletesen megírt hibaanalízis reakciója az volt: „Szóval... le van-e az oldal vagy sem?”
Ad egy technikai frissítést. Visszaad egy vezetői összefoglalót – három pontban, zsargon nélkül, stack trace-ek nélkül, létezési szorongás nélkül. Csak az, mi történt, üzleti hatás, és a következő lépés.
Ön mondja:
„Az API késleltetés nőtt a szálkészlet kimerülése miatt, amelyet a v3.2-ben bevezetett szinkron hívások okoztak.”
Az ügynök válasza:
Vezetői összefoglaló:
- Mi történt: A legutóbbi kiadás után a rendszer lassult.
- Üzleti hatás: Néhány felhasználó késedelmet tapasztalt a szolgáltatás használata közben.
- Következő lépés: A változtatást visszavonták, és javítást készítenek elő az ismételt telepítés előtt.
Ez egy egyszerű, egypurpose (egyetlen célú) ügynök – tökéletes a hosted agent munkafolyamat végpontok közötti végigjárásához anélkül, hogy komplex eszköztárakba keveredne. És őszintén? Minden mérnöki csapatnak kellene egy ilyen.
📂 Foundry_Toolkit_for_VSCode_Lab/
├── 📄 README.md ← You are here
├── 📂 ExecutiveAgent/ ← Standalone hosted agent project
│ ├── agent.yaml
│ ├── Dockerfile
│ ├── main.py
│ └── requirements.txt
└── 📂 workshop/
├── 📂 lab01-single-agent/ ← Full lab: docs + agent code
│ ├── README.md ← Hands-on lab instructions
│ ├── 📂 docs/ ← Step-by-step tutorial modules
│ │ ├── 00-prerequisites.md
│ │ ├── 01-install-foundry-toolkit.md
│ │ ├── 02-create-foundry-project.md
│ │ ├── 03-create-hosted-agent.md
│ │ ├── 04-configure-and-code.md
│ │ ├── 05-test-locally.md
│ │ ├── 06-deploy-to-foundry.md
│ │ ├── 07-verify-in-playground.md
│ │ └── 08-troubleshooting.md
│ └── 📂 agent/ ← Reference solution (auto-scaffolded by Foundry extension)
│ ├── agent.yaml
│ ├── Dockerfile
│ ├── main.py
│ └── requirements.txt
└── 📂 lab02-multi-agent/ ← Resume → Job Fit Evaluator
├── README.md ← Hands-on lab instructions (end-to-end)
├── 📂 docs/ ← Step-by-step tutorial modules
│ ├── 00-prerequisites.md
│ ├── 01-understand-multi-agent.md
│ ├── 02-scaffold-multi-agent.md
│ ├── 03-configure-agents.md
│ ├── 04-orchestration-patterns.md
│ ├── 05-test-locally.md
│ ├── 06-deploy-to-foundry.md
│ ├── 07-verify-in-playground.md
│ └── 08-troubleshooting.md
└── 📂 PersonalCareerCopilot/ ← Reference solution (multi-agent workflow)
├── agent.yaml
├── Dockerfile
├── main.py
└── requirements.txt
Megjegyzés: Az
agent/mappa minden laborban azt tartalmazza, amit a Microsoft Foundry kiterjesztés generál, amikor a Parancs palettán futtatja aMicrosoft Foundry: Create a New Hosted Agentparancsot. A fájlokat ezután testreszabja az ügynök utasításaival, eszközeivel és konfigurációjával. Az 01-es labor végigvezeti Önöket ezen az újrateremtésen nulláról.
git clone https://github.com/microsoft-foundry/Foundry_Toolkit_for_VSCode_Lab.git
cd Foundry_Toolkit_for_VSCode_Labpython -m venv venvAktiválja:
- Windows (PowerShell):
.\venv\Scripts\Activate.ps1
- macOS / Linux:
source venv/bin/activate
pip install -r workshop/lab01-single-agent/agent/requirements.txtMásolja az agent mappában található .env minta fájlt és töltse ki saját értékekkel:
cp workshop/lab01-single-agent/agent/.env.example workshop/lab01-single-agent/agent/.envSzerkessze a workshop/lab01-single-agent/agent/.env fájlt:
AZURE_AI_PROJECT_ENDPOINT=https://<your-account>.services.ai.azure.com/api/projects/<your-project>
MODEL_DEPLOYMENT_NAME=<your-model-deployment-name>Minden labor önálló, saját modulokkal. Kezdje a Labor 01-gyel az alapok elsajátításához, majd térjen át a Labor 02-re a többügynökös munkafolyamatokhoz.
Labor 01 - Egyszemélyes ügynök (teljes utasítások)
| # | Modul | Link |
|---|---|---|
| 1 | Előfeltételek elolvasása | 00-prerequisites.md |
| 2 | Foundry Toolkit és Foundry kiterjesztés telepítése | 01-install-foundry-toolkit.md |
| 3 | Foundry projekt létrehozása | 02-create-foundry-project.md |
| 4 | Hosted agent létrehozása | 03-create-hosted-agent.md |
| 5 | Utasítások és környezet beállítása | 04-configure-and-code.md |
| 6 | Helyi tesztelés | 05-test-locally.md |
| 7 | Telepítés Foundry-be | 06-deploy-to-foundry.md |
| 8 | Ellenőrzés a Playgroundban | 07-verify-in-playground.md |
| 9 | Hibakeresés | 08-troubleshooting.md |
Labor 02 - Többügynökös munkafolyamat (teljes utasítások)
| # | Modul | Link |
|---|---|---|
| 1 | Előfeltételek (Labor 02) | 00-prerequisites.md |
| 2 | Többügynökös architektúra megértése | 01-understand-multi-agent.md |
| 3 | Többügynökös projekt scaffoldolása | 02-scaffold-multi-agent.md |
| 4 | Ügynökök és környezet konfigurálása | 03-configure-agents.md |
| 5 | Ütemezési minták | 04-orchestration-patterns.md |
| 6 | Helyi tesztelés (többügynökös) | 05-test-locally.md |
| 7 | Telepítés Foundry-ra | 06-deploy-to-foundry.md |
| 8 | Ellenőrzés a playgroundban | 07-verify-in-playground.md |
| 9 | Hibakeresés (több ügynök) | 08-troubleshooting.md |
 Shivam Goyal |
| Forgatókönyv | Szükséges szerepkörök |
|---|---|
| Új Foundry projekt létrehozása | Azure AI Owner a Foundry erőforráson |
| Telepítés meglévő projekthez (új erőforrások) | Azure AI Owner + Contributor az előfizetésen |
| Teljesen konfigurált projekthez való telepítés | Reader a fiókon + Azure AI User a projekten |
Fontos: Az Azure
OwnerésContributorszerepkörök csak kezelői engedélyeket tartalmaznak, nem fejlesztői (adatműveleti) jogosultságokat. Az ügynökök építéséhez és telepítéséhez Azure AI User vagy Azure AI Owner szükséges.
- Gyors kezdés: Első hosztolt ügynök telepítése (VS Code)
- Mik azok a hosztolt ügynökök?
- Hosztolt ügynök munkafolyamatok létrehozása VS Code-ban
- Hosztolt ügynök telepítése
- RBAC a Microsoft Foundry-hoz
- Architecture Review Agent minta - Valós hosztolt ügynök MCP eszközökkel, Excalidraw diagramokkal és dupla telepítéssel
Felelősségkizárás:
Ez a dokumentum az AI fordító szolgáltatás, a Co-op Translator segítségével készült. Bár törekszünk a pontosságra, kérjük, vegye figyelembe, hogy az automatikus fordítások hibákat vagy pontatlanságokat tartalmazhatnak. Az eredeti dokumentum az anyanyelvén tekintendő kötelező érvényű forrásnak. Kritikus információk esetén profi emberi fordítást javasolt igénybe venni. Nem vállalunk felelősséget az ebből a fordításból származó félreértésekért vagy félreértelmezésekért.