Ehita, testi ja juuruta tehisintellekti agente Microsoft Foundry Agent Service-i kohta kui hostitud agente – täielikult VS Code’ist kasutades Microsoft Foundry laiendust ja Foundry tööriistakomplekti.
Hostitud agendid on hetkel eelvaates. Toetatud regioonid on piiratud – vaata regioonide saadavust.
Iga töötoa sees asuv
agent/kaust on automatiseeritult genereeritud Foundry laienduse poolt – selle järel kohandad koodi, testid kohapeal ja juurutad.
Araabia | Bengali | Bulgaaria | Burmai (Myanmar) | Hiina (lihtsustatud) | Hiina (traditsiooniline, Hongkong) | Hiina (traditsiooniline, Macau) | Hiina (traditsiooniline, Taiwan) | Horvaadi | Tšehhi | Taani | Hollandi | Eesti | Soome | Prantsuse | Saksa | Kreeka | Heebrea | Hindi | Ungari | Indoneesia | Itaalia | Jaapani | Kannada | Khmeri | Korea | Leedu | Malai | Malajalami | Marathi | Nepali | Nigeeria pidžin | Norra | Pärsia (Farsi) | Poola | Portugali (Brasiilia) | Portugali (Portugal) | Punjabi (Gurmukhi) | Rumeenia | Vene | Serbia (kirillitsas) | Slaavi | Sloveeni | Hispaania | Suahiili | Rootsi | Tagalogi (Filipiinid) | Tamiili | Telugu | Tai | Türgi | Ukraina | Urdu | Vietnami
Eelistad kloonimist lokaalselt?
See hoidla sisaldab 50+ keele tõlget, mis suurendab allalaadimise mahtu märgatavalt. Kui soovid kloonida ilma tõlgeteta, kasuta sparsi checkout’i:
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"See annab sulle kõik vajaliku kursuse läbimiseks palju kiiremalt alla laadituna.
flowchart TB
subgraph Local["Kohalik arendus (VS Code)"]
direction TB
FE["Microsoft Foundry
Laiendus"]
FoundryToolkit["Foundry tööriistakomplekti
Laiendus"]
Scaffold["Agentide kood šablooniga
(main.py · agent.yaml · Dockerfile)"]
Inspector["Agendi inspektor
(Kohalik testimine)"]
FE -- "Loo uus
Hostitud agent" --> Scaffold
Scaffold -- "F5 silumine" --> Inspector
FoundryToolkit -.- Inspector
end
subgraph Cloud["Microsoft Foundry"]
direction TB
ACR["Azure konteineritöötlus
registratuur"]
AgentService["Foundry agendifunktsioon
(Hostitud agendi töökeskkond)"]
Model["Azure OpenAI
(gpt-4.1 / gpt-4.1-mini)"]
Playground["Foundry mänguväljak
& VS Code mänguväljak"]
ACR --> AgentService
AgentService -- "/responses API" --> Model
AgentService --> Playground
end
Scaffold -- "Paiguta
(Docker ehitus + push)" --> ACR
Inspector -- "POST /responses
(localhost:8088)" --> Scaffold
Playground -- "Testi päringud" --> AgentService
style Local fill:#f0f4ff,stroke:#4a6cf7,stroke-width:2px
style Cloud fill:#fff4e6,stroke:#f59e0b,stroke-width:2px
Voog: Foundry laiendus genereerib agendi → sa kohandad koodi ja juhiseid → testid lokaalselt Agent Inspectoriga → juurutad Foundrys (Dockeri pilt tõstetakse ACR-i) → kontrollid Playground’is.
| Labor | Kirjeldus | Olemasolek |
|---|---|---|
| Labor 01 - Üksikagent | Ehita "Selgita nagu oleksin juhtkonna liige" agent, testi seda kohapeal ja juuruta Foundrys | ✅ Saadaval |
| Labor 02 - Mitmeagendi töövoog | Ehita "CV → töö sobivuse hindaja" - 4 agenti teevad koostööd CV sobivuse hindamiseks ja õpperaja genereerimiseks | ✅ Saadaval |
Selles töökojas ehitad "Selgita nagu oleksin juhtkonna liige" agendi – tehisintellekti agendi, mis võtab keerulise tehnilise žargooni ja tõlgib selle rahulikuks, juhtruumile sobivaks kokkuvõtteks. Sest olgem ausad, ükski C-tasandi juht ei taha kuulda "keerme-ressursside ammendumist, mida põhjustasid sünkroonsed kõned versioonis v3.2."
Selle agendi ehitasin pärast liiga palju juhtumeid, kus minu perfektne post-mortem sai vastuseks: "Nii et... kas veebileht on maas või mitte?"
Sa annad tehnilise uuenduse sisendiks. See annab tagasi juhtkonnale mõeldud kokkuvõtte – kolm põhijuppi, ilma žargoonita, ilma virnade jälgedeta, ilma eksistentsiaalse hirmuta. Lihtsalt mis juhtus, äri mõju ja järgmine samm.
Sa ütled:
"API latentsus suurenes tõttu teemade grupi ammendumisest, mida põhjustasid versioonis v3.2 lisatud sünkroonsed kõned."
Agent vastab:
Juhtkonna kokkuvõte:
- Mis juhtus: Pärast viimast versiooni aeglustus süsteem.
- Ärimõju: Mõned kasutajad kogesid teenuse kasutamisel viivitusi.
- Järgmine samm: Muudatus tühistati ja parandust valmistatakse ette enne uuesti juurutamist.
See on äärmiselt lihtne, üheotstarbeline agent – ideaalne majutatud agendi töövoo õppimiseks algusest lõpuni ilma keeruliste tööriistade ummikutesse sattumata. Ja ausalt öeldes? Iga insenerimeeskond võiks sellist vaja minna.
📂 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
Märkus: Iga töötoa sees olev
agent/kaust on see, mida Microsoft Foundry laiendus genereerib kui valid käsurealtMicrosoft Foundry: Create a New Hosted Agent. Failid kohandatakse seejärel sinu agendi juhiste, tööriistade ja seadistustega. Labor 01 juhendab sind, kuidas see nullist uuesti luua.
git clone https://github.com/microsoft-foundry/Foundry_Toolkit_for_VSCode_Lab.git
cd Foundry_Toolkit_for_VSCode_Labpython -m venv venvAktiveeri see:
-
Windows (PowerShell):
.\venv\Scripts\Activate.ps1
-
macOS / Linux:
source venv/bin/activate
pip install -r workshop/lab01-single-agent/agent/requirements.txtKopeeri näidiskuv fail .env agent-kaustast ja täida oma väärtused:
cp workshop/lab01-single-agent/agent/.env.example workshop/lab01-single-agent/agent/.envMuuda faili 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>Iga labor on iseseisev oma moodulitega. Alusta Labor 01-st, et õppida põhialuseid, seejärel liiguta Labor 02-sse mitmeagendi töövoogude jaoks.
Labor 01 - Üksikagent (täielikud juhised)
| # | Moodul | Link |
|---|---|---|
| 1 | Loe eeltingimused | 00-prerequisites.md |
| 2 | Paigalda Foundry Toolkit & Foundry laiendus | 01-install-foundry-toolkit.md |
| 3 | Loo Foundry projekt | 02-create-foundry-project.md |
| 4 | Loo majutatud agent | 03-create-hosted-agent.md |
| 5 | Sea juhised & keskkond | 04-configure-and-code.md |
| 6 | Testi kohapeal | 05-test-locally.md |
| 7 | Juuruta Foundrys | 06-deploy-to-foundry.md |
| 8 | Kontrolli Playground’is | 07-verify-in-playground.md |
| 9 | Probleemide lahendamine | 08-troubleshooting.md |
Labor 02 - Mitmeagendi töövoog (täielikud juhised)
| # | Moodul | Link |
|---|---|---|
| 1 | Eeltingimused (Labor 02) | 00-prerequisites.md |
| 2 | Mõista mitmeagendi arhitektuuri | 01-understand-multi-agent.md |
| 3 | Genereeri mitmeagendi projekt | 02-scaffold-multi-agent.md |
| 4 | Sea agendid & keskkond | 03-configure-agents.md |
| 5 | Orkestreerimise mustrid | 04-orchestration-patterns.md |
| 6 | Testi kohapeal (mitmeagent) | 05-test-locally.md |
| 7 | Deployimine Foundrysse | 06-deploy-to-foundry.md |
| 8 | Kontroll playground'is | 07-verify-in-playground.md |
| 9 | Tõrkeotsing (mitmeagendiline) | 08-troubleshooting.md |
 Shivam Goyal |
| Stsenaarium | Vajalikud rollid |
|---|---|
| Uue Foundry projekti loomine | Azure AI omaniku roll Foundry ressursil |
| Paigaldamine olemasolevasse projekti (uued ressursid) | Azure AI omaniku + Kaastöötaja roll tellimuses |
| Paigaldamine täielikult seadistatud projekti | Lugeja roll kontol + Azure AI kasutaja roll projektis |
Oluline: Azure
OwnerjaContributorrollid sisaldavad ainult haldus õigusi, mitte arenduse (andmete toimingute) õigusi. Agentide ehitamiseks ja juurutamiseks on vajalikud Azure AI kasutaja või Azure AI omaniku õigused.
- Kiire algus: juuruta oma esimene majutatud agent (VS Code)
- Mis on majutatud agendid?
- Loo majutatud agendi töövood VS Code'is
- Juuruta majutatud agent
- RBAC Microsoft Foundrys
- Arhitektuuriülevaate agendi näidis - Reaalmaailma majutatud agent MCP tööriistade, Excalidraw diagrammide ja kahekordse juurutusega
Lahtiütlus:
See dokument on tõlgitud AI tõlketeenuse Co-op Translator abil. Kuigi püüame saavutada täpsust, palun arvestage, et automaatsed tõlked võivad sisaldada vigu või ebatäpsusi. Originaaldokument selle emakeeles tuleks pidada autoriteetseks allikaks. Olulise teabe puhul soovitatakse kasutada professionaalset inimtõlget. Me ei vastuta selle tõlke kasutamisest tingitud arusaamatuste või valesti mõistmiste eest.