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