Bygg, testa och distribuera AI-agenter till Microsoft Foundry Agent Service som Hosted Agents – helt från VS Code med hjälp av Microsoft Foundry extension och Foundry Toolkit.
Hosted Agents är för närvarande i förhandsgranskning. Stödda regioner är begränsade – se regiontillgänglighet.
Mappen
agent/i varje labb skapas automatiskt av Foundry extension – du anpassar sedan koden, testar lokalt och distribuerar.
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
Föredrar du att klona lokalt?
Detta repository inkluderar 50+ språköversättningar vilket markant ökar nedladdningsstorleken. För att klona utan översättningar, använd 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"Detta ger dig allt du behöver för att genomföra kursen med en mycket snabbare nedladdning.
flowchart TB
subgraph Local["Lokal Utveckling (VS Code)"]
direction TB
FE["Microsoft Foundry
Tillägg"]
FoundryToolkit["Foundry Toolkit
Tillägg"]
Scaffold["Ramverk Agentkod
(main.py · agent.yaml · Dockerfile)"]
Inspector["Agentinspektör
(Lokal Testning)"]
FE -- "Skapa Ny
Hostad Agent" --> Scaffold
Scaffold -- "F5 Felsök" --> Inspector
FoundryToolkit -.- Inspector
end
subgraph Cloud["Microsoft Foundry"]
direction TB
ACR["Azure Container
Register"]
AgentService["Foundry Agenttjänst
(Hostad Agent Runtime)"]
Model["Azure OpenAI
(gpt-4.1 / gpt-4.1-mini)"]
Playground["Foundry Lekplats
& VS Code Lekplats"]
ACR --> AgentService
AgentService -- "/responses API" --> Model
AgentService --> Playground
end
Scaffold -- "Distribuera
(Docker build + push)" --> ACR
Inspector -- "POST /responses
(localhost:8088)" --> Scaffold
Playground -- "Testa uppmaningar" --> AgentService
style Local fill:#f0f4ff,stroke:#4a6cf7,stroke-width:2px
style Cloud fill:#fff4e6,stroke:#f59e0b,stroke-width:2px
Flöde: Foundry extension skapar agenten → du anpassar koden & instruktionerna → testar lokalt med Agent Inspector → distribuerar till Foundry (Docker-image pushas till ACR) → verifierar i Playground.
| Labb | Beskrivning | Status |
|---|---|---|
| Lab 01 - Enskild Agent | Bygg "Explain Like I'm an Executive" Agent, testa lokalt och distribuera till Foundry | ✅ Tillgänglig |
| Lab 02 - Multi-Agent Arbetsflöde | Bygg "Resume → Job Fit Evaluator" – 4 agenter samarbetar för att poängsätta CV-passform och generera en lärande plan | ✅ Tillgänglig |
I denna workshop bygger du "Explain Like I'm an Executive" Agent – en AI-agent som omvandlar svår teknisk jargong till lugna, styrelserumsfärdiga sammanfattningar. För ärligt talat, ingen i ledningsgruppen vill höra om "thread pool exhaustion orsakad av synkrona anrop införda i v3.2."
Jag skapade denna agent efter ett antal incidenter där min perfekt utformade post-mortem fick svaret: "Så... är webbplatsen nere eller inte?"
Du matar in en teknisk uppdatering. Den levererar en ledningssammanfattning – tre punkter, ingen jargong, inga stacktraces, ingen existentiell ångest. Bara vad som hände, affärspåverkan, och nästa steg.
Du säger:
"API-latensen ökade på grund av thread pool exhaustion orsakad av synkrona anrop införda i v3.2."
Agenten svarar:
Sammanfattning för ledningen:
- Vad som hände: Efter senaste releasen blev systemet långsammare.
- Affärspåverkan: Vissa användare upplevde förseningar vid användning av tjänsten.
- Nästa steg: Ändringen har rullats tillbaka och en fix förbereds innan omdistribuering.
Den är enkel och har ett enda syfte – perfekt för att lära sig hosted agent-arbetsflödet från början till slut utan att fastna i komplexa verktygskedjor. Och ärligt talat? Varje teknikteam kan ha nytta av en sådan här.
📂 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
Notera: Mappen
agent/i varje labb är vad Microsoft Foundry extension genererar när du körMicrosoft Foundry: Create a New Hosted Agentfrån Command Palette. Filernas innehåll anpassas sedan med agentens instruktioner, verktyg och konfiguration. Lab 01 visar hur du återskapar detta från grunden.
git clone https://github.com/microsoft-foundry/Foundry_Toolkit_for_VSCode_Lab.git
cd Foundry_Toolkit_for_VSCode_Labpython -m venv venvAktivera den:
- Windows (PowerShell):
.\venv\Scripts\Activate.ps1
- macOS / Linux:
source venv/bin/activate
pip install -r workshop/lab01-single-agent/agent/requirements.txtKopiera exempel .env-filen inuti agent-mappen och fyll i dina värden:
cp workshop/lab01-single-agent/agent/.env.example workshop/lab01-single-agent/agent/.envRedigera 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>Varje labb är självständigt med egna moduler. Börja med Lab 01 för att lära dig grunderna, sedan går du vidare till Lab 02 för multi-agent arbetsflöden.
Lab 01 - Enskild Agent (fullständiga instruktioner)
| # | Modul | Länk |
|---|---|---|
| 1 | Läs förutsättningar | 00-prerequisites.md |
| 2 | Installera Foundry Toolkit & Foundry extension | 01-install-foundry-toolkit.md |
| 3 | Skapa ett Foundry-projekt | 02-create-foundry-project.md |
| 4 | Skapa en hosted agent | 03-create-hosted-agent.md |
| 5 | Konfigurera instruktioner & miljö | 04-configure-and-code.md |
| 6 | Testa lokalt | 05-test-locally.md |
| 7 | Distribuera till Foundry | 06-deploy-to-foundry.md |
| 8 | Verifiera i playground | 07-verify-in-playground.md |
| 9 | Felsökning | 08-troubleshooting.md |
Lab 02 - Multi-Agent Arbetsflöde (fullständiga instruktioner)
| # | Modul | Länk |
|---|---|---|
| 1 | Förutsättningar (Lab 02) | 00-prerequisites.md |
| 2 | Förstå multi-agent arkitektur | 01-understand-multi-agent.md |
| 3 | Skapa multi-agent projekt | 02-scaffold-multi-agent.md |
| 4 | Konfigurera agenter & miljö | 03-configure-agents.md |
| 5 | Orkestreringsmönster | 04-orchestration-patterns.md |
| 6 | Testa lokalt (multi-agent) | 05-test-locally.md |
| 7 | Distribuera till Foundry | 06-deploy-to-foundry.md |
| 8 | Verifiera i lekplatsen | 07-verify-in-playground.md |
| 9 | Felsökning (fleragent) | 08-troubleshooting.md |
 Shivam Goyal |
| Scenario | Krävs roller |
|---|---|
| Skapa nytt Foundry-projekt | Azure AI Owner på Foundry-resurs |
| Distribuera till befintligt projekt (nya resurser) | Azure AI Owner + Contributor på prenumerationen |
| Distribuera till fullt konfigurerat projekt | Läsare på konto + Azure AI User på projektet |
Viktigt: Azure-rollerna
OwnerochContributorinkluderar bara hanteringsbehörigheter, inte utvecklings (dataåtgärd) behörigheter. Du behöver Azure AI User eller Azure AI Owner för att bygga och distribuera agenter.
- Snabbstart: Distribuera din första hostade agent (VS Code)
- Vad är hostade agenter?
- Skapa arbetsflöden för hostad agent i VS Code
- Distribuera en hostad agent
- RBAC för Microsoft Foundry
- Architecture Review Agent Sample - Verklighetsbaserad hostad agent med MCP-verktyg, Excalidraw-diagram och dubbel distribution
Ansvarsfriskrivning: Detta dokument har översatts med AI-översättningstjänsten Co-op Translator. Även om vi eftersträvar noggrannhet, bör du vara medveten om att automatiska översättningar kan innehålla fel eller brister. Det ursprungliga dokumentet på dess modersmål bör betraktas som den auktoritativa källan. För kritisk information rekommenderas professionell mänsklig översättning. Vi ansvarar inte för eventuella missförstånd eller feltolkningar som uppstår vid användning av denna översättning.