Rakenna, testaa ja ota käyttöön tekoälyagentteja Microsoft Foundry Agent Servicen kautta Hosted Agents -muodossa — kokonaan VS Codesta käyttäen Microsoft Foundry -laajennusta ja Foundry Toolkitia.
Hosted Agents ovat tällä hetkellä esikatseluvaiheessa. Tuetut alueet ovat rajoitettuja — katso alueiden saatavuus.
Jokaisen labran
agent/-kansio luodaan automaattisesti Foundry-laajennuksen toimesta — sen jälkeen koodia räätälöidään, testataan paikallisesti ja otetaan käyttöön.
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
Haluatko mieluummin kloonata paikallisesti?
Tässä repositoriossa on yli 50 kielen käännökset, mikä lisää merkittävästi latauskokoa. Kloonaaaksesi ilman käännöksiä, käytä sparse checkoutia:
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"Saat kaiken mitä tarvitset kurssin suorittamiseen paljon nopeammalla latauksella.
flowchart TB
subgraph Local["Paikallinen kehitys (VS Code)"]
direction TB
FE["Microsoft Foundry
Laajennus"]
FoundryToolkit["Foundry-työkalupakki
Laajennus"]
Scaffold["Skeletinoitu agenttikoodi
(main.py · agent.yaml · Dockerfile)"]
Inspector["Agenttien tarkastaja
(Paikallinen testaus)"]
FE -- "Luo uusi
Isännöity agentti" --> Scaffold
Scaffold -- "F5 Virheenkorjaus" --> Inspector
FoundryToolkit -.- Inspector
end
subgraph Cloud["Microsoft Foundry"]
direction TB
ACR["Azure Container
Rekisteri"]
AgentService["Foundry-agenttipalvelu
(Isännöity agentin ajonaika)"]
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 -- "Ota käyttöön
(Docker build + push)" --> ACR
Inspector -- "POST /responses
(localhost:8088)" --> Scaffold
Playground -- "Testaa kehotteita" --> AgentService
style Local fill:#f0f4ff,stroke:#4a6cf7,stroke-width:2px
style Cloud fill:#fff4e6,stroke:#f59e0b,stroke-width:2px
Virta: Foundry-laajennus luo agentin → räätälöit koodin & ohjeet → testaat paikallisesti Agent Inspectorilla → otat käyttöön Foundryssa (Docker-kuva työnnetään ACR:ään) → validoit Playgroundissa.
| Labra | Kuvaus | Tila |
|---|---|---|
| Lab 01 - Yksittäinen agentti | Rakenna "Selitä kuin olisin johtaja" -agentti, testaa paikallisesti ja ota käyttöön Foundryssa | ✅ Saatavilla |
| Lab 02 - Moni-agenttinen työnkulku | Rakenna "Ansioluettelo → Työhön sopivuuden arvioija" - 4 agenttia tekee yhteistyötä pisteyttääkseen ansioluettelon ja luodakseen oppimissuunnitelman | ✅ Saatavilla |
Tässä työpajassa rakennat "Selitä kuin olisin johtaja" -agentin — tekoälyagentin, joka ottaa vaikeat tekniset termit ja kääntää ne rauhallisiksi, johtajille sopiviksi tiivistyksiksi. Koska ollaan rehellisiä, kukaan johtoryhmässä ei halua kuulla "säikeiden uupumisesta, jonka aiheutti v3.2:ssa käyttöön otetut synkroniset kutsut."
Rakensin tämän agentin liian monen kerran jälkeen, kun täydellisesti laadittu analyysi sai vastaukseksi: "Eli... Onko verkkosivusto alas vai ei?"
Syötät sille teknisen päivityksen. Se palauttaa johtajayhteenvetona kolme kohokohtaa, ilman ammattisanastoa, ilman pinon jälkiä, ilman eksistentiaalista ahdistusta. Vain mitä tapahtui, liiketoiminnan vaikutus ja seuraava askel.
Sinä sanot:
"API-viive kasvoi säikeiden uupumisen vuoksi, jonka aiheuttivat v3.2:ssa käyttöön otetut synkroniset kutsut."
Agentti vastaa:
Johtajayhteenveto:
- Mitä tapahtui: Viimeisimmän julkaisun jälkeen järjestelmä hidastui.
- Liiketoiminnan vaikutus: Jotkut käyttäjät kokivat viiveitä palvelun käytössä.
- Seuraava askel: Muutos on peruutettu ja korjausta valmistellaan ennen uudelleenkäyttöönottoa.
Se on kuoleman yksinkertainen, yhden käyttötarkoituksen agentti — täydellinen oppimaan hosted-agentti työnkulku päästä päähän ilman monimutkaisia työkaluketjuja. Ja rehellisesti? Jokainen insinööriryhmä voisi käyttää tällaista.
📂 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
Huom: Jokaisen labran sisällä oleva
agent/-kansio on se, jonka Microsoft Foundry -laajennus luo, kun suoritat komentopalettistaMicrosoft Foundry: Create a New Hosted Agent-komennon. Tiedostot räätälöidään sitten agentin ohjeilla, työkaluilla ja asetuksilla. Lab 01 ohjaa sinut tämän luomiseen alusta asti.
git clone https://github.com/microsoft-foundry/Foundry_Toolkit_for_VSCode_Lab.git
cd Foundry_Toolkit_for_VSCode_Labpython -m venv venvAktivoi se:
-
Windows (PowerShell):
.\venv\Scripts\Activate.ps1
-
macOS / Linux:
source venv/bin/activate
pip install -r workshop/lab01-single-agent/agent/requirements.txtKopioi esimerkkitiedosto .env agentin kansiosta ja täytä arvosi:
cp workshop/lab01-single-agent/agent/.env.example workshop/lab01-single-agent/agent/.envMuokkaa tiedostoa 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>Jokainen labra on itsenäinen omine moduuleineen. Aloita Lab 01 opitaksesi perusteet ja siirry sitten Lab 02:een moniacjenttisiin työnkulkuihin.
Lab 01 - Yksittäinen agentti (täydelliset ohjeet)
| # | Moduuli | Linkki |
|---|---|---|
| 1 | Lue esivaatimukset | 00-prerequisites.md |
| 2 | Asenna Foundry Toolkit & Foundry -laajennus | 01-install-foundry-toolkit.md |
| 3 | Luo Foundry-projekti | 02-create-foundry-project.md |
| 4 | Luo hosted agentti | 03-create-hosted-agent.md |
| 5 | Määritä ohjeet & ympäristö | 04-configure-and-code.md |
| 6 | Testaa paikallisesti | 05-test-locally.md |
| 7 | Ota käyttöön Foundryssa | 06-deploy-to-foundry.md |
| 8 | Tarkista Playgroundissa | 07-verify-in-playground.md |
| 9 | Vianmääritys | 08-troubleshooting.md |
Lab 02 - Moni-agenttinen työnkulku (täydelliset ohjeet)
| # | Moduuli | Linkki |
|---|---|---|
| 1 | Esivaatimukset (Lab 02) | 00-prerequisites.md |
| 2 | Ymmärrä moni-agentti arkkitehtuuri | 01-understand-multi-agent.md |
| 3 | Luo moni-agenttiprojekti | 02-scaffold-multi-agent.md |
| 4 | Määritä agentit & ympäristö | 03-configure-agents.md |
| 5 | Orkestrointimallit | 04-orchestration-patterns.md |
| 6 | Testaa paikallisesti (moni-agentti) | 05-test-locally.md |
| 7 | Julkaise Foundryyn | 06-deploy-to-foundry.md |
| 8 | Vahvista leikkikentällä | 07-verify-in-playground.md |
| 9 | Vianmääritys (moni-agentti) | 08-troubleshooting.md |
 Shivam Goyal |
| Tilanne | Vaaditut roolit |
|---|---|
| Luo uusi Foundry-projekti | Azure AI Owner Foundry-resurssissa |
| Julkaise olemassa olevaan projektiin (uudet resurssit) | Azure AI Owner + Contributor tilauksessa |
| Julkaise täysin konfiguroituun projektiin | Reader tilillä + Azure AI User projektissa |
Tärkeää: Azure
OwnerjaContributor-roolit sisältävät vain hallinnolliset oikeudet, eivät kehitysoikeuksia (data-toiminnot). Tarvitset Azure AI User tai Azure AI Owner rakentaaksesi ja julkaistaksesi agenteja.
- Pikaopas: Julkaise ensimmäinen isännöity agenttisi (VS Code)
- Mitä ovat isännöidyt agentit?
- Luo isännöityjen agenttien työnkulkuja VS Codessa
- Julkaise isännöity agentti
- RBAC Microsoft Foundrylle
- Arkkitehtuurin tarkistus -agenttimalli - Todellisen maailman isännöity agentti MCP-työkaluilla, Excalidraw-kaavioilla ja kaksoisjulkaisulla
Vastuuvapauslauseke:
Tämä asiakirja on käännetty käyttämällä tekoälypohjaista käännöspalvelua Co-op Translator. Vaikka pyrimme tarkkuuteen, ota huomioon, että automaattiset käännökset voivat sisältää virheitä tai epätarkkuuksia. Alkuperäistä asiakirjaa sen alkuperäiskielellä tulee pitää virallisena lähteenä. Tärkeiden tietojen osalta suositellaan ammattimaista ihmiskäännöstä. Emme ole vastuussa tästä käännöksestä johtuvista väärinkäsityksistä tai väärinymmärryksistä.