[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M699TK47D3KK1CBZXSPBAFRM":3,"skill-same:01M699TK47D3KK1CBZXSPBAFRM":48},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M699TK47D3KK1CBZXSPBAFRM","deploying-scalable-agents",null,"microsoft\u002Fai-agents-for-beginners","microsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F6154722?v=4","01M698VYDXZ6JW5WH3CRV650R8","Microsoft","01M6998ZK2275KMJE6Y5SEA2X2",79423,"MIT","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fsk\u002F.agents\u002Fskills\u002Fdeploying-scalable-agents\u002FSKILL.md",[],[18],"deploying scalable agents","2026-11-10 10:12:30",false,"---\nname: deploying-scalable-agents\nlicense: MIT\n---\n# Nasadzovanie škálovateľných agentov s Microsoft Foundry\n\n> Sprievodná zručnosť pre [Lekcia 16 – Nasadzovanie škálovateľných agentov](..\u002F..\u002F..\u002F16-deploying-scalable-agents\u002FREADME.md).\n> Použite ju na pomoc študentovi pri presune agenta z prototypu do škálovateľného, pozorovateľného\n> produkčného nasadenia. Každé odporúčanie zakladajte na obsahu lekcie a\n> spustiteľnom notebooku; nevymýšľajte API Foundry.\n\n## Spúšťače\n\nAktivujte túto zručnosť, keď chce študent:\n- Nasadiť agenta do Microsoft Foundry ako **hostovaného agenta** a spravovať ho verziami\u002Fpozorovateľnosťou.\n- Vybrať medzi vzormi nasadenia **klient-hosted, hosted-agent a agent-workflow**.\n- Pridať **smerovanie modelu**, **kešovanie odpovedí** alebo **obmedzenú paralelizáciu** na kontrolu latencie a nákladov.\n- Pridať **evaluačnú bránu**, aby sa zlá verzia agenta nedostala do produkcie.\n- Pridať krok **schválenia človekom v slučke** pre rizikové akcie.\n- Instrumentovať agenta pomocou **OpenTelemetry** trasovania pre produkčnú pozorovateľnosť.\n- **Rýchlo otestovať (smoke-test)** nasadeného agenta ako rýchlu bránu po nasadení.\n\n## Základný mentálny model\n\nProdukčný agent je prevažne operačný skelet *okolo* modelu (~80 %),\nnie samotný model. Každé odporúčanie priraďte k jednému z týchto aspektov:\n\n| Aspekt | Prototyp → Produkcia |\n|--------|--------------------|\n| Hosting | notebook → verziovaná hostovaná služba |\n| Identita | váš `az login` → spravovaná identita + obmedzený RBAC |\n| Stav | v pamäti → externé ukladanie vlákien\u002Fpamäte |\n| Chyba | traceback → opakovania, záložné možnosti, upozornenia |\n| Cena | \"niekoľko centov\" → sledovaná, smerovaná, kešovaná, rozpočtovaná |\n| Kvalita | odhadovanie okom → automatizovaná evaluačná brána |\n| Dôvera | vy schvaľujete → politika + človek v slučke |\n\n## Vzory nasadenia (vyberte jeden alebo kombinujte)\n\n1. **Klient-hosted** — slučka uvažovania beží vo vašom procese. Maximálna kontrola; vlastníte škálovanie\u002Fstav.\n2. **Hostovaný agent (Foundry Agent Service)** — Foundry hostí slučku, ukladá vlákna, vynucuje RBAC\u002Fbezpečnosť obsahu, zobrazí agenta v portáli. Menej kontroly, oveľa menšia prevádzková plocha.\n3. **Agent workflow** — viac agentov\u002Fnástrojov zložených do grafu s vetvením, schvaľovacími uzlami a trvalými kontrolnými bodmi.\n\n## životný cyklus (slučka, ktorá dodáva agenta)\n\n`create → version → evaluate (gate) → deploy hosted → observe online → collect failures → repeat`.\n**Offline hodnotenie je brána, nie dodatočná myšlienka** — verzia sa nedodá\n, pokiaľ neprejde prahom. Online pozorovateľnosť vracia skutočné chyby späť\ndo offline testovacej sady.\n\n## Páky škálovania a nákladov (v poradí priority)\n\n1. **Zvoliť vhodnú veľkosť modelu** — použiť najmenší model, ktorý prejde evaluačnou bránou.\n2. **Smerovať podľa zložitosti** — malý\u002Frýchly model pre jednoduché požiadavky, veľký model pre reálne uvažovanie (DIY klasifikátor alebo Foundry Model Router).\n3. **Kešovať** — obslúžiť takmer duplicitné požiadavky bez volania modelu.\n4. **Bezstavový dizajn + obmedzená paralelizácia** — externalizovať stav; opakovať s odkladom.\n\n## Kľúčové vzory na reprodukciu\n\nUkážte študentovi tieto z notebooku\n[`16-python-agent-framework.ipynb`](..\u002F..\u002F..\u002F16-deploying-scalable-agents\u002Fcode_samples\u002F16-python-agent-framework.ipynb):\n\n- **Spracovanie požiadaviek**: kešovať → smerovať podľa zložitosti → trasovací úsek → spustiť → kešovať.\n- **Evaluačná brána**: ohodnotiť offline testovaciu sadu; vrátiť `pass_rate >= threshold` a nasadiť len ak je pravda.\n- **Ľudské schválenie**: `@tool(approval_mode=\"always_require\")` pre akcie ako veľké vrátenia.\n- **Trasovanie**: obaliť každú požiadavku do `tracer.start_as_current_span(...)` a nastaviť atribúty ako `routed.model`, `customer.id`.\n\n## Rýchlotestovanie (smoke-testing) nasadeného agenta\n\nPo nasadení overte, že endpoint skutočne odpovedá (zelené nasadenie môže byť\ntiché). Použite akciu [AI Smoke Test](https:\u002F\u002Fgithub.com\u002Fmarketplace\u002Factions\u002Fai-smoke-test)\ncez [`.github\u002Fworkflows\u002Fsmoke-test.yml`](..\u002F..\u002F..\u002F..\u002F..\u002F.github\u002Fworkflows\u002Fsmoke-test.yml)\ns katalógom v [`tests\u002F`](..\u002F..\u002F..\u002Ftests\u002FREADME.md). Spúšťač pošle POST pre každý\nprompt na `POST {project_endpoint}\u002Fagents\u002F{agent_name}\u002Fendpoint\u002Fprotocols\u002Fopenai\u002Fresponses`\na preverí text odpovede. Identita potrebuje rolu **Azure AI User** v Foundry projekte; divák tokenu musí byť `https:\u002F\u002Fai.azure.com\u002F`.\n\n\nhodnotenie** (dostatočne dobrý na dodanie, pred propagáciou) → **online hodnotenie** (ako sa mu darí v reálnom prostredí, kontinuálne).\n\n\n\n## Podnikové kontroly\n\n- **RBAC**: každému hostovanému agentovi priraďte spravovanú identitu s minimálnymi oprávneniami.\n- **MCP v produkcii**: každý MCP server považujte za neoverenú hranicu — pripnite verziu, ohraničte identitu, overujte výstupy, limitujte rýchlosť, nikdy neodhaľujte tajomstvá.\n\n## Ochranné opatrenia pre asistenta\n\n- Uprednostnite kanonický vzor `FoundryChatClient(...)` + `provider.as_agent(...)` používaný v celom kurze.\n- Nesľubujte výsledky live-Azure, ktoré ste neoverili; odporučte workflow smoke-testu na overenie nasadenia.\n- Držte rady ohľadom hodnotenia a nákladov spolu: hodnotenie nastavuje kvalitativny základ, smerovanie\u002Fkešovanie drží náklady blízko tohto základu.\n\n---\n\n\u003C!-- CO-OP TRANSLATOR DISCLAIMER START -->\n**Vyhlásenie o zodpovednosti**:\nTento dokument bol preložený pomocou AI prekladateľskej služby [Co-op Translator](https:\u002F\u002Fgithub.com\u002FAzure\u002Fco-op-translator). Hoci sa snažíme o presnosť, vezmite prosím na vedomie, že automatické preklady môžu obsahovať chyby alebo nepresnosti. Pôvodný dokument v jeho natívnom jazyku by mal byť považovaný za autoritatívny zdroj. Pre kritické informácie sa odporúča profesionálny ľudský preklad. Nie sme zodpovední za žiadne nedorozumenia alebo nesprávne interpretácie vyplývajúce z použitia tohto prekladu.\n\u003C!-- CO-OP TRANSLATOR DISCLAIMER END -->","# Nasadzovanie škálovateľných agentov s Microsoft Foundry\n\n> Sprievodná zručnosť pre [Lekcia 16 – Nasadzovanie škálovateľných agentov](..\u002F..\u002F..\u002F16-deploying-scalable-agents\u002FREADME.md).\n> Použite ju na pomoc študentovi pri presune agenta z prototypu do škálovateľného, pozorovateľného\n> produkčného nasadenia. Každé odporúčanie zakladajte na obsahu lekcie a\n> spustiteľnom notebooku; nevymýšľajte API Foundry.\n\n## Spúšťače\n\nAktivujte túto zručnosť, keď chce študent:\n- Nasadiť agenta do Microsoft Foundry ako **hostovaného agenta** a spravovať ho verziami\u002Fpozorovateľnosťou.\n- Vybrať medzi vzormi nasadenia **klient-hosted, hosted-agent a agent-workflow**.\n- Pridať **smerovanie modelu**, **kešovanie odpovedí** alebo **obmedzenú paralelizáciu** na kontrolu latencie a nákladov.\n- Pridať **evaluačnú bránu**, aby sa zlá verzia agenta nedostala do produkcie.\n- Pridať krok **schválenia človekom v slučke** pre rizikové akcie.\n- Instrumentovať agenta pomocou **OpenTelemetry** trasovania pre produkčnú pozorovateľnosť.\n- **Rýchlo otestovať (smoke-test)** nasadeného agenta ako rýchlu bránu po nasadení.\n\n## Základný mentálny model\n\nProdukčný agent je prevažne operačný skelet *okolo* modelu (~80 %),\nnie samotný model. Každé odporúčanie priraďte k jednému z týchto aspektov:\n\n| Aspekt | Prototyp → Produkcia |\n|--------|--------------------|\n| Hosting | notebook → verziovaná hostovaná služba |\n| Identita | váš `az login` → spravovaná identita + obmedzený RBAC |\n| Stav | v pamäti → externé ukladanie vlákien\u002Fpamäte |\n| Chyba | traceback → opakovania, záložné možnosti, upozornenia |\n| Cena | \"niekoľko centov\" → sledovaná, smerovaná, kešovaná, rozpočtovaná |\n| Kvalita | odhadovanie okom → automatizovaná evaluačná brána |\n| Dôvera | vy schvaľujete → politika + človek v slučke |\n\n## Vzory nasadenia (vyberte jeden alebo kombinujte)\n\n1. **Klient-hosted** — slučka uvažovania beží vo vašom procese. Maximálna kontrola; vlastníte škálovanie\u002Fstav.\n2. **Hostovaný agent (Foundry Agent Service)** — Foundry hostí slučku, ukladá vlákna, vynucuje RBAC\u002Fbezpečnosť obsahu, zobrazí agenta v portáli. Menej kontroly, oveľa menšia prevádzková plocha.\n3. **Agent workflow** — viac agentov\u002Fnástrojov zložených do grafu s vetvením, schvaľovacími uzlami a trvalými kontrolnými bodmi.\n\n## životný cyklus (slučka, ktorá dodáva agenta)\n\n`create → version → evaluate (gate) → deploy hosted → observe online → collect failures → repeat`.\n**Offline hodnotenie je brána, nie dodatočná myšlienka** — verzia sa nedodá\n, pokiaľ neprejde prahom. Online pozorovateľnosť vracia skutočné chyby späť\ndo offline testovacej sady.\n\n## Páky škálovania a nákladov (v poradí priority)\n\n1. **Zvoliť vhodnú veľkosť modelu** — použiť najmenší model, ktorý prejde evaluačnou bránou.\n2. **Smerovať podľa zložitosti** — malý\u002Frýchly model pre jednoduché požiadavky, veľký model pre reálne uvažovanie (DIY klasifikátor alebo Foundry Model Router).\n3. **Kešovať** — obslúžiť takmer duplicitné požiadavky bez volania modelu.\n4. **Bezstavový dizajn + obmedzená paralelizácia** — externalizovať stav; opakovať s odkladom.\n\n## Kľúčové vzory na reprodukciu\n\nUkážte študentovi tieto z notebooku\n[`16-python-agent-framework.ipynb`](..\u002F..\u002F..\u002F16-deploying-scalable-agents\u002Fcode_samples\u002F16-python-agent-framework.ipynb):\n\n- **Spracovanie požiadaviek**: kešovať → smerovať podľa zložitosti → trasovací úsek → spustiť → kešovať.\n- **Evaluačná brána**: ohodnotiť offline testovaciu sadu; vrátiť `pass_rate >= threshold` a nasadiť len ak je pravda.\n- **Ľudské schválenie**: `@tool(approval_mode=\"always_require\")` pre akcie ako veľké vrátenia.\n- **Trasovanie**: obaliť každú požiadavku do `tracer.start_as_current_span(...)` a nastaviť atribúty ako `routed.model`, `customer.id`.\n\n## Rýchlotestovanie (smoke-testing) nasadeného agenta\n\nPo nasadení overte, že endpoint skutočne odpovedá (zelené nasadenie môže byť\ntiché). Použite akciu [AI Smoke Test](https:\u002F\u002Fgithub.com\u002Fmarketplace\u002Factions\u002Fai-smoke-test)\ncez [`.github\u002Fworkflows\u002Fsmoke-test.yml`](..\u002F..\u002F..\u002F..\u002F..\u002F.github\u002Fworkflows\u002Fsmoke-test.yml)\ns katalógom v [`tests\u002F`](..\u002F..\u002F..\u002Ftests\u002FREADME.md). Spúšťač pošle POST pre každý\nprompt na `POST {project_endpoint}\u002Fagents\u002F{agent_name}\u002Fendpoint\u002Fprotocols\u002Fopenai\u002Fresponses`\na preverí text odpovede. Identita potrebuje rolu **Azure AI User** v Foundry projekte; divák tokenu musí byť `https:\u002F\u002Fai.azure.com\u002F`.\n\n\nhodnotenie** (dostatočne dobrý na dodanie, pred propagáciou) → **online hodnotenie** (ako sa mu darí v reálnom prostredí, kontinuálne).\n\n\n\n## Podnikové kontroly\n\n- **RBAC**: každému hostovanému agentovi priraďte spravovanú identitu s minimálnymi oprávneniami.\n- **MCP v produkcii**: každý MCP server považujte za neoverenú hranicu — pripnite verziu, ohraničte identitu, overujte výstupy, limitujte rýchlosť, nikdy neodhaľujte tajomstvá.\n\n## Ochranné opatrenia pre asistenta\n\n- Uprednostnite kanonický vzor `FoundryChatClient(...)` + `provider.as_agent(...)` používaný v celom kurze.\n- Nesľubujte výsledky live-Azure, ktoré ste neoverili; odporučte workflow smoke-testu na overenie nasadenia.\n- Držte rady ohľadom hodnotenia a nákladov spolu: hodnotenie nastavuje kvalitativny základ, smerovanie\u002Fkešovanie drží náklady blízko tohto základu.\n\n---\n\n\u003C!-- CO-OP TRANSLATOR DISCLAIMER START -->\n**Vyhlásenie o zodpovednosti**:\nTento dokument bol preložený pomocou AI prekladateľskej služby [Co-op Translator](https:\u002F\u002Fgithub.com\u002FAzure\u002Fco-op-translator). Hoci sa snažíme o presnosť, vezmite prosím na vedomie, že automatické preklady môžu obsahovať chyby alebo nepresnosti. Pôvodný dokument v jeho natívnom jazyku by mal byť považovaný za autoritatívny zdroj. Pre kritické informácie sa odporúča profesionálny ľudský preklad. Nie sme zodpovední za žiadne nedorozumenia alebo nesprávne interpretácie vyplývajúce z použitia tohto prekladu.\n\u003C!-- CO-OP TRANSLATOR DISCLAIMER END -->",{"name":5,"license":14},"main","f09e94ffe170f8af6d3db7c42987bbe4db227723","translations\u002Fsk\u002F.agents\u002Fskills\u002Fdeploying-scalable-agents",26019,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners","https:\u002F\u002Faka.ms\u002Fai-agents-beginners","https:\u002F\u002Fgithub.com\u002Fmicrosoft","https:\u002F\u002Fopensource.microsoft.com","Open source projects and samples from Microsoft","2026-11-07 12:51:12",{"source":7,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add microsoft\u002Fai-agents-for-beginners --skill deploying-scalable-agents",{"tool":40,"command":41},"bunx","bunx skills add microsoft\u002Fai-agents-for-beginners --skill deploying-scalable-agents",{"tool":43,"command":44},"pnpm","pnpm dlx skills add microsoft\u002Fai-agents-for-beginners --skill deploying-scalable-agents","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fsk\u002F.agents\u002Fskills\u002Fdeploying-scalable-agents\u002FSKILL.md",true,[],[49,67,78,86,94,99],{"skillNo":50,"name":51,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":52,"categories":53,"keywords":64,"publishedAt":19},"01M69A206TRZ8KK0CW0HYJF5V5","testing-course-samples","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-TW\u002F.agents\u002Fskills\u002Ftesting-course-samples\u002FSKILL.md",[54,59],{"categoryNo":55,"categoryName":56,"taxonomyType":57,"taxonomyTypeDesc":58},"01JBSEEDCAT000000000000008","测试与质量","SCENARIO","使用场景",{"categoryNo":60,"categoryName":61,"taxonomyType":62,"taxonomyTypeDesc":63},"01JBSEEDCAT000000000000039","教师与教育","PROFESSION","适用职业",[65,66],"testing","testing course samples",{"skillNo":68,"name":69,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":75,"publishedAt":19},"01M69A1XRB2SFHYRMEH0K08EKZ","microsoft-docs","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-TW\u002F.agents\u002Fskills\u002Fmicrosoft-docs\u002FSKILL.md",[72],{"categoryNo":73,"categoryName":74,"taxonomyType":57,"taxonomyTypeDesc":58},"01JBSEEDCAT000000000000023","Skill与智能体开发",[76,8,77],"docs","microsoft docs",{"skillNo":79,"name":80,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M69A1VPZFJQ1HNGTZQ5P3WSC","local-ai-agents","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-TW\u002F.agents\u002Fskills\u002Flocal-ai-agents\u002FSKILL.md",[],[84,85],"ai agents","local ai agents",{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":19},"01M69A1S947N7MM6V9JF85S2E7","jupyter-notebook","當使用者要求建立、搭建或編輯 Jupyter 筆記本（`.ipynb`）用於實驗、探索或教學時使用；優先使用隨附範本並執行輔助腳本 `new_notebook.py` 來產生一個乾淨的起始筆記本。","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-TW\u002F.agents\u002Fskills\u002Fjupyter-notebook\u002FSKILL.md",[],[93],"jupyter notebook",{"skillNo":95,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":19},"01M69A1Q8EXPWKZSQK69V6WF22","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-TW\u002F.agents\u002Fskills\u002Fdeploying-scalable-agents\u002FSKILL.md",[],[18],{"skillNo":100,"name":101,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":102,"categories":103,"keywords":104,"publishedAt":19},"01M69A1MHZTH3RH9N8VYSYG74X","azure-openai-to-responses","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-TW\u002F.agents\u002Fskills\u002Fazure-openai-to-responses\u002FSKILL.md",[],[105],"azure openai to responses"]