Zgradite, preizkusite in namestite AI agente v Microsoft Foundry Agent Service kot Hosted Agents – vse neposredno iz VS Code z uporabo razširitve Microsoft Foundry in Foundry Toolkit.
Hosted Agents so trenutno v predogledu. Podprte regije so omejene – glej dostopnost regij.
Mapa
agent/znotraj vsake delavnice je samodejno ustvarjena z razširitvijo Foundry – nato prilagodite kodo, preizkusite lokalno in namestite.
Arabščina | Bengalščina | Bolgarščina | Burmanščina (Mjanmar) | Kitajščina (poenostavljena) | Kitajščina (tradicionalna, Hong Kong) | Kitajščina (tradicionalna, Macau) | Kitajščina (tradicionalna, Taiwan) | Hrvaščina | Češčina | Danska | Nizozemščina | Estonščina | Finščina | Francoščina | Nemščina | Grščina | Hebrejščina | Hindijščina | Madžarščina | Indonezijščina | Italijanščina | Japonščina | Kannada | Khmerščina | Korejščina | Litovščina | Malajščina | Malajalščina | Maratščina | Nepalščina | Nigerijski pidžin | Norveščina | Perzijščina (Farzi) | Poljščina | Portugalščina (Brazilija) | Portugalščina (Portugalska) | Pandžabščina (Gurmukhi) | Romunščina | Ruščina | Srbščina (cirilica) | Slovaščina | Slovenščina | Španščina | Svahili | Švedščina | Tagalog (Filipini) | Tamilščina | Telugu | Tajščina | Turščina | Ukrajinščina | Urdu | Vietnamščina
Raje klonirate lokalno?
Ta repozitorij vključuje prevode v več kot 50 jezikov, kar znatno povečuje velikost prenosa. Če želite klonirati brez prevodov, uporabite 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"Tako dobite vse, kar potrebujete za dokončanje tečaja z veliko hitrejšim prenosom.
flowchart TB
subgraph Local["Lokalni razvoj (VS Code)"]
direction TB
FE["Microsoft Foundry
Razširitev"]
FoundryToolkit["Orodni komplet Foundry
Razširitev"]
Scaffold["Scaffoldirana koda agenta
(main.py · agent.yaml · Dockerfile)"]
Inspector["Inšpektor agenta
(Lokalno testiranje)"]
FE -- "Ustvari novega
gostujočega agenta" --> Scaffold
Scaffold -- "F5 Razhroščevanje" --> Inspector
FoundryToolkit -.- Inspector
end
subgraph Cloud["Microsoft Foundry"]
direction TB
ACR["Azure Container
Register"]
AgentService["Storitev Foundry agenta
(Čas izvajanja gostujočega agenta)"]
Model["Azure OpenAI
(gpt-4.1 / gpt-4.1-mini)"]
Playground["Foundry igrišče
& VS Code igrišče"]
ACR --> AgentService
AgentService -- "/odgovori API" --> Model
AgentService --> Playground
end
Scaffold -- "Namesti
(Docker build + push)" --> ACR
Inspector -- "POST /odgovori
(localhost:8088)" --> Scaffold
Playground -- "Testiraj pozive" --> AgentService
style Local fill:#f0f4ff,stroke:#4a6cf7,stroke-width:2px
style Cloud fill:#fff4e6,stroke:#f59e0b,stroke-width:2px
Potek: Razširitev Foundry pripravi ogrodje agenta → prilagodite kodo in navodila → preizkusite lokalno z Agent Inspector → namestite v Foundry (Docker slika potisnjena v ACR) → preverite v Playground.
| Delavnica | Opis | Status |
|---|---|---|
| Delavnica 01 - En sam agent | Zgradite "Razloži, kot da sem izvršni direktor" agent, ga preizkusite lokalno in namestite v Foundry | ✅ Na voljo |
| Delavnica 02 - Delovni tok več agentov | Zgradite "Ocenjevalec ustreznosti življenjepisa za delovno mesto" - sodeluje 4 agente, ki ocenijo ustreznost življenjepisa in generirajo učni načrt | ✅ Na voljo |
V tej delavnici boste zgradili "Razloži, kot da sem izvršni direktor" agent – AI agenta, ki vzame zahtevno tehnično žargonijo in jo prevede v mirne, za upravni odbor primerne povzetke. Ker bodimo iskreni, nihče v vrhu ne želi slišati o "izčrpanju skupine niti zaradi sinhronih klicev uvedenih v v3.2."
Ta agent sem ustvaril po še eni preveč primerih, ko je moj popolnoma sestavljen post-mortem sprožil odziv: "Torej... ali spletna stran deluje ali ne?"
Vnesete tehnično posodobitev. Agent vrne izvršni povzetek – tri jedrnate točke, brez žargona, brez sledov skladov, brez eksistencialnega strahu. Samo kaj se je zgodilo, poslovni vpliv in naslednji koraki.
Vi rečete:
"Zakasnitev API-ja se je povečala zaradi izčrpanosti skupine niti povzročene s sinhronimi klici, uvedenimi v v3.2."
Agent odgovori:
Izvršni povzetek:
- Kaj se je zgodilo: Po zadnji izdaji se je sistem upočasnil.
- Poslovni vpliv: Nekateri uporabniki so med uporabo storitve imeli zamude.
- Naslednji korak: Sprememba je bila razveljavljena in pripravljamo popravek pred ponovnim zagonom.
Je enostaven agent z eno samo nalogo – popoln za učenje delovnega toka hosted agentov od začetka do konca brez zapletov z zapletenimi orodji. In iskreno? Vsaka inženirska ekipa bi lahko imela takega.
📂 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
Opomba: Mapa
agent/znotraj vsake delavnice je ustvarjena s strani Microsoft Foundry razširitve, ko zaženeteMicrosoft Foundry: Create a New Hosted Agentiz ukazne palete. Datoteke nato prilagodite z navodili vašega agenta, orodji in konfiguracijo. Delavnica 01 vas vodi skozi postopek izdelave iz nič.
git clone https://github.com/microsoft-foundry/Foundry_Toolkit_for_VSCode_Lab.git
cd Foundry_Toolkit_for_VSCode_Labpython -m venv venvAktivirajte ga:
- Windows (PowerShell):
.\venv\Scripts\Activate.ps1
- macOS / Linux:
source venv/bin/activate
pip install -r workshop/lab01-single-agent/agent/requirements.txtKopirajte primer .env datoteke v mapi agenta in izpolnite svoje vrednosti:
cp workshop/lab01-single-agent/agent/.env.example workshop/lab01-single-agent/agent/.envUredite 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>Vsaka delavnica je samostojna z lastnimi moduli. Začnite z Delavnico 01 za osnovno znanje, nato nadaljujte z Delavnico 02 za delovne tokove z več agenti.
Delavnica 01 - En sam agent (popolna navodila)
| # | Modul | Povezava |
|---|---|---|
| 1 | Preberite predpogojne zahteve | 00-prerequisites.md |
| 2 | Namestite Foundry Toolkit in razširitev Foundry | 01-install-foundry-toolkit.md |
| 3 | Ustvarite Foundry projekt | 02-create-foundry-project.md |
| 4 | Ustvarite hosted agenta | 03-create-hosted-agent.md |
| 5 | Konfigurirajte navodila in okolje | 04-configure-and-code.md |
| 6 | Preizkusite lokalno | 05-test-locally.md |
| 7 | Namestite v Foundry | 06-deploy-to-foundry.md |
| 8 | Preverite v playgroundu | 07-verify-in-playground.md |
| 9 | Odpravljanje težav | 08-troubleshooting.md |
Delavnica 02 - Delovni tok več agentov (popolna navodila)
| # | Modul | Povezava |
|---|---|---|
| 1 | Predpogojne zahteve (Delavnica 02) | 00-prerequisites.md |
| 2 | Spoznajte arhitekturo z več agenti | 01-understand-multi-agent.md |
| 3 | Ustvarite osnovo za projekt z več agenti | 02-scaffold-multi-agent.md |
| 4 | Konfigurirajte agente in okolje | 03-configure-agents.md |
| 5 | Vzorec orkestracije | 04-orchestration-patterns.md |
| 6 | Preizkusite lokalno (več agentov) | 05-test-locally.md |
| 7 | Namestitev v Foundry | 06-deploy-to-foundry.md |
| 8 | Preverjanje v playgroundu | 07-verify-in-playground.md |
| 9 | Odpravljanje težav (večagentno) | 08-troubleshooting.md |
 Shivam Goyal |
| Scenarij | Potrebne vloge |
|---|---|
| Ustvari nov Foundry projekt | Azure AI Owner na Foundry viru |
| Namestitev v obstoječi projekt (novi viri) | Azure AI Owner + Contributor na naročnini |
| Namestitev v popolnoma konfiguriran projekt | Reader na računu + Azure AI User na projektu |
Pomembno: Vloge Azure
OwnerinContributorvključujejo samo upravljavske pravice, ne pa razvojnih (dejanja s podatki). Potrebujete Azure AI User ali Azure AI Owner za izdelavo in nameščanje agentov.
- Hitri začetek: Namestite svoj prvi gostujoči agent (VS Code)
- Kaj so gostujoči agenti?
- Ustvarite delovne tokove gostujočih agentov v VS Code
- Namestitev gostujočega agenta
- RBAC za Microsoft Foundry
- Vzorec agenta za pregled arhitekture - Resnični gostujoči agent z orodji MCP, diagrami Excalidraw in dvojno namestitvijo
Omejitev odgovornosti: Ta dokument je bil preveden z uporabo AI prevajalske storitve Co-op Translator. Čeprav si prizadevamo za natančnost, upoštevajte, da lahko avtomatizirani prevodi vsebujejo napake ali netočnosti. Izvirni dokument v njegovem izvorno jeziku velja za avtoritativni vir. Za kritične informacije je priporočljiv strokovni človeški prevod. Nismo odgovorni za morebitna nesporazume ali napačne interpretacije, ki izhajajo iz uporabe tega prevoda.