Vytvárajte, testujte a nasadzujte AI agentov do Microsoft Foundry Agent Service ako Hosted Agents - úplne z VS Code pomocou Microsoft Foundry rozšírenia a Foundry Toolkit.
Hosted Agents sú momentálne v ukážkovej prevádzke (preview). Podporované regióny sú obmedzené - pozrite si dostupnosť regiónov.
Priečinok
agent/v každom laboratory je automaticky generovaný Foundry rozšírením - potom kód prispôsobíte, testujete lokálne a nasadíte.
Arabčina | Bengálčina | Bulharčina | Barmský (Mjanmarsko) | Čínština (zjednodušená) | Čínština (tradičná, Hongkong) | Čínština (tradičná, Macao) | Čínština (tradičná, Taiwan) | Chorvátčina | Čeština | Dánčina | Holandčina | Estónčina | Fínčina | Francúzština | Nemčina | Gréčtina | Hebrejčina | Hindčina | Maďarčina | Indonézština | Taliančina | Japončina | Kannadčina | Khmerčina | Kórejčina | Litovčina | Malajčina | Malayalam | Maráthčina | Nepálčina | Nigérijský pidžin | Nórčina | Perzština (Farsi) | Poľština | Portugalčina (Brazília) | Portugalčina (Portugalsko) | Pandžábčina (Gurmukhi) | Rumunčina | Ruština | Srbčina (cyrilika) | Slovenčina | Slovinčina | Španielčina | Swahelčina | Švédčina | Tagalog (Filipíny) | Tamil | Telugu | Thajčina | Turečtina | Ukrajinčina | Urdčina | Vietnamčina
Radšej klonovať lokálne?
Tento repozitár obsahuje viac než 50 jazykových prekladov, čo výrazne zväčšuje veľkosť stiahnutia. Ak chcete klonovať bez prekladov, použite sparse checkout:
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"Toto vám poskytne všetko potrebné na dokončenie kurzu s oveľa rýchlejším stiahnutím.
flowchart TB
subgraph Local["Lokálny vývoj (VS Code)"]
direction TB
FE["Rozšírenie Microsoft Foundry"]
FoundryToolkit["Rozšírenie Foundry Toolkit"]
Scaffold["Šablónový agentový kód
(main.py · agent.yaml · Dockerfile)"]
Inspector["Inspector agenta
(Lokálne testovanie)"]
FE -- "Vytvoriť nového
hostovaného agenta" --> Scaffold
Scaffold -- "Ladiť F5" --> Inspector
FoundryToolkit -.- Inspector
end
subgraph Cloud["Microsoft Foundry"]
direction TB
ACR["Azure Container
Registry"]
AgentService["Služba agenta Foundry
(Hostované prostredie agenta)"]
Model["Azure OpenAI
(gpt-4.1 / gpt-4.1-mini)"]
Playground["Foundry Playground
& VS Code Playground"]
ACR --> AgentService
AgentService -- "/responses API" --> Model
AgentService --> Playground
end
Scaffold -- "Nasadiť
(Docker build + push)" --> ACR
Inspector -- "POST /responses
(localhost:8088)" --> Scaffold
Playground -- "Testovať prompt-y" --> AgentService
style Local fill:#f0f4ff,stroke:#4a6cf7,stroke-width:2px
style Cloud fill:#fff4e6,stroke:#f59e0b,stroke-width:2px
Priebeh: Foundry rozšírenie generuje skelet agenta → prispôsobíte kód a inštrukcie → testujete lokálne s Agent Inspector → nasadíte do Foundry (Docker image uploadnutý do ACR) → overíte v Playground.
| Laboratórium | Popis | Stav |
|---|---|---|
| Lab 01 - Jediný agent | Vytvorte "Vysvetli to ako manažérovi" agenta, otestujte ho lokálne a nasadte do Foundry | ✅ K dispozícii |
| Lab 02 - Multi-agentný pracovný tok | Vytvorte "Životopis → hodnotiaci agent vhodnosti na pracovnú pozíciu" - 4 agenti spolupracujú na hodnotení životopisu a vytvorení plánu učenia | ✅ K dispozícii |
V tomto workshope vytvoríte "Vysvetli to ako manažérovi" agenta - AI agenta, ktorý vezme zložité technické termíny a prevedie ich do pokojného, reprezentatívneho zhrnutia vhodného na rokovania. Pretože úprimne, nikto v C-suite nechce počuť o "vyčerpaní thread poolu spôsobenom synchronnými volaniami predstavenými vo verzii 3.2."
Tohto agenta som vytvoril po príliš mnohých situáciách, keď moja dokonale spracovaná analýza incidentu dostala odpoveď: "Takže... je webová stránka nefunkčná alebo nie?"
Dáte mu technickú aktualizáciu. Agent vráti zhrnutie pre manažéra - tri základné body, žiadny žargón, žiadne stack trace alebo existenčné obavy. Len čo sa stalo, dopad na biznis a ďalší krok.
Vy hovoríte:
"Zvýšila sa latencia API kvôli vyčerpaniu thread poolu spôsobenému synchronnými volaniami predstavenými vo verzii 3.2."
Agent odpovedá:
Executive zhrnutie:
- Čo sa stalo: Po poslednom vydaní systém spomalil.
- Dopad na biznis: Niektorí používatelia zažili oneskorenia pri používaní služby.
- Ďalší krok: Zmena bola stiahnutá a pripravuje sa oprava pred opätovným nasadením.
Je to úplne jednoduchý, jednoúčelový agent - ideálny na naučenie sa pracovného toku hosted agentov od začiatku do konca bez komplikovaných nástrojov. A úprimne? Každý technický tím by takéhoto agenta potreboval.
📂 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
Poznámka: Priečinok
agent/v každom laboratornom cvičení je to, čo Microsoft Foundry rozšírenie vytvorí, keď spustíteMicrosoft Foundry: Create a New Hosted Agentz Command Palette. Súbory sa potom prispôsobujú inštrukciami, nástrojmi a konfiguráciou agenta. Lab 01 vás prevedie vytvorením tohto od základov.
git clone https://github.com/microsoft-foundry/Foundry_Toolkit_for_VSCode_Lab.git
cd Foundry_Toolkit_for_VSCode_Labpython -m venv venvAktivujte ho:
- Windows (PowerShell):
.\venv\Scripts\Activate.ps1
- macOS / Linux:
source venv/bin/activate
pip install -r workshop/lab01-single-agent/agent/requirements.txtSkopírujte príklad .env súboru v priečinku agenta a vyplňte svoje hodnoty:
cp workshop/lab01-single-agent/agent/.env.example workshop/lab01-single-agent/agent/.envUpravte workshop/lab01-single-agent/agent/.env:
AZURE_AI_PROJECT_ENDPOINT=https://<your-account>.services.ai.azure.com/api/projects/<your-project>
MODEL_DEPLOYMENT_NAME=<your-model-deployment-name>Každý laboratórium má vlastné moduly. Začnite s Lab 01 pre základy, potom prejdite na Lab 02 pre multi-agentné pracovné toky.
Lab 01 - Jediný agent (plné inštrukcie)
| # | Modul | Odkaz |
|---|---|---|
| 1 | Prečítajte si požiadavky | 00-prerequisites.md |
| 2 | Nainštalujte Foundry Toolkit a Foundry rozšírenie | 01-install-foundry-toolkit.md |
| 3 | Vytvorte Foundry projekt | 02-create-foundry-project.md |
| 4 | Vytvorte hosted agenta | 03-create-hosted-agent.md |
| 5 | Nakonfigurujte inštrukcie a prostredie | 04-configure-and-code.md |
| 6 | Testujte lokálne | 05-test-locally.md |
| 7 | Nasadte do Foundry | 06-deploy-to-foundry.md |
| 8 | Overte v playground | 07-verify-in-playground.md |
| 9 | Riešenie problémov | 08-troubleshooting.md |
Lab 02 - Multi-agentný pracovný tok (plné inštrukcie)
| # | Modul | Odkaz |
|---|---|---|
| 1 | Požiadavky (Lab 02) | 00-prerequisites.md |
| 2 | Pochopte architektúru multi-agenta | 01-understand-multi-agent.md |
| 3 | Vygenerujte multi-agentný projekt | 02-scaffold-multi-agent.md |
| 4 | Nakonfigurujte agentov a prostredie | 03-configure-agents.md |
| 5 | Vzorce orchestrácie | 04-orchestration-patterns.md |
| 6 | Testujte lokálne (multi-agent) | 05-test-locally.md |
| 7 | Nasadiť do Foundry | 06-deploy-to-foundry.md |
| 8 | Overiť v playground | 07-verify-in-playground.md |
| 9 | Riešenie problémov (multi-agent) | 08-troubleshooting.md |
 Shivam Goyal |
| Scenár | Požadované role |
|---|---|
| Vytvoriť nový Foundry projekt | Azure AI Owner na Foundry zdroji |
| Nasadiť do existujúceho projektu (nové zdroje) | Azure AI Owner + Contributor na predplatnom |
| Nasadiť do plne nakonfigurovaného projektu | Reader na účte + Azure AI User na projekte |
Dôležité: Role Azure
OwneraContributorzahŕňajú iba manažérske oprávnenia, nie oprávnenia na vývoj (akcie nad dátami). Na vytváranie a nasadzovanie agentov potrebujete Azure AI User alebo Azure AI Owner.
- Rýchly štart: Nasadenie prvého hosteného agenta (VS Code)
- Čo sú hostení agenti?
- Vytvárajte pracovné postupy hostených agentov vo VS Code
- Nasadiť hosteného agenta
- RBAC pre Microsoft Foundry
- Príklad Architecture Review Agenta - Skutočný hostený agent s MCP nástrojmi, diagramami Excalidraw a duálnym nasadením
Zrieknutie sa zodpovednosti:
Tento dokument bol preložený pomocou AI prekladateľskej služby Co-op Translator. Aj keď sa snažíme o presnosť, vezmite prosím na vedomie, že automatizované preklady môžu obsahovať chyby alebo nepresnosti. Originálny dokument v jeho pôvodnom jazyku by mal byť považovaný za autoritatívny zdroj. Pre dôležité informácie sa odporúča profesionálny ľudský preklad. Nie sme zodpovední za akékoľvek nedorozumenia alebo nesprávne výklady vyplývajúce z použitia tohto prekladu.