Kurti, testuoti ir diegti DI agentus į Microsoft Foundry Agent Service kaip Hosted Agents – visiškai iš VS Code naudojant Microsoft Foundry plėtinį ir Foundry Toolkit.
Hosted Agents šiuo metu yra peržiūros būsenoje. Palaikomos regionų ribotos galimybės – žiūrėkite regionų prieinamumą.
Kiekvienose dirbtuvėse aplankas
agent/yra automatiškai sukuriamas Foundry plėtinio – tuomet pritaikote kodą, testuojate vietoje ir diegiate.
Arabic | Bengali | Bulgarian | Burmese (Myanmar) | Chinese (Simplified) | Chinese (Traditional, Hong Kong) | Chinese (Traditional, Macau) | Chinese (Traditional, Taiwan) | Croatian | Czech | Danish | Dutch | Estonian | Finnish | French | German | Greek | Hebrew | Hindi | Hungarian | Indonesian | Italian | Japanese | Kannada | Khmer | Korean | Lithuanian | Malay | Malayalam | Marathi | Nepali | Nigerian Pidgin | Norwegian | Persian (Farsi) | Polish | Portuguese (Brazil) | Portuguese (Portugal) | Punjabi (Gurmukhi) | Romanian | Russian | Serbian (Cyrillic) | Slovak | Slovenian | Spanish | Swahili | Swedish | Tagalog (Filipino) | Tamil | Telugu | Thai | Turkish | Ukrainian | Urdu | Vietnamese
Norite klonuoti vietoje?
Ši saugykla turi daugiau nei 50 kalbų vertimų, todėl žymiai padidina atsisiuntimo dydį. Norėdami klonuoti be vertimų, naudokite ribotą atsisiuntimą:
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"Tai suteikia viską, ko reikia kursui baigti, su daug greitesniu atsisiuntimu.
flowchart TB
subgraph Local["Vietinis vystymas (VS Code)"]
direction TB
FE["Microsoft Foundry
Plėtinys"]
FoundryToolkit["Foundry komplektas
Plėtinys"]
Scaffold["Surenkamas agente kodo
(main.py · agent.yaml · Dockerfile)"]
Inspector["Agento inspektorius
(vietinis testavimas)"]
FE -- "Sukurti naują
talpinamą agentą" --> Scaffold
Scaffold -- "F5 derinimas" --> Inspector
FoundryToolkit -.- Inspector
end
subgraph Cloud["Microsoft Foundry"]
direction TB
ACR["Azure konteinerių
saugykla"]
AgentService["Foundry agentų paslauga
(talpinamas agentų vykdymas)"]
Model["Azure OpenAI
(gpt-4.1 / gpt-4.1-mini)"]
Playground["Foundry žaidimų aikštelė
& VS Code žaidimų aikštelė"]
ACR --> AgentService
AgentService -- "/responses API" --> Model
AgentService --> Playground
end
Scaffold -- "Diegti
(Docker build + push)" --> ACR
Inspector -- "POST /responses
(localhost:8088)" --> Scaffold
Playground -- "Testuoti užklausas" --> AgentService
style Local fill:#f0f4ff,stroke:#4a6cf7,stroke-width:2px
style Cloud fill:#fff4e6,stroke:#f59e0b,stroke-width:2px
Srautas: Foundry plėtinys sukuria agentą → jūs pritaikote kodą ir instrukcijas → testuojate vietoje su Agent Inspector → diegiate į Foundry (Docker atvaizdas įkeltas į ACR) → tikrinate Playground aplinkoje.
| Dirbtuvės | Aprašymas | Būklė |
|---|---|---|
| Dirbtuvės 01 - Vienas Agentas | Sukurkite „Paaiškinkit kaip vadovui“ agentą, išbandykite vietoje ir įdiekite į Foundry | ✅ Galima |
| Dirbtuvės 02 - Daugiagentinis darbas | Sukurkite „CV → Darbo tinkamumo vertintojas“ – 4 agentai bendradarbiauja vertindami CV atitikimą ir generuodami mokymosi planą | ✅ Galima |
Šiose dirbtuvėse kursite „Paaiškinkit kaip vadovui“ agentą – DI agentą, kuris sudėtingą techninę kalbą išvers į ramias, valdybos posėdžiui paruoštas santraukas. Nes tiesa, nė vienas vadovas nenori girdėti apie „siūlų rezervo išsekimą, sukeltą sinchroninių kvietimų, įvestų v3.2 versijoje“.
Šį agentą sukūriau po pernelyg daug situacijų, kai mano tobulai parašytas poanalizės pranešimas sulaukdavo atsakymo: „Tai... svetainė neveikia ar neveikia?“
Jūs duodate techninį atnaujinimą. Jis pateikia vadovo santrauką – tris punktus, be jargonų, be steko ribų, be egzistencinio streso. Tiesiog kas įvyko, verslo poveikis ir kitas žingsnis.
Jūs sakote:
„API delsos padidėjo dėl siūlų rezervo išsekimo, sukelto sinchroninių kvietimų, įvestų v3.2 versijoje.“
Agentas atsako:
Vadovo santrauka:
- Kas įvyko: Po paskutinio leidimo sistema sulėtėjo.
- Verslo poveikis: Kai kurie vartotojai patyrė delsą naudodamiesi paslauga.
- Kitas žingsnis: Pakeitimas atšauktas, ruošiama pataisa prieš pakartotinį diegimą.
Tai labai paprastas, vieno tikslo agentas – puikus mokantis naudoti hostingų agentų darbo eigą nuo pradžios iki pabaigos, nesivelkant į sudėtingas įrankių grandines. Ir nuoširdžiai? Kiekviena inžinerinė komanda galėtų tokį turėti.
📂 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
Pastaba: Aplankas
agent/kiekvienose dirbtuvėse yra tai, ką Microsoft Foundry plėtinys sugeneruoja, kai paleidžiate komandąMicrosoft Foundry: Create a New Hosted AgentCommand Palette lange. Failai po to pritaikomi pagal jūsų agento instrukcijas, įrankius ir konfigūraciją. Dirbtuvės 01 padeda žingsnis po žingsnio tai atkurti nuo nulio.
git clone https://github.com/microsoft-foundry/Foundry_Toolkit_for_VSCode_Lab.git
cd Foundry_Toolkit_for_VSCode_Labpython -m venv venvAktyvuokite ją:
- Windows (PowerShell):
.\venv\Scripts\Activate.ps1
- macOS / Linux:
source venv/bin/activate
pip install -r workshop/lab01-single-agent/agent/requirements.txtKopijuokite pavyzdinį .env failą iš agento aplanko ir užpildykite savo reikšmes:
cp workshop/lab01-single-agent/agent/.env.example workshop/lab01-single-agent/agent/.envRedaguokite 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>Kiekvienos pamokos moduliai yra savarankiški. Pradėkite nuo Dirbtuvių 01, kad išmoktumėte pagrindus, tada tęskite su Dirbtuvėmis 02 apie daugiagentinį darbą.
Dirbtuvės 01 - Vienas Agentas (pilnos instrukcijos)
| # | Modulis | Nuoroda |
|---|---|---|
| 1 | Perskaitykite išankstinius reikalavimus | 00-prerequisites.md |
| 2 | Įdiekite Foundry Toolkit ir Foundry plėtinį | 01-install-foundry-toolkit.md |
| 3 | Sukurkite Foundry projektą | 02-create-foundry-project.md |
| 4 | Sukurkite hostingų agentą | 03-create-hosted-agent.md |
| 5 | Sukonfigūruokite instrukcijas ir aplinką | 04-configure-and-code.md |
| 6 | Testuokite vietoje | 05-test-locally.md |
| 7 | Diegkite į Foundry | 06-deploy-to-foundry.md |
| 8 | Tikrinkite žaidimų aikštelėje (playground) | 07-verify-in-playground.md |
| 9 | Gedimų šalinimas | 08-troubleshooting.md |
Dirbtuvės 02 - Daugiagentinis darbas (pilnos instrukcijos)
| # | Modulis | Nuoroda |
|---|---|---|
| 1 | Išankstiniai reikalavimai (Dirbtuvės 02) | 00-prerequisites.md |
| 2 | Supraskite daugiagentinę architektūrą | 01-understand-multi-agent.md |
| 3 | Sukurkite daugiagentinį projektą | 02-scaffold-multi-agent.md |
| 4 | Konfigūruokite agentus ir aplinką | 03-configure-agents.md |
| 5 | Orkestracijos modeliai | 04-orchestration-patterns.md |
| 6 | Testuokite vietoje (daugiagentinis) | 05-test-locally.md |
| 7 | Diegti į Foundry | 06-deploy-to-foundry.md |
| 8 | Patikrinti žaidimų aikštelėje | 07-verify-in-playground.md |
| 9 | Problemų sprendimas (daugiaprogramis) | 08-troubleshooting.md |
 Shivam Goyal |
| Scena | Reikalingos rolės |
|---|---|
| Sukurti naują Foundry projektą | Azure AI savininkas Foundry ištekliaus lygmenyje |
| Diegti į esamą projektą (nauji ištekliai) | Azure AI savininkas + Bendradarbis prenumeratos lygmenyje |
| Diegti visiškai sukonfigūruotą projektą | Skaitytojas paskyroje + Azure AI vartotojas projekte |
Svarbu: Azure
SavininkoirBendradarbiorolės apima tik valdymo teises, o ne kūrimo (duomenų veiksmų) teises. Jums reikia Azure AI vartotojo arba Azure AI savininko, kad kurtumėte ir diegtumėte agentus.
- Greita pradžia: įdiekite savo pirmąjį hostintą agentą (VS Code)
- Kas yra hostinti agentai?
- Sukurkite hostinto agente darbo eigas VS Code
- Įdiekite hostintą agentą
- RBAC Microsoft Foundry
- Architektūros peržiūros agento pavyzdys - Realaus pasaulio hostintas agentas su MCP įrankiais, Excalidraw schemomis ir dvigubu diegimu
Atsakomybės apribojimas: Šis dokumentas buvo išverstas naudojant dirbtinio intelekto vertimo paslaugą Co-op Translator. Nors siekiame tikslumo, atkreipkite dėmesį, kad automatiniame vertime gali būti klaidų ar netikslumų. Originalus dokumentas gimtąja kalba turėtų būti laikomas autoritetingu šaltiniu. Kritinei informacijai rekomenduojamas profesionalus žmogaus vertimas. Mes neatsakome už bet kokius nesusipratimus ar neteisingus aiškinimus, kilusius naudojant šį vertimą.