Skaleeritavate agentide juurutamine Microsoft Foundry abil
Kaasasolev oskus õppetükile Õppetükk 16 – Skaleeritavate agentide juurutamine.
Kasutage seda, et aidata õppijal viia agent prototüübist skaleeritava ja jälgitava
tootmisjuurutuseni. Põhjendage iga soovitus õppetüki sisu ja
käivitatava märkmikuga; ärge leiutage Foundry API-sid.
Käivitajad
Aktiveerige see oskus, kui õppija soovib:
- Juurutada agent Microsoft Foundry’s hostitud agent-ina ja muuta see versioonihaldatavaks/jälgitavaks.
- Valida kliendipoolse hostimise, hostitud agendi ja agentide töövoo vahel.
- Lisada mudeli marsruutimine, vastuse vahemällu salvestamine või piiratud paralleelsus latentsuse ja kulude juhtimiseks.
- Lisada hinnangukontrollpunkt, et halb agentide versioon ei saaks välja tulla.
- Lisada inimene-otsustsüklis kinnitamine kõrge riskiga tegevuste jaoks.
- Instrumendistada agent OpenTelemetry jälgimisega tootmisjälgitavuseks.
- Teha juurutatud agentile suitsutesti kiireks järelkontrolliks pärast juurutust.
Põhimudeli arusaam
Tootmisagent on peamiselt operatsiooniline skelet mudeli ümber (~80%),
mitte mudel ise. Kaardistage iga soovitus ühele neist valdkondadest:
| Valdkond |
Prototüüp → Tootmine |
| Hostimine |
märkmik → versioonitud hostitud teenus |
| Identiteet |
teie az login → hallatud identiteet + skoopitud RBAC |
| Olekurajastus |
mälus → eksterneeritud lõime/mälupood |
| Tõrge |
veateated → kordused, varuplaanid, hoiatused |
| Kulu |
"paar senti" → jälgitud, marsruutitud, vahemällu salvestatud, eelarvestatud |
| Kvaliteet |
silmaga hindamine → automatiseeritud hinnangukontrollpunkt |
| Usaldus |
teie kinnitate → poliitika + inimene-otsustsüklis |
Juurutusmustrid (vali üks või kombineeri)
- Kliendipoolne hostimine — loogikamälu töötab teie protsessis. Maksimaalne kontroll; teie omate skaleerimist/olekurajastust.
- Hostitud agent (Foundry Agent Service) — Foundry majutab loogikat, hoiab lõimesid, rakendab RBAC/sisu turvalisust, kuvab agendi portaalis. Vähem kontrolli, palju väiksem operatiivne pind.
- Agendi töövoog — mitme agendi/tööriista kokkukomplekseerimine graafikuks koos harude, kinnitussõlmede ja püsivate kontrollpunktidega.
Elutsükkel (agentide käivitamise tsükkel)
loo → versiooni → hinda (värav) → juuruta hostitud → jälgi võrgu peal → kogu tõrkeid → korda.
Võrguvälise hindamisega kontrollpunkt on värav, mitte kõrvalmõte — versioon ei jõua faasi
välja, kui see ei ületa künnist. Võrgupealne jälgimine edastab reaalvead tagasi
võrguvälise testikomplekti.
Skaleerimise ja kulude kangid (prioriteedi järjekorras)
- Mudeli õige suurus — kasuta väikseimat mudelit, mis läbib hinnanguvärava.
- Marsruudi keerukuse järgi — väike/kiire mudel lihtsate päringute jaoks, suur mudel päris mõtlemiseks (DIY klassifikaator või Foundry Model Router).
- Vahemälu — paku peaaegu dubleerivaid päringuid ilma mudelikutseta.
- Olekurajastuseta disain + piiratud paralleelsus — eksternaliseeri olek; proovi uuesti tagasilöögiga.
Peamised mustrid, mida korrata
Suunake õppija märkmikust siia
16-python-agent-framework.ipynb:
- Päringu käitleja: vahemälu → marsruudi keerukuse järgi → jälgimispunkt → käivitus → vahemällu salvestus.
- Hinnanguvärav: hinda võrguvälise testikomplekti tulemust; tagasta
pass_rate >= threshold ja juuruta ainult, kui see on tõene.
- Inimese kinnitamine:
@tool(approval_mode="always_require") toimingute jaoks nagu suuremad tagasimaksed.
- Jälgimine: mähkige iga päring
tracer.start_as_current_span(...) abil ja seadke atribuudid nagu routed.model, customer.id.
Juurutatud agendi suitsutestimine
Pärast juurutust kontrollige, kas lõpp-punkt tegelikult vastab (roheline juurutamine võib siiski olla
vaikne). Kasutage AI suitsutesti
tegevust läbi .github/workflows/smoke-test.yml
kataloogi tests/. Käivitaja saadab iga
päringu POST {project_endpoint}/agents/{agent_name}/endpoint/protocols/openai/responses
aadressile ja kontrollib vastusteksti. Identiteedil peab olema Foundry projektitasandil
Azure AI User roll; tokeni sihtrühm peab olema https://ai.azure.com/.
Skaalake kontrollpunkte: suitsutest (jõuab kohale/vastab, iga juurutus) → võrguväline
hindamine (piisavalt hea juurutamiseks, enne edendamist) → võrgupealne hindamine (kuidas
see looduses töötab, pidev).
Ettevõtte kontrollid
- RBAC: andke igale hostitud agendile hallatud identiteet miinimumõigustega.
- MCP tootmises: käsitle iga MCP serverit usaldustmittevana piirina — fikseerige versioon, skoopige identiteet, valideerige väljundid, piirake kiirust, ärge kunagi avalikustage salasõnu.
Abilise turvavööndid
- Eelistage kursuse jooksul kasutatavat kanonilist mustrit
FoundryChatClient(...) + provider.as_agent(...).
- Ära tõota elusa Azure tulemust enne, kui oled teda kontrollinud; soovita suitsutesti töövoogu kinnitamiseks.
- Hoidke hinnang ja kulunõuanne koos: hinnang seab kvaliteedipõranda, marsruutimine/vahemällu salvestamine hoiab kulu selle lähedal.
Lahtiütlus:
See dokument on tõlgitud kasutades AI tõlketeenust Co-op Translator. Kuigi me püüdleme täpsuse poole, palun pange tähele, et automatiseeritud tõlgetes võib esineda 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õlkega seotud eksimustest või valesti mõistmistest.
Source: microsoft/ai-agents-for-beginners → translations/et/.agents/skills/deploying-scalable-agents/SKILL.md
1---
2name: deploying-scalable-agents-9
3description: "Aktiveerige see oskus, kui õppija soovib: - Juurutada agent Microsoft Foundry’s hostitud agent-ina ja muuta see versioonihaldatavaks/jälgitavaks. - Valida kliendipoolse hostimise, hostitud agendi ja agentide töövoo vahel. - Lisada mudeli marsruutimine, vastuse vahemällu salvestamine või piiratud paralleelsus latentsuse ja kulude juhtimiseks. - Lisada hinnangukontrollpunkt, et halb agentide versioon ei saaks välja tulla."
4category: ai-agents-and-harness
5source_repo: microsoft/ai-agents-for-beginners
6source_path: "translations/et/.agents/skills/deploying-scalable-agents/SKILL.md"
7source_url: https://github.com/microsoft/ai-agents-for-beginners/blob/HEAD/translations/et/.agents/skills/deploying-scalable-agents/SKILL.md
8metadata:
9 source: https://skillmd.com/skills/microsoft/deploying-scalable-agents-9
10---
11
12# Skaleeritavate agentide juurutamine Microsoft Foundry abil
13
14> Kaasasolev oskus õppetükile [Õppetükk 16 – Skaleeritavate agentide juurutamine](../../../16-deploying-scalable-agents/README.md).
15> Kasutage seda, et aidata õppijal viia agent prototüübist skaleeritava ja jälgitava
16> tootmisjuurutuseni. Põhjendage iga soovitus õppetüki sisu ja
17> käivitatava märkmikuga; ärge leiutage Foundry API-sid.
18
19## Käivitajad
20
21Aktiveerige see oskus, kui õppija soovib:
22- Juurutada agent Microsoft Foundry’s **hostitud agent**-ina ja muuta see versioonihaldatavaks/jälgitavaks.
23- Valida **kliendipoolse hostimise, hostitud agendi ja agentide töövoo** vahel.
24- Lisada **mudeli marsruutimine**, **vastuse vahemällu salvestamine** või **piiratud paralleelsus** latentsuse ja kulude juhtimiseks.
25- Lisada **hinnangukontrollpunkt**, et halb agentide versioon ei saaks välja tulla.
26- Lisada **inimene-otsustsüklis kinnitamine** kõrge riskiga tegevuste jaoks.
27- Instrumendistada agent **OpenTelemetry** jälgimisega tootmisjälgitavuseks.
28- Teha juurutatud agentile **suitsutesti** kiireks järelkontrolliks pärast juurutust.
29
30## Põhimudeli arusaam
31
32Tootmisagent on peamiselt operatsiooniline skelet *mudeli ümber* (~80%),
33mitte mudel ise. Kaardistage iga soovitus ühele neist valdkondadest:
34
35| Valdkond | Prototüüp → Tootmine |
36|---------|---------------------|
37| Hostimine | märkmik → versioonitud hostitud teenus |
38| Identiteet | teie `az login` → hallatud identiteet + skoopitud RBAC |
39| Olekurajastus | mälus → eksterneeritud lõime/mälupood |
40| Tõrge | veateated → kordused, varuplaanid, hoiatused |
41| Kulu | "paar senti" → jälgitud, marsruutitud, vahemällu salvestatud, eelarvestatud |
42| Kvaliteet | silmaga hindamine → automatiseeritud hinnangukontrollpunkt |
43| Usaldus | teie kinnitate → poliitika + inimene-otsustsüklis |
44
45## Juurutusmustrid (vali üks või kombineeri)
46
471. **Kliendipoolne hostimine** — loogikamälu töötab teie protsessis. Maksimaalne kontroll; teie omate skaleerimist/olekurajastust.
482. **Hostitud agent (Foundry Agent Service)** — Foundry majutab loogikat, hoiab lõimesid, rakendab RBAC/sisu turvalisust, kuvab agendi portaalis. Vähem kontrolli, palju väiksem operatiivne pind.
493. **Agendi töövoog** — mitme agendi/tööriista kokkukomplekseerimine graafikuks koos harude, kinnitussõlmede ja püsivate kontrollpunktidega.
50
51## Elutsükkel (agentide käivitamise tsükkel)
52
53`loo → versiooni → hinda (värav) → juuruta hostitud → jälgi võrgu peal → kogu tõrkeid → korda`.
54**Võrguvälise hindamisega kontrollpunkt on värav, mitte kõrvalmõte** — versioon ei jõua faasi
55välja, kui see ei ületa künnist. Võrgupealne jälgimine edastab reaalvead tagasi
56võrguvälise testikomplekti.
57
58## Skaleerimise ja kulude kangid (prioriteedi järjekorras)
59
601. **Mudeli õige suurus** — kasuta väikseimat mudelit, mis läbib hinnanguvärava.
612. **Marsruudi keerukuse järgi** — väike/kiire mudel lihtsate päringute jaoks, suur mudel päris mõtlemiseks (DIY klassifikaator või Foundry Model Router).
623. **Vahemälu** — paku peaaegu dubleerivaid päringuid ilma mudelikutseta.
634. **Olekurajastuseta disain + piiratud paralleelsus** — eksternaliseeri olek; proovi uuesti tagasilöögiga.
64
65## Peamised mustrid, mida korrata
66
67Suunake õppija märkmikust siia
68[`16-python-agent-framework.ipynb`](../../../16-deploying-scalable-agents/code_samples/16-python-agent-framework.ipynb):
69
70- **Päringu käitleja**: vahemälu → marsruudi keerukuse järgi → jälgimispunkt → käivitus → vahemällu salvestus.
71- **Hinnanguvärav**: hinda võrguvälise testikomplekti tulemust; tagasta `pass_rate >= threshold` ja juuruta ainult, kui see on tõene.
72- **Inimese kinnitamine**: `@tool(approval_mode="always_require")` toimingute jaoks nagu suuremad tagasimaksed.
73- **Jälgimine**: mähkige iga päring `tracer.start_as_current_span(...)` abil ja seadke atribuudid nagu `routed.model`, `customer.id`.
74
75## Juurutatud agendi suitsutestimine
76
77Pärast juurutust kontrollige, kas lõpp-punkt tegelikult vastab (roheline juurutamine võib siiski olla
78vaikne). Kasutage [AI suitsutesti](https://github.com/marketplace/actions/ai-smoke-test)
79tegevust läbi [`.github/workflows/smoke-test.yml`](../../../../../.github/workflows/smoke-test.yml)
80kataloogi [`tests/`](../../../tests/README.md). Käivitaja saadab iga
81päringu `POST {project_endpoint}/agents/{agent_name}/endpoint/protocols/openai/responses`
82aadressile ja kontrollib vastusteksti. Identiteedil peab olema Foundry projektitasandil
83**Azure AI User** roll; tokeni sihtrühm peab olema `https://ai.azure.com/`.
84
85Skaalake kontrollpunkte: **suitsutest** (jõuab kohale/vastab, iga juurutus) → **võrguväline
86hindamine** (piisavalt hea juurutamiseks, enne edendamist) → **võrgupealne hindamine** (kuidas
87see looduses töötab, pidev).
88
89## Ettevõtte kontrollid
90
91- **RBAC**: andke igale hostitud agendile hallatud identiteet miinimumõigustega.
92- **MCP tootmises**: käsitle iga MCP serverit usaldustmittevana piirina — fikseerige versioon, skoopige identiteet, valideerige väljundid, piirake kiirust, ärge kunagi avalikustage salasõnu.
93
94## Abilise turvavööndid
95
96- Eelistage kursuse jooksul kasutatavat kanonilist mustrit `FoundryChatClient(...)` + `provider.as_agent(...)`.
97- Ära tõota elusa Azure tulemust enne, kui oled teda kontrollinud; soovita suitsutesti töövoogu kinnitamiseks.
98- Hoidke hinnang ja kulunõuanne koos: hinnang seab kvaliteedipõranda, marsruutimine/vahemällu salvestamine hoiab kulu selle lähedal.
99
100---
101
102<!-- CO-OP TRANSLATOR DISCLAIMER START -->
103**Lahtiütlus**:
104See dokument on tõlgitud kasutades AI tõlketeenust [Co-op Translator](https://github.com/Azure/co-op-translator). Kuigi me püüdleme täpsuse poole, palun pange tähele, et automatiseeritud tõlgetes võib esineda 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õlkega seotud eksimustest või valesti mõistmistest.
105<!-- CO-OP TRANSLATOR DISCLAIMER END -->
106
107---
108
109**Source:** [`microsoft/ai-agents-for-beginners`](https://github.com/microsoft/ai-agents-for-beginners) → `translations/et/.agents/skills/deploying-scalable-agents/SKILL.md`