Направите, тестирате и распорестите AI агенте на Microsoft Foundry Agent Service као Hosted Agents - у потпуности из VS Code користећи Microsoft Foundry екстензију и Foundry Toolkit.
Hosted Agents су тренутно у прегледу (preview). Подржани региони су ограничени - погледајте доступност региона.
Фасцикла
agent/унутар сваке лабораторије је аутоматски генерисана од стране Foundry екстензије - затим прилагодите код, тестирате локално и распорестите.
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
Више волите да клоните локално?
Ово складиште садржи преводе на преко 50 језика што значајно повећава величину преузимања. Да бисте клонирали без превода, користите 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"Ово вам даје све што вам је потребно за завршетак курса са много бржим преузимањем.
flowchart TB
subgraph Local["Локални развој (VS Code)"]
direction TB
FE["Microsoft Foundry
Додатак"]
FoundryToolkit["Foundry Toolkit
Додатак"]
Scaffold["Код агента са шаблоном
(main.py · agent.yaml · Dockerfile)"]
Inspector["Инспектор агента
(Локално тестирање)"]
FE -- "Креирај нови
домаћински агент" --> Scaffold
Scaffold -- "F5 дебаговање" --> Inspector
FoundryToolkit -.- Inspector
end
subgraph Cloud["Microsoft Foundry"]
direction TB
ACR["Azure Registry контејнера"]
AgentService["Foundry Agent сервис
(Рuntime домаћинског агента)"]
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 -- "Деплој
(Docker изградња + пуш)" --> ACR
Inspector -- "POST /responses
(localhost:8088)" --> Scaffold
Playground -- "Тестирај упите" --> AgentService
style Local fill:#f0f4ff,stroke:#4a6cf7,stroke-width:2px
style Cloud fill:#fff4e6,stroke:#f59e0b,stroke-width:2px
Ток: Foundry екстензија генерише агента → прилагођавате код и инструкције → тестирате локално са Agent Inspector → распорестите на Foundry (Docker слика гурана у ACR) → верификујете у Playground-у.
| Лабораторија | Опис | Статус |
|---|---|---|
| Лаб 01 - Један агент | Направите „Објасни као да сам извршни директор“ агента, тестирате локално и распорестите на Foundry | ✅ Доступно |
| Лаб 02 - Вишемањски радни ток | Направите „Резиме → Оцена погодности за посао“ - 4 агента сарађују да оцењују прикладност резимеа и генеришу план учења | ✅ Доступно |
На овом радионици направићете „Објасни као да сам извршни директор“ агента - AI агента који узима компликовани технички жаргон и преводи га у смирене, спремне за управни одбор резиме. Јер, будимо искрени, нико у врху управе не жели да чује о "исцрпљености thread pool-а изазваној синхроним позивима уведеним у в3.2."
Овај агент је настао након више инцидената где је мој савршено састављен пост-мортем добио одговор: "Дакле... да ли је сајт пао или није?"
Унесете техничко ажурирање. Он враћа извршни резиме - три тачке, без жаргона, без stack trace-ева, без егзистенцијалног страха. Само шта се десило, пословни утицај, и следећи корак.
Ви кажете:
"Kашњење API-а се повећало због исцрпљености thread pool-а изазване синхроним позивима уведеним у в3.2."
Агент одговара:
Извршни резиме:
- Шта се десило: Након последњег издања, систем је успорио.
- Пословни утицај: Неки корисници су осетили кашњења при коришћењу услуге.
- Следећи корак: Промена је повучена и припрема се исправка пре новом распорештавања.
То је препрост, агента једне сврхе - савршен за учење радног тока hosted агената од почетка до краја без заливања у сложене алате. И искрено? Сваком инжењерском тиму би пријало да има једног оваквог.
📂 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
Белешка: Фасцикла
agent/унутар сваке лабораторије је оно што Microsoft Foundry екстензија генерише када покренетеMicrosoft Foundry: Create a New Hosted Agentиз Command Palette-а. Фајлови се затим прилагођавају са упутствима, алатима и конфигурацијом вашег агента. Лабораторија 01 вас води кроз поновно креирање овога од нуле.
git clone https://github.com/microsoft-foundry/Foundry_Toolkit_for_VSCode_Lab.git
cd Foundry_Toolkit_for_VSCode_Labpython -m venv venvАктивирајте га:
- Windows (PowerShell):
.\venv\Scripts\Activate.ps1
- macOS / Linux:
source venv/bin/activate
pip install -r workshop/lab01-single-agent/agent/requirements.txtКопирајте пример .env фајла унутар agent фасцикле и попуните своје вредности:
cp workshop/lab01-single-agent/agent/.env.example workshop/lab01-single-agent/agent/.envИзмените 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>Свака лабораторија је самостална са својим модулима. Почните са Лаб 01 да научите основе, а затим пређите на Лаб 02 за вишемањске радне токове.
Лаб 01 - Један агент (пуна упутства)
| # | Модул | Линк |
|---|---|---|
| 1 | Прочитајте предуслове | 00-prerequisites.md |
| 2 | Инсталирајте Foundry Toolkit & Foundry екстензију | 01-install-foundry-toolkit.md |
| 3 | Креирајте Foundry пројекат | 02-create-foundry-project.md |
| 4 | Креирајте hosted агента | 03-create-hosted-agent.md |
| 5 | Конфигуришите упутства и окружење | 04-configure-and-code.md |
| 6 | Тестирајте локално | 05-test-locally.md |
| 7 | Распорестите на Foundry | 06-deploy-to-foundry.md |
| 8 | Верификујте у playground-у | 07-verify-in-playground.md |
| 9 | Решавање проблема | 08-troubleshooting.md |
Лаб 02 - Вишемањски радни ток (пуна упутства)
| # | Модул | Линк |
|---|---|---|
| 1 | Претпоставке (Лаб 02) | 00-prerequisites.md |
| 2 | Разумевање архитектуре вишемањских агената | 01-understand-multi-agent.md |
| 3 | Генерисање пројекта вишемањског агента | 02-scaffold-multi-agent.md |
| 4 | Конфигуришите агенте и окружење | 03-configure-agents.md |
| 5 | Обрасци оркестрације | 04-orchestration-patterns.md |
| 6 | Тестирање локално (вишемањско) | 05-test-locally.md |
| 7 | Деплој на Foundry | 06-deploy-to-foundry.md |
| 8 | Верификација у playground-у | 07-verify-in-playground.md |
| 9 | Решавање проблема (више агената) | 08-troubleshooting.md |
 Шивам Гојал |
| Сценарио | Потребне улоге |
|---|---|
| Креирање новог Foundry пројекта | Azure AI Owner на Foundry ресурсу |
| Деплој на постојећи пројекат (нови ресурси) | Azure AI Owner + Contributor на претплату |
| Деплој на потпуно конфигурисан пројекат | Reader на налогу + Azure AI User на пројекту |
Важно: Azure улоге
OwnerиContributorукључују само управљачке дозволе, а не развојне (операције са подацима). Потребни су вам Azure AI User или Azure AI Owner да бисте креирали и деплојовали агенте.
- Quickstart: Deploy your first hosted agent (VS Code)
- What are hosted agents?
- Create hosted agent workflows in VS Code
- Deploy a hosted agent
- RBAC for Microsoft Foundry
- Architecture Review Agent Sample - Реални пример уграђеног агента са MCP алатима, Excalidraw дијаграмима, и двоструким деплојем
Одрицање од одговорности:
Овај документ је преведен уз помоћ AI услуге за превођење Co-op Translator. Иако тежимо прецизности, имајте у виду да аутоматизовани преводи могу садржати грешке или нетачности. Оригинални документ на свом матичном језику треба сматрати ауторитетом. За критичне информације препоручује се професионални људски превод. Нисмо одговорни за било каква неспоразума или погрешне тумачења која проистекну из коришћења овог превода.